用途:ce-proof 用于与 Proof 协作 Markdown 编辑器交互,支持发布、读取、评论、建议修改和编辑 Markdown 文档,也用于分享规格、计划、草稿,或从规划工作流(如 ce-brainstorm、ce-ideate、ce-plan)接收文件路径与标题的交接。
主要能力:通过托管 Web API(https://www.proofeditor.ai)经 Bash 走 HTTP 调用;若环境已提供 proof_* 类型化 MCP 工具(proof_share_markdown、proof_v3_document、proof_v3_edit、proof_presence、proof_document_title、proof_document_delete、proof_report_bug),则优先使用。可发布本地 Markdown 为新文档并返回可分享链接,也可对已有文档做范围替换、插入、删除、建议、评论、回复、解决等操作。读取接口为 GET /api/agent/<slug>/v3/document,写入接口为 POST /api/agent/<slug>/v3/edit。
使用方式:首次读取或写入前应先阅读 references/api.md(定义端点、操作表、错误与重试分类等);审阅共享文档、创建并分享、拉取到本地前先阅读 references/workflows.md。发布时读取本地 Markdown 全文并作为新文档正文上传,本地文件仍是规范来源,发布不会反向同步。删除文档需 ownerSecret(未认领时)或所有者的 Every 会话;认领后 ownerSecret 永久失效。触发目标不明确(TARGET_AMBIGUOUS)须用 occurrence/before/after 消歧,不可盲目重试;202/PENDING 或 partial: true 时应先重读文档再判断是否成功。
限制:仅发布 Markdown;HTML 统一计划应返回本地打开路径而非上传。凭证与密钥不得写入文档,ownerSecret 不得出现在仓库跟踪文件、提交或日志中。清空 Markdown 不会清除评论痕迹,删除文档才是隐私清理。不要自动删除发布交接的文档,除非用户主动要求或为明确的临时草稿。官方定价、可用平台等更多事实暂未提供。