小杨技术铺 Cursor · Claude Code · Codex

API CONTRACT HARNESS · /api多协议接口契约框架

会抓包 ≠ 能交差。HTTP + TCP + UDP,整理成可复查契约 REPORT。

Harness 货架 × IronHive 门禁密度 × 契约领域专属规则。install → doctor → 12 阶段 → verify;Exit Criteria A1–A8。买断秒下载,不绑企业运行时。

¥69 立刻拿下 · 支付后秒下载 先看交付清单 怎么用(3 步)

首发 ¥69(标价 ¥89)· iface-lab 金样含 HAR + 可打开 pcap · 不做未授权扫网

痛点

HAR / Wireshark 一堆,交不出契约表

把 TCP/UDP 糊成「也是接口」、无证据写鉴权完善、错误码靠猜——本包用协议卡 + 未覆盖纪律把门禁焊死。

“只有 REST 叙事”
真实系统还有 TCP 私有帧、UDP 心跳。本包三类 HARD 硬支持;扩展协议按卡,无证据禁止装有「已完整还原」。
“截图当交付”
必须落契约表 / 会话卡 / 证据表,终局一份 REPORT + Exit Declaration。领导能复查字段、状态码、帧边界。
“和安全/逆向换皮”
铁律标题独立:流量边界 · 协议会话 · 契约错误面 · 鉴权可靠性。不是 /sec 信任边界换皮,也不是 /fr 拆 dist。

流水线

12 阶段:从授权到 REPORT,不再靠聊天碰运气

每个阶段有明确产出;P06 四铁律标题逐字;收口必须过 Exit A1–A8。

P01–P02

授权 · 协议范围

样本来源、时间窗、禁止项;声明本 case 覆盖 http / tcp / udp / ext。

P03–P05

环境 · 指纹 · 流地图

工具记下即可;指纹≥3;谁连谁、方向、主路径可陈述。

P06–P09

四铁律 · 协议专项

设计门禁 → HTTP 契约表 → TCP/UDP 卡 → 扩展协议或未覆盖。

P10–P12

证据 · 缺口 · 报告

证据≥4 行;缺口清单禁装有;单一 REPORT + Exit Declaration。

终局不是一堆聊天记录,而是: 授权边界 + 协议范围 + 会话/流地图 + HTTP/TCP/UDP 契约卡 + 鉴权挂载(或未覆盖)+ 证据表 + 缺口清单 + Exit A1–A8。

协议矩阵

不只 REST:传输层也要能交差

HARD 必须交得出卡;SOFT/EXT 无证据就写「未覆盖」,禁止装有。

HARD

HTTP / HTTPS

  • 输入:HAR / 导出流量
  • 产出:契约表 + 错误码面
  • 辅助:指纹扫描 / 契约草稿脚本
HARD

TCP

  • 输入:pcap + 会话笔记
  • 产出:端口 / 角色 / 帧边界说明
  • 金样含可打开 pcap,不是空笔记
HARD

UDP

  • 输入:pcap + 数据报笔记
  • 产出:报文角色;重传/丢失写清
  • 可靠性常写「未覆盖」而非瞎猜「有」
SOFT / EXT

WebSocket · gRPC / MQTT / 自定义

  • WS:Upgrade 链 / 帧笔记(金样已附)
  • 扩展:有证据才开扩展卡
  • 无证据禁止写「已完整还原」

P06 四铁律 · 逐字

领域规则,不是换皮标题

design 阶段标题必须逐字出现在 REPORT;Exit A1 专门卡这一条。

1. 流量边界与授权

样本来源、时间窗、禁止项;未授权则停。不做未授权扫网、代抓包人工。

2. 协议与会话模型

HTTP 请求响应 / TCP 连接帧 / UDP 无连接,分卡陈述,禁止糊成「也是接口」。

3. 契约与错误面

字段、状态、错误码;无响应证据写未覆盖,禁止靠猜补全。

4. 鉴权与可靠性

挂载点或显式未覆盖;重试 / 幂等 / 丢包有证据才写「有」。

Exit Criteria A1–A8

A1P06 四标题逐字
A2授权与协议范围
A3指纹 ≥ 3
A4会话/流地图可陈述
A5至少 1 张 HARD 卡达标
A6鉴权挂载或未覆盖
A7证据 ≥ 4 · 无明文密钥
A8REPORT + 无 forbid 短语

交付物

¥69 你拿到的硬资产

买断制;完整 Skill、金样、脚本与跟做清单在支付后下载。

核心

API Contract Skill · /api

  • 封闭命令面:authorize / continue / status
  • 12 阶段门禁 + Exit Criteria A1–A8
  • 反模式清单 · 螺旋上限 · 未覆盖纪律
