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"

方式 B：本地 link 开发模式

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