Перейти к основному содержимому
H

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-connect

README

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 刷新端点。凭据过期时:

  1. daemon 握手失败后写入 .token-invalid 标记
  2. 面板显示「设备凭据已失效」
  3. 点「重新配对设备」重新授权即可

要求

  • Node.js 18+
  • 无需第三方依赖
  • 直连 Capy(不需要代理)

开发

npm test              # 单元测试
node --test test/*.test.mjs

CI 在 push/PR 时用 Node 20、22 跑语法检查和测试。

许可

MIT

Похожие плагины