HTML 协作审阅

要解决什么问题

长文档在 LLM 与人类之间来回改，常见痛点是：改的是哪一段、批注挂在哪、定稿后还要不要带着审阅 UI。纯 Markdown 或裸 HTML 很难在「可继续协作」和「可直接对外展示」两种形态之间切换，也容易在对话里丢失人类已写的 inline 修改与评论。

技能如何工作

html-collab 把文档做成单文件 HTML：正文在 #collab-main 里，每个块级元素带唯一 data-cid（如 p-001、sec-002）；元数据写在 <meta name="collab-data"> 的 JSON 里（comments、edits、时间戳、模型标识等）。引擎自带的 #collab-header / #collab-sidebar 负责保存与侧栏批注，文档级自定义控件应放在 <article> 内，避免被误当成引擎功能。

典型流程三条：

• GENERATE：以 template.html 为骨架生成新文档，填满语义化 HTML，为每个块分配 CID，初始化空的 comments / edits。
• READ：解析已标注文件，跳过 <head> 内引擎 CSS/JS；若有 meta.summary 可先读结构索引；在对话中先输出上下文块（含评论与编辑），再处理图片（超 maxImageBytes 时按环境压缩或降级描述）。
• REVISE：按 edits verbatim 替换对应 CID 文本，再按 comments 改内容；新增块用递增 CID，删除块永久废弃 CID；输出时清空 comments/edits、更新 lastRevised，保留原有 data-cid 与 originalCreated。

可用 /html-collab off 切到纯 HTML 模式：无 collab 元数据、无引擎脚本与侧栏，适合定稿对外阅读。

适用边界与注意点

• 同一 data-cid 若同时出现在 Comments 与 Edits：先应用 edit，再理解 comment（comment 的引用针对编辑前原文）。
• REVISE 后文件里的批注会被清空，对话历史才是反馈的持久记录；无文件访问环境时建议用「标题+日期」命名新版本。
• 默认图片内联 base64 上限约 50KB（maxImageBytes），大截图需压缩或按能力改为描述字段。