dsh-api-contract

Manifest valid

API contract studio for DeepSeek Harness: decide the seven things that must be locked before coding, author and review OpenAPI, classify breaking changes by how they actually break clients, and settle

hasBundlePatch

dsh-api-contract · JOJO&Adam

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

不是"让 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

Comments

Loading…

Similar plugins

dsh-api-probe

by LFY-bot

在配置前验证 API Key 和模型可用性，保姆级中文报错诊断插件，专为 DeepSeek Harness 打造。

Development & InfrastructureManifest valid

★ 3

MIT

JavaScript

Oct 10, 2026

dsh plugin --profile web add dsh-api-probe

dsh-polymarket-knowhow

by fashionmascherine-svg

DeepSeek Harness plugin (dsh-plugin): complete Polymarket superpowers — 31 verified tools across Gamma/CLOB/Data-API/Perps/RFQ/Bridge, embedded knowhow skill, live WebSocket stream. Read-only by defau

Tools & CapabilitiesManifest valid

★ 3

JavaScript

Oct 7, 2026

dsh plugin --profile web add dsh-polymarket-knowhow

dsh-tool-lens

by trench-xinxin

Deterministic AST code graph and architecture intelligence tool for call hierarchies, blast radius, circular dependencies, domain slices, and full-stack API contracts.

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 4

↓ 151/wk

MIT

TypeScript

Aug 18, 2026

dsh plugin --profile web add @trench-xinxin/dsh-tool-lens

dsh-diff-review-likecodex

by new-Beginner

Codex-like diff review plugin for DeepSeek Harness Web: interactive side-by-side diffs, compact floating dock, and turn-scoped deliverable change tracking.

Development & InfrastructureManifest valid

★ 0

MIT

TypeScript

Sep 14, 2026

dsh plugin --profile web add dsh-diff-review-likecodex

dsh-studio

by euanguo

DSH Studio — a local development workbench for DeepSeek Harness: project tree, Git review, terminal, and plugin marketplace (Desktop + Web)

Development & InfrastructureManifest valid

★ 12

MIT

TypeScript

Aug 30, 2026

dsh plugin --profile web add @dsh-studio/desktop

dsh-packycode-api

by BaronCyrus

Use a PackyCode (PackyAPI) API key in DeepSeek Harness: built-in multi-protocol model route, ordered API-key rotation, and balance display

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 20

↓ 2.5k/wk

MIT

JavaScript

Oct 30, 2026

dsh plugin --profile web add dsh-packycode-api