deepseek-desk-rsi
English | 中文
一个 DeepSeek Harness（DSH）插件，让下游应用与高速演进的上游 harness 保持同步——工人就是 DSH 自己。
AI for AI：DSH 维护 DSH。
为什么做这个
DeepSeek Harness 目前是 0.1.x-rc，频繁出破坏性变更。一个锁死版本的桌面壳（或任何下游应用）几天就会腐坏。手工追上游是一份全职工作。这个 bundle 把这份工作交给 agent——并且给它硬的、可自动化的成功信号，让这个环不会跑偏。
为什么 —— 最大的优势
- 真正的 AI for AI。 工人就是 DeepSeek Harness 自己：它对比上游 diff、改集成胶水、构建、测试、回滚、开 PR——除了最后 merge 那一下，全程无人。
- "一模一样"是机器校验的，不是口头承诺。
rsi_parity强制一个 128 插件契约（parity.json，从官方dsh-base+dsh-web-app两个 bundle 生成）。上游任何增删改名都会变成硬失败——精确名字匹配，不是子串。 - 不会失控的进化。 有界修复（最多 3 轮）、Memento 检查点（
rsi_checkpoint/rsi_rollback）、PR 闸门——环只提议，人来 merge。 - 零构建即装。 纯 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
