Tinzlu/dsh-review

dsh-review

为 Codex 提供的独立代码审查，由 DeepSeek Harness (dsh) + DeepSeek V4 Flash 驱动。
来自不同模型家族和不同 harness 的第二意见——成本几乎为零。

Agent = Model + Harness。大多数审查工具会重新运行相同的模型和相同的 harness——这意味着审查者与作者共享相同的盲点。dsh-review 将你的 diff 发送给一个真正独立的组合：DeepSeek 的 V4 Flash 运行在 DeepSeek 自己的 harness 中，以无头模式运行，并带回一份你可以据此行动的结构化审查报告。

为什么你需要第二意见

- 编写代码的模型往往会忽略自己的盲点（自我审查偏差）。
- 与独立第三方进行交叉审查是 2026 年的社区共识：不要让作者当裁判。
- dsh-review 将这一工作流变成一条命令：收集 diff → DeepSeek Harness 审查 → 返回结构化报告。

功能特性

- 🧠 设计上独立 —— 与 Codex 不同的模型家族（DeepSeek V4 Flash）和不同的 harness（DSH）
- ⚡ 快速 —— 一次审查只需几秒到几分钟
- 💰 便宜 —— V4 Flash 缓存命中输入价格约为 $0.0028/M；批量审查无需盯着计费表
- 📜 可追溯 —— DSH 的无头运行会保留仅追加的会话日志
- 🔌 灵活的范围 —— git diff、特定文件或整个仓库

安装

要求：Node.js、DeepSeek API 密钥（DEEPSEEK_API_KEY）、网络访问。

一条命令：

git clone https://github.com/Tinzlu/dsh-review.git ~/.codex/skills/dsh-review

或使用官方 Codex 技能安装器：

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo Tinzlu/dsh-review --path .

重启 Codex，然后只需提问：

用 dsh-review 审查当前 diff

Run dsh-review on this PR / these files

使用方法

该技能可在 Codex 内部使用（只需描述范围），也可直接从终端使用：

review a file
~/.codex/skills/dsh-review/scripts/dsh_review.sh "严格审查 /path/to/file.py，按严重程度列出问题"

review from stdin
echo "审查下面这段 diff：$(git diff)" | ~/.codex/skills/dsh-review/scripts/dsh_review.sh

该脚本封装了 npx -y @deepseek-ai/dsh --profile headless "" —— 首次运行会下载该包，之后的运行会很快。

效果证明

- 示例报告 —— 一份真实的 DSH 无头审查，在实时会话中生成
- 交叉审查对比 —— 同一个文件分别由 Codex 和 DSH + V4 Flash 审查，并排对比

工作原理

Codex collects scope (git diff / files)
↓
dsh_review.sh → npx @deepseek-ai/dsh --profile headless ""
↓
DeepSeek V4 Flash reviews with DSH's toolset
↓
structured findings → back to Codex → delivered to you

常见问题

费用是多少？ 一次典型审查只需几美分或更少。V4 Flash 很便宜，而 DSH 对缓存友好的会话设计使长时间、重复的审查也很经济。
它会取代我正常的代码审查吗？ 不会——它是对代码审查的补充。把它当作独立的第二意见，尤其是在 Codex 或 Claude 编写了代码之后。

我的代码会离开本机吗？ 会，审查请求会发送到 DeepSeek API，就像任何 DeepSeek 的使用一样。切勿在审查范围内包含机密、令牌或凭据。

DSH 是开发者预览版——如果它出故障了怎么办？ 该技能记录了一个回退方案：如果 dsh 不可用（缺少密钥、网络问题、安装失败），Codex 会执行正常的审查并说明情况。

许可证

MIT