自进化同步引擎huchunlinnk/deepseek-desk-rsi

deepseek-desk-rsi

License: MIT

一个 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 插件契约

测试
sh
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