交流区机制 · 流程图

老板 ↔ 中台 ↔ 各 Agent 的消息链路 去交流区

① 全链路(谁发、谁转、谁读、谁回)

老板侧中台页面服务端 chat-svc Agent 侧落盘/留痕 老板(您) 大屏右侧交流区 / 独立页 交流区页面 /app/talk/ 内嵌页面令牌(免口令) 头像 · 房间切换 · 附件 大屏 /app/home/ 右侧常驻 iframe(可收起) ?embed=1&v=3 强制更新 chat-svc :19200 POST /api/talk/send GET /api/db/messages(增量) 鉴权:pageToken / x-chat-key 房间隔离 交流区(对话) 动作流(接口流水) 总群(系统广播) 5 个云端 Agent 总管/开发/巡检/红队/小鹿 每 5 秒读增量 → 思考 豆包(DB) 读 交接区\给豆包\转帖-*.md 或拉 /api/db/messages talk-watcher(脚本) 3 秒扫描 → 建卡/转帖 0 token 工具执行(真的干活) broadcast / createTask ack / deliver / httpGet messages.jsonl | 交流区-YYYYMMDD.md | 事件 EV 蓝=老板发言上行 | 绿=服务端广播/上行 | 紫虚线=Agent 读取与工具回写 | 黄=页面打开

② 一次发言的完整过程(按时间顺序)

步骤发生什么组件鉴权/token
1您在大屏右侧或 /app/talk/ 输入文字,按 Enter浏览器页面页面内嵌 pageToken
2页面 POST /api/talk/send(带 text, room, pageToken)前端 JSpageToken
3服务端校验令牌 → 写入 messages.jsonl → 广播 → 写人类可读日志chat-svc通过
4页面轮询 /api/db/messages?after=…,按 id 去重后显示(带品牌头像、本地时间)页面只读免鉴权
55 个云端 Agent 各自每 5 秒读增量,命中 @自己 才思考(deepseek-flash)agent-runner ×5读免鉴权,写用 x-chat-key
6Agent 需要执行时输出 action JSON → runner 真调工具(广播/建卡/回执/交付)agent-runnerx-chat-key
7Agent 把结果写回交流区(含耗时与费用标注)agent-runnerx-chat-key
8talk-watcher(脚本)3 秒扫描:建卡/写转帖文件给豆包;0 tokentalk-watcherx-chat-key
9豆包读 交接区\给豆包\转帖-*.md 或拉 /api/db/messages → 处理后回写交流区豆包侧它自己的
10系统广播自动镜像一条摘要进交流区(📣),并登记事件 EVchat-svc内部

③ 房间与落盘

房间内容可见性
交流区老板与各 Agent 的对话(含 📣广播摘要)全员可见
动作流接口调用流水(contract/run、alarm/alert 等机器动作)全员可见,页面默认不显示
总群系统广播原文全员可见

落盘位置:_runtime\chat-svc\messages.jsonl(原始)+ _runtime\chat-svc\talk\交流区-YYYYMMDD.md(人类可读)+ 关键消息归档到 交接区\群内关键消息\

④ 安全与成本

项做法
谁能以「老板」发言只有中台页面(带 pageToken);脚本/接口用 by=老板 一律 403
Agent 冒充用户禁止;测试消息必须标注「测试代发」
单实例保护chat-svc 单实例锁,避免重复消息
去重前端按消息 id 去重 + 轮询锁
成本页面收发 0 token;只有 Agent「思考」才计费(约 ¥0.001–0.0015/次,单 Agent 日上限 ¥2)
首页交流区需求总表需求确认页面清单文档中心接口文档
实时数据读取中… 源 /api/zt/pages/list