Files
HardlyWork/README.md
T

82 lines
3.2 KiB
Markdown
Raw Normal View History

# 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)
```