VCP 桥接 Asaka-RUM/dsh-vcp-bridge

dsh-vcp-bridge

把 VCPToolBox 桥接为 DSH 原生工具的插件。

这是什么

面向「裸 DSH」场景：当你的 DSH 没有记忆系统、没有丰富工具生态、没有自主行为能力时，本插件把一台独立运行的 VCPToolBox 变成 DSH 的外挂器官——

DSH (agent) ──原生工具调用──▶ dsh-vcp-bridge ──HTTP/Bearer──▶ VCPToolBox :6005
├─ DailyNote 记忆(浪潮引擎) ├─ 300+ 插件(搜索/画图/B站/计算…)
└─ 定时任务(自主行为)

如果你已经在使用 DSH 的 viking / ACP / task 等 harness 层能力，本插件与它们功能重叠，没有必要安装。
VCP 与 DSH 是两套平行生态，本插件只服务「裸 DSH + 已有 VCP 部署」这一场景。

提供的工具

| 工具 | 作用 | VCP 端点 |
| …_tool_call | 执行任意 VCP 插件（万能透传）：BrowserSearch / FluxGen / DailyHot / SciCalculator… | POST /v1/human/tool |
| …_note_create | 写入长期记忆笔记（DailyNote，可被 VCP 记忆引擎检索） | POST /v1/human/tool |
| …_note_search | 关键词检索 VCP 记忆笔记 | POST /v1/human/tool |
| …_schedule_task | 定时任务——Agent 可以在无人值守的未来时点行动 | POST /v1/schedule_task |
| …_chat | 走 VCP 完整管线的一次性对话（记忆注入 + 语义选模） | POST /v1/chat/completions |
| …_status | 连通性检查 | GET /v1/models |

一键部署（推荐）

不想手动部署 VCPToolBox？仓库自带编排脚本，一条命令把整个 VCP 拉起来：

node scripts/deploy.mjs # Docker 优先;无 Docker 自动 clone+install+后台启动
node scripts/deploy.mjs --china # 国内网络:npmmirror / gh-proxy / 清华 pip 镜像
node scripts/deploy.mjs --set API_Key=sk-xx --set Key=myKey --set API_URL=https://... # 非交互写配置
node scripts/deploy.mjs --skip-chromium # 不下载 Chromium(放弃浏览器类插件,省 400MB)

脚本行为：
1. 有 Docker → 直接用官方镜像 lioensky/vcptoolbox:latest 起容器（deploy/docker-compose.yml，记忆/向量库/日志全部持久化卷）；
2. 无 Docker → 多镜像自动 clone VCPToolBox（gh-proxy 兜底）→ npm install（+可选 npmmirror）→ pip install → 后台 node server.js（日志 vcptoolbox/server.log）；
3. 必填项（API_Key / API_URL / Key）缺失或仍为占位符时会拒绝启动并提示补齐方式；
4. 轮询 /v1/models 直到服务存活，完成后打印 DSH 插件应填的配置值。

前提

1. 一台独立部署并运行的 VCPToolBox（本插件不负责部署它；Docker 或 node server.js 均可）；
2. VCP 的 config.env 里已配置上游 LLM（API_Key/API_URL）并记下 Key；
3. 一个支持第三方插件的 DSH 环境。

安装

标准方式（Profile Bundle）：

dsh plugin --profile <profile> add https://github.com/Asaka-RUM/dsh-vcp-bridge

或手动构建后复制本目录到 DSH 插件目录（旧版本兼容）：

git clone https://github.com/Asaka-RUM/dsh-vcp-bridge.git
cd dsh-vcp-bridge
npm run build # 需要 DSH_CHECKOUT 指向 dsh 源码检出;没有也可直接使用仓库内预构建的 lib/

仓库已包含预构建产物 lib/index.js——没有 DSH checkout 的环境可以跳过构建步骤直接装载。

配置

| 项 | 默认 | 说明 |
| baseUrl | http://127.0.0.1:6005 | VCPToolBox 地址 |
| key | 空 | VCP config.env 中的 Key（Bearer 鉴权） |
| timeoutMs | 300000 | 上游超时（VCP 插件可能很慢，官方默认 15 分钟） |
| defaultMaid | DSH | 日记默认署名 |
| defaultModel | 空 | chat 工具的默认模型（留空走 VCP 语义路由） |

协议实现说明

桥接依据 VCPToolBox @main 分支源码（2026-08 抓取）：

- 鉴权：Authorization: Bearer <Key>；
- 插件执行走 /v1/human/tool，请求体为纯文本 VCP 标记协议：

<<<[TOOL_REQUEST]>>>
tool_name:「始」DailyNote「末」, command:「始」create「末」, Content:「始」…「末」
<<<[END_TOOL_REQUEST]>>>

值里出现的 「始」/「末」 会被自动剥掉，防止逃逸；
- 定时任务走 /v1/schedule_task，task_id 以 dsh- 前缀生成。

许可

本桥接代码以 MIT 发布。
VCPToolBox / VCPChat 上游为 CC BY-NC-SA 4.0（署名-非商业-相同方式共享），部署与使用上游时请遵循其条款。本插件与 VCP 官方无隶属关系。

致谢

- lioensky/VCPToolBox — Variable & Command Protocol 运行时
- lioensky/VCPChat — 官方桌面前端