一个数据模型搞定审批、评论与改写：proof-sdk 统一 Marks 系统全解

【免费下载链接】proof-sdkProof SDK: open-source collaborative editor, provenance model, and agent HTTP bridge项目地址https://gitcode.com/gh_mirrors/pr/proof-sdk点击查看免费下载 在开源项目proof-sdk一个带溯源能力的协同 Markdown 编辑器中审批、评论、插入、删除、改写全部共用同一套统一 Marks 系统一个Mark数据模型、一种存储格式、一套装饰渲染体系。本文带你零基础看懂这套设计以及它如何让 AI Agent 像人类一样在文档里留痕、评审和改写内容。一、为什么需要统一 Marks传统编辑器里评论是一棵树、修订是另一棵树、溯源标记又是第三棵树——各自存储、各自渲染、互不兼容。proof-sdk 的做法是一切皆 Mark审批、标记、评论、建议全部是 mark带来四个设计原则原子化Atomic每个 mark 自包含独立增删不影响他人细粒度Granular精确锚定到具体文本位置可组合Composable不同类型的 mark 可自由叠加到同一段内容可扩展Extensible新增 mark 类型无需改动整体架构核心定义在 src/formats/marks.ts 文件头部注释中写得很直白Everything is a mark - approvals, flags, comments, and suggestions. One data model, one storage format, one decoration system.二、7 种内置 Mark 类型一览内置类型定义在MarkKind联合类型中见 src/formats/marks.ts类型kind用途额外数据authored记录每段内容的作者溯源无靠by字段区分人/AIapproved内容已通过审批签字无flagged标记需要关注的内容可选note备注comment评论讨论串text、thread、replies、resolvedinsert建议插入新内容content 状态delete建议删除原文状态replace建议改写原文新content 状态每种类型都有对应的工厂函数比如 createComment、createReplaceSuggestion调用方无需关心 ID 生成、时间戳、引文归一化这些细节。三、解剖一个 Mark核心字段速览一个Mark对象的结构见 src/formats/marks.ts非常紧凑字段说明id/kind唯一标识与类型by操作者采用统一命名human:张三或ai:claudeatISO 时间戳range主锚点文档内的{ from, to }位置quote兜底锚点目标内容的归一化文本orphaned原文被删/移动后置为truedata按类型变化的载荷评论文本、建议内容、状态等✨ 亮点在by字段人类和 AI 用同一个身份命名空间human:/ai:/system:前缀判定函数见 isHuman / isAI这使得AI 写的多少、人写的多少这类溯源统计可以基于同一份数据直接算出calculateAuthorshipStats。四、锚点如何不失准range 优先、quote 兜底文档会不断被编辑位置随时漂移。proof-sdk 采用双锚点策略解析逻辑见 resolveMark先用range位置还在合法区间内直接命中 ✅range 失效则用quote在文档文本中搜索归一化后的引文resolveQuote 支持精确匹配、前缀匹配、模糊匹配三级降级都找不到 → 标记为orphaned孤儿 mark不会静默丢失后续可清理purgeOrphanedMarks同时编辑发生后所有 mark 的位置会由 updateMarkRangesAfterEdit 统一重算——编辑落在 mark 内部、跨越边界、还是整体吞掉 mark都有对应的处理分支。五、Marks 如何存进 MarkdownSpan 锚 PROOF 元数据块proof-sdk 的文档就是纯 MarkdownMarks 用两个层面持久化① 正文内联 span 锚点每个 mark 在正文中被序列化为带data-proof属性的 HTML span如span>赞分享【免费下载链接】proof-sdkProof SDK: open-source collaborative editor, provenance model, and agent HTTP bridge项目地址https://gitcode.com/gh_mirrors/pr/proof-sdk点击查看免费下载相关推荐Apache Beam 总览统一批流处理编程模型、SDK 与 Runner 体系全解析Apache Beam 总览统一批流处理编程模型、SDK 与 Runner 体系全解析 Apache Beam 是一个开源、统一的编程模型用于定义 批处理批处理流处理大数据一文搞定多版本Stable DiffusionDiffusionBee模型系统全指南一文搞定多版本Stable DiffusionDiffusionBee模型系统全指南 你还在为本地部署Stable Diffusion时的版本兼容问题头疼吗人工智能大模型媒体生成本地部署AI 应用企业级人脸识别实战如何用CompreFace在30分钟内构建安全可靠的识别系统企业级人脸识别实战如何用CompreFace在30分钟内构建安全可靠的识别系统 在数字化转型浪潮中 企业级人脸识别系统 已成为众多行业的基础设施需求。然而人工智能计算机视觉后端AI 应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考