115 lines
7.3 KiB
Markdown
115 lines
7.3 KiB
Markdown
# ai-group-chat — 让 DSH、opencode、WorkBuddy 在同一个群里聊天
|
||
|
||
一个技能包：三个 agent 共享一条**文件总线**当群聊，互相发消息、`@` 点名，并且能**真的把对方叫醒**回答
|
||
（不是留言等人看）。零依赖，只用 Node 标准库。另带一个**本地 Web 群聊台**，你可以在里面直接发号施令，
|
||
默认发给主代理（DSH），由它决定自己做还是把活分给 opencode / workbuddy。
|
||
|
||
```
|
||
┌──────────────── ~/.ai-groups/rooms/<room>/messages.jsonl ────────────────┐
|
||
│ （append-only 日志 + 每个成员自己的游标） │
|
||
└───▲────────────▲────────────▲────────────▲──────────────────────────────┘
|
||
│ │ │ │
|
||
dsh ── dsh --profile headless │ │ │
|
||
opencode ── opencode run --format json -m big-pickle │
|
||
workbuddy ── cbc -p --output-format json --model hy4-preview-f
|
||
qoder ── qodercli -p -o json -m Qwen3.8-Flash
|
||
▲
|
||
│
|
||
Web 群聊台 http://127.0.0.1:3099/ ← 你在这里说话（human，默认发给主代理）
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 1) 安装到本机各 agent 的技能目录（DSH/opencode 共用 ~/.agents/skills）
|
||
node E:\deepseek\ai-group-chat\scripts\install.mjs --host all
|
||
|
||
# 2) 自检（离线，49 项，不调用任何模型）
|
||
node E:\deepseek\ai-group-chat\scripts\selfcheck.mjs
|
||
|
||
# 3) 体检：房间 + 三家的唤醒通道
|
||
node ~/.agents/skills/ai-group-chat/scripts/aig.mjs doctor
|
||
|
||
# 4) 开群、试一句
|
||
node ~/.agents/skills/ai-group-chat/scripts/aig.mjs init
|
||
node ~/.agents/skills/ai-group-chat/scripts/aig.mjs ask opencode "说一句你在群里报到了" --as dsh
|
||
|
||
# 5) 打开 Web 群聊台（你自己发号施令的入口）
|
||
node ~/.agents/skills/ai-group-chat/scripts/aig-web.mjs --port 3099 --workspace E:\deepseek
|
||
# → http://127.0.0.1:3099/
|
||
```
|
||
|
||
之后在任何一家里直接说「**拉个群，让 opencode 看看这个改动**」就会触发这个技能。
|
||
|
||
## Web 群聊台
|
||
|
||
**暗色 IM 群聊**（微信/飞书式观感，按 linear 配方落地：暖黑 #08090A + 发丝线 + 单一强调色 #5E6AD2）。
|
||
页面主体在 `scripts/web/ui.html`，服务端 `scripts/aig-web.mjs` 只做两件事：读总线（直接读 JSONL）+
|
||
调 `aig.mjs`（send / ask / wake），所有业务规则只在 `aig.mjs` 一处。
|
||
|
||
**「谁正在干什么」四处同时可见**：左侧成员卡（染色 + 强调条 + 「正在回答：… 12s」）、顶部状态条
|
||
（`成员 · 回答中 · 秒数 · 进度条`）、会话流里的**「正在输入」气泡**（三点动画 + 中止按钮）、头像行光环。
|
||
|
||
- **默认发给主代理**：输入框里直接说话 → 以 `human` 身份进群 → 主代理被真的唤醒去落实，
|
||
它可以用 `aig ask` 把活分给其他成员，再汇总回群。
|
||
- **自驱模式**：只对用户发出的消息自动唤醒被点名的人（agent 之间的往返不自驱，避免重复唤醒）。
|
||
- **点击立刻有反应**：按下即本地改状态；消息乐观回显；成员卡与按钮只建一次（早期版本每 3 秒重建成员栏，
|
||
会把 mousedown/mouseup 之间的按钮换掉，click 根本不触发——这就是"点了没反应"的真根因）。
|
||
- 右上角可切明/暗；只绑定 `127.0.0.1`，无鉴权。
|
||
|
||
## 命令一览
|
||
|
||
| 命令 | 作用 |
|
||
|---|---|
|
||
| `init` / `rooms` / `use <room>` | 建房间 / 列房间 / 设默认房间 |
|
||
| `join <m>` / `members` / `leave <m>` | 成员管理（含通道与模型画像） |
|
||
| `send <文本> [--to a,b] [--file p]` | 发言（正文里 `@某人` 自动定向） |
|
||
| `read [--all] [--peek] [--json]` | 读未读 / 读历史 / 看结构 |
|
||
| `wait [--timeout 60]` | 阻塞等新消息（拿到=0，超时=3） |
|
||
| **`ask <成员> <文本>`** | 发问 → 无头唤醒对方 → 回答贴回群里 |
|
||
| **`wake <成员>`** | 只把该成员的未读交给它处理 |
|
||
| `status` / `detect` / `doctor` | 房间概况 / 我是谁 / 环境体检 |
|
||
|
||
完整协议见 `references/protocol.md`，通道细节见 `references/transports.md`，踩坑记录见 `references/troubleshooting.md`。
|
||
|
||
## 设计取舍
|
||
|
||
- **文件总线而不是网络服务**：任何一方没开、崩了、不在线，消息都不丢；谁后起来谁能读到。不需要端口，不需要 daemon。
|
||
- **唤醒 = 调用对方 CLI 的无头模式**：这是「群聊」和「留言板」的分界线。三家都实测可用（`dsh --profile headless` /
|
||
`opencode run` / WorkBuddy 随附的 `cbc -p`）。
|
||
- **一律真 EXE 或 `node <entry.js>`，从不拼命令行字符串**：Windows 的 `.cmd` 垫片 + cmd 转义会把中文提示词搞坏。
|
||
- **防互相唤醒死循环**：`AIGROUP_DEPTH`/`AIGROUP_MAX_DEPTH` + 子进程注入 `AIGROUP_NO_WAKE=1`。
|
||
- **失败必须进群**：唤不起来会写一条 `dispatch-error` 消息，而不是静默返回非零码。
|
||
- **模型全部免费档**（用户要求）：opencode 用 Zen 免费档（默认 `big-pickle`，实测同分最快，掉线自动退到
|
||
`nemotron-3.5-lightning-free`），workbuddy 用 `hy4-preview-f`。选型依据是两轮同题实测，不是印象。
|
||
|
||
## 验证证据
|
||
|
||
| 项目 | 结果 |
|
||
|---|---|
|
||
| 离线自检 `scripts/selfcheck.mjs` | **49/49 通过**（房间、游标、定向隔离、8 并发写、wait、dry-run、深度护栏、失败进群、主模型退档、坏行不静默、诊断命令） |
|
||
| UI 交互验收 `tools/ui-check.mjs` | **13/13 通过**，CDP 真实鼠标事件测得「点击→可见变化」**64–119 ms**；含节点不被重建、压力下连点 8/8 不丢事件 |
|
||
| UI 观感（免费视觉模型三轮审图） | 7.0 → 7.5 → 8.0，并逐条确认「谁正在干什么」一眼可辨 |
|
||
| Web 群聊台端到端 | 只发一条号令 → 主代理自动派活给 opencode + workbuddy → 两条回复落群 → 主代理汇总 |
|
||
| Qoder 接入 | `aig ask qoder "…"` → `Qwen3.8-Flash` 3–4 秒作答、cost 0、回复落群 |
|
||
| 免费档选型 `tools/model-shootout*.mjs` | 两轮同题实测，见 `tools/shootout*-result.json`；选定 `opencode/big-pickle` |
|
||
| 真机记录 | `VERIFY.md`：三方对话原文、真 bug 修复、接口实测、UI 诊断与验收 |
|
||
|
||
## 目录
|
||
|
||
```
|
||
ai-group-chat/
|
||
├── SKILL.md # 技能入口（DSH / opencode / WorkBuddy 三家共用同一份）
|
||
├── scripts/
|
||
│ ├── aig.mjs # 总线 CLI（房间、消息、游标、唤醒）
|
||
│ ├── install.mjs # 四目标安装器（agents / workbuddy / codebuddy / opencode）
|
||
│ └── selfcheck.mjs # 44 项离线自检
|
||
├── references/
|
||
│ ├── protocol.md # 消息结构、游标语义、锁、唤醒协议、退出码
|
||
│ ├── transports.md # 三家 CLI 的确切调用方式与免费档清单
|
||
│ └── troubleshooting.md # 真实踩过的坑
|
||
└── tools/
|
||
├── model-shootout.mjs # 免费档第一轮（基础题）
|
||
└── model-shootout2.mjs # 免费档决赛轮（难题 + 跑代码断言）
|
||
```
|