ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

cloudflare-os Workspace Docs 蓝图深度解析:基于 Durable Object 的实时协同富文本编辑器

cloudflare-os Workspace Docs 蓝图深度解析:基于 Durable Object 的实时协同富文本编辑器 人工智能AI 应用AI AgentAgent 沙箱AI 安全治理【免费下载链接】cloudflare-osAgent workspace built on Cloudflare Workers for creating documents, building apps, and running agents with your company’s context and systems.项目地址https://gitcode.com/gh_mirrors/cl/cloudflare-os点击查看免费下载本文聚焦 cloudflare-os 仓库中预置的workspace-docs文档蓝图Blueprint它是一套单文档、Google Docs 风格的富文本编辑器由 Cloudflare Durable Object 持久化权威快照以块block为粒度实现实时协作、协作光标Presence与冲突安全并发编辑。读完本文你将掌握该蓝图的整体架构、实时数据模型、块级乐观并发策略、Presence 实现、程序化填充 API 与导出机制并能在此基础上为 Agent 工作区二次开发同类的文档类 Gadget。蓝图定位Agent 工作区的文档输出格式workspace-docs是 cloudflare-os 仓库中随包发布的捆绑蓝图bundled blueprint之一其元数据定义在 blueprint.jsonblueprintId为format.document是安装与分组的关键历史保留的format.前缀见 bundled-blueprints 说明输出类型output.id为document、noun为 Doc作为 Workshop 后端 Outputs 页面上文档类输出的分组键描述为Use to write, format, and edit rich text documents interactively or with natural language即既支持人直接交互编辑也支持 Agent 以自然语言驱动生成文档内容蓝图自带revision当前为 10与version当前为 9作为内容版本与 R2 keybindings为空——本蓝图没有任何必需绑定可选的GOOGLE_DOC绑定由部署方自行配置。一句话概括它的能力单文档、Google Docs 风格的富文本编辑器具备 Durable Object 持久化、实时块更新、协作者在线状态以及冲突安全的并发编辑见 files/README.md。架构总览server.js 权威协调 client.js 可编辑表面该蓝图的运行时只有两个文件构建产物client.js与server.js源码为 client.ts 与 server.ts共享的类型契约在 lib/protocol.tsserver.jsDurable Object是权威的协作协调者。它存储一个原子的document:v2快照内含标题、全局修订号revision、有序的块列表、每个块的版本号以及修改时间。所有写操作经由MutationQueue串行化保证无论 RPC 如何交错每次操作都基于前一次操作提交后的权威状态执行。client.js围绕一个contenteditable表面构建整个 UI。文档的每个顶层元素都带稳定的data-block-id本地输入是乐观optimistic的发生变化的块在约220 ms防抖后被发送到服务端。客户端通过 Capn Web 的RpcTarget订阅服务端服务端把被接受的块操作与临时的 Presence 事件广播给每个已连接客户端。两个共享库ui与sync蓝图的代码分为两层界面与协作的通用骨架来自共享库编辑命令、粘贴清理器、块模型、远程光标绘制与导出格式是 Docs 蓝图自己的实现。共享库位于 packages/bundled-blueprints/libraries构建时会把蓝图引用的库代码内联进它发布的client.js/server.js因此从蓝图创建的 Gadget 自带一份创建时点的库副本运行时不会解析包名Agent 之后改写的 Gadget 也无法再 import 库。libraries/ui/client绘制界面外壳——el元素构造器、共享图标表、工具栏的按钮/分组/取色器/下拉框、代替沙箱中被屏蔽的window.prompt的页内对话框、保存状态圆点以及读取/缩小/重编码被选择、拖入或粘贴的图片prepareImage默认maxDimension1600px、data URL 上限 1.4M 字符GIF 在 2.7M 字符内保持动画其余转 WebP、失败降级 JPEG。libraries/sync/client浏览器端的协作循环——防抖、串行、带重试的保存调度器SaveSchedulerDEBOUNCE_MS防抖flush()串行化保存期间再次 flush 会折叠成一次失败按RETRY_BASE_MS指数退避至RETRY_MAX_MS成功后复位、Presence 名单PresenceRoster与节流上报器PresenceReporterTHROTTLE_MS节流、HEARTBEAT_MS心跳、STALE_MS超时清除、以及供服务端回调的RpcTarget封装createSubscriber。libraries/sync/serverDurable Object 端的协作骨架——变更队列MutationQueue、订阅者注册表SubscriberRegistry带 join/leave Presence 钩子、以及逐块乐观并发规则applyVersioned。实时数据模型版本化的有序块持久化的文档结构类似于节选自 files/README.md{ revision: 42, title: Project plan, blocks: [ { id: b_…, html: h1>赞分享人工智能AI 应用AI AgentAgent 沙箱AI 安全治理【免费下载链接】cloudflare-osAgent workspace built on Cloudflare Workers for creating documents, building apps, and running agents with your company’s context and systems.项目地址https://gitcode.com/gh_mirrors/cl/cloudflare-os点击查看免费下载相关推荐Cloudflare Agents Workspace 深入解析基于 Durable Object SQLite R2 的 Agent 虚拟文件系统Cloudflare Agents Workspace 深入解析基于 Durable Object SQLite R2 的 Agent 虚拟文件系统 本篇AI AgentAgent 框架后端云原生MCP 服务实时通信Cloudflare Codemode Runtime 深度解析基于 Durable Object facet 的持久化执行引擎Cloudflare Codemode Runtime 深度解析基于 Durable Object facet 的持久化执行引擎 Codemode 让模型通过AI AgentAgent 框架后端云原生MCP 服务实时通信终极Nuke特效工具包150免费插件彻底改变你的视觉特效工作流终极Nuke特效工具包150免费插件彻底改变你的视觉特效工作流 Nuke Survival ToolkitNST是一套包含150多个专业级插件的 免费NAI AgentAgent 框架后端云原生MCP 服务实时通信上一篇如何用Mermaid Live Editor告别绘图烦恼免费在线图表编辑终极指南下一篇SMUDebugTool解锁Ryzen处理器隐藏性能的三大实战技巧创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表