# 动效实验室 1.21.0 · 几何与路径底座 2026-10-15新增7个真实库案例,专题76个主库案例、完整目录251项/25类,原244项保留。继续更新同一本机项目,入口 http://127.0.0.1:23341/engines/index.html#engine-earcut 。本轮没有公网部署。 ## 接入判断与固定版本 | 主库/官方资料 | 版本 | 许可 | 能力与适配理由 | 本地模块 | |---|---|---|---|---| | [Earcut · 多边形三角剖分](https://github.com/mapbox/earcut) | 3.2.4 | ISC | 把移动的凹多边形拆为三角网格,比较有孔与无孔区域。 | earcut.js | | [Polygon Clipping · 图形布尔运算](https://github.com/mfogel/polygon-clipping) | 0.15.7 | MIT | 观察两个移动多边形的交集、并集与差集。 | polygonclip.js | | [Simplify.js · 轨迹简化](https://github.com/mourner/simplify-js) | 1.2.4 | BSD-2-Clause | 对比原始轨迹与减少采样点后的形状,观察精度取舍。 | simplify.js | | [Perfect Freehand · 手绘笔迹](https://github.com/steveruizok/perfect-freehand) | 1.2.3 | MIT | 把指针轨迹转成笔画轮廓;可直接用鼠标或手指绘制。 | freehand.js | | [Points on Curve · 自适应曲线采样](https://github.com/pshihn/bezier-points) | 1.0.1 | MIT | 用容差控制曲线采样密度,比较控制点、曲线与离散点。 | curvepoints.js | | [SVG Path Properties · 路径长度与切线](https://github.com/rveciana/svg-path-properties) | 2.1.0 | ISC | 用路径长度定位移动物块,并让方向跟随真实切线。 | pathprops.js | | [D3 Interpolate Path · 不同点数路径形变](https://github.com/pbeshai/d3-interpolate-path) | 2.3.0 | BSD-3-Clause | 在节点数量不同的开放曲线之间连续插值。 | pathinterpolate.js | 本轮补充动效所依赖的几何运算,不把这些库都称为独立播放器。Earcut用于多边形网格,Polygon Clipping用于面积布尔运算;Simplify.js减少轨迹节点,Perfect Freehand生成笔画轮廓;Points on Curve按容差采样三次曲线,SVG Path Properties提供长度与切线,D3 Interpolate Path处理不同节点数量的开放路径形变。D3 Interpolate Path是独立插件项目,本轮首次作为主库案例接入;Earcut可能已被其他绘图库作为依赖使用,本轮首次直接展示其API。案例均为代表能力,不表示覆盖全部功能。 版本固定,下载SHA512通过,库代码生成本地ESM。9个安装包许可和通知已保留;splaytree 3.2.3的完整MIT文本在原Readme.md内,按原样保留,不虚构独立LICENSE。Points on Curve的实际源码仓库是pshihn/bezier-points;最初按包名访问points-on-curve仓库失败,随后依照固定包repository、README核对并更正。原React Spring、Rive候选判断延续。 ## 模块、来源及顺序 | 模块 | 来源、版本与处理 | 用户任务与顺序依据 | |---|---|---| | 导航、目录、详情、专题卡片、公共控件 | 继承1.20,新增7项注册、统计和来源入口 | 维持原查找和比较路径,按接近视口装载 | | Earcut / Polygon Clipping | 固定原版库;原创星形、孔洞、六边形、旋转矩形和SVG适配 | 先理解封闭区域如何拆分与组合 | | Simplify.js / Perfect Freehand | 固定原版库;原创201点轨迹、96点带压力示例、笔宽切换及指针输入 | 对比简化线条和生成笔迹轮廓;鼠标或触摸可直接绘制 | | Points on Curve | 原版采样API;原创控制点、辅助线、曲线与采样点 | 从笔迹进入曲线的离散表达,比较容差与节点数量 | | SVG Path Properties | 原版长度、位置、切线API;原创两条路径及朝向图形 | 用长度驱动物块沿路径移动 | | D3 Interpolate Path | 原版interpolatePath;原创不同节点数的开放路径 | 比较路径自身形状随时间变化 | | 播放、暂停、回放、减少动态、视口、清理 | 继承公共MotionInstance;本轮控制器接入共享时钟 | 几何更新按30Hz取时间,未另启库自动定时器;回放恢复默认模式 | | 字体、样式、图片、附属页面 | 继承系统字体、eng-svg和公共界面;本轮无新增第三方CSS、图片、外部字体或子页面 | 图形完全由原创数据与本地计算生成 | | 表单、账号与状态 | 无新增业务表单、账号、数据库;单笔轨迹与模式保存在当前实例内存 | 不跨会话保存绘制;回放恢复内置示例,销毁释放指针捕获及事件 | 逐文件SHA256与库源码gitHead见sources-geometry.json。官方页面及安装源码研究用于API和许可核对,未复制官方演示画面,未声称观察过所有官方动画。 ## 实际工作流记录 单一执行者Codex完成全部工作,辅助工具为网页读取、PowerShell、npm 10.9.3、Node 24.19.0、esbuild 0.28.2、Playwright Chromium 151.0.7922.34、Python/Pillow。没有代理协作或独立评审者。 | 步骤 | 输入、实际调用与工具 | 输出和交接 | 检查、失败及处理 | |---|---|---|---| | 研究 | 读取1.20注册、控制器、测试、打包文件;读取7项官方仓库与固定npm元数据/README | 按面积、轨迹、曲线和路径选定7项 | Points on Curve初始仓库地址失败,按原包repository更正为bezier-points;未用空壳替代 | | 依赖固定 | PowerShell从registry读取明确版本、下载tarball并核对SHA512;npm install --ignore-scripts --legacy-peer-deps | 独立构建目录向打包器交接9个原版包 | 安装无漏洞报告;这是包管理器输出,不代表全面安全审计 | | 构建 | ENGINE_NODE_MODULES、ESBUILD_MODULE指定依赖;Node运行tests/build-geometry-engines.cjs | 7份本地ESM、许可、manifest和便携lock | 主依赖锁定明确版本,去除file:和构建机依赖路径;不放宽CSP或加载CDN | | 接入 | tests/integrate-geometry.cjs写入新注册与路由;新增engine-geometry-studies.js | 76项专题、251项主目录;原界面继续使用 | SVG与中文内容为本轮原创,未改写库算法;手绘采集至多1500点 | | 基础检查 | Node --test tests/framework.test.mjs | 5项框架测试通过 | 唯一ID、统计、参数约束及原业务辅助检查通过 | | 真实动画检查 | Node运行tests/geometry-engines.cjs | 每项起始、运行、中间、结束、减少动态和手机截图,results.json | 7项实际画面变化、按钮变化、暂停画面稳定、回放、减少动态及操作后静止;无页面/控制台错误或失败资源 | | 计算与输入检查 | Node运行tests/geometry-engine-details.cjs | details.json、freehand-mouse.png、freehand-touch.png | 孔洞实际不填色、布尔面积关系、容差节点减少、路径与浏览器原生测量、鼠标及CDP触摸笔迹和回车切笔宽通过 | | 视觉验收 | Python/Pillow运行tests/geometry-engine-sheets.py;view_image查看最新桌面、手机拼图和触摸笔迹 | contact-end.png、contact-mobile.png与触摸输入画面 | 人工复查图形留白、网格孔洞、控制点、曲线与移动物块;与自动截图断言分开记录 | | 保留旧版 | 比较7个历史manifest中的原69个运行模块SHA256 | preserved.json | 69个原运行模块哈希全部一致;旧版证据仍属于旧版,不宣称全库重新视觉验收 | | 来源与打包 | Node运行tests/geometry-engine-docs.mjs;Python运行tests/package-local.py | 当前报告、来源JSON、完整源码ZIP和证据 | ZIP完整性、本地页面与来源入口单独核验;不以打包成功代替公网部署 | ## 实测与限制 Earcut无孔10片、带孔16片,面积相对误差约1.76e-16;用SVG原生isPointInFill确认带孔中央没有三角片。Polygon Clipping四种操作都有输出,验证对称差面积等于并集减交集。固定时间下,Simplify.js从63点减至7点,曲线采样从15点减至7点。SVG Path Properties长度546.300110,浏览器原生测量546.300354;采样位置误差约0.253个SVG单位。 Perfect Freehand真实鼠标输入19点、模拟触摸输入15点均生成可见轮廓,实际画面改变;绘制后减少动态保持静止,键盘回车切换笔宽,回放恢复示例。普通暂停停用绘制,减少动态保留主动绘制;隐藏或离开视口释放正在进行的指针捕获。坐标按SVG实际矩阵转换,不把画布外边距当成路径坐标。 390×844手机触摸模拟逐项截图;320/390/768/1440专题布局无横向溢出,按需加载、销毁和旧Hairline/空间案例抽查通过。未验证实体手机、实体压感笔、所有浏览器或所有官方案例。压力字段支持事件输入,模拟示例压力为生成值,不能据此宣称实体笔压感验收。Earcut示例是有效的不自交多边形,不承诺任意病态几何都正确;布尔运算和采样展示范围仅限本页可核对图形。 新增7份JS共77755字节,gzip估算27882字节,按需加载。本次没有公网部署、账号变动或数据迁移。