deepseek-desk-rsi

English | 中文

一个 DeepSeek Harness（DSH）插件，让下游应用与高速演进的上游 harness 保持同步——工人就是 DSH 自己。

AI for AI：DSH 维护 DSH。

为什么做这个

DeepSeek Harness 目前是 0.1.x-rc，频繁出破坏性变更。一个锁死版本的桌面壳（或任何下游应用）几天就会腐坏。手工追上游是一份全职工作。这个 bundle 把这份工作交给 agent——并且给它硬的、可自动化的成功信号，让这个环不会跑偏。

为什么 —— 最大的优势

1. 真正的 AI for AI。 工人就是 DeepSeek Harness 自己：它对比上游 diff、改集成胶水、构建、测试、回滚、开 PR——除了最后 merge 那一下，全程无人。
2. "一模一样"是机器校验的，不是口头承诺。 rsi_parity 强制一个 128 插件契约（parity.json，从官方 dsh-base + dsh-web-app 两个 bundle 生成）。上游任何增删改名都会变成硬失败——精确名字匹配，不是子串。
3. 不会失控的进化。 有界修复（最多 3 轮）、Memento 检查点（rsi_checkpoint / rsi_rollback）、PR 闸门——环只提议，人来 merge。
4. 零构建即装。 纯 ESM + JSDoc，无 prepare 脚本：dsh plugin add github:huchunlinnk/deepseek-desk-rsi#main 直接可用。

环路

perceive  →  integrate  →  verify  →  parity  →  repair（有界）→  propose

阶段	谁	怎么做
perceive	工具 rsi_perceive	fetch 上游，对比上次同步以来的 commit log + stat
integrate	agent（现有工具）	用 bash / edit / subagent / workflow 把相关 harness 变更应用进应用的胶水
verify	工具 rsi_verify	硬适应度函数：cargo build && cargo test && bash scripts/smoke-web.sh，退出码 0 才算过
parity	工具 rsi_parity	同面门：parity.json 里的每个必需插件都还在
repair	agent + rsi_checkpoint / rsi_rollback	改动前先 checkpoint（Memento），verify/parity 失败后回滚重试
propose	工具 rsi_propose	commit、推分支、用 gh 开 PR——人审闸门

环路纪律由一个 bundle 注入的 system-prompt 段（rsi:loop）强制执行，agent 无法偷偷跳过某个阶段。

工具

工具	作用	设计模式
rsi_perceive	对比上游相对某个 base ref 的差异	—
rsi_checkpoint	提交一个带标签的快照	Memento（捕获）
rsi_rollback	git reset --hard 回到某个检查点	Memento（恢复）
rsi_verify	跑构建/测试/服务冒烟适应度命令	—
rsi_parity	用 --dump-config 精确匹配校验 parity.json	—
rsi_propose	用 gh 开 PR	Command（人审闸门）

五个阶段是一条 Pipeline；整个环是有界递归（最多 3 轮修复）。

安装

dsh plugin --profile rsi add github:huchunlinnk/deepseek-desk-rsi#main
dsh --profile rsi "Run the daily upstream sync: perceive, integrate, verify, parity, repair if needed, then propose a PR."

profile/ 目录是一个起始无头 profile（dsh-base + dsh-headless + dsh-desk-rsi）。把它复制进 $DSH_HOME/profiles/rsi 并指向你的仓库。

对等契约

parity.json 列出了官方 dsh-base + dsh-web-app 两个 bundle 里的全部插件（128 个）加上宿主端点。同步后少了任何一个名字，rsi_parity 就会失败。上游增删改名插件后，从官方 bundle 重新生成：

node scripts/gen-parity.mjs /path/to/deepseek-harness

设计原则

• 第一性原则 —— 复用 harness（@deepseek-ai/dsh-tools、@deepseek-ai/cordis 是 DSH 提供的 peer 依赖）；绝不重写 bash、git 或子代理。
• 奥卡姆剃刀 —— 纯 ESM JavaScript，零构建、零 prepare；git 安装开箱即用。
• 设计模式 —— Pipeline（阶段）、Memento（检查点/回滚）、Command（PR 闸门）、Strategy（桌面端的更新策略）、有界递归。

仓库结构

index.js           单入口；注册 6 个工具 + 环路 prompt
prompt.js          rsi:loop system-prompt 段（纪律）
tools/             一个文件一个工具
lib/exec.js        有界 shell 执行器
scripts/           smoke.js、e2e-loop.mjs、gen-parity.mjs
profile/           起始无头 profile
parity.json        128 插件契约

测试

npm install --no-save --no-package-lock @deepseek-ai/dsh-tools   # 预构建的注册表 + cordis peer
npm test   # smoke（注册 6 工具 + prompt）+ e2e（真实 git 跑 perceive→checkpoint→rollback→verify→parity）

若要对着本地已构建的 harness checkout 开发，可以改为把它的包 symlink 进 node_modules/@deepseek-ai/。

安全

一个正在运行的环就是拥有 shell 权限的本地用户。密钥绝不进源码；PR 是闸门；把 upstream 钉到你信任的 commit。见 SECURITY.md。

许可证

MIT