xingyingyuzhui/dsh-updater-ui 预览 preview

xingyingyuzhui/dsh-updater-ui

Project Overview项目介绍

dsh-updater-ui is a native update checker plugin built exclusively for DeepSeek Harness (DSH). After installation, it adds a dedicated “DSH Update” page to DSH’s settings menu, and runs automatic background update checks every 30 minutes. If a new official version is detected, it shows a red dot notification on the navigation bar to alert the user. To install the plugin, you need a working DSH installation that can be run via dsh web or npx @deepseek-ai/dsh web, then run the install command from your terminal. After installation completes, you just need to restart DSH to activate the plugin.

When you open the “DSH Update” page after restarting DSH, it will automatically detect which installation method your running DSH process uses, whether that’s npx, a global npm install, or a cloned source code from the official repository. It displays the current version status, telling you clearly if you are already on the latest official release or if an update is available for download. If an update is available, you can trigger the full update process with just one click on the corresponding button. Once the update finishes installing, you only need to restart DSH one more time to load the new version.

This plugin is released under the permissive MIT open-source license, and it has no third-party dependencies at all, and it does not include any telemetry or user tracking of any kind. It includes multiple security checks to prevent accidental modification of non-official DSH installations, and will refuse to overwrite local DSH installations that have uncommitted changes or point to a non-official repository. If it fails to fetch version information from the default npm registry, it automatically falls back to the npmmirror mirror, and it supports custom npm registry configurations via environment variables.

这是一个专为 DeepSeek Harness(DSH)开发的原生更新检查插件,安装后会在 DSH 的设置页面新增「DSH 更新」入口,支持每30分钟自动后台检查更新,当有官方更新时会在导航栏显示红点提醒。它可以自动识别当前运行 DSH 进程的安装方式,包括 npx、全局 npm 安装以及从官方源码克隆安装三种,对应不同方式提供版本检查和一键更新功能。用户可通过 DSH 内置的 CLI 命令直接从 GitHub 安装本插件。

本插件面向所有使用官方 DSH 的用户,无论你通过哪种方式安装 DSH 都可以使用它管理更新。安装完成后只需重启 DSH,打开设置页的「DSH 更新」入口,即可看到当前 DSH 的安装方式和更新状态。如果检测到有可用更新,点击对应一键更新按钮即可完成更新,更新后重启 DSH 就能加载新版本代码。遇到更新锁死等常见异常,页面也会给出可直接复制执行的命令帮助用户手动完成更新。

本插件遵循 MIT 许可开源,没有第三方依赖,也不会收集用户遥测数据,完全免费使用。它有多重安全校验,对于非官方源码仓库、本地有未合并改动的情况会拒绝更新,避免误操作。npm 源查询失败时会自动切换到 npmmirror 镜像,支持自定义 npm registry,对不同平台和安装路径都做了适配,保证更新流程可靠。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:xingyingyuzhui/dsh-updater-ui

把 xingyingyuzhui/dsh-updater-ui 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-updater-ui · DSH 官方更新检查器

DeepSeek Harness(DSH)官方更新插件:在设置 → DSH 更新页一键检查并更新官方 DSH。自动后台检查 + 导航红点提醒。

它看的是当前正在跑的那个 DSH 进程怎么安装的,而不是磁盘上碰巧有没有一份源码:

当前进程 检查 一键更新
npx @deepseek-ai/dsh web npm registry 上的 @deepseek-ai/dsh 更新 npx 缓存里的官方包,然后重启
npm i -g @deepseek-ai/dsh / 全局 dsh web 同上 npm install -g @deepseek-ai/dsh@<官方版本>,然后重启
git clone 后 pnpm dsh web git fetch 对比官方远端 git pull --ff-only

Mac / Windows 同一套逻辑。本机另有一份 ~/deepseek-harness 但进程其实是 npx/全局 npm 时,不会去 git pull 那份源码。

