dsh-updater
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 明确提示失败原因。
安装
通过 dsh plugin（推荐）
# 从 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
A DeepSeek Harness plugin that periodically checks for new releases, shows a red NEW badge on the top-left logo, and adds an "About" tab in Settings with version info, manual check, a GitHub acceleration toggle, and upgrade instructions.
- Host half (
lib/index.js): registers /plugins/dsh-updater/status|check|config routes, runs the scheduled check (npm registry as the version source, ungh.cc mirror / gh-proxy as changelog fallbacks), and persists the acceleration toggle.
- Client half (
lib/client.js): the "About" settings tab, the fixed NEW logo badge (click → open Settings → About), and the one-shot toast.
Install:
dsh plugin --profile web add dsh-updater
# or
dsh plugin --profile web add github:onewilk/dsh-updater
Then restart the harness.
