前言¶
用 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）。
