用途：把本地 Markdown 文件（头脑风暴、计划、学习笔记、草稿）以单向发布方式推送到 Proof，生成可分享链接供人阅读、评论与转发；也可对已有共享文档做评论、建议与块级编辑。
主要能力：Web API 无需安装，POST https://www.proofeditor.ai/share/markdown 创建共享文档并返回 tokenUrl、accessToken、ownerSecret 及 state/ops 链接；通过 Accept: application/json 或 text/markdown 直接读取共享文档；用 /api/agent/{slug}/state 读取标记与变更元数据，?kinds=comment 过滤评论。编辑走 /api/agent/{slug}/ops（评论、建议、回复、解决）与 /api/agent/{slug}/edit/v2（replace_block、insert_before/after、delete_block、replace_range、find_replace_in_block、find_replace_in_doc）。macOS 本地桥接需 Proof.app 运行，端口 localhost:9847，提供 /windows、/state、/marks、/rewrite、/presence 等端点。
使用方式：每次写操作须带归属，X-Agent-Id 默认 ai:compound-engineering，展示名通过 POST /presence 绑定；受保护文档带 x-share-token 或 Bearer；变更需 baseToken，推荐每次带 Idempotency-Key。优先窄编辑（find_replace_in_doc 或块操作），rewrite.apply 仅作最后手段且被 LIVE_CLIENTS_PRESENT 阻止。
限制：桥接端点 /d/{slug}/bridge/* 需客户端版本头，否则 426；ops 与 edit/v2 的报文结构不可混用（op 发到 /ops 返回 422）；STALE_BASE 等需重读重试，ANCHOR_* 与 INVALID_* 不应盲目重试。其它收费、平台范围等细节资料暂未提供。