内核补丁库 xiamubumu/dsh-patch-library

dsh-patch-library

官方 DSH 内核补丁，以「数据」形式发布 —— 五种方式随你挑。

十条自成体系的补丁，针对 @deepseek-ai/dsh- 与 @earendil-works/pi-ai；配一个小巧的应用器，它会自己找到你的 DSH 安装位置。没有硬编码路径，仓库里没有任何个人信息，全程不需要联网。

面向 @deepseek-ai/dsh 0.1.5-rc.2（1.5 系列）。每条补丁都记录了它所期待的原文件与它产出的新文件各自的 sha256，所以应用器在动手之前就能告诉你 exact / applied / conflict。

🌐 English README → README.md

另外两份中文材料：给 agent 的中文提示词 ·五种方式的详细步骤。

为什么会有这个仓库

有些修复没法做成插件：它们必须跑在官方文件内部，在 Cordis 没有暴露成接缝的函数中间。
其中一批已经做成了插件（dsh-context-reclaim、dsh-capability-composer、 dsh-composer-launcher、dsh-aux-degrade）。剩下的那些 —— 以及只有想凑齐全套时才需要的那些 —— 就住在这里，是普通的 unified diff：任何人可以阅读、审查、应用、回退、重新生成。

这里没有二进制黑盒，也没有魔法：patches/<id>/change.diff 就是一份普通的补丁， manifest.json 是让脚本能安全、可回退地应用它的元数据。

十条补丁

| id | 包 → 文件 | 类型 | 规模 | 需重启 | 已有插件代劳？ |
| dsh-llm-writable-request | @deepseek-ai/dsh-llm → lib/index.js | lines | +18 −1 | 是 | 是 —— dsh-context-reclaim |
| agent-loop-snapshot-prompt | @deepseek-ai/dsh-agent-loop → lib/index.js | lines | +97 −20 | 是 | 否 |
| llm-pi-ai-system-prompt | @deepseek-ai/dsh-llm-pi-ai → lib/index.js | lines | +96 −54 | 是 | 否 |
| compaction-pruner | @deepseek-ai/dsh-compaction-tool-result-pruner → lib/index.js | lines | +354 −14 | 是 | 否 |
| ui-renderer-turntail | @deepseek-ai/dsh-client-ui-renderer → lib/client.js | lines | +9 −1 | 否 | 否 |
| ui-sidebar-wrap | @deepseek-ai/dsh-client-ui-sidebar → lib/lib-client.js | regex | +1 −1 | 否 | 否 |
| session-format-v1-to-v2 | @deepseek-ai/dsh-session-format-v1-to-v2 → lib/index.js | lines | +2 −1 | 是 | 否 |
| session-persistence-jsonl | @deepseek-ai/dsh-session-persistence-jsonl → lib/worker.cjs | lines | +2 −1 | 是 | 否 |
| mcp-client | @deepseek-ai/dsh-mcp-client → lib/index.js | lines | +59 −6 | 是 | 否 |
| pi-ai-max-tokens-floor | @earendil-works/pi-ai → dist/api/simple-options.js | lines | +11 −1 | 是 | 否 |

每条补丁都有自己的 patches/<id>/NOTES.md，中英双语写明改了什么、什么时候需要它、怎么验证、和你的构建对不上时怎么办。

ui-sidebar-wrap 故意做成正则补丁：侧栏的类名前缀是构建哈希，行级 diff 一旦遇到重建就失效。patches/<id>/change.json 里存着模式串以及它显式的逆操作。

五种应用方式

挑你顺手的。五种的详细步骤都在 docs/methods.zh-CN.md （英文：docs/methods.md）。

| | 方式 | 命令 |
| A | 脚本（推荐） | node apply.mjs --check，然后 node apply.mjs --apply --all |
| B | git apply | cd <包目录> && git apply -p1 <库>/patches/<id>/change.diff |
| C | 交给你自己的 AI agent | 把 PROMPT.zh-CN.md 里的整块复制给它，让它按 A 或 B 打 |
| D | 为你的构建重新生成 | node tools/make-patch.mjs --file <改后> --orig <原文件> --pkg <包> --rel <相对路径> |
| E | 回退 | node apply.mjs --revert --all，或手工把任一 .orig 还原回去 |

十条 diff 全部在包目录里通过了 git apply -p1 --check，所以方式 B 对每一条都可用。

方式 A 全流程

node apply.mjs --list # 这里有什么
node apply.mjs --roots # 本机找到了哪些 DSH 安装
node apply.mjs --check # 逐文件状态：exact / applied / conflict / missing
node apply.mjs --apply --all # 应用所有能对上的
node apply.mjs --apply --only mcp-client,compaction-pruner
node apply.mjs --revert --all # 把所有 .orig 备份还原回去

