前言¶
用 DeepSeek Harness（DSH）讓模型改後端代碼時，常見問題是：改完以後，各 HTTP 接口的響應是否還和改前一致、哪些字段或狀態碼變了，往往只能靠手工點接口或臨時寫腳本對比。DSH API Revise（npm 包名 dsh-apirevise）是 Lostforest7 維護的工作流類 DSH 插件，在 DSH Web 裏提供「API 接口驗收臺」：改前對監控端點做基線快照，改後一鍵重跑並給出結構化 diff，再逐條人工驗收並導出報告。它不是流量抓包代理（README 標明 v2 方向），也不是前端驗收工具（同類場景見 dsh-revise）或通用測試框架運行器。
這是什麼¶
- 定位：面向 DeepSeek Harness 的 API regression & acceptance workbench（接口迴歸與驗收工作臺）。
- 維護者：Lostforest7；倉庫 https://github.com/Lostforest7/dsh-apirevise，社區目錄頁 https://www.skillhub.cn/plugins/Lostforest7/dsh-apirevise。
- 版本與驗證環境：預發佈 v0.1.0；README 寫明在 DSH Web 0.2.0-rc.2、Windows、Node 24 上驗證；界面與報告爲中文。2026-10-01 文檔記錄過真實模型閉環（基線 → 真實 DeepSeek V4-Flash 改後端 → 重跑 → 結構化 diff → 逐條驗收 → 報告），模型步驟未 mock，細節見倉庫
docs/real-model-validation.md。 - 憑證：按 DSH 官方文檔配置 Harness；插件本身不需要單獨的 API Key。
核心功能¶
下面介紹 README 中已列出的能力，均可在 DSH Web 面板中操作（端點 method、URL、可選 headers/body 手工錄入，不做流量捕獲）。
- 註冊端點：爲本輪要監控的接口填寫請求信息。
- 基線快照：創建驗收輪次時對每個端點請求一次，將響應（狀態碼、headers、JSON 或文本 body）寫入項目目錄下的
.dsh-apirevise/，並保存有界範圍內的後端源文件快照。 - 與會話銜接：變更目標與監控端點列表通過 DSH 常規 prompt 隊列發往當前 DSH 會話，供模型改代碼。
- 重跑與對比：模型改完後一鍵重跑所有端點，生成結構化 diff：JSON 字段級（增刪、類型、數值及 old → new）、狀態碼變更高亮、純文本 body 的 text patch；並與源碼 diff 並排查看。
- 逐條驗收：每個端點可接受，或標記「需返工」並附帶反饋進入下一輪；若 rerun 之後源碼又變了，對比會過期，須先重跑再驗收；全部端點在當前 rerun 下被接受後，才能完成本輪。
- 可攜帶報告：導出 Markdown 與單文件 HTML（內嵌 diff、XSS 轉義、嚴格 CSP）；報告只呈現事實，不替人判定「接口一定沒問題」——驗收結論由人做出。
插件明確不是：流量抓包代理、前端工具、測試框架 runner；也不會自動宣稱 API 已正確，只展示狀態碼、字段與數值變化。
安裝與啓用¶
環境要求：Node 22.19+（22.x）或 Node 24。先按 DeepSeek Harness 官方文檔 安裝並配置 DSH。
從 npm 安裝（README 給出的命令）：
dsh plugin --profile web add dsh-apirevise
包發佈爲 dsh-apirevise@0.1.0；GitHub v0.1.0 也附帶預發佈 tarball。
若從源碼目錄加載：在 checkout 內 npm ci 與 npm run build 後，停止 DSH，用絕對路徑註冊 Web profile 再啓動 dsh web（README 示例命令爲 dsh plugin --profile web add /absolute/path/to/dsh-apirevise）。倉庫含已構建的 lib/，也可不跑 build 由 DSH 加載。
注意：DSH 插件以當前 DSH 進程權限運行；安裝前請自行查看倉庫源碼與 MIT 許可證，並確認與本地 DSH / Node 版本匹配（peerDependencies 含 @deepseek-ai/cordis ~4.0.4 及 DSH Web 0.2.0-rc.2 相關客戶端包）。
典型用法¶
README 給出的可復現流程如下。
- 本地啓動後端（例如倉庫
examples/api-server中node server.mjs，端口 3000）。 - 打開工作目錄爲該後端項目的 DSH 會話，點擊右下角 API 接口驗收臺。
- 創建一輪：填寫標題（本次改動說明）、目標（會發給會話）、要監控的端點；創建時會立即打基線快照。
- 點擊 生成請求，確認後 發送到當前會話，由模型修改後端。
- 模型結束後點擊 重跑對比，查看結構化 diff 與源碼 diff；逐端點驗收或附反饋再送回會話。
- 全部端點驗收通過後點擊 完成本輪驗收，再 導出報告。
建議將 .dsh-apirevise/ 加入項目 .gitignore。
本地開發插件時，可用 npm run dev 在 http://127.0.0.1:4320 預覽獨立工作臺（配合 examples/api-server）；完整檢查爲 npm run check（typecheck、單測、build）。單測在 tests/unit，fixture 離線、僅 loopback HTTP，無需 DSH 與外網。
適用場景與邊界¶
適合：你在 DSH 裏用智能體迭代後端 API，需要可重複的「改前快照 / 改後對比 / 人工簽字式驗收」閉環，且願意手工維護監控端點列表（而非自動抓流量）。
邊界：v0.1.0 爲預發佈；與 DSH Web 0.2.0-rc.2 的兼容性以倉庫 docs/compatibility.md 爲準。社區目錄 skillhub.cn 爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；插件星標以目錄/GitHub 當時顯示爲準（當前線索爲 0）。
結尾¶
DSH API Revise 把「模型改後端之後接口到底變沒變」收成一條工作流：基線、重跑、字段級 diff、逐條驗收與報告導出，並把是否接受差異留給開發者而不是工具替你做結論。進一步瞭解請查看 SkillHub 目錄頁 與 GitHub 倉庫（含中文說明 README.zh-CN.md）。
