前言¶
在 DeepSeek Harness(DSH)裏做改動,常見做法是開對話、貼 diff,或依賴別的插件用 /review 在會話裏出報告。若你更習慣 Codex 那套「選範圍 → 看 unified diff → 按 P0–P3 看結論」,又不想爲此再起子 Agent、也不希望工具自動改倉庫或往 GitHub 寫評論,側欄裏缺一塊只讀、本地優先的審查面板,就會顯得彆扭。
@uponnoise/dsh-code-review(GitHub:UponNoise/dsh-code-review)是社區維護的工作流類插件:在 Web 版 DSH 左側欄增加「代碼審查」入口,主面板對標 Codex 的 review 體驗,在本機收集 diff,僅在點擊「開始審查」時把 diff 交給當前 profile 已配置的 LLM。插件與 DeepSeek、OpenAI、GitHub 均無隸屬或背書關係。
這是什麼¶
維護者 UponNoise 將其定位爲 DeepSeek Harness 的「代碼審查」插件:側欄一個入口,主面板復刻 Codex 代碼審查流程。審查 rubric 逐字取自 OpenAI Codex 倉庫中的 review/rubric.md(Apache-2.0);Host 側負責預取 diff,相當於把 Codex reviewer「自己跑 git」改成「本機先算好 diff 再送模型」。當前 package 版本爲 0.1.0,插件源碼許可爲 MIT。
核心功能¶
側欄與審查範圍¶
插件通過 sidebar.panellist 註冊 code-review,點擊後打開主面板。審查範圍與 codex review 對齊,包括:
- 未提交的更改(暫存、未暫存、未跟蹤)
- 對比基線分支(PR 風格)
- 指定提交
- 自定義審查指令
差異與 GitHub¶
- 差異瀏覽:逐文件 unified diff、增刪統計、文件樹;未跟蹤文件會合成 diff 展示。
- GitHub:讀取本機
ghCLI 登錄態,展示賬號與頭像;左欄列出「我的開放 PR」和當前倉庫的開放 PR,點擊載入 PR diff。不向 GitHub 寫入任何評論。
模型審查與輸出¶
Host 調用 DSH 已配置的 llm 服務(默認跟隨 profile 的 agent-default-model),流式返回;結果解析爲結構化 findings,按 P0 / P1 / P2 / P3 展示,可複製爲 Markdown。審查結果只留在當前頁面內存,不落盤。
與同類插件的差異(README 對照)¶
| 方向 | 本插件 |
|---|---|
| 側欄面板 + PR 瀏覽 | 有 |
| 本地四種審查範圍 + Codex rubric | 有,直連當前 profile 模型 |
| 子 Agent、改代碼、寫 GitHub | 無,全程只讀 |
同類項目還包括 MichengAI、f-e-n-g-0531、HaoyueQin、moazzamak、dsh-plugins 等倉庫下的 code-review 變體;側重各不相同,README 中有表格說明。
安裝與啓用¶
需要 DSH 0.2.x(在 0.2.1-rc.5 上驗證)、本機 Git;使用 GitHub PR 列表與 PR diff 時,還需已登錄的 gh CLI。
從 GitHub 安裝:
dsh plugin --profile web add github:UponNoise/dsh-code-review
或從 Release 預構建包安裝:
dsh plugin --profile web add https://github.com/UponNoise/dsh-code-review/releases/latest/download/dsh-code-review.tgz
裝完後刷新頁面或重啓 DSH,左側欄會出現「代碼審查」。
可選配置¶
在 cordis.patch.yml 的插件 config 中可覆蓋:
- insert:
- id: code-review
name: '@uponnoise/dsh-code-review'
config:
githubUser: UponNoise
provider: deepseek-official # 可選
model: deepseek-flash # 可選
典型用法¶
- 在 DSH Web 中打開目標工作區(含 Git 倉庫的路徑)。
- 點擊側欄「代碼審查」,確認 health/context 能讀到分支與倉庫狀態。
- 選擇審查範圍(例如未提交更改,或從 GitHub 區選一個開放 PR)。
- 在 diff 視圖中核對文件樹與逐文件變更。
- 按需填寫自定義審查指令,點擊開始審查;等待流式結果,按 P0–P3 查看並可複製 Markdown。
本機 API 均爲同源、僅本機訪問,例如 GET /dsh-code-review/api/health 探測服務與默認模型,POST /dsh-code-review/api/diff 取本地或 PR diff,POST /dsh-code-review/api/review 以 NDJSON 流式返回審查。
適用場景與注意¶
適合:已在 DSH 0.2.x Web profile 下開發、希望 Codex 式 rubric 與優先級展示、並要在同一界面裏切本地改動與 GitHub PR 的開發者。
注意:
- 插件以當前 DSH 進程權限運行,可執行本機
git、讀取gh態;安裝前請自行查看 源碼與 LICENSE。 - 只有發起審查時纔會把 diff 發給配置的模型;diff 在本機收集,不會自動修改倉庫。
- 卸載:從插件管理器移除 bundle,或刪除 profile 補丁里
code-review對應行;插件不寫用戶文件。
社區插件目錄頁獨立於 DeepSeek / 幻方,並非官方應用商店;星標與收錄信息以目錄站爲準(當前 GitHub 星標爲 0)。
結尾¶
dsh-code-review 把側欄面板、GitHub PR 瀏覽、四種本地審查範圍與 Codex rubric 串在同一條只讀工作流裏,適合不想在對話裏嵌審查、又需要對齊 P0–P3 輸出的 DSH 用戶。