功能

  • 识别安装方式:源码仓库 / npm 全局 / npx
  • 一键检查:源码 git fetch;npm 查询官方 registry(失败则试 npmmirror)
  • 版本对比:本地 vs 官方 package.json 版本号
  • 更新说明:源码可折叠列出官方新提交(短哈希 + 标题,前 15 条)
  • 一键更新:源码只允许快进;npm 只安装官方包名 @deepseek-ai/dsh 和已校验的版本号
  • 自动检查:Host 每 30 分钟后台检查(防重入),页面每 60 秒轮询缓存
  • 红点提醒:有官方更新时设置页导航显示「DSH 更新 ●」
  • 安全拒绝:源码本地存在未推送提交、分叉或冲突改动时拒绝覆盖;npm 安装失败时给出可复制命令

安装

前置:已安装 DSH(dsh web 或 npx @deepseek-ai/dsh web 可运行)。npm 通道需要能访问 npm registry;源码通道需要本机 git 和官方 clone。

# 从 GitHub 安装
dsh plugin --profile web add github:xingyingyuzhui/dsh-updater-ui

装完重启 DSH,然后打开 设置 → DSH 更新。

使用

打开 设置 → DSH 更新:

  • 页面显示当前安装方式和官方更新状态(✅ 已是最新 / ⚠️ 有官方更新)
  • 点击 一键更新官方 npm 包 或 一键拉取官方更新
  • 更新成功后重启 DSH 才会加载新代码
  • 若 npm 安装被运行中的进程锁住(常见于 Windows),页面会给出对应命令,停掉 DSH 后再跑

npx 用户也可直接:

npx --yes @deepseek-ai/dsh@latest web

源码仓库定位

仅当当前进程来自官方源码 clone时才会用 git。查找顺序:

  1. 正在运行的 @deepseek-ai/dsh-root 目录
  2. 配置 repo / 环境变量 DSH_REPO
  3. ~/deepseek-harness
  4. ~/.dsh/deepseek-harness

~/.dsh 是设置、插件和会话数据,不能 git pull 当官方源码。

插件会校验该目录:

  1. 必须是 git 仓库
  2. origin 必须是 deepseek-ai/deepseek-harness
  3. 必须能读取当前分支和上游分支

校验不通过会拒绝操作,避免误 pull 到 /opt/homebrew 等无关仓库。

npm 通道

  • 查询 https://registry.npmjs.org/@deepseek-ai/dsh/latest,失败则试 https://registry.npmmirror.com
  • 可用 DSH_NPM_REGISTRY 或 npm_config_registry 指定 registry
  • 全局安装按正在运行的包路径推导 --prefix(Homebrew node@24 的 Cellar 和 npm prefix -g 不是同一处)。装完会回读该路径的 package.json,版本没变则报失败,不假装成功
  • Windows 下用当前 node.exe 直接跑同目录的 node_modules/npm/bin/npm-cli.js,不 spawn npm.cmd。找不到 JS 入口时才退回 cmd.exe:整条命令外层再包一层引号,并用 windowsVerbatimArguments,避免 Node 把引号转成 \"
  • 不会对 ~/.dsh 做 npm install,也不会安装官方包以外的任何名字

安全设计

  • 路由仅接受 POST
  • 必须带自定义请求头 X-DSH-Updater: 1(跨站表单/图片无法触发)
  • 如果带 Origin,只允许 http://127.0.0.1 / http://localhost
  • 源码拉取使用 --ff-only
  • npm 安装包名写死为 @deepseek-ai/dsh,版本号须匹配安全字符集
  • 所有外部命令带超时与输出上限;错误一律返回结构化 JSON
  • 无第三方依赖、无遥测

卸载

dsh plugin --profile web remove dsh-updater-ui

开发

pnpm install   # 无依赖,仅占位
pnpm test      # 基础契约测试
# 本地验证:dsh plugin --profile web add link:/path/to/dsh-updater-ui

License

MIT

← 上一个 Prev dsh-page-preview 下一个 Next tmcra-memory →