ENGINEERING REFERENCE

工程参考

教材负责循序学习；这里保留开源仓库的 SDK 架构、契约、接入和发布文档，适合实现时查阅。

开发文档

11 篇

这些文档面向把 @jason-huang/infinite-canvas-agent 接入真实项目的开发者，记录公共 API、状态所有权、容量模型、失败语义、扩展点和迁移方法。npm 包不包含教材、课程生成服务或部署文档。

普通 Canvas Demo 通常可以完成缩放、平移、新增节点。真实产品的难点是：

本文解释 DocumentStore 、Camera、SpatialIndex、WorkingSet、 RendererPort 和 CommandBus 如何共同工作。它面向两类读者：准备从零构建无限画布的人，以及希望把运行时逐层接入现有 Canvas/Konva 项目的人。

无限画布的缓存问题通常不是“文件有没有保存”，而是同一时刻有多少图片被解码、多少纹理在 GPU、多少视频播放器仍挂在 DOM。 ResourcePool 管理的是这类可回收的运行时资源。

持久化的目标是重启后恢复用户文档及与它严格匹配的撤销历史。它不负责恢复已经解码的图片、 GPU 纹理、Konva Group、HTMLVideoElement、Blob URL 或正在播放的时间点。

src/node 是桌面宿主使用的源码级 Node 适配层。它与浏览器安全的 Core 分离，不依赖 Electron、产品 SDK、账号、Provider 或应用路径。消费仓库直接合并这些 .mjs 源码；当前开发版本没有把它作为 npm subpath 发布。

这个包不内置 Agent、模型 SDK、Provider、Prompt、API Key 或业务节点 Schema。它提供的是 “如何让任意 Agent 安全地读有限上下文，并通过同一 CommandBus 修改画布”的方法。

@jason-huang/infinite-canvas-agent 是一组独立端口和模块，不是新的应用壳。老项目可以继续拥有 React/Vue、Pinia/Redux、Konva Stage、Canvas 输入事件、路由、业务 Schema、持久服务和模型 Provider，只接入当前真正需

本文是公开 API 的结构化速查。行为语义与设计原因请继续阅读对应专题文档。

“代码存在”“Demo 能跑”“npm dry-run 成功”“包已发布”是不同状态。本仓库的发布流程把类型、行为、浏览器构建、隐私门禁和真实 tarball 消费验证拆开，任何一步失败都不能用下一步替代。

最终站点由发布宿主仓库负责。本仓库只保留可选 Agent Gateway 容器，不再构建或服务一套重复站点。