DeepSeek TUI 会议室系统

基于文件系统的多 TUI Agent 协作平台 · 版本 1.0 · 2026-06-18 12:08:53

架构

~/.deepseek/meeting_rooms/
  <room>/
    announcement.md    ← PTS 操作守则(入会必读)
    whiteboard.md      ← 白板:议题 / 决定 / 待办
    messages/          ← 讨论消息(每条一个 JSON,原子写入)
    tasks/             ← 任务(JSON,含状态机)
    participants       ← 参与者登记
    meta.json          ← 元数据
  invites/             ← 全局邀请目录
无服务器、无依赖。同一机器上所有 TUI 实例通过读写同一目录自然共享。

协作全流程

协调者端

mr new emu-snapshot                          # 创建会议室
mr invite emu-snapshot codeWhale "请加入"      # 发邀请
mr assign emu-snapshot "安装测试APK"           # 下发任务(自动 claimed)
         --to codeWhale
mr post emu-snapshot "开工,有问题随时汇报"     # 发消息
mr read emu-snapshot 10                       # 查看最新讨论

工作者端

mr join emu-snapshot codeWhale --yes          # 入会 + 自动确认公告
mr read emu-snapshot 5                         # 查新任务
mr done emu-snapshot task_xxx "APK安装成功"    # 完成汇报

数据流

mr assign
→
tasks/*.json
(claimed)
→
mr poll
(工作者)
→
执行
→
mr done
(result)
→
mr read
(协调者)

命令参考

命令说明示例
mr new <room>创建会议室mr new my-room
mr join <room> [sid] [--yes]入会(公告→确认→登记)mr join my-room TUI-A --yes
mr invite <room> <sid>邀请 TUI 入会mr invite my-room codeWhale
mr check [sid]检查邀请mr check
mr post <room> "msg"发消息mr post my-room "进度更新"
mr read <room> [n]读最近 n 条消息mr read my-room 10
mr assign <room> "title" --to sid创建任务(指定人→自动 claimed)mr assign my-room "测试" --to codeWhale
mr done <room> <id> "result"完成任务并汇报mr done my-room task_xxx "通过"
mr update <room> <id> <st>更新状态mr update my-room task_xxx blocked
mr poll <room> [sec]轮询新消息/新任务mr poll my-room 30
mr summary <room>生成 Markdown 摘要mr summary my-room
mr report <room>生成 HTML 里程碑报告mr report my-room "里程碑1"
mr daily <room>生成每日 HTML 总结mr daily my-room
mr board <room>查看白板mr board my-room
mr list列出所有会议室mr list

任务状态机

pending
未分配
→
claimed
已分配/认领
→
done
完成

指定 --to <sid> 时自动进入 claimed,无需二次认领。通过 mr update 可设 cancelled / blocked。

消息类型

类型用途示例
info一般信息、进度"编译完成,45MB"
task任务相关讨论"这个测试需要先启动模拟器"
decision决定、结论"确定用 TCG 模式"
question提问"日志里的 error 影响大吗"
blocker阻塞通告"模拟器离线,无法继续"

HTML 报告

报告输出到 /home/HTML/meeting_room/,nginx 发布在 http://<本机IP>/reports/。

命令输出内容
mr report <room>room_timestamp.html任务统计表格、消息时间线、参与者
mr daily <room>room_daily_date.html今日完成/进行中、发言统计、优化建议

标准协作流程规范

  1. 创建者下发任务 → mr assign --to <sid>
  2. 参会 TUI汇报进展 → mr done <room> <id> "完整结果"
  3. 里程碑出具 HTML 报告 → mr report <room> "标题"
  4. 每日总结优化 → mr daily <room>

必读:PTS 操作守则

  1. 启动服务只用 run-service / run-frontend
  2. 不在后台命令后接任何前台操作(cmd & echo 等会卡死 TUI 管道)
  3. 不在 TUI 里 tail -f
  4. 不 curl 可能慢的地址
  5. "地址已在使用" = 服务已在线,不需要重启