Workbuddy Acp Bridge — Productivity skill for Claude Code

WorkBuddy ACP Bridge

**让其他 agent（Claude、Codex、Hermes、OpenClaw 等）直接给 WorkBuddy 桌面客户端里 已经打开的会话发消息，消息在 PC 客户端界面实时显示，并把 WorkBuddy 的回复拿回来。**

为什么需要它

多 agent 协作里最常见的痛点：你在 Claude / Codex / Hermes / OpenClaw 那边跑分析、 跑回测、跑工程任务，但真正有完整代码上下文、有工具权限、有项目历史的是 WorkBuddy（CodeBuddy Code）里那个已经打开的会话。如果让外部 agent 新开一个会话， 上下文是空的，什么都要重讲一遍。

这个桥接解决的就是这一步：**把外部 agent 的结论/指令，投递到用户桌面上那个 “懂行”的 WorkBuddy 会话里**，用户在自己的 PC 客户端里就能实时看到消息和回复， 不用切换窗口、不用复制粘贴。

外部 agent（Claude / Codex / Hermes / OpenClaw / 任何能跑 Python 的进程）
   │  acp_live_send.py  -- 本地 127.0.0.1，无需任何密码或令牌
   ▼
WorkBuddy PC 客户端的 interactive session（客户端自己 daemon 激活的）
   │  daemon → 主进程 wb:event → 渲染进程
   ▼
PC 客户端对话界面实时显示消息 + WorkBuddy agent 的回复

**安全模型**：全部流量都在 `127.0.0.1` 上。WorkBuddy 的 ACP 主通道对 loopback 做了豁免，`POST /api/v1/acp/connect` 直接下发一次性的 `connectionId` + `sessionToken`， 不需要任何长期密钥、不需要登录、不需要配置。本工具也不读写任何凭证文件。

文件

文件	说明
acp_live_send.py	核心工具。自动发现活跃会话端点 → 免密 connect → load → prompt。Python 标准库，零依赖。
acp_live_test.py	最小冒烟测试（手动传端口），用来单独验证 ACP 四步调用链。
README.md	本文档。

用法

只需要 Python 3（标准库即可，无第三方依赖）。

1. 列出当前活跃的会话

python acp_live_send.py --list

pid=39092  port=13416  session=  cwd=C:\path\to\project

**前提**：目标对话必须在 PC 客户端里**打开/聚焦过**，客户端的 daemon 才会为它 激活 interactive session；空闲一段时间后 session 会被回收（端口随之消失）， 此时发消息会报 “no live interactive session”。**加 `--ensure` 可以自动重新 激活**（见 2b），或者在客户端里点一下那个对话。

2. 发消息（用 sessionId 精确指定，推荐）

python acp_live_send.py --session-id  --msg "回测跑完了，把结果汇总到报告里"

也可以按项目路径自动匹配会话（不用记 UUID）：

python acp_live_send.py --cwd "C:\path\to\project" --msg "..."

2b. 会话没活端点？自动激活（`--ensure`）

会话空闲一段时间后会被客户端回收回预热池，此时直接发会报 “no live interactive session”。**不用手动去客户端点那个对话**， 加 `--ensure` 就行——工具会打开 `workbuddy://chat/` 协议链接， 客户端接到后自动把该对话重新激活成一个活会话：

python acp_live_send.py --session-id  --msg "..." --ensure

前提是 PC 客户端正在运行，且系统已注册 `workbuddy://` 协议（安装客户端时 自动注册）。`--ensure` 需要 `--s