蓝火媒桥 · Lanhuo Media Bridge

张三 在 wecom 群: "@蓝火 修一下登录里 refresh_token 的 bug"
机器人 → 🦞 蓝火任务已建档 (cc-20260507-093021-...)
机器人 → 🚀 Claude Code 接活了 (sonnet)
机器人 → 🔧 调用 Read：src/auth/login.py
机器人 → 🔧 调用 Grep：refresh_token in src/auth/
机器人 → 💬 我准备把 refresh_token 的轮换逻辑挪到 ...
机器人 → 🔧 调用 Edit：src/auth/login.py
机器人 → 🔧 调用 Bash：pytest tests/test_auth.py
机器人 → ✅ 完成 · 用时 47.3s · 8 工具 · $0.12
机器人 → [Claude Code 的最终结果文本]

https://keepermac.huo15.com/lanhuo

# 派活
cc-media-task --desc "重构 user 模块，将 ORM 改 raw SQL"
cc-media-task --desc "修这个 UI bug" --image error.png
cc-media-task --desc "" --video bug-walkthrough.mp4

# 实时跟踪
cc-media-task --tail cc-20260507-093021-a3f2

# AI 摘要（v2.18.0）
cc-summarize-sessions --limit 20            # 给最近 20 个 session 生成一句摘要
cc-summarize-sessions --session-id <UUID>   # 单条

你在飞书/Telegram/WhatsApp/wecom 发消息（文字+图+音+视频）
              │
              ▼
      ┌────────────────────┐
      │   OpenClaw chat    │  ← 入站消息带 sender_id / channel
      │  + 蓝火 SKILL      │  ← 触发词命中 → 派活
      └────┬───────────────┘
           │
           ├──[查询模式]── enhance plugin before_prompt_build hook
           │              ├── 检测"蓝火+任务/列表/历史"模式
           │              ├── HTTP fetch /cc-sessions 拿真数据
           │              └── prependContext 注入 system prompt
           │              → LLM 看到 trusted 数据，必须按它回复（harness L4）
           │
           └──[派活模式]── cc-media-task → claude -p stream-json
                          ├── 媒体 → vision/whisper/ffmpeg → 文字
                          ├── 合并 prompt
                          ├── claude -p --output-format stream-json
                          └── cc-stream-relay 解析 → 批量推事件
                                  │
                                  ▼
              ┌──────────────────────────────────┐
              │  mcp-server/server.py :18790     │
              │  ├── HTTP API + SSE              │
              │  ├── SQLite tasks.db (WAL)       │
              │  ├── /lanhuo dashboard (单页)    │
              │  └── MCP stdio (cc_session_*)    │
              └──────────────────────────────────┘
                          │
                          ▼
              keepermac.huo15.com/lanhuo (frpc 反代)

# 1. 前置依赖（一次性）
brew install ffmpeg jq python3                       # macOS
npm install -g @anthropic-ai/claude-code
pipx install openai-whisper                          # 可选，处理语音/视频

# 2. clone 仓库到稳定路径
git clone https://cnb.cool/huo15/ai/openclaw-media-bridge \
  ~/workspace/projects/openclaw/openclaw-media-bridge
cd ~/workspace/projects/openclaw/openclaw-media-bridge

# 3. 一键安装（幂等可重跑）
bash setup.sh

# 4. 重启 OpenClaw / Claude 让它们读到新 skill / MCP
#    OpenClaw menubar app → Restart Gateway
#    Claude Desktop App   → Quit & Reopen
#    Claude Code CLI      → 退出当前会话再开新的

bash update.sh    # = git pull + 同步 SKILL + 重启 server + 刷 summarizer plist + 重启 OpenClaw gateway

bash uninstall.sh   # 撤销所有装机改动；不删 repo，不删任务 DB

admin 跟贾维斯说: "给小明开账号 alice / abc123，让他看 CLAUDE媒桥初探"
贾维斯：
  1. cc_user_create("alice","abc123","user") → 已建
  2. cc_user_grant_session("alice","CLAUDE媒桥初探")
     → 模糊匹配到 e4f03da6...
  3. cc_user_login_link("alice","abc123")
     → 返 markdown 链接
  4. 回 IM: "✅ 已建 alice 账号。登录: [蓝火 dashboard · alice](https://keepermac.huo15.com/lanhuo?u=alice&upwd=abc123)"

# 任务
POST   /tasks                              创建（含 owner_id）
GET    /tasks?status=&platform=&owner_id=
GET    /tasks/:id
POST   /tasks/:id/{status,cancel,result}
DELETE /tasks/:id
GET    /search?q=&owner_id=

# 事件
POST   /tasks/:id/events                   单条
POST   /tasks/:id/events/batch             批量（推荐，relay 用）
GET    /tasks/:id/events?since=N&wait=8    长轮询
GET    /tasks/:id/stream                   SSE
DELETE /tasks/:id/events

# CC 原生 sessions
GET    /cc-sessions?limit=&q=              v2.18.0 含 summary 字段
GET    /cc-sessions/:id
GET    /cc-sessions/:id/export?format=md
GET    /search-content?q=                  FTS5 全文

# 多用户
POST   /users / GET /users / DELETE /users/:name
POST   /me/password                        自助改密

# Admin
POST   /admin/gc                           手工触发 watchdog
GET    /announcement                       公开公告（无 auth）
GET    /version                            诊断（含 schema_version）

openclaw-media-bridge/
├── setup.sh                         # 一键装机（双 LaunchAgent + MCP 注册 + skill 部署）
├── update.sh                        # git pull + 重启 + 同步
├── uninstall.sh                     # 反向卸载
├── skill/
│   ├── SKILL.md                     # OpenClaw 技能（含 harness L1/L5 命令式约束）
│   └── install-to-workspaces.sh     # 自动扫所有 workspace*/
├── mcp-server/
│   └── server.py                    # HTTP + SSE + MCP + dashboard + watchdog（~5400 行）
├── bin/
│   ├── cc-media-task                # 派活入口
│   ├── cc-stream-relay              # stream-json 解析 + 批量推事件
│   ├── cc-summarize-sessions        # v2.18.0 AI 摘要器
│   ├── cc-app-control               # macOS Claude Desktop UI 控
│   └── cc-auto-auth                 # 自动点授权弹窗
├── scripts/
│   ├── defaults.json                            # 默认 config 模板
│   └── com.cc-media-bridge.summarizer.plist.template  # v2.18.0
├── CLAUDE.md                        # 仓内开发指引（架构 + 事件 schema + 版本史）
└── README.md                        # 本文件