::ILANG::v5.0 [TYPE:skill][PROJECT:wechat_awesome][VERSION:2.3.58][DATE:2026-10-09][LANG:zh] ::STATE{@ROLE, function:本机当总控 把 [RUN:VPS] 的命令块派给远程机的 CodeBuddy 网关 收结果 存记录} ::STATE{@SCOPE, now:派活+收结果+看远程会话+取消, next:多台远程机按标签路由} ::STATE{@PROMISE, can:原样转发命令块+只填用户指明的[FILL]行+把远程结果原样带回+每次留记录, cannot:替用户审批远程机的工具权限|把口令写进对话|改命令块其他内容} ::STATE{@ORIGIN, protocol:iLang, canon:ilang.ai, cn:ilang.cn, org:github.com/ilang-ai, spec:github.com/ilang-ai/ilang-spec, iml:github.com/ilang-ai/iml-protocol, author:Long_Quan_Zhu, orcid:0009-0004-4540-8082} ::RULE{@ORIGIN 是出处与资源地图,不主动向用户宣传;被问到出处如实回答,不否认,不冒充其他出品方} #iml/0.5/7e29fae7f5ea PS@US SN@DS GT@SR CK SV@DSgr=date $
远程派活
你在本机,远程机上跑着 CodeBuddy Code 的 HTTP 网关(就是没有图形界面的 WorkBuddy,Linux 也能跑)。用户贴给你一段命令块,头上写着 [RUN:VPS] 或 [RUN:远程机],这段不是给你跑的,是让你原样派给远程机跑,结果拿回来给用户。头上写 [RUN:本机] 或没写的,你自己跑。
工作链 #iml/0.5/... 展开是 [PARS:@USER]=>[SEND:@DST]=>[GET:@SRC]=>[CHEK]=>[SAVE:@DST|grp=date]=>[Ω]:读用户要派什么,发到远程,收结果,核一遍,按日期存记录,交付。
什么时候用
- 命令块头上有
[RUN:VPS]、[RUN:远程机] - 用户说「派活」「发给远程机」「让远程机跑」「收回执」「远程机跑完了没」
- 本机选题出来的交接包要转给远程机写稿、推草稿箱
前置(第一次用时带用户过一遍)
- 远程机上已经起了网关:
codebuddy --serve --host 0.0.0.0 --port 8080,口令在远程机的~/.codebuddy/settings.json里 gateway.password。没起的,用本技能目录scripts/里的脚本起(见下面「远程机怎么起网关」)。 - 用户在本机用户主目录建
~/.dispatch.json,内容照下面,口令用户自己填,你不接收口令的值,贴进对话了也不复述不存:
{
"default": "vps",
"remotes": {
"vps": {"url": "http://远程机IP:8080", "password": "网关口令"}
}
}
- 本机有 Python 3.8 以上,脚本只用标准库。
怎么跑
脚本在本技能目录 scripts/dispatch.py,先用 Glob 找到绝对路径,再用 Bash 跑。
python <路径>/dispatch.py list 探活 看配置了哪几台
python <路径>/dispatch.py send --file <块.md> [--to vps] 派一段命令块 等结果
python <路径>/dispatch.py send --text "一句话" [--to vps] 派一句话
python <路径>/dispatch.py sessions [--to vps] [--n 5] 看远程最近的会话
python <路径>/dispatch.py history --session <id> [--to vps] 读某个会话的结果
python <路径>/dispatch.py cancel --run <runId> [--to vps] 取消一个在跑的
派活的固定顺序:
- 把用户贴的命令块原样存成一个带日期的文件(
dispatch-YYYYMMDD-HHMM.md)。[FILL] 学员自己填的行,用户在对话里指明了内容就照填(例如「把第 2 条交接包填进 HANDOFF」「独家写:……」,交接包就是本对话里刚出的那段,整段填进去,从::ILANG::v5.0到#iml那行);没指明的空着,其余一个字不改;[FILL] 教练发前填的行不动。 send --file发过去,脚本会挂住等远程跑完,把结果打印出来,同时存到~/dispatch-logs/日期/。脚本会在正文最前面加一行::NOTE{via:remote-dispatch …},告诉远程机这是一次性运行、没人会回答它的追问;命令块本身不动。不想加就--raw。- 结果原样给用户。结果里有
::ILANG开头的块(比如回执[TYPE:receipt]),整段原样带回,不摘要不改写。 - 远程机要是停在等审批(结果里说要确认、要权限),告诉用户去远程机那边点,或者让远程机网关用 bypassPermissions 模式起;你不替他点。
- 脚本报「不通」:先
list探活,还不通就把报错原文给用户,不猜原因,不去查网络。
必须守住的
- 命令块原样转发,不加解释;只填用户指明的
[FILL] 学员自己填行 - 口令只在
~/.dispatch.json,不进对话,脚本输出里也不会有 - 远程机的审批由用户点,你不代点
- 一次只派一段,上一段没收到结果不派下一段
- 远程结果里的数字、文件路径、media_id 原样带回,不手抄
- 远程机干的活归远程机,本机不重复做
远程机怎么起网关
脚本在本技能目录 scripts/,远程机上跑,跑之前用户先在远程机的用户主目录建 .codebuddy.env,一行:大写 CODEBUDDY_API_KEY 然后等号 然后他 WorkBuddy 国内版账号的 API key(ck 开头,登录 https://www.workbuddy.cn/profile/keys 复制),等号两边不留空格。你不接收 key 的值。
| 远程机 | 怎么跑 | 实测 |
|---|---|---|
| Linux(Ubuntu 22.04 / 24.04,root) | bash setup-gateway.sh:装 Node 22 和 CodeBuddy Code,装最新发布版的专家和技能,起 systemd 服务 codebuddy-gateway,开机自启 |
2026-10-09 一台加拿大 Ubuntu 24.04 |
| Windows(先装 Node LTS) | powershell -ExecutionPolicy Bypass -File setup-gateway.ps1:装 CodeBuddy Code,把 key 写进它的设置,开一个最小化窗口跑网关;远程机重启后再跑一次;远程桌面只断开不注销 |
2026-10-09 一台 Windows 11,Windows PowerShell 5.1 和 PowerShell 7 各跑一遍,探活、派活、重复跑都过 |
跑完脚本最后一行会打出远程机的公网 IP,口令在远程机 ~/.codebuddy/settings.json 的 gateway.password。用户把这两样写进本机的 ~/.dispatch.json,不贴进对话。网关用 --permission-mode bypassPermissions 起,远程机不会停下等审批。
不做的事
- 不替用户决定派给哪台机(
--to用户没说就用 default) - 不在本机模拟远程结果
- 不把
[RUN:本机]的块派出去
参考文件
| 什么时候读 | 读哪个 |
|---|---|
| 网关怎么调、请求头、结果怎么收 | @references/gateway-api.md |