金样

iface-lab(可 verify)

  • HTTP HAR 样本 + 指纹/草稿脚本对照
  • TCP / UDP 可打开 pcap + 会话/数据报笔记
  • WebSocket 帧笔记;金样 REPORT 可跟做
自证

install · doctor · verify

  • install.ps1 落 Skill
  • doctor.ps1 → READY
  • verify-gold.ps1 → PASS
模板

跟做路径 + 报告模板

  • 约 90~120 分钟跟做清单
  • templates/case 复制开案
  • 终局只维护一份 REPORT.md

上手

怎么用:解压 → doctor 绿 → 说一句话

Cursor / Claude Code / Codex 三选一;先双绿再开案,避免空转。

STEP 1

解压并 install

支付后下载 api-contract-v1.zip,解压到工作区,执行安装脚本。

D:\联调工作区\
├── api-contract-v1\     ← 解压这一包
│   ├── skills\
│   ├── fixtures\iface-lab\
│   ├── scripts\
│   └── cases\...
└── 你的授权样本\
STEP 2

按工具挂 Skill

Cursor
复制 skills/api-contract.cursor/skills/,或跑 install.ps1 后重载窗口。
Claude
整包放项目旁,让它先读 OVERVIEW.mdSKILL.md
Codex
同样以 Markdown 工单推进;阶段命令与产出物一致。

先跑 scripts/doctor.ps1,看到 READY 再往下。

STEP 3

开案一句话

复制模板,对 AI 说:

按 api-contract Skill,对 fixtures/iface-lab
从 /api authorize 开始,continue 到 P12。
最终一份 REPORT.md + Exit A1–A8。
先 doctor,再 verify-gold。

卡住用 /api status;买家案换你的授权 HAR/pcap 即可。

跑通标准:doctor READY · verify PASS · 金样 REPORT 含 HTTP + TCP + UDP 卡 · Exit Declaration 八项闭合。

受众

适合谁 · 不适合谁

FOR

会抓包、交不出契约

Charles / Wireshark 熟练,但领导要的是可复查表而不是截图堆。

FOR

样本不止 REST

联调 / 逆向里夹着 TCP 私有帧、UDP 心跳,需要分卡陈述。

FOR

要用 AI 按工单跑

Cursor / Claude / Codex 都能装同一套阶段门禁,明天还能 continue。

NOT

未授权扫网

不做黑产抓包、代抓包、未授权渗透步骤。

NOT

一键还原任意私有协议

无证据扩展协议只能写未覆盖,不卖「万能解码」幻想。

NOT

想买 /sec 或 /fr

危险 sink 走安全包;拆 dist 走前端 Dist 包——见下方邻包。

FAQ

常见疑问

Q:和免费「怎么抓 HAR」教程有什么区别?
教程教工具开关;本包给你可安装 Skill、12 阶段门禁、协议卡纪律、iface-lab 金样、doctor/verify 双绿与 Exit A1–A8。买的是可复用工单,不是会员链接。
Q:必须用 Cursor 吗?Claude / Codex 行不行?
可以。交付是 Markdown 工单 + Skill + 模板 + 脚本;流程不绑死单一 IDE。
Q:金样里的 pcap 真的能打开吗?
能。TCP/UDP 金样带可打开 pcap + 笔记;HTTP 带 HAR。verify-gold 会核对关键产物是否在位。
Q:会不会和安全分析 / 前端 Dist 包重复?
不重复。/api 回答「多协议契约与会话可交付面」;/sec 回答信任边界与危险 sink;/fr 拆 dist 路由与请求封装。铁律标题独立,禁止换皮。
Q:买了之后怎么拿到?
扫码支付成功后浏览器自动下载 ZIP,也可点「立即下载」。先读 BUYER-README 与 FOLLOW-PATH,再跑 doctor。
Q:支持退款吗?
数字商品一经下载不支持退款。请先看清交付清单与「不适合」条款再购买。

邻包边界

别买错包

同店货架各答一个问题;需要哪类交付就点哪一类。

把抓包从「截图堆」变成「可复查契约工程」

一顿好一点的外卖钱,换一套 HTTP + TCP + UDP 都能交差的工单

¥69¥89
微信 / 支付宝扫码 · 支付后秒下载

商品 ID:api-contract-v1 · 一次买断 · 数字商品自动交付

诚实说明(购买前请读): 本商品是多协议接口契约工程框架(Skill、手册、金样、脚本与模板),不是代抓包 / 代写契约服务; 不含第三方 Agent 账号;不含未授权扫网或攻击操作指南;不承诺「任意私有协议一键完整还原」。 数字商品一经下载不支持退款,介意请先看清交付清单再购买。