--check 会给出五种状态之一：

| 状态 | 含义 |
| exact | 文件正是本库构建时所用的原版 —— 应用是安全的 |
| applied | 文件已经等于打补丁后的版本，无需操作 |
| variant | 版本号相同但构建不同（哈希不同）而 hunks 仍能对上 —— 需要 --allow-variant，或用方式 D |
| conflict | hunks 对不上。不会写入任何东西。 用方式 D 为你的构建重新生成 |
| missing | 找到的这个安装里没有这个包 |

应用器的硬保证

* 它去找你的安装，而不是假设某台电脑。 --root、$DSH_APP_ROOT、$DSH_INSTALL_ROOT、 $DSH_HOME（含 profiles/）、当前进程自己的 DSH 路径、从当前目录做的 node 解析，以及对 Windows / macOS / Linux 常规安装位置做的有界扫描 —— 见 lib/discover.mjs。
--root 的含义是「就这一个」，绝不会变成「这一个 + 顺便扫到的那些」。
.orig 是圣物。 备份只在文件旁边写一次，永不覆盖；已存在就直接复用。
* 每次改写都做语法检查。 写入后立刻 node --check；失败就立即还原备份，并把该条报为失败。
* 对不上的 hunk 是冲突，不是猜测。 引擎要求 hunk 的旧侧在它被记录的位置附近精确匹配、且只匹配一处。
* 只在解析出的根目录内写入。 除了你显式把 --root 指向某个 profile 目录（那是该 profile 自己的 node_modules 副本），不会碰 $DSH_HOME 下的任何东西。

退出码：0 成功，1 某个请求的操作失败或冲突，2 没找到安装。

如果你已经在用那四个插件

dsh-llm-writable-request 可以跳过 —— dsh-context-reclaim 在插件内部接管了这条路径，官方补丁保持原样即可。--check 会明说：

= dsh-llm-writable-request already node_modules/@deepseek-ai/dsh-llm/lib/index.js
not needed: the dsh-context-reclaim plugin already handles this

其余九条与插件互不依赖：插件装不装、装一个还是四个，都行。

自检

node verify.mjs

离线运行，不需要装 DSH。它会检查：每条 diff 都能解析、hunk 行数与声明一致、声明的 marker 确实由该补丁新增、应用／回退引擎在合成样本上来回一趟是恒等变换、重复上下文会被拒绝而不是被猜、正则补丁能在任意类名前缀上往返 —— 以及仓库里没有任何文件含盘符、个人主目录或私有工作区名（这条扫描是测试套件的一部分，不是一个口头承诺）。

verify.mjs 最后会对本机找到的安装做一次只读的 --check 汇总。

仓库结构

apply.mjs 应用器：--list --roots --check --apply --revert --show verify.mjs 离线自检 + 个人信息扫描 manifest.json 每条补丁的元数据：哈希、字节数、marker、风险、为什么、何时该打 lib/manifest.mjs manifest 加载与 schema 校验 lib/discover.mjs 自适应定位 DSH 安装（跨平台） lib/unified.mjs unified diff 解析／应用／回退引擎 lib/backup.mjs .orig 备份与还原 lib/hash.mjs sha256 小工具 patches/<id>/change.diff 补丁本体（路径相对包根） patches/<id>/change.json 正则补丁：模式串 + 显式逆操作 patches/<id>/NOTES.md 改了什么／何时需要／怎么验证，中英双语 tools/make-patch.mjs 为同版本的另一种构建重新生成补丁 docs/methods.zh-CN.md 五种方式的分步说明 PROMPT.zh-CN.md 复制粘贴给自己 agent 的提示词

如实说明边界

* 这些补丁是按 0.1.5-rc.2 构建的。如果你的构建不同，--check 会告诉你（variant / conflict）—— 那是信息，不是失败。方式 D 就是为这种情况准备的。
* 打补丁就是在改你 DSH 安装里的文件 —— 补丁的本义如此。应用器为它碰过的每个文件留下 .orig， --revert 能把它们放回去。卸载或升级 DSH 会整体替换目录树，补丁也随之消失。
* manifest 里的 restartRequired 说明受影响的代码跑在主进程（重启 DSH）还是渲染进程（刷新窗口即可）。
* 这些补丁是修复，它们不构成对 DSH 的安全审计。应用之前请读一读 patches/<id>/change.diff —— 把补丁当数据发布，图的就是这个选项。

许可

MIT。上游包的权利归其作者所有；本仓库只包含针对它们的 diff。