dsh-api-contract 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-api-contract 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-api-contract 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-api-contract 还在维护吗？

GitHub 0 星。最近一次上游提交在 2026/10/29。

接口契约工坊 JOJO-Adam/dsh-api-contract

DeepSeek 客户端

JOJO-Adam5 天前有提交已提供中文文档扫描：含敏感能力兼容 / 相关生态

在 GitHub 查看 ↗

先定接口契约，再评审改动是否会破坏客户端

29.5/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/11/2 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

相关生态插件（非 dsh 原生，按其对应运行时安装）

git clone https://github.com/JOJO-Adam/dsh-api-contract.git

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：仅索引

是什么

生态应用

桌面端 / Web 外壳，不以 dsh plugin add 安装

装得上吗

本站尚未做安装检查

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 5 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件

查看扫描证据（共 3 处，展示前 3 条）

读取本地文件
lib/index.js:45
entries = readdirSync(SKILLS_DIR, { withFileTypes: true })
读取本地文件
lib/index.js:54
return statSync(join(dir, 'SKILL.md')).isFile()
读取本地文件
lib/index.js:63
const { data, body } = parseFrontmatter(readFileSync(locator, 'utf8'))

扫描于 2026/11/2（1 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

DeepSeek Harness 的 API 契约工作室：契约优先编写、破坏性变更评审、错误契约、版本管理、文档，含 7 个技能。

README

由 DeepSeek 最新模型翻译生成

dsh-api-contract · JOJO&Adam 装完之后，你和智能体讨论接口时会先拿到一份能落地的契约；要改接口时，它会先告诉你这次会不会伤到现有客户端。不是「让 AI 写个接口文档」，是把接口这一层的判断变成可复核的流程：契约先行 → 可被机器校验 → 变更用同一把尺子评审。安装 Web 版 dsh plugin --profile web add @jojonadam/dsh-api-contract 桌面版 dsh plugin --profile desktop add @jojonadam/dsh-api-contract 装完能做什么 - 开新接口：把必须早定的七件事（资源边界、命名、分页、错误、鉴权、幂等、版本）一次问清楚，而不是写到一半才发现分歧 - 写/审 OpenAPI：资源导向的路径设计、components 复用、请求响应约定，以及那些会悄悄变成破坏性变更的反模式 - 判破坏性变更：按变更类型给出客户端具体坏在哪，含「未知字段」这种常被忽略的兼容例外 - 定错误契约：HTTP 状态码与业务错误码的分工，业务失败返 200 的反模式 - 版本与弃用：什么时候才真需要新版本、版本放哪、四步弃用流程 - 文档与示例：文档从契约生成，示例质量的四个层次怎么触发

展开完整文档（README 剩余 1 节）

dsh-api-contract · JOJO&Adam

装完之后，你和智能体讨论接口时会先拿到一份能落地的契约；要改接口时，它会先告诉你这次会不会伤到现有客户端。

不是「让 AI 写个接口文档」，是把接口这一层的判断变成可复核的流程：契约先行 → 可被机器校验 → 变更用同一把尺子评审。

安装

Web 版
dsh plugin --profile web add @jojonadam/dsh-api-contract
桌面版
dsh plugin --profile desktop add @jojonadam/dsh-api-contract

装完能做什么

- 开新接口：把必须早定的七件事（资源边界、命名、分页、错误、鉴权、幂等、版本）一次问清楚，而不是写到一半才发现分歧
- 写/审 OpenAPI：资源导向的路径设计、components 复用、请求响应约定，以及那些会悄悄变成破坏性变更的反模式
- 判破坏性变更：按变更类型给出客户端具体坏在哪，含「未知字段」这种常被忽略的兼容例外
- 定错误契约：HTTP 状态码与业务错误码的分工，业务失败返 200 的反模式
- 版本与弃用：什么时候才真需要新版本、版本放哪、四步弃用流程
- 文档与示例：文档从契约生成，示例质量的四个层次

怎么触发

直接用自然语言，例如「帮我设计一个订单接口的契约」「这次把 status 改成枚举算不算破坏性变更」「错误码怎么设计」；也可以显式点名技能。

边界

- 只管接口这一层（契约、演进、文档）；不替代你们的框架选型与代码规范
- 变更检测以你提供的契约文件为准；没有契约文件时，第一件事是补契约
- 不生成可直接上线的服务端实现

许可

MIT