dsh-about
DeepSeek Harness 设置中心「关于」分区插件 —— 检查更新 + 一键更新。
DeepSeek Harness 设置中心“About” tab: DeepSeek logo, version info, check for updates (npm latest/next), one-click update with auto-restart, and GitHub releases history.
dsh-about 设置中心「关于」分区
功能特性
- 版本信息：当前 dsh 版本（npm 包
@deepseek-ai/dsh）、Web 前端版本、Node / 平台、项目主页。
- 检查更新：对比当前版本与 npm
latest / next **及全部其余 dist-tag（含 alpha 开发者预览版、beta 测试版）**中较新者，提示发现新版本。
- 预发布分级：新版本按 semver 预发布标识符自动归类为 开发者预览版（alpha，红色高风险角标） / Beta 测试版（橙色角标） / 预览版（rc） / 稳定版；检测到 alpha/beta 时在状态行与安装弹窗显示对应风险警告。
- 插件兼容性提醒：任何版本更新（含稳定版）都会提示「版本更新后可能与某些插件不兼容，建议先关闭并退出所有插件再安装」。
- 附带 GitHub 同步检测（每次点「检查更新」都实时拉取 GitHub）：当 GitHub Releases 已发布但 npm 尚未同步时（如
v0.1.2-alpha.1 这类预发布），状态行会明确提示「GitHub 已发布 vX（npm 尚未发布，发布后即可一键更新）」；若该版本已存在 npm 但未打 latest/next 标签，则提示可手动安装。npm 发布并打上 latest/next 标签后，提示与角标自动消失；GitHub 发布新版本后，提示中的版本号自动跟随最新发布。
- 角标随列表常驻：版本更新记录每次返回（打开页面 / 每日自动拉取 / 点「刷新」）都会当场对比一次 npm 注册表，「npm 未发布（或未标记 latest/next）」角标随列表数据一起下发——不依赖先点「检查更新」，刷新或重进设置页后标签依然存在；npm 一发布并打标签，对应角标自动消失。
- 更新源选择：检查更新与一键更新所用的 npm registry 可选 国外官方（registry.npmjs.org，默认）/ 国内镜像（registry.npmmirror.com，国内访问更快，同步存在轻微延迟）/ 本地配置（跟随
npm config get registry）；UI 为紧凑下拉菜单（设置 → 关于 → 更新源），切换即时生效并持久化到 $DSH_HOME/dsh-about/source.json（随插件卸载清理），所有 npm 请求（dist-tags / packument / 安装）统一走选中源，保证「查到哪个源就在哪个源安装」一致。
- 延迟检测：下拉列表中每个源右侧显示「未检测」，点击即测该源连通性并显示实测毫秒延迟；只标记被点击的那个源为「检测中…」，其余源不受影响；连不上标红「不可达」，可随时点重新检测。检测在宿主侧发起（走 dsh 所在机器的网络，与安装路径一致）。
- 开合动画：下拉展开时淡入并轻微上滑展开，收起时平滑折叠（响应系统「减弱动态效果」偏好时自动关闭动画）。
- 版本选择：列出 npm 上比当前新的版本（最多 10 个），并合并 GitHub 已发布但 npm 未同步的版本（如
0.1.2-alpha.1，标注「npm 未发布」，无法一键安装），弹窗选择安装。
- 一键更新：
npm install -g @deepseek-ai/dsh@<目标版本>（走当前选中的 npm 源），成功后自动重启 dsh web（委托外部一次性看护 dsh-watchdog once：包内内置、随装随卸，Windows / macOS / Linux 三平台可用；等宿主退出 → 数 3 秒 → 优先 systemd 拉起 dsh-web、退回原命令裸拉起（带 --no-open），端口就绪后自动退出、零常驻；决策日志 $DSH_HOME/dsh-watchdog.log）。
- 跨平台看护：
bin/dsh-watchdog.mjs（纯 Node）是三平台首选——node 是 dsh 运行时必有依赖，零新增依赖，Windows / macOS / Linux 同一套；bin/dsh-watchdog（bash）保留给 Linux「常驻主循环 + systemd 用户服务」高级场景，并在极少数无 node 环境兜底。
- Linux + systemd-run：看护进程放进独立 transient 单元（独立 cgroup）——实测宿主退出时
systemd 会清空 dsh-web 服务 cgroup 内的一切子进程，普通 detached 派生必死；
transient 单元不受影响，更新后白屏无人拉起的根因即此。
- macOS / Windows：无 systemd，宿主 detached 派生 Node 看护即可；Windows 下
npm 安装走
npm.cmd（shell 解析）、进程树终止走 taskkill /T /F，均已适配。
- 版本更新记录：官方 GitHub Releases 最新 10 条，中文正文渲染，每条描述默认收起，点击头部箭头展开/收起；每日首次打开自动拉取一次并保存到本地电脑（
$DSH_HOME/dsh-about/releases-cache.json），失败不会反复重试；点「刷新」可手动强刷。
安全性设计要点
- 宿主路由
/dsh-about/* 仅允许回环地址访问（DNS 重绑定防护），跨站 GET 用 Sec-Fetch-Site 拦下，跨站 POST 用 Origin 白名单 + application/json 预检双重防护（CSRF）。
/update 是破坏性端点：并发互斥（同一时刻只允许一个安装任务）、目标版本号必须已存在于 npm 注册表且比当前新。npm install -g 带 5 分钟超时与进程组终止，安装输出尾部回显到弹窗便于排查。- 只有加载了本插件的 dsh 进程才获得这些能力；不修改任何核心文件，卸载即完全移除。
安装（官方 dsh 插件机制）
本包遵循 dsh 官方插件安装形式：dsh plugin --profile <name> add <包>（内部由
pnpm 安装 + cordis.patch.yml insert 层挂载 + dsh 客户端模块自动发现打包）。
支持三种来源：
# 1) 本仓库源码（开发调试）
git clone https://github.com/YannZhou/dsh-about.git
dsh plugin --profile web add /path/to/dsh-about
# 2) GitHub 直接安装（推荐，一条命令，随仓库更新可 re-add 升级）
dsh plugin --profile web add "git+https://github.com/YannZhou/dsh-about.git"
# 3) npm 安装（发布后可用，见下方「发布到 npm」）
dsh plugin --profile web add dsh-about
安装验证：
dsh --profile web --dump-config | grep dsh-about # 应看到 - id: dsh-about 层
然后重启 / 刷新 dsh web（默认 http://127.0.0.1:3080），打开 设置 → 关于 即可看到本分区。
插件自带的看护（bin/dsh-watchdog.mjs 跨平台 Node 版 + bin/dsh-watchdog Linux bash 版）
随包安装、随包卸载，无需任何手工放置。
验证
- 配置树中应出现
- id: dsh-about / name: dsh-about 层（bundle 自动应用）。
- 浏览器侧：设置 → 关于出现 DeepSeek 图标与版本行；点「检查更新」返回 npm 最新版本对比结果。
卸载（随时拔除，零残留）
# 1) 官方移除（组合层 + 包文件，一步完成）
dsh plugin --profile web remove dsh-about
- 组合层：
dsh.profile.bundles 清单移除本包、dependencies 移除依赖，包内
cordis.patch.yml（dsh.bundle.patch 层）随之消失；重启后「关于」分区、
/dsh-about/* 路由、客户端 bundle 全部消失。无需手动改任何配置文件。
- 包文件：profile node_modules 内的
dsh-about 实体（含内置看护
bin/dsh-watchdog.mjs / bin/dsh-watchdog、卸载脚本）随包删除。
- 进程：更新链路的一次性看护进程端口就绪后自动退出，不驻留。
运行期数据（$DSH_HOME/dsh-about 插件数据目录——版本记录缓存与更新源选择、$DSH_HOME/dsh-watchdog.log、
$DSH_HOME/dsh-about-restart.log、锁文件）由卸载钩子 scripts/postuninstall.js
自动删除；注意 pnpm 对 link:/本地路径/tarball 安装的包不执行该钩子，此时请补跑兜底脚本：
# 2) 运行期残留清理（仅当 1 未自动清理时）
bash scripts/uninstall.sh # 克隆目录内
# 或未克隆时：bash <(curl -fsSL https://raw.githubusercontent.com/YannZhou/dsh-about/v1.5.0/scripts/uninstall.sh)
唯一可选手动项：如果你曾执行过 cp bin/dsh-watchdog ~/.local/bin/（为独立使用
check/once 命令），按需自行删除；插件本身不需要它。
发布到 npm（可选）
# 包结构已符合从 npm 直接安装的官方形态（main/exports/dsh./files/bin/scripts 齐备）
npm publish --access public
架构简介
双半体插件，两个文件，零构建：
| 文件 | 半体 | 职责 |
|---|
lib/index.js | 宿主（Cordis loader 行） | 注册 /dsh-about/{source,ping,describe,releases,check,versions,update} 同源 HTTP 路由；更新源选择与持久化（$DSH_HOME/dsh-about/source.json）与延迟检测；npm dist-tag / packument / GitHub Releases 拉取；npm install -g 执行与自动重启看护 |
lib/client.js | 浏览器（window.__ModuleLoader__ 模块） | 注册 settings.section（id: about，导航「关于」）组件：图标、版本行、更新源选择（下拉菜单，点各源「未检测」即测延迟）、检查更新/一键更新弹窗、版本更新记录（数据由宿主落盘，浏览器不再用 localStorage） |
- 宿主行由
cordis.patch.yml（dsh.bundle.patch）挂载；浏览器半体由包内 dsh.client 清单 + exports["./client"] 自动发现打包（@deepseek-ai/dsh-client-modules 机制）。
- 零运行时依赖：semver 已内嵌（
lib/semver.js，语义与 node-semver 对齐并通过全量对拍）。dsh plugin add <目录> 走 link: 协议时不携带外部依赖，因此 clone 即可装、即装即用。
兼容性
- dsh CLI ≥ 0.x（支持
dsh plugin --profile <name> add/remove 与 cordis.patch.yml insert 层）。
License
MIT © YannZhou
