GongYuanCaiJi/dsh-simplify

dsh-simplify

简体中文 | English

License
DSH
上游

一句话：改完代码打一句 /simplify，让 agent 只审查你刚改动的那几行，不碰其他地方。

移植自 pi-simplify（MIT），
上游的提示词与 git diff 解析逻辑逐字保留，只适配 DeepSeek Harness 的 API 差异。

✨ 功能

- 🎯 只审查改动行 —— 通过 git diff 定位改动的文件与行号范围，agent 可以读周围代码当背景，但编辑严格限制在改动行内
- 🔍 四种范围 —— 未提交改动 / 已 staged / 与任意 ref 比较 / 指定文件
- 🧪 改完自己跑测试 —— 审查结束前会运行既有测试，确认没有改坏
- 📐 遵守项目规范 —— 自动遵循项目里的 CLAUDE.md / AGENTS.md 约定
- 🈶 空白与引号文件名安全 —— 参数逐个 POSIX 单引号转义

📸 效果

在一个有未提交改动的仓库里：

/simplify

read  src/alpha.ts          ← 只读被改过的文件
read  src/beta.ts
edit  src/alpha.ts          ← 只改 4-5 行（本次改动范围内）
edit  src/beta.ts           ← 只改 3-4 行
bash  npm test              → 1 pass, 0 fail

agent 的总结会明确说明范围外的行为什么不动（示意）：

Removed the intermediate variable d… Both edits stayed strictly within the
listed changed line ranges… the test suite passes (1 pass, 0 fail).

没有任何改动时：

/simplify
No changed files found. Specify file paths or make some changes first.

📦 安装

dsh plugin --profile  add github:GongYuanCaiJi/dsh-simplify

安装时会通过 prepare 脚本自动构建 dist/。若 pnpm 拦下构建步骤，在 profile 的
pnpm-workspace.yaml 里把本包加进 allowBuilds。

从本地目录安装（需要先自行构建）：

git clone https://github.com/GongYuanCaiJi/dsh-simplify.git
cd dsh-simplify && npm install        # 触发 prepare，产出 dist/
dsh plugin --profile  add ../dsh-simplify

🚀 用法

/simplify                      # 审查所有未提交的改动
/simplify --staged             # 只审查已 staged 的改动
/simplify --ref=          # 与指定 ref 比较，例如 --ref=main、--ref=HEAD~3
/simplify             # 只审查指定文件

移植说明（对上游 pi-simplify@0.2.3）

逐字保留，cmp 验证一致：src/types.ts、src/prompt-builder.ts（含提示词全文）、
以及 src/git-diff.ts 的 STATUS_MAP / parseDiffOutput / parseChangedLines / diffArgs。

这一点你可以自己验，不必信我们 —— THIRD_PARTY_NOTICES.md
钉住了上游 tarball 的 integrity / shasum / gitHead 与逐字文件的 SHA-256，附可直接复制的比对命令。

六处适配（dsh 与 Pi 的 API 不同）：入口改为 Cordis namespace 形状；命令改注册到 commands 服务；
工作目录取自 agent.session.header.cwd；「无改动」提示改为命令回传值；
pi.exec 改走 ctx.shell（薄转接层，调用端零改动）；提示词改用 agent.followup 送出。

已知限制： agent 收到的提示词是英文的 —— 那是上游原文，逐字保留未做翻译。

🛠 开发

npm install      # 触发 prepare，产出 dist/
npm test         # 构建后跑单元测试

tools/verify-driver/ 是仓库内的验收工具（不随包发布）：它把一条 slash 命令通过真正的
commands.execute 接缝跑完一整轮，用来做端到端验证。

它需要先装进目标 profile 才能用 --patch 挂载：

cd tools/verify-driver && npm install && cd ../..
dsh plugin --profile  add ./tools/verify-driver
dsh --profile  --patch tools/verify-driver/patch.yml "/simplify"

📄 许可证

MIT。上游 pi-simplify
Copyright (c) 2026 Matt Devy，本移植 Copyright (c) 2026 GongYuanCaiJi。见 LICENSE。

感谢 MattDevy/pi-extensions 的原作者 ——
如果这个插件对你有用，也请去给上游仓库点个 star。

English

License
DSH

一句话：编辑之后，输入 /simplify，agent 只审查你刚刚改动的那些行 —— 别的都不看。

这是 pi-simplify（MIT）到
DeepSeek Harness 的移植。上游的 prompt 和
git-diff 解析保持逐字节一致；只适配了 dsh API 的接缝处。

✨ 特性

- 🎯 只针对改动的行 —— 通过 git diff 定位改动的文件和行范围；agent 可以读取周边代码作为上下文，但编辑只停留在改动的范围内
- 🔍 四种范围 —— 未提交 / 已暂存 / 对比任意 ref / 指定文件
- 🧪 运行你的测试 —— 在结束前验证没有破坏任何东西
- 📐 遵循项目规范 —— 遵守 CLAUDE.md / AGENTS.md
- 🈶 路径中含空格和引号也安全 —— 每个参数都经过 POSIX 单引号转义

📦 安装

dsh plugin --profile  add github:GongYuanCaiJi/dsh-simplify

prepare 脚本会在安装期间构建 dist/。如果 pnpm 阻止了构建步骤，
请将该包添加到 profile 的 pnpm-workspace.yaml 中的 allowBuilds。

从本地检出安装（先构建）：

git clone https://github.com/GongYuanCaiJi/dsh-simplify.git
cd dsh-simplify && npm install        # runs prepare, produces dist/
dsh plugin --profile  add ../dsh-simplify

🚀 用法

/simplify                      # review all uncommitted changes
/simplify --staged             # review only staged changes
/simplify --ref=          # diff against a ref, e.g. --ref=main, --ref=HEAD~3
/simplify             # review only the given files

📄 许可证

MIT。上游 pi-simplify
Copyright (c) 2026 Matt Devy；本移植 Copyright (c) 2026 GongYuanCaiJi。见 LICENSE。

感谢 MattDevy/pi-extensions 的作者们 ——
如果这个插件对你有用，也请去给
上游仓库点个 star。