@three333/termbuddy 0.1.2 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/settings.local.json +3 -1
- package/README.md +60 -0
- package/dist/cli.js +283 -137
- package/dist/cli.js.map +1 -1
- package/package.json +1 -1
- package/src/components/AiConsole.tsx +3 -1
- package/src/components/InfoPanel.tsx +67 -0
- package/src/components/index.ts +2 -0
- package/src/components/tool/createBubbleTool.ts +31 -11
- package/src/hooks/useAiAgent.ts +22 -10
- package/src/hooks/useTcpSync.ts +9 -0
- package/src/page/Session.tsx +159 -100
package/README.md
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# TermBuddy
|
|
2
|
+
|
|
3
|
+
一个跑在终端里的“同频搭子”。你敲键盘，它也知道你在努力；你想专注，它就给你上钟；你想互动，它还能帮你把“礼物”从你这边丢到对面。
|
|
4
|
+
|
|
5
|
+
## 安装
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g @three333/termbuddy
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## 启动
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
termbuddy
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
进入后：
|
|
18
|
+
|
|
19
|
+
- 先取个昵称（直接回车用默认也行）
|
|
20
|
+
- `[1]` 建房（Host）：会在局域网里广播房间
|
|
21
|
+
- `[2]` 加入（Join）：扫描局域网，选择房间加入
|
|
22
|
+
|
|
23
|
+
常用按键：
|
|
24
|
+
|
|
25
|
+
- `/` 打开/关闭 AI Console
|
|
26
|
+
- `q` 结束本次陪伴（或在菜单里退出）
|
|
27
|
+
- 扫描页 `b` 返回
|
|
28
|
+
- 倒计时进行中按 `x` 取消
|
|
29
|
+
|
|
30
|
+
## 核心功能
|
|
31
|
+
|
|
32
|
+
- **局域网组队**：Host 用 UDP 广播房间（`UDP 45888`），客户端扫描后用 TCP 连接同步状态（默认 `TCP 45999`）。
|
|
33
|
+
- **敲键盘状态同步**：本地输入会变成 `TYPING/IDLE`，对面会看到你在不在“认真”。
|
|
34
|
+
- 可选：`TERMBUDDY_ACTIVITY_SOURCE=keyboard` 用全局键盘监听统计活跃（适合你不在这个终端里敲字也想计入活跃的场景）。
|
|
35
|
+
- **专注倒计时**：倒计时会显示成一个小钟表 sprite，并在结束/取消后退出舞台。
|
|
36
|
+
- **互动投掷物**：你可以在你和 buddy 之间投掷物品（例如 `ROSE/POOP/HAMMER`），终端里会看到飞行动画。
|
|
37
|
+
- **小猫气泡**：可以在小猫头上弹出一句话（适合“加油”“别摸鱼”等短提示）。
|
|
38
|
+
- **AI Console（可选）**：按 `/` 召唤一个极简 AI 助手，它可以调用工具帮你：
|
|
39
|
+
- `start_countdown` 开始倒计时
|
|
40
|
+
- `throw_projectile` 投掷互动
|
|
41
|
+
- `show_bubble` 显示气泡
|
|
42
|
+
|
|
43
|
+
### AI Key（DeepSeek）
|
|
44
|
+
|
|
45
|
+
AI Console 会提示你输入 DeepSeek API Key。当前实现会把 key 存到**你运行 `termbuddy` 的当前目录**下的 `./src/assets/key.json`。
|
|
46
|
+
|
|
47
|
+
你也可以手动创建：
|
|
48
|
+
|
|
49
|
+
```json
|
|
50
|
+
{
|
|
51
|
+
"apiKey": "YOUR_DEEPSEEK_API_KEY"
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## 例子（直接对 AI 说）
|
|
56
|
+
|
|
57
|
+
- “倒计时 25 分钟”
|
|
58
|
+
- “扔他一个玫瑰”
|
|
59
|
+
- “在我头上显示气泡：专注 10 分钟”
|
|
60
|
+
|