nowanti/dsh-keeper

dsh-keeper

CI

dsh-keeper 是 DeepSeek Harness 的外部生命周期与兼容性管理器。其主要可执行文件是更短的 dshk；dsh-keeper 是等效的别名。默认工作流有意设计为一条命令：

dshk upgrade

它会发现已安装的 DSH 配置文件，评估插件候选，询问一次，在无凭据的隔离配置文件中验证确切的集合，将其作为一个可恢复的事务应用，并在任何实时检查失败时恢复上一代。

社区项目；与 DeepSeek 无关联。开发者预览：DSH 核心升级会被报告，但尚未自动应用。

安装

需要 Node.js 24 或更高版本。

npm install --global dsh-keeper
dshk upgrade

如需一次性检查：

npx dsh-keeper status

它保护什么

- 当较新的核心尚无法以事务方式切换时，保留当前 DSH 版本。
- 仅选择具有可用 DSH/宿主和 Node 兼容性证据的 npm 插件候选。
- 将缺失的 peer 包视为隔离证据，而不是假定它们是用户管理的冲突。
- 暂缓处理本地补丁、权限变更、新的生命周期脚本、可变 Git 引用以及证据不足的候选。
- 绝不因为插件的远程仓库不可用就移除该插件。
- 不将任何凭据、会话、存储、SSH 密钥或提供商机密复制到暂存区。
- 重新验证已提升的配置文件，并在失败时恢复包清单、锁文件、node_modules 和常驻服务。

命令

dshk upgrade
dshk upgrade -y                # 仅跳过提问，绝不跳过验证
dshk upgrade --profile web
dshk upgrade --plugins-only
dshk upgrade --preview
dshk upgrade --dry-run
dshk upgrade --json
dshk status
dsh-keeper status              # 等效的长格式可执行文件

交互式终端在耗时操作期间显示一行更新的加载指示器。JSON 和管道输出不包含进度字符。阶段计时仅在 --verbose 下或 JSON 中出现。

语言

内置英语和简体中文。中文系统默认为 zh-CN；其他系统默认为英语。

dshk --lang en status
dshk upgrade --lang zh-CN
DSH_KEEPER_LANG=zh-CN dshk status

JSON 回执与语言无关。兼容性和决策说明使用稳定的原因代码加结构化参数；翻译仅发生在人类可读的呈现中。

兼容性状态

- declared：候选暴露了兼容的 DSH 宿主契约。
- unknown：证据不足以进行自动升级。
- blocked：DSH、Node 或必需 peer 契约存在已确认的冲突。
declared 不等于已验证。自动切换仍然需要精确的包解析、隔离安装、配置组合、实时重新验证以及服务恢复。

平台状态

macOS、Linux 和 Windows 均由 GitHub 托管的原生运行器覆盖。矩阵运行单元/事务测试、双语 CLI 冒烟测试、包检查，以及使用 dsh --dump-config 的真实 DSH profile。确切的证据和剩余边界见可移植性与本地化。

开发

corepack enable
pnpm install --frozen-lockfile
pnpm check
pnpm test:real-dsh
npm pack --dry-run

架构与发布详情：

- 设计
- 安全模型
- 可移植性与本地化
- 发布流程
- DSH 生态定位

中文说明

dsh-keeper 是运行在 DSH 进程之外的生命周期与兼容性工具，日常使用短命令 dshk。普通用户只需执行 dshk upgrade：系统发现候选后展示一次明确方案，用户确认才下载并隔离验证，整组通过后自动应用；任何一步失败都会恢复旧版本和原有服务。

它不是 DSH 插件，也不替代 pnpm。这样设计的原因是：当 DSH 本身或某个 profile 已经无法启动时，修复与回滚工具仍然必须可用。远端不可达只会保留当前版本并给出手动移除建议，不会触发自动卸载。

使用 --lang zh-CN 或 DSH_KEEPER_LANG=zh-CN 可固定中文；中文系统会自动选择中文。完整工程边界与验证证据见上方文档链接。