后端【免费下载链接】automergeA JSON-like data structure (a CRDT) that can be modified concurrently by different users, and merged again automatically.项目地址https://gitcode.com/gh_mirrors/au/automerge点击查看免费下载导读本文基于 Automerge JavaScript 实现automerge/automerge的 3.5.0 版本变更记录javascript/CHANGELOG.md系统解读该版本相对 3.4.1 的全部变化新增的 change 作者元数据能力getAuthor/getAuthors、对__proto__键赋值的RangeError安全加固以及针对大列表插入、富文本块补丁、性能回归等多处关键修复。通过对照 javascript/src 与 rust/automerge-wasm/src/lib.rs 的源码实现和 javascript/test 中的测试用例读者可以理解每一项变更的底层原理、正确用法与升级注意事项。版本背景3.5.0 相对 3.4.1 的变更范围3.5.0 是 Automerge JavaScript 包的一个功能与修复并重的版本。变更记录以三项分类组织Added新增 change 作者author元数据写入与查询能力Changed__proto__键赋值行为收紧改为抛出RangeErrorFixed一批与补丁应用patch application、大变更性能、富文本与片段 API 相关的修复。下文逐一展开并在每个条目下补充对应的源码与测试证据。新增为 change 附加作者元数据核心能力3.5.0 起可以在创建文档或产生变更时附加一个作者标识它被记录在 change 的元数据中。从 Automerge 的角度看作者是一个不透明opaque的十六进制字符串——库本身不解释其语义你可以用它承载用户 ID、会话 ID 或任意自定义标识。对应的 JS 层 API 定义在 javascript/src/implementation.tsgetAuthorT(doc: DocT): Author | null返回文档当前头部 change 的作者未设置时为nullgetAuthorsT(doc: DocT): Author[]返回文档变更历史中出现过的全部作者getAuthorForActorT(doc: DocT, actor: ActorId): Author | null按 actor 查询其关联作者getActorsForAuthorT(doc: DocT, author: Author): Actor[]反向查询某个作者对应的所有 actor。作者信息在变更历史change history中持久记录因此merge之后依然可以追溯到各分支的作者来源。WASM 绑定层实现这些 JS API 最终转发到 WASM 绑定层实现在 rust/automerge-wasm/src/lib.rsgetAuthorSome(self.doc.get_author()?.to_string())作者未设置时返回nullgetAuthors遍历doc.get_authors()收集为数组getAuthorForActor先将十六进制字符串解码为ActorId再查询映射getActorsForAuthor先通过Author::try_from校验格式非法时返回BadAuthor错误配套的setAuthor(author)用于写入作者元数据。值得注意的是getAuthorForActor/getActorsForAuthor在 JS 层的implementation.ts中均有对应封装见 javascript/src/implementation.ts说明作者与 actor 之间存在可逆的双向映射可用于在多人协作中把物理 actor与业务作者身份关联起来。测试用例验证作者 API 的完整行为在 javascript/test/basic_test.ts 中被覆盖可作为最佳实践参考未设置作者时getAuthor返回nullfrom({...}, { author: aabbcc })与init({ author: ff00ff })均可在初始化时指定作者clone(doc, { author: ffaa00 })支持在克隆时更换作者两个带不同作者的分支merge后getAuthors返回两个作者的有序集合如[aabbcc, ffaa00]getAuthorForActor(doc, actor)返回当前 actor 对应的作者getActorsForAuthor(doc, author)返回该作者的全部 actor。变更__proto__键赋值现在抛出 RangeError变更内容3.5.0 起向 Automerge 文档或其嵌套对象赋值为__proto__键会抛出RangeError消息为The key __proto__ is not allowed in Automerge documents。该保护不仅作用于change回调中的赋值也覆盖传给from的初始状态对象在change中赋值的嵌套对象批量插入路径。这一收紧是为了防止 JavaScript 原型链污染__proto__是对象原型访问器若被当作普通键写入文档可能意外修改原型或造成赋值语义混乱。源码实现保护逻辑分两层代理层赋值拦截文档对象的赋值经由 Proxy 拦截见 javascript/src/proxies.ts当键为__proto__时直接抛出RangeError批量插入校验validateForBatchInsert见 javascript/src/proxies.ts在递归校验批量插入值时对每个键名检查k __proto__。关于批量校验只遍历自身可枚举属性own enumerable properties这一细节validateForBatchInsert使用Object.keys(value)遍历对象键Object.keys只返回自身可枚举属性、不包含继承属性因此继承链上的属性不会被误检或误写入避免了校验逻辑自身触发原型链访问。测试覆盖javascript/test/proxies.ts 中专门设有__proto__ handling测试组覆盖四种场景在 change 回调中给d[__proto__]赋标量值 → 抛RangeError赋对象值{ x: 1 }→ 抛错且不污染原型初始状态from({ [__proto__]: false })→ 抛错嵌套对象d[nested] { [__proto__]: { x: 1 } }→ 抛错。修复补丁应用与性能问题大列表插入不再触发 Maximum call stack size exceeded此前应用合并后的补丁consolidated patches时若一次性向列表插入大量元素会把每个元素逐一传给单个splice调用导致递归或参数展开过深而触发 V8 的调用栈上限错误。3.5.0 的修复思路是WASM 绑定层按有界分块bounded chunks应用插入而不是把全部元素塞进一次splice。JS 侧的补丁应用入口见 javascript/src/apply_patches.tsapplyInsertPatch对数组目标使用原生parent.splice(prop, 0, ...patch.values)而对文本目标则在 Automerge 文档内逐块调用splitBlock分块策略确保单次调用规模受限从而避免调用栈溢出。applyPatch/applyPatches支持富文本块文本中的嵌入块embedded rich-text blocks此前在补丁应用时无法正确处理3.5.0 起应用于普通 JavaScript 字符串时块以对象替换字符UFFFC\ufffc表示对块内容的更新被忽略。见 javascript/src/apply_patches.ts其中用\ufffc.repeat(patch.values.length)填充插入位置应用于 Automergechange回调内时块数据被完整保留。applyPatch首先通过resolveEmbeddedBlock见 javascript/src/apply_patches.ts解析补丁路径是否命中块标记命中则先在块的旧值上应用补丁再调用updateBlock写回新值从而实现块内容的可编辑更新。这套机制使外部 diff / patch 管线能够安全地表示和更新富文本块而不会丢失块的结构信息。暴露既有文本对象的 marks 与块内容此前生成的补丁若涉及一个已存在的文本对象可能丢失其 marks标记、嵌入块与块内容。3.5.0 修复了这一点补丁现在会携带这些富文本细节从而修复了恢复已删除富文本时 diff 不完整的问题——也就是说删除后又恢复的富文本内容能够被正确重建。大变更中的性能回归修复了因反复扫描 pending operations 来检查对象可见性而导致的性能回归。在变更规模很大时这种重复扫描会让时间复杂度退化修复后可见性检查的扫描路径得到优化大变更的补丁生成不再出现可感知的退化。计数器增量与尾随插入的定位修复修复了一个较隐蔽的排序问题在 change 应用过程中当计数器增量counter increment紧跟一个尾随插入trailing insert之前时列表插入的定位可能出错进而破坏操作分组operation grouping导致后续 change 重建change reconstruction失败。该修复保证了操作排序的正确性避免由此引发的数据重建错误。实验性getFragmentsAPI 的 checkpoints 调整getFragments与 fragment 元数据 API仍为实验性中checkpoints不再包含 fragment 自身的 headcheckpoints 现在同时排除 head 与边界哈希boundary hashes而 head 仍然保留在members中。这使 checkpoints 的语义更精确避免与成员列表信息重复。文档与示例修正将文档示例中不存在的forkAPI 更正为clonefork 并非公开 API修正了 TypeScript 示例的格式问题。升级与迁移建议面向从 3.4.1 升级到 3.5.0 的用户总结如下注意事项新增能力可直接使用作者元数据是纯增量 APIfrom/init/clone的author选项与getAuthor/getAuthors/getAuthorForActor/getActorsForAuthor查询函数不会破坏现有代码__proto__是破坏性行为变更如果现有代码依赖向文档写入__proto__键应属极少见情况升级后会抛出RangeError需改用其他键名富文本补丁行为增强applyPatch/applyPatches现在会保留嵌入块数据依赖块更新被忽略这一旧行为的代码需要重新审视大列表插入更健壮过去以单次超大 splice方式触发调用栈溢出的场景已修复大列表批量插入可放心使用实验性getFragments/ fragment 元数据 API 的checkpoints语义有调整使用方请按新语义核对输出。总结Automerge JavaScript 3.5.0 是一个兼顾功能与健壮性的版本作者元数据把变更归属带入了协作数据模型__proto__安全加固堵住了原型链污染入口而大列表分块插入、富文本块补丁、计数器排序与性能扫描等一系列修复则提升了补丁应用的正确性和大变更场景下的可用性。配合 javascript/src/implementation.ts 与 rust/automerge-wasm/src/lib.rs 的源码实现以及 javascript/test/basic_test.ts 与 javascript/test/proxies.ts 中的测试用例开发者可以完整把握每一项变更的边界与正确用法。赞分享后端【免费下载链接】automergeA JSON-like data structure (a CRDT) that can be modified concurrently by different users, and merged again automatically.项目地址https://gitcode.com/gh_mirrors/au/automerge点击查看免费下载相关推荐Vitess v24.0.2 补丁版本发布解读安全修复、连接池与 VReplication 稳定性加固Vitess v24.0.2 补丁版本发布解读安全修复、连接池与 VReplication 稳定性加固 Vitess v24.0.2 是 v24.0 系列的一数据库分布式数据库云原生后端数据存储NumPy 1.18.1 补丁版本全解析整数梯度修复、构建链修复与 CI 加固NumPy 1.18.1 补丁版本全解析整数梯度修复、构建链修复与 CI 加固 导读 本文基于仓库内的官方发布记录 doc/changelog/1.18.1科学计算数据分析Vitess v22.0.3 补丁版本发布全解析40 个 PR 的稳定性修复与安全加固Vitess v22.0.3 补丁版本发布全解析40 个 PR 的稳定性修复与安全加固 导读 Vitess v22.0.3 是 v22 系列的第 3 个补丁版数据库分布式数据库云原生后端数据存储上一篇终极罗技鼠标宏配置指南PUBG绝地求生压枪脚本快速上手教程下一篇Zotero插件市场终极指南3步打造你的高效学术工具箱创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考