0f806ed17c
- 服务端不再在接受首个连接后关闭 listener,新连接到来时替换旧连接 (替换语义同时是半开连接的恢复路径) - 客户端断线后指数退避自动重连(500ms 起步、封顶 10s),连上即重置; 支持先于服务端启动;连接阶段 5s 超时防不可达地址卡 SYN 重传 - socket 代数计数:被替换/拆除的旧 socket 的迟到事件全部判废 - 修复潜伏 bug:readline 将 socket error 转发重抛,无 listener 直接 崩进程 —— 原先"连不上报错退出"实为崩溃 - ECONNRESET 过滤(正常断开不再显示吓人报错)、同文本错误去重 (无限重连不刷屏)、TCP keepalive 30s - Phase 新增 reconnecting;UI 适配重连状态显示 - smoke 测试重写为事件驱动 4 场景(基础收发/客户端先行/服务端替换/ 服务端重启+断线排队 flush) Co-Authored-By: Claude Code <noreply@anthropic.com>
82 lines
3.2 KiB
Markdown
82 lines
3.2 KiB
Markdown
# termchat — 极简双人终端聊天
|
||
|
||
一个命令启动,两个人直连聊天。无用户系统、无历史存储,断线自动重连。
|
||
自带摸鱼模式:老板键一键伪装、全程不留痕迹。
|
||
|
||
## 用法
|
||
|
||
```bash
|
||
npm run build
|
||
|
||
# A 机(服务端)
|
||
node dist/cli.js serve -n 小明
|
||
|
||
# B 机(客户端,填 A 的 IP;本机测试用 127.0.0.1)
|
||
node dist/cli.js connect <A的IP> -n 小红
|
||
```
|
||
|
||
装成全局命令:
|
||
|
||
```bash
|
||
npm install -g .
|
||
chat serve -n 小明
|
||
chat connect 192.168.x.x -n 小红
|
||
```
|
||
|
||
开发模式(免编译):`npm run dev -- serve 小明`(昵称可直接作位置参数;
|
||
Windows 上 npm 会吞掉 `-n` 短选项,dev 模式下请用位置参数或 `--name` 长选项)
|
||
|
||
## 摸鱼模式
|
||
|
||
| 快捷键 | 作用 |
|
||
|---|---|
|
||
| `Ctrl+B` | **老板键**:一键切换伪装屏 / 切回聊天 |
|
||
| `Esc` | 伪装屏下切回聊天;"干活中"打断(记一条 `✻ Worked for Ns`) |
|
||
| `Ctrl+T` | 聊天区 Claude 风(默认) / 彩色风切换 |
|
||
|
||
- **整个界面伪装成 Claude Code**:启动是 Clawd 吉祥物 banner,
|
||
你的消息显示成灰底 `> 提问`,对方消息显示成 `● 回复` 并带
|
||
`● Read(…)` / ` ⎿ Read 120 lines` 工具调用痕迹,
|
||
底部是 `❯` 上下线输入框(带闪烁块光标、权限模式 footer)——
|
||
聊天状态被看到,也以为你在跟 Claude 对话
|
||
- **聊天节奏也像**:你发出消息后底部出现橙色 spinner 转个不停
|
||
(✻ Pondering… (3s · esc to interrupt)),对方回复到达时变成
|
||
`✻ Worked for Ns`——看起来就是 Claude 刚干完活
|
||
- **伪装屏**(`Ctrl+B`):全屏显示一个正在跑的 Claude Code 会话——
|
||
工具调用步骤持续滚动、底部 spinner 转个不停,任由老板盯着看
|
||
- **双向毁迹**:每次切换都清屏 + 清回滚缓冲,向上翻页也翻不到聊天记录;
|
||
聊天内容保留在内存,切回自动恢复,未发送的草稿也不丢
|
||
- **伪装期间**:按键全部吞掉(不会误发消息),对方发来的消息静默接收,
|
||
切回即可查看
|
||
- **窗口标题伪装**:任务栏/标签页显示 `claude`(毕竟是 2026 年,
|
||
满屏 Claude Code 就是正在干活的铁证);`--title` 可自定义
|
||
- **退出毁迹**:`Ctrl+C` 退出时清屏清缓冲,不留任何痕迹
|
||
|
||
## 参数
|
||
|
||
| 命令 | 选项 | 默认 |
|
||
|---|---|---|
|
||
| `serve` | `-p, --port` | 9000 |
|
||
| `serve` | `-n, --name` | A |
|
||
| `serve` | `--title` | claude |
|
||
| `connect <host>` | `-p, --port` | 9000 |
|
||
| `connect <host>` | `-n, --name` | B |
|
||
| `connect <host>` | `--title` | claude |
|
||
|
||
## 说明
|
||
|
||
- 协议:TCP,每行一个 JSON(`{"type":"msg","name":"…","text":"…","ts":…}`)
|
||
- **断线自动重连**:客户端断线后指数退避重连(500ms 起步、封顶 10s),
|
||
重启对方即可恢复,无需重启自己;客户端也可以先于服务端启动,会一直等
|
||
- 服务端常驻监听,新连接到来时替换旧连接(顺便救活半开连接);
|
||
界面上 `reconnecting…` / `等待重连…` 即重连状态
|
||
- 局域网直连;跨公网需要 A 侧有公网 IP 或端口映射(或后续加中转服务器)
|
||
- 目前**明文传输**,同网段可被抓包看到内容;加密(--key)后续版本再加
|
||
- Windows 首次 `serve` 会弹防火墙授权,允许即可
|
||
|
||
## 测试
|
||
|
||
```bash
|
||
npm run smoke # 通信层冒烟测试(不起 UI)
|
||
```
|