onewilk/dsh-updater

dsh-updater

dsh-plugin

DeepSeek Harness 更新检查插件：定时检查新版本，在左上角 logo 右上角显示红色 NEW 角标提醒，并在设置中提供「关于」Tab。

English · 中文

功能特性

- 定时检查更新：服务端每 6 小时自动检查，客户端每 30 分钟轮询；版本号以 npm registry 为主源（dist-tags.latest），changelog 通过第三方镜像获取。
- logo NEW 角标：检测到新版本时，在左上角 DeepSeek Harness logo 右上角显示红色 NEW 角标，点击直接打开设置窗口并定位到「关于」Tab。
- 一次性提醒：同一新版本只弹一次 toast 提醒，不重复打扰。
- 「关于」设置 Tab：展示 logo、当前版本 / 最新版本、最近检查时间、手动检查入口、仓库链接，以及新版本的 changelog。
- GitHub 加速开关：内置 ungh.cc 镜像（首选）与 gh-proxy 拼接（兜底），解决直连 api.github.com 被墙 / rate limit（403）导致 changelog 拿不到的问题；开关持久化，默认开启。
- 升级指引：有新版本时在「关于」Tab 显示升级命令（npx @deepseek-ai/dsh@latest web）并提供一键复制。

数据源与网络

| 数据源 | 用途 | 说明 |
|--------|------|------|
| registry.npmjs.org | 最新版本号（主源） | 直连可达，作为 updateAvailable 的判定依据 |
| ungh.cc | changelog（首选镜像） | unjs 维护的 GitHub 数据镜像，直连可达、自带缓存、不受 GitHub API rate limit 限制 |
| gh-proxy.com | changelog（加速兜底） | ghproxy 类拼接，受 GitHub rate limit 影响，仅作后备 |
| api.github.com | changelog（直连兜底） | 多数网络下被墙或 rate limit，最后才尝试 |

每个请求带 8 秒超时，npm 与 GitHub 并行请求，保证「检查更新」总能在有限时间内返回（不会一直「检查中」）。changelog 获取失败不影响版本号检查，会在「关于」Tab 明确提示失败原因。

安装

方式一：让 AI Agent 自动安装（推荐）

把下面这段提示词发给任意 AI 编程助手（Claude Code / Cursor / Copilot / Codex 等），它会自动完成安装与生效：

请帮我在当前环境安装 DeepSeek Harness 更新检查插件 dsh-updater，并完成应用。按以下步骤操作：

1. 运行安装命令（二选一，npm 优先）：
- npm：dsh plugin --profile web add dsh-updater
- GitHub：dsh plugin --profile web add github:onewilk/dsh-updater
2. 重启 DeepSeek Harness Web 界面使其生效：
npx @deepseek-ai/dsh@latest web
3. 验证：打开浏览器访问 harness 页面，进入 设置 → 关于，应能看到当前版本、最新版本与「检查更新」入口，即安装成功。

注意事项：
- 本插件为纯 JavaScript，无需构建，dsh plugin add 安装后即可用。
- 安装后必须重启 harness 才能生效。
- 若 GitHub 直连受限，请改用 npm 安装方式。

方式二：手动命令安装

从 npm 安装（推荐）
dsh plugin --profile web add dsh-updater

或从 GitHub 安装
dsh plugin --profile web add github:onewilk/dsh-updater

安装后，插件的 dsh.bundle 声明会让它自动加入 profile 的 bundles 层（host 半自动加载），dsh.client 声明让客户端半自动注入。

手动安装（开发 / 本地）

1. 链接到 web profile 的 node_modules
ln -sfn "$PWD" "$DSH_HOME/profiles/web/node_modules/dsh-updater"

2. 在 $DSH_HOME/profiles/web/cordis.patch.yml 中插入 host 插件
若使用 bundle 方式（dsh plugin add）则此步可省略
- insert:
- id: dsh-updater
name: 'dsh-updater'

安装或改动后需重启 harness（重新运行 npx @deepseek-ai/dsh@latest web）生效。

配置

「关于」Tab 内提供 「GitHub 加速」开关：

- 开启（默认）：GitHub changelog 走 ungh.cc 镜像 → gh-proxy 拼接 → 直连 顺序兜底；
- 关闭：仅直连 api.github.com。

开关持久化到 $DSH_HOME/profiles/web/dsh-updater.json（{ "proxy": true|false }），客户端同步到 localStorage，重启后保留。

插件标识（便于 DSH 收录）

package.json 通过 dsh 字段声明自身为 DSH 插件：

"dsh": {
"bundle": { "patch": "./cordis.patch.yml" },
"client": {
"inject": ["@deepseek-ai/dsh-client-runtime"],
"platform": "web"
}
}

本仓库已在 GitHub 添加官方推荐的 dsh-plugin topic，用于插件被发现 / 收录。
- dsh.bundle.patch：host 半（lib/index.js，注册 /plugins/dsh-updater/* 路由）通过 cordis.patch.yml 的 insert 自动加载，dsh plugin add 安装后自动加入 bundles 层。
- dsh.client：client 半（lib/client.js，关于 Tab / NEW 角标 / toast）由 DSH 客户端模块系统按 platform 与 inject 自动发现并注入。

目录结构

.
├── lib/
│   ├── index.js    # host 半：路由、定时检查、版本对比、多源兜底
│   └── client.js   # client 半：关于 Tab、NEW 角标、toast、加速开关
├── cordis.patch.yml  # bundle patch：加载 host 插件
└── package.json      # dsh.bundle + dsh.client 插件标识

开发

node --check lib/index.js   # 语法检查 host 半
node --check lib/client.js  # 语法检查 client 半

License

MIT

English

一个 DeepSeek Harness 插件，会定期检查新版本，在左上角 logo 上显示红色 NEW 角标，并在设置中添加一个“关于”Tab，包含版本信息、手动检查、GitHub 加速开关以及升级说明。

- Host 半（lib/index.js）：注册 /plugins/dsh-updater/status|check|config 路由，运行定时检查（以 npm registry 作为版本来源，ungh.cc 镜像 / gh-proxy 作为 changelog 兜底），并持久化加速开关。
- Client 半（lib/client.js）：“关于”设置 Tab、固定的 NEW logo 角标（点击 → 打开设置 → 关于）以及一次性 toast。

安装：

dsh plugin --profile web add dsh-updater
or
dsh plugin --profile web add github:onewilk/dsh-updater

然后重启 harness。