设置 → 插件里的「安装」标签页:按 npm spec、`github:user/repo` 或本地路径安装、更新、卸载任意插件,走的都是 `dsh plugin add` 这条 CLI 路径;更新检查对照 npm latest 或 GitHub HEAD,带降级保护与装后版本核对,每次 add/remove 均附带 pnpm 11 发布冷静期豁免;服务重启在 DSH Desktop 由壳层执行,独立 `dsh web` 下由中转进程接力并交接回原终端。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-plugin-install
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:qinyre/dsh-plugin-install
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
为 DeepSeek Harness 的插件页补上更新提示:列表绿点、详情页版本标签,以及一键更新按钮。
dsh 0.2.0 起已自带插件安装、卸载与启停管理,本插件专注于检查和更新,直接融入现有插件页。适用于 dsh web 及内嵌该 Web UI 的桌面端。
安装
dsh plugin --profile web add dsh-plugin-install
要求 dsh ≥ 0.2.0。安装并加载后,打开 插件 页面即可使用;添加新插件仍使用页面自带的「添加插件」。
使用
| 在哪里 | 会看到什么 |
|---|---|
| 插件列表 | 有新版的插件亮起绿点,启用开关旁显示「更新」按钮 |
| 插件详情 | 标注可更新版本;GitHub 安装的插件提示远端有新提交 |
| 侧栏导航 | 「插件」旁显示待更新数量 |
| 更新完成后 | 支持热替换时直接生效;否则提供「重启」按钮 |
点击「更新」后,插件会先暂停运行中的目标插件,再替换包并重新挂载。不能安全暂停时会停止操作,提示先重启;更新本插件自身也需要重启。
详情页还提供 强制卸载:官方卸载被 pnpm 发布冷静期拦截时,可从这里重试。操作需要两次点击确认;如果运行中的插件无法安全暂停,会拒绝卸载并提示先重启。
更新机制
| 安装来源 | 检查依据 |
|---|---|
| npm | registry 的 latest 版本;不高于当前版本时拒绝更新,避免降级 |
| GitHub | 仓库 HEAD 提交 |
| 本地链接 | 标明来源,不检查更新 |
更新仍通过 dsh plugin add 执行,由 dsh CLI 维护 profile。完成后核对实际安装版本,未达到预期版本时会明确提示。
安装与强制卸载会传入 --config.minimum-release-age=0,跳过 pnpm 的发布冷静期,避免刚发布的版本被解析成旧版,或整个 lockfile 的策略检查阻断操作。旧版 pnpm 不支持该参数时,会去掉参数重试。遇到发布后 registry 元数据尚未传播的 ERR_PNPM_NO_VERSIONS,会延时重试一次。
热替换前先暂停目标插件,释放文件监听等资源,再让宿主按包名重新解析并挂载新代码。浏览器端刷新页面后与新版对齐。组合不支持热替换、插件未运行,或更新本插件自身时,需要重启。
桌面端的重启交给壳层执行;独立运行 dsh web 时,由中转进程等待旧进程释放端口,再按原命令启动新实例,页面恢复后自动刷新。
更新目标只能来自已安装清单,同一时刻只允许一个安装、卸载或更新任务。
写操作要求同源 POST。官方桌面壳转发的请求没有 Origin 头时,仅在 Host 与连接对端均为回环地址、没有代理痕迹,且没有跨站 Sec-Fetch-Site 标记的条件下放行。
更新会在本机执行第三方包的代码与生命周期脚本。请只更新来源可信的插件。强制卸载跳过的是发布冷静期,仍受运行状态检查约束。
开发
npm install
npm run typecheck
npm test
npm run build
安装本地源码检出,prepare 会自动构建 lib/:
dsh plugin --profile web add file:/path/to/dsh-plugin-install
端到端 smoke 默认关闭。需要 Node ≥ 22.19,并在同级目录准备已安装依赖的 deepseek-harness 源码检出。测试使用临时 DSH_HOME 安装插件、启动真实 dsh web,探测安装、卸载、取消及更新检查等路由。
# macOS / Linux
DSH_DESKTOP_PLUGIN_SMOKE=1 npm test
# Windows PowerShell
$env:DSH_DESKTOP_PLUGIN_SMOKE = '1'
npm test
卸载本插件:
dsh plugin --profile web remove dsh-plugin-install
链接
同类插件
dsh-market/dsh-market★ 10295
在 DeepSeek Harness 设置页内浏览、搜索并安装社区插件,支持分类筛选、一键更新与停用,以及主题切换与配置备份。
zhu1090093659/dsh-web#packages/dsh-plugin-manager★ 9959
设置 → 插件 分区里的插件管理 Tab:从 npm/git 安装带进度、下次启动生效的启停开关、安装冲突对账可撤销、失败一键转交修复会话。
kingOfSoySauce/dsh-skin-market★ 295
原生皮肤市场与生命周期管理器,发现社区皮肤、展示预览与兼容状态,并提供已验证的一键安装或手动安装入口。
awesome-dsh-plugin/dsh-find-plugin★ 216
会话内直接找插件:按关键词/分类搜索本精选 registry,返回描述与可直接执行的安装命令。
bradeGithub/DSH-Plugins-Marketplace★ 199
面向 GitHub dsh-plugin 话题的插件与技能市场:设置页内逛自动收录的全量索引(CI 每 2 小时刷新),一键安装带类型识别、安装脚本与宿主依赖遮蔽安全检查、环境变量密钥管理,并附 STANDARD.md 识别层规范。
Sanqi-normal/dsh-webui-market-plugin★ 103
dsh Web GUI 内的社区插件市场:浏览 awesome-dsh-plugin.com 目录,从 设置 → 插件 → 插件市场 安装/卸载插件到 profile。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。