leaferjs/leafer-ui：README 来源编辑指南

leaferjs/leafer-ui 的 README 将项目描述为"好用的 Canvas 引擎，轻松实现图形交互与编辑，AI 时代的无限画布引擎。An easy-to-use Canvas engine for effortless graphic interaction and editing , an infinite canvas engine for the AI era."。本文只整理仓库能直接核验的内容，不把星标、Fork 或宣传语当成质量证明。README 在"LeaferJS：好用的 Canvas 引擎"下的说明是：👉 在浏览器里 "跑得动 100 万个图形" 的 Canvas 引擎 👉 可以做 "Figma 级编辑器" 的 Canvas 内核。这给出的首先是项目边界，而不是已经完成的生产验证。

从 README 的"🏗️ 为什么是 AI 时代的无限画布引擎？"和相关条目看，读者可以先判断它是否解决自己的具体问题：🤖 语义化编辑： 结构化场景树让 AI 能像操作 DOM 一样操控图形，构建真正的 AI 协同工作流。。如果你的目标与这段说明不一致，就不应仅凭项目热度采用它。这里保留原项目名、命令和组件名，方便回到一手来源核对。 README 还列出了另一条可核对的信息：⚡ 极致承载力： 突破极限，百万交互图层依然保持丝滑响应，完美承载 AI 生成的海量碎片。。这类原文条目可以帮助读者设计试运行步骤，但不能代替自己的环境测试。

README 把工作方式分散写在"🏗️ 为什么是 AI 时代的无限画布引擎？"等段落中。可确认的线索包括：在 AI 生成内容爆发的今天，图形引擎的挑战已从 "如何画出来" 转变为 "如何编排与精修"：。这篇整理没有把未写出的架构、性能或安全边界补成结论；真正的运行链仍应结合仓库目录、配置文件和版本标签检查。

第一次安装应从 README 给出的入口开始。当前可复核的命令是： npm install leafer-ui # 需使用插件时，推荐同时安装跨平台核心包，防止出现更新版本不同步问题 npm install leafer-ui @leafer-ui/core @leafer-ui/draw 如果仓库没有提供命令，本文不会替它编造安装步骤，而是建议先打开 README 的"🧐 为什么选择LeaferJS？"部分，确认系统依赖、默认端口和首次初始化动作。

日常使用的细节取决于项目实际文档。README 的"🔥 性能表现"段落提到：| 测试项 (100万个可交互矩形) | 传统 Canvas 库 | LeaferJS | 提升 | | :------------------------- | :---------------------- | :----------- | :--------------- | | 首屏创建速度 | 9-15 秒 | 1.28 秒 | 约快 8 倍 🎉 | | 内存占用 | 2-4GB (浏览器可能崩溃) | 320 MB | 约节省 8 倍 | | 单元素拖拽帧率。对于配置文件、环境变量、权限和数据目录，当前稿只记录来源明确的部分；未写明的默认值必须在测试环境中验证，并保留可回滚的配置副本。 同一部分还提到：🛠️ 原生编辑器： 内置 Editor 插件，让AI 生成的内容一键获得精准旋转、缩放、多选等工业级编辑能力。。

README 能确认的限制比宣传页面更重要。当前来源没有证明leaferjs/leafer-ui具备固定的兼容矩阵、服务等级、性能基准或长期支持承诺。README 只明确写到"测试环境: 2K屏笔记本 / Chrome V143.0，数据仅供参考，实际表现取决于硬件性能。"。这类未知项应在选型记录里列为待验证事项，而不是被改写成肯定句。