前言¶
在 DeepSeek Harness（DSH）里，插件往往来自 GitHub、npm 或本地开发包，数量一多，逐个查 Release、对版本、再重装就很费时间。社区目录里虽有各类插件，但并没有统一的「批量拉到最新」入口。下面介绍的 dsh-oneshot（面板名 Oneshot一键新）由维护者 zhangyong0010 提供，归类为 admin-security，作用是对当前 profile 里全部已安装插件做版本扫描，按扫描结果一键强制更新，并汇总「从哪一版到哪一版」的变更说明。它与单插件管理器的差别在于：一次操作覆盖整机插件清单，且带兼容预检与失败回滚尝试。
这是什么¶
dsh-oneshot 是 DSH 的 Bundle 插件，定位为一键强制更新器：自动读取已安装插件、查询各自上游最新版本（以 GitHub 为主，npm 注册源按策略处理），在确认有新版本时批量安装，并输出更新日志。许可证为 MIT（以仓库说明为准）；SkillHub 目录页与 GitHub 仓库见文末链接。插件在 DSH 宿主进程权限下运行，安装前宜自行审阅源码与许可证。
核心功能¶
扫描与版本发现¶
打开左侧边栏 Oneshot一键新 面板后会自动扫描；也可手动「扫描版本」强制刷新并显示耗时。扫描最多 6 个插件并行查询，请求去重，60 秒短缓存。插件会识别每条 Bundle 的来源：github:owner/repo、npm 注册源、或 link: / file: 本地包。
对每个 GitHub 来源插件，最新版本按三级回退查询：Releases → Semver Tags → 默认分支 package.json。多包仓库按 repository.directory 取插件自身版本，避免误用仓库根版本。
一键更新与策略复用¶
一键强制更新全部会复用最近一次扫描结果：已是最新的不再查询或重装；只安装扫描阶段已确认的新版本。尚未扫描时会先扫一次；成功更新过的项在再次点击更新时会跳过。
| 插件来源 | 行为摘要 |
|---|---|
github:owner/repo |
安装扫描确认的 Release / Tag / 默认分支提交，安装后核对本地版本；失败时尝试恢复原版本 |
| npm 注册源 | 更新到最新已发布版本；若 GitHub 版本领先且包名与 Bundle 声明可核验，可切到 GitHub 目标 |
link: / file: |
安全跳过，不尝试远程下载 |
更新日志与安全预检¶
右上角 更新日志 进入二级页：每次操作为一张卡片（时间、成功/失败/跳过数量、变更摘要），完整日志可展开；历史最多保留最近 20 次，Host 重载后清空。
更新前会比对目标版本的 DSH 兼容性声明；不兼容或无法确认时阻止替换，并提示版本豁免（本插件不会自动授予豁免，需你在 DSH 中显式操作）。不能确定恢复来源时保留原版；恢复失败会在日志中给出手动恢复规格。
Agent 工具¶
内置工具 dsh_oneshot_update，可在对话中让 Agent 执行扫描或更新（例如扫描插件、更新全部插件）。
网络方面：查询版本时访问 GitHub API 与 npm 注册源；README 写明零遥测、不上传用户数据。GitHub 匿名 API 有限速，失败会在日志中标明。
安装与启用¶
在 DSH 设置 → 插件 → 安装 中粘贴安装规格（须与官方 README 一致）：
github:zhangyong0010/dsh-oneshot
README 标注当前版本为 v1.0.2；也可使用 v1.0.2 安装包 链接安装。亦可通过 Agent 的 plugin_manager / install_bundle，安装规格同上。
安装后客户端会注入侧边栏与 Web 面板（package.json 中 dsh.client 依赖布局与侧边栏 UI 包）。
典型用法¶
- 点击左侧边栏 Oneshot一键新 图标，等待自动扫描完成。
- 在列表中对照已安装版本与 GitHub（或策略下的）最新版本。
- 点击 一键强制更新全部（或等价按钮），仅升级扫描已确认有更新的项。
- 需要追溯时，打开 更新日志，展开单次操作的完整记录。
- 在会话中对 AI 说明：用
dsh_oneshot_update扫描插件或更新全部插件。
本地 link: / file: 开发包会出现在列表中但不会被远程强制覆盖，避免打断本地联调。
适用场景与注意¶
适合：长期开着多个 DSH 插件、希望定期对齐上游 Release；希望批量操作且需要变更摘要与安全门禁的维护者或团队环境。
注意：
- 插件以当前 DSH 进程权限读写安装目录，属 admin-security 类能力，只应从可信来源安装。
- 强制更新可能引入与当前 DSH 主版本不兼容的插件；预检会拦截明显不兼容目标，但无法消除所有运行时风险。
- 网络异常或上游删除旧版本时，自动恢复可能失败，需按日志中的规格手动处理。
- SkillHub 目录为社区站点，与 DeepSeek / 幻方无官方从属关系；星标等元数据以目录页为准（当前仓库 GitHub 星标为 0）。
结尾¶
dsh-oneshot 把「扫版本 → 定计划 → 批量强制更新 → 看变更日志」收成一条链路，并复用扫描结果减少重复请求。若你维护的 DSH 环境里插件较多，可用它做周期性的版本对齐，同时保留兼容检查与更新历史。
- 目录页：https://www.skillhub.cn/plugins/zhangyong0010/dsh-oneshot
- GitHub：https://github.com/zhangyong0010/dsh-oneshot
