Bifrost（结构化协作通道）

不是传话筒。 两个 Agent 从不同视角分析同一个问题，合力得出比单人更好的结论。 提问方必须消化融合后产出自己的结论，而不是直接转发对方的话。

核心原则

1. 共同探讨，不是转话 - 提问方消化融合后产出自己的结论，不可直接转发原话。
2. 平等分析 - 双方视角不同很正常，不压制、不急转弯。
3. 议题隔离 - 一个 session-id 只走一个议题，完结即休眠。
4. 降级可用 - 协作系统不可达时消息入队，不阻塞业务。

什么时候用 Bifrost

路由模式

同体系内：走 sub-agent 调度机制 跨体系（非同一协议环境）：走协作 API（bifrost.py）

角色注册

角色是"视角偏好"，不是"能力限制"。每个角色都可以讨论任何话题，只是默认切入角度不同。

API 调用

前置条件

1. bifrost.py 脚本位于 scripts/bifrost.py
2. 协作服务已启动（本地端口监听）
3. 端口号从环境变量 BIFROST_PORT 读取，默认 8765
4. Bearer Token 从环境变量 BIFROST_TOKEN 读取

基础命令

# 架桥 - 抛出议题（开启新会话）
python scripts/bifrost.py \
  --message "议题内容" \
  --session-id "bifrostTopicName" \
  --speaker "提问方名称" \
  --target main

# 同一议题继续对话（复用 session-id）
python scripts/bifrost.py \
  --message "补充内容/反馈" \
  --session-id "bifrostTopicName" \
  --speaker "提问方名称"

参数说明

消息长度限制：单条 ≤ 8000 字符。超过则拆分为多条，或先做摘要。

每轮协作指南

提问方怎么做

收尾方式

观点收敛或分歧明确时，提问方做汇总：

【协作汇总】

一致的观点：
- ...
- ...

分歧点：
- A 方认为：...
- B 方认为：...

我的综合判断：
- ...

重要：这是提问方自己的结论，不是"双方共识"。提问方要对结论负责。

四镜协同（与 origin-thinking）

Bifrost 协作默认使用 origin-thinking 的四镜作为共同语言：

--lens 参数可以手动指定切入角度：

python scripts/bifrost.py --message "..." --lens 破执

不指定时，系统根据议题类型自动选择切入镜。

降级策略（协作系统不可达时）

协作系统不可达时不阻塞业务流程，消息自动入队：

正常路径：提问方 → 协作 API → 接收方
降级路径：提问方 → <shared-tasks>/bifrost-queue/ → 接收方下次启动拾取
恢复路径：协作系统恢复后 → 自动发送积压消息

队列规则：

• 队列位置：默认写入用户缓存目录；设置 SHARED_TASKS 后写入 ${SHARED_TASKS}/bifrost-queue/
• 队列文件格式：{timestamp}_{session_id}.json
• 队列最多 50 条，超出丢弃最旧的
• 恢复时不保证严格顺序
• 消息入队后告知用户："协作系统暂不可达，消息已入队待发送"

队列文件结构：

{
  "timestamp": "2026-07-17T10:00:00Z",
  "session_id": "bifrostTopicName",
  "speaker": "提问方",
  "target": "main",
  "message": "...",
  "retries": 0
}

会话管理

session-id 命名规范：

• 格式：bifrost{主题名}（无分隔符，驼峰）
• 示例：bifrostSkillArch、bifrostSecurityReview
• 一个议题一个 id，不要混用

故障处理

重试策略：

• 首次失败 → 等待 2 秒 → 重试
• 再次失败 → 等待 5 秒（指数退避）→ 重试
• 超过 --retries 次 → 入队降级，告知用户

注意：是"指数退避"，不是"指数退"。

最小执行单元

输入：

• 议题、session-id、speaker、target，以及是否指定四镜视角。

执行：

• 使用同一 session-id 发送同一议题消息。
• 消息超过限制时先摘要或拆分。
• 服务不可达时写入本地队列，不阻塞主任务。

输出：

• 发送结果或队列文件。
• 对方返回内容（如有）。
• 提问方消化后的综合判断。

完成标准：

• 议题没有被拆散到多个 session。
• 协作失败时有降级队列。
• 最终输出是提问方的综合结论，而不是转发。

失败处理：

• 服务不可达：入队并稍后 --flush-queue。
• 认证失败：检查 BIFROST_TOKEN。
• 消息过长：摘要后再发送。

禁止事项

• ❌ 直接转发对方原话（提问方必须消化融合，产出自己的结论）
• ❌ 同一议题用多个 session-id（造成上下文碎片化）
• ❌ 单条消息超 8000 字符（先压缩/摘要）
• ❌ 用 Bifrost 做任务分配/命令传达（那不是"共同探讨"）
• ❌ 协作失败就卡住不前进（降级入队，业务继续）