Files
HardlyWork/README.md
T
zuoyuxiang 0f806ed17c termchat: 断线自动重连 — 服务端常驻监听 + 客户端退避重连
- 服务端不再在接受首个连接后关闭 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>
2026-10-03 23:22:06 +08:00

82 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)
```