DeepSeek Harness 安装/更新插件介绍

前言¶

DeepSeek Harness（DSH）的插件树只在启动时合成，profile 里的插件由 dsh plugin 管理。这个插件补上的是 Harness 自身的运维闭环：不必再开终端敲 npm install --prefix ...，也不必切到 DeepSeekDesk 的原生设置页——在 Web 设置面板里就能看版本、查更新、装新版、重启生效。

核心功能¶

插件在 Web「设置」中增加了一个「安装 / 更新」页面，提供以下能力：

状态一目了然：显示当前运行版本、安装目录、Node / npm 版本、监听端口及进程 PID。
检查更新：读取 npm registry 的 dist-tags，不依赖本机 npm，离线也能对比本地版本。
在线安装 / 更新：实时日志流式回显，按钮上会直接写明目标版本（如 在线更新到 v0.1.6-alpha.1）。
高级选项：支持选择更新通道（latest / next / alpha / 指定版本）、修改安装目录、更换 registry、指定 npm 路径，并支持保存为默认。
重启 Harness：等待旧进程退出后，使用相同参数拉起新实例。
查看 harness.log：显示文件尾部 96KB 内容，其中的 token 和 _authToken 已脱敏。

安装与启用¶

安装插件需要使用 -w（--workspace-root）参数，且安装或卸载后必须重启 Harness 才能生效。

dsh plugin --profile web add -w github:udisyue/dsh-update

安装完成后，打开 Web 界面的「设置」即可看到「安装/更新」页面。

使用步骤¶

打开 设置 → 安装/更新，按以下顺序操作：

查看状态卡：确认当前运行版本、安装目录及探测来源。
检查更新：点击按钮，插件会查询 registry 上的最高版本及来源通道。
在线安装 / 更新：点击主按钮执行安装，过程中实时显示日志，结束后自动刷新状态。
设置高级选项：在「高级选项」中调整 channel、指定版本或修改默认配置，可保存为默认值。
重启 Harness：点击重启按钮，确认后等待旧进程退出并启动新实例。
查看日志：如需排查问题，可查看 harness.log 尾部日志。

配置¶

插件支持通过 cordis.yml 配置项覆盖默认行为。在 profile 目录下的 cordis.patch.yml 中添加配置：

- id: dsh-harness-updater
  name: dsh-harness-updater
  config:
    installDir: '/path/to/harness'      # 默认自动探测
    registry: 'https://registry.npmjs.org'
    npmPath: '/usr/bin/npm'             # 默认自动探测
    channel: 'latest'                   # 默认 latest
    restartEnabled: true                # 默认 true

设置页修改的值会持久化保存到 $DSH_HOME/harness-updater/state.json（默认 ~/.dsh/harness-updater/state.json，权限 0600）。

安全与行为细节¶

鉴权机制：每个路由都经过 connection.requestRejection 鉴权，防止 DoS 攻击和未授权访问。
数据脱敏：日志返回和任务日志中的 token、_authToken 已自动脱敏。
无数据出网：不触碰模型，不注册 system-prompt，不进行遥测，仅请求 registry 查询版本。
Token 复用：重启 Harness 后不需要重新获取 token，刷新浏览器页面即可保持登录状态。
默认安装目标：默认安装到 registry 所有 dist-tag 中的最高版本，界面会明确标注来源通道。

生态与链接¶

目录页：https://www.skillhub.cn/plugins/udisyue/dsh-update
GitHub 仓库：https://github.com/udisyue/dsh-update
许可证：MIT