GongYuanCaiJi/dsh-simplify

Plugin插件 Native原生 ⭐ 2 MIT Dev Workflow开发与代码工作流

DeepSeek Harness 插件:审查最近改动的代码,就清晰度、一致性与可维护性提出改进(移植自 pi-simplify)

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH). It is a port of the pi-simplify project, keeping all original prompt wording and git diff parsing logic from upstream, only adjusting to fit DSH API differences. You can install it directly via the DSH CLI with one command: dsh plugin --profile <your-profile> add github:GongYuanCaiJi/dsh-simplify. The install script automatically builds the distribution bundle during installation, so no extra build steps are needed beyond the initial install command. If pnpm blocks the build step, you just need to add this package to allowBuilds in your profile's pnpm-workspace.yaml to fix it.

After you make changes to your codebase, you just run the /simplify slash command to trigger the review. The plugin uses git diff to locate exactly which files and lines were changed, and instructs the agent to only make edits within those changed ranges. It supports four different scope options: all uncommitted changes, only staged changes, diff against any git reference, or a custom list of specific files to review. Before the agent finishes its review, it will automatically run your existing test suite to confirm no existing functionality was broken by the changes.

This plugin is released under the open source MIT license, with copyright retained by both the upstream original author and the porter of this DSH version. The only known limitation is that the prompt sent to the agent is kept as the original English text from upstream, with no translation added. You can also install from a local clone if you prefer to modify the plugin before installing it, and there is a built-in end-to-end verification tool in the repository for plugin development work.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件,移植自 pi-simplify 项目,保留了上游的提示词和 git diff 解析逻辑,仅适配 DSH 的 API 差异。核心功能是让开发者改完代码后输入 /simplify,让 agent 只审查本次改动的代码行,不会触碰其他无关区域。

它支持四种改动审查范围:未提交改动、已暂存改动、与指定引用比较、指定单个或多个文件。审查结束前会自动运行项目已有测试,确认改动没有破坏现有功能,还会自动遵循项目内 CLAUDE.md 或 AGENTS.md 约定的规范。

可通过 DSH 插件命令直接远程安装,也可克隆到本地后手动安装,安装时会自动构建产物。本插件采用 MIT 许可分发,已知限制是 agent 收到的提示词为上游原文,未做中文翻译。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 GongYuanCaiJi/dsh-simplify 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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 <你的 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 <你的 profile> add ../dsh-simplify

🚀 用法

/simplify                      # 审查所有未提交的改动
/simplify --staged             # 只审查已 staged 的改动
/simplify --ref=<ref>          # 与指定 ref 比较,例如 --ref=main、--ref=HEAD~3
/simplify <file...>            # 只审查指定文件
移植说明(对上游 pi-simplify@0.2.3)

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

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev ai-sdk-provider-dsh 下一个 Next dsh-github-release-radar →