用途：Proof 是面向人类与智能体的协作式 Markdown 文档编辑器，用于创建、编辑、评论和分享文档。资料给出两种模式：Web API（无需安装，主要用于分享）与本地桥（驱动 macOS Proof 应用，地址 http://localhost:9847）。
主要能力：Web API 无需认证即可创建共享文档，返回 slug、tokenUrl、accessToken、ownerSecret 及指向 state 与 ops 的 _links。读取状态用 GET https://www.proofeditor.ai/api/agent/{slug}/state；操作统一 POST 到 /api/agent/{slug}/ops（注意不是 /api/documents/{slug}/ops）。操作包括 comment.add、comment.reply、comment.resolve、suggestion.add（kind 为 replace 或 delete）、rewrite.apply。受保护文档通过 x-share-token 或 Authorization: Bearer 头认证。本地桥需 Proof.app 运行，要求头 X-Agent-Id、Content-Type，多文档时需 X-Window-Id，提供 /windows、/state、/marks 系列（suggest-replace、suggest-insert、suggest-delete、comment、reply、resolve、accept、reject）、/rewrite、/presence、/events/pending 等端点，presence 状态含 thinking、reading、idle、acting、waiting、completed。
使用方式：创建用 curl -X POST https://www.proofeditor.ai/share/markdown 并传 title 与 markdown；再以返回的 tokenUrl 分享，用 ops 端点评论或建议修改。审阅已有链接时从 URL 提取 slug 与 token，先读 state 再操作。
限制：Web API 上 suggestion.add 的 kind 为 insert 会返回 Bad Request，需改用更宽 quote 的 replace 或 rewrite.apply；桥式 /d/{slug}/bridge/* 端点缺少客户端版本头会返回 426 CLIENT_UPGRADE_REQUIRED，应改用 /api/agent/{slug}/ops。编辑前应以 /state 内容为准，小改动优先建议替换，避免在单次替换中跨表格单元格，并始终填写 by 字段以追踪归属。收费、定价与平台细节暂未提供。