契约
版本与来源
版本、来源链、保密与更新流程
版本(构建快照)
- Bridge API:
0.49(apiFingerprint: d351b6bc763b,routeCount: 72) - Guide/Skill:
0.49(guideHash: 0dbe99b42c32db98d0bafc526176cd722c084c5a50164d05b944c5c294a787ac) - App:MarginNote 4(
appVersion: 4.5.0)
本站是构建时刻的静态快照,不是权威。连上实例后一律以运行时
GET /status(guideVersion/guideHash/apiFingerprint)与GET /capabilities+GET /guide为准;不一致时以运行时为准。
来源链(可复核,不含敏感信息)
- 运行时状态:
GET /status(免鉴权 + 带鉴权各一次,确认authorized:true) - 运行时能力:
GET /capabilities(72 路由 + 机器可读附录:presets/anchorModes/accessPolicy等) - 运行时规程:
GET /guide(与已安装 Skill 的guideVersion/guideHash比对,不一致则以返回为准) - 本地原始响应存档于
raw/(不提交到公开仓库,仅用于本地生成 OpenAPI 与核对指纹)
保密
- 安装码为一次性凭证,用后即废。不要把安装码、token、原始安装响应提交到公开仓库,也不要写进 PR、commit message、issue。
- 本站所有示例用
$TOKEN/mnb0.…占位,不含真实凭证。 - 轮换:重跑一次新的「Copy Agent Setup Command」即换 token,旧 token 失效。
更新流程
- 重拉
GET /status,比对guideVersion/guideHash/apiFingerprint - 不一致 → 带现有 token 重拉
GET /guide+GET /capabilities(只读刷新,不调安装接口、不轮换 token、不覆写磁盘 Skill 文件) npm run openapi:build重生成openapi/openapi.yaml- 按
routeCount差补参考页,npm run build验证