Files

3.2 KiB
Raw Permalink Blame History

dsh-watch

DeepSeek Harness 插件:把当前 Harness 变成一个可被 DSHWatch 手机 / 手表 远程控制的端点。 插件负责把 Harness 的会话/状态/事件串给 DSHWatch 客户端;客户端用 WebView 串 Harness 网页壳,数据由本插件填入。


✅ 一条命令安装(给 AI / 他人)

你只需把本仓库链接给 AI(或用户),让它执行下面任意一种即可装好。

方式 A:克隆仓库后装打包好的插件(推荐)

git clone https://gitea.truestudio.cn/jiangchen/dsh-watch.git
cd dsh-watch
# 插件已打包在 dist/。用 DSH 的 dsh CLI 把它装到桌面 profile:
dsh plugin --profile desktop add "$(pwd)/dist/dsh-watch-0.1.0.tgz"
git clone https://gitea.truestudio.cn/jiangchen/dsh-watch.git
dsh plugin --profile desktop add link:$(pwd)/dsh-watch

方式 C:直接在仓库里跑安装脚本

git clone https://gitea.truestudio.cn/jiangchen/dsh-watch.git
cd dsh-watch
./scripts/install.sh          # macOS / Linux
scripts\install.bat           # Windows

对 AI 的明确指令(可直接粘贴给它)

克隆仓库 https://gitea.truestudio.cn/jiangchen/dsh-watch.git,
在仓库目录运行 npm install 或 npm pack 确保 dist/dsh-watch-0.1.0.tgz 是最新,
然后用 DSH 的 CLI:dsh plugin --profile desktop add <repo绝对路径>/dist/dsh-watch-0.1.0.tgz
安装完成后在 DSH 设置 -> 插件 中配置 dsh-watch(mode / serverUrl / userId / token / apiKey / host / port)。

配置

装好后,在 DSH 的 profile cordis.patch.yml 或 设置 -> 插件 里加:

- id: dsh-watch
  config:
    mode: direct      # direct | relay
    host: "0.0.0.0"   # direct 模式监听地址
    port: 18321       # direct 模式端口
    token: "你自己定的token"
    apiKey: ""        # 可选:DeepSeek API Key(harness.balance 直查余额)
    reconnectMs: 5000
    timeoutMs: 30000

1. 直连模式(direct)

插件在本机起一个 WebSocket 服务,手机/手表直接填主机/端口/token 连进来(可配合 FRP / 内网穿透)。

手机端填:ws://主机IP:18321 + 同一个 token。

2. 服务器中转模式(relay)

插件主动外连 DSHWatch_Server,手机端连同一台服务器,用同样的 userId/token。适合公网、无需给电脑开端口。

- id: dsh-watch
  config:
    mode: relay
    serverUrl: "wss://your-server:8787"
    userId: "someone"
    token: "shared-secret"

暴露方法(手机/手表端可调用)

透传 DSH apiProxy:

  • harness.status / harness.prompt / harness.cancel / harness.balance
  • session.list / session.history / session.create / session.prompt / session.cancel
  • goal.* subagent.* workspace.* host.*
  • skill.list agentPreset.* llm.* settings.* credentials.*

事件推送:session/event、session/projection、status。


开发

npm install
npm pack          # 生成 dist/dsh-watch-0.1.0.tgz
node --check lib/index.js

依赖

  • node >= 18
  • ws(装在 DSH 宿主里即可)

关联仓库

  • 服务端:DSHWatch_Server
  • 手表端:DSHWatch
  • 手机端:DSHWatchPhone