2026-09-30 15:27:06 +08:00
|
|
|
|
# termchat — 极简双人终端聊天
|
|
|
|
|
|
|
2026-10-03 23:22:06 +08:00
|
|
|
|
一个命令启动,两个人直连聊天。无用户系统、无历史存储,断线自动重连。
|
2026-10-03 17:44:21 +08:00
|
|
|
|
自带摸鱼模式:老板键一键伪装、全程不留痕迹。
|
2026-09-30 15:27:06 +08:00
|
|
|
|
|
|
|
|
|
|
## 用法
|
|
|
|
|
|
|
|
|
|
|
|
```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 小红
|
|
|
|
|
|
```
|
|
|
|
|
|
|
2026-10-03 17:44:21 +08:00
|
|
|
|
开发模式(免编译):`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` 退出时清屏清缓冲,不留任何痕迹
|
2026-09-30 15:27:06 +08:00
|
|
|
|
|
|
|
|
|
|
## 参数
|
|
|
|
|
|
|
|
|
|
|
|
| 命令 | 选项 | 默认 |
|
|
|
|
|
|
|---|---|---|
|
|
|
|
|
|
| `serve` | `-p, --port` | 9000 |
|
|
|
|
|
|
| `serve` | `-n, --name` | A |
|
2026-10-03 17:44:21 +08:00
|
|
|
|
| `serve` | `--title` | claude |
|
2026-09-30 15:27:06 +08:00
|
|
|
|
| `connect <host>` | `-p, --port` | 9000 |
|
|
|
|
|
|
| `connect <host>` | `-n, --name` | B |
|
2026-10-03 17:44:21 +08:00
|
|
|
|
| `connect <host>` | `--title` | claude |
|
2026-09-30 15:27:06 +08:00
|
|
|
|
|
|
|
|
|
|
## 说明
|
|
|
|
|
|
|
|
|
|
|
|
- 协议:TCP,每行一个 JSON(`{"type":"msg","name":"…","text":"…","ts":…}`)
|
2026-10-03 23:22:06 +08:00
|
|
|
|
- **断线自动重连**:客户端断线后指数退避重连(500ms 起步、封顶 10s),
|
|
|
|
|
|
重启对方即可恢复,无需重启自己;客户端也可以先于服务端启动,会一直等
|
|
|
|
|
|
- 服务端常驻监听,新连接到来时替换旧连接(顺便救活半开连接);
|
|
|
|
|
|
界面上 `reconnecting…` / `等待重连…` 即重连状态
|
2026-09-30 15:27:06 +08:00
|
|
|
|
- 局域网直连;跨公网需要 A 侧有公网 IP 或端口映射(或后续加中转服务器)
|
2026-10-03 23:22:06 +08:00
|
|
|
|
- 目前**明文传输**,同网段可被抓包看到内容;加密(--key)后续版本再加
|
2026-09-30 15:27:06 +08:00
|
|
|
|
- Windows 首次 `serve` 会弹防火墙授权,允许即可
|
|
|
|
|
|
|
|
|
|
|
|
## 测试
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
npm run smoke # 通信层冒烟测试(不起 UI)
|
|
|
|
|
|
```
|