前言¶
DeepSeek Harness(DSH)插件生态中,下游应用经常需要跟上高速演进的上游 harness:更新集成胶水、跑构建和测试、确认插件契约是否仍然对齐,最后把改动交给人工审核。
huchunlinnk/deepseek-desk-rsi 是一个 DSH 插件,目标就是让下游应用与上游 DSH 保持同步。它的思路是“AI for AI:DSH 维护 DSH”,也就是用 DSH 自身执行上游同步流程,并把结果以 PR 形式交给人审。
这是什么¶
huchunlinnk/deepseek-desk-rsi 由 huchunlinnk 维护,许可证为 MIT。它注册 6 个工具,并注入一个 rsi:loop system-prompt 段,用于约束同步环路的行为。
它复用 DSH 提供的 peer 依赖:
@deepseek-ai/dsh-tools
@deepseek-ai/cordis
实现方式是零构建即装:纯 ESM + JSDoc,无 prepare 脚本。
核心环路¶
下面介绍它提供的同步环路:
perceive → integrate → verify → parity → repair → propose
各阶段对应关系如下:
1、perceive
通过 rsi_perceive 对比上游相对某个 base ref 的差异。
2、integrate
把上游变化落到下游应用的集成代码中。
3、verify
通过 rsi_verify 执行硬适应度检查:
cargo build && cargo test && bash scripts/smoke-web.sh
退出码 0 才算通过。
4、parity
通过 rsi_parity 用 parity.json 校验 128 插件契约,要求精确名字匹配。
5、repair
通过 rsi_checkpoint 与 rsi_rollback 提供 Memento 检查点和回滚。修复有界,最多 3 轮。
6、propose
通过 rsi_propose 用 gh 开 PR,作为人审闸门。
对等契约¶
parity.json 来自官方 dsh-base + dsh-web-app 两个 bundle 生成,包含 128 个插件。同步后如果缺少必需插件名字,rsi_parity 会失败。
上游插件发生增删改名后,可以从官方 harness 路径重新生成契约:
node scripts/gen-parity.mjs /path/to/deepseek-harness
安装与启用¶
安装命令如下:
dsh plugin --profile rsi add github:huchunlinnk/deepseek-desk-rsi#main
接着需要启用对应 profile。把 profile/ 目录复制进:
$DSH_HOME/profiles/rsi
并指向你的仓库。
完成以上步骤后,可以运行每日同步:
dsh --profile rsi "Run the daily upstream sync: perceive, integrate, verify, parity, repair if needed, then propose a PR."
测试¶
安装或修改后,可以运行:
npm test
适用场景与注意¶
适合这类情况:
- 维护依赖 DSH 的下游应用。
- 上游 DSH 变化较快,需要持续追平。
- 希望由 DSH 执行感知、集成、验证、对齐和修复,最终只生成 PR。
- 希望保留人工 merge 闸门。
使用前需要注意:
- 一个正在运行的环就是拥有 shell 权限的本地用户。
- 密钥绝不进源码。
- PR 是闸门。
- 把 upstream 钉到你信任的 commit。
- 环只提议,人来 merge。
- 修复有界,最多 3 轮。
- 安装前应检查源码与许可证。该插件许可证为 MIT。
资源链接¶
- GitHub 仓库:https://github.com/huchunlinnk/deepseek-desk-rsi
- 插件目录页:https://www.skillhub.cn/plugins/huchunlinnk/deepseek-desk-rsi(该 URL 按插件线索提供,本文不扩展其内容)