YannZhou/dsh-about

README 摘要

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 版本（npm 包 @deepseek-ai/dsh ）、Web 前端版本、Node / 平台、项目主页。 - 检查更新 ：对比当前版本与 npm latest / next 两个 dist-tag 中较新者，提示发现新版本。 - 版本选择 ：列出 npm 上所有比当前新的版本（最多 10 个），弹窗选择安装。 - 一键更新 ： npm install -g @deepseek-ai/dsh@ （固定官方 registry），成功后 自动重启 dsh web （委托外部一次性看护 bin/dsh-watchdog once ：包内内置、随装随卸；等宿主退出 → 数 3 秒 → 优先 systemd 拉起 dsh-web 、退回原命令裸拉起（带 --no-open ），端口就绪后 自动退出、零常驻 ；决策日志 $DSH HOME/dsh-watchdog.log ）。 - 看护进程经 systemd-run 放入独立 transient 单元（独立 cgroup）——实测宿主退出时 systemd 会清空 dsh-web 服务 cgroup 内的一切子进程，普通 detached 派生必死； transient 单元不受影响，更新后白屏无人拉起的根因即此。 - 版本更新记录 ：官方 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 进程才获得这些能力；不修改任何核心文件，卸载即完全移除。 …

分类