- Главная
- Плагины
- Модели и провайдеры
- capy-connect
capy-connect
helloloveworld/capy-connect
Brings Capy models into DSH as a tool-capable provider: a local OpenAI-compatible gateway plus a device tunnel, so tool calls run inside DSH under its own permissions.
Установка
dsh plugin --profile web add github:helloloveworld/capy-connectREADME
capy-connect
把 Capy 的模型接入 DeepSeek Harness,当作本地模型使用。
模型推理在 Capy 云端,工具由 DSH 执行——所以在 DSH 里能用读写文件、跑命令、搜索等全部能力,效果等同于一个自带执行环境的模型提供商。
特性
- OpenAI 兼容:注册成标准 provider,DSH 的模型选择器里直接出现
- 工具由 DSH 执行:不是套壳聊天,工具调用走 DSH 自己的权限与沙箱
- 每对话独立线程:新对话自动建对应的 Capy 线程,历史不串
- 零第三方依赖:只用 Node 内置模块
- 默认不启动:装上不会自动起服务,需手动开启
- 本地网关 + 设备隧道:全部流量走
127.0.0.1,设备连接用 WSS
安装
dsh plugin --profile web add github:helloloveworld/capy-connect
然后重启 DSH 引擎。
配置
1. 准备 Capy 凭据
在 Capy Settings → API 创建 API Key,并记下项目 ID。
2. 填配置
创建 $DSH_HOME/capy-connect/config.json:
{
"apiKey": "capy_xxxxxxxx",
"projectId": "project_xxxxxxxx",
"workspaceRoot": "~/capy-ws"
}
3. 配对设备
打开 App 面板「Capy 连接」→ 点「重新配对设备」→ 按提示在浏览器打开授权链接。
配对成功后设备凭据自动写入,无需手动干预。
4. 开启连接
点面板上的「开启连接」,或:
echo on > $DSH_HOME/capy-connect/.conn
5. 开始使用
DSH 模型选择器里选 Capy Particle 1 即可。
配置项
| 字段 | 必填 | 说明 |
|---|---|---|
apiKey | 是 | Capy API Key |
projectId | 是 | Capy 项目 ID |
workspaceRoot | 否 | 工作区路径,默认 ~/capy-ws |
deviceId | 否 | 配对后自动写入 |
threadId | 否 | 指定固定线程,不填则按对话自动分配 |
proxyKey | 否 | 网关本地访问密钥,首次启动自动生成 |
port | 否 | 网关端口,默认 3000 |
数据位置
运行时数据存放在 $DSH_HOME/capy-connect/,不在插件目录内:
$DSH_HOME/capy-connect/
├── config.json # 配置(含 API Key,权限 600)
├── device.json # 设备凭据(配对后生成,权限 600)
├── threads.json # 对话→线程映射(持久化)
├── .conn # 连接开关(on/off)
├── *.pid / *.lock # 进程管理
└── *.log # JSON 行日志
插件目录可安全地备份、更新或分发,不会带上凭据。
安全
设备守护会响应 Capy 云端下发的执行请求,因此有三层护栏:
路径限制 — 所有文件操作必须落在 workspaceRoot 内;~/.ssh、~/.gnupg、~/.aws、DSH 凭据文件等敏感路径无条件拒绝。
命令 denylist — 拦截破坏性操作(rm -rf /、mkfs、dd of=/dev/sd*)、远程执行(curl | sh)、系统操作(shutdown、crontab -r)、凭据窃取(写 authorized_keys)。
环境最小化 — 子进程只继承 PATH/HOME/LANG 等白名单变量,宿主平台注入的密钥不会传给子进程。
denylist 是纵深防御的一层,不是安全边界。真正的边界是路径限制和保管好你的 Capy 账号。
架构
DSH App
│ 带 tools 的 chat/completions
▼
gateway (127.0.0.1:3000)
│ 写入 Capy 线程,要求 agent 只输出执行计划
▼
Capy 云端 agent
│ <CMD>命令</CMD> 或 <DONE>结论</DONE>
▼
gateway 转成标准 tool_calls
│
▼
DSH 执行工具 ──结果喂回──▶ 循环直到完成
设备隧道(daemon)负责让 Capy 云端能触达本机,与上面的工具循环配合工作。
日志与排障
日志为 JSON 行格式,5MB 自动滚动:
# 只看错误
grep '"level":"error"' $DSH_HOME/capy-connect/gateway.log
# 护栏拦截记录
grep -i guard $DSH_HOME/capy-connect/daemon.log
# 设备连接状态
tail -5 $DSH_HOME/capy-connect/daemon.log
凭据过期
Capy 的公开 API 不提供 device token 刷新端点。凭据过期时:
- daemon 握手失败后写入
.token-invalid标记 - 面板显示「设备凭据已失效」
- 点「重新配对设备」重新授权即可
要求
- Node.js 18+
- 无需第三方依赖
- 直连 Capy(不需要代理)
开发
npm test # 单元测试
node --test test/*.test.mjs
CI 在 push/PR 时用 Node 20、22 跑语法检查和测试。
许可
MIT
Похожие плагины
dsh-our-free-model
ebony-vinyl/dsh-our-free-model
dsh-routing-suite
yjh051108/dsh-routing-suite
dsh-connect-workbuddy
dingminhua/dsh-connect-workbuddy
dsh-workbuddy-connect
corrinehu/dsh-workbuddy-connect