# Hairline 全量专题 · Motion Lab 1.13.0 2026-10-14。用户要求将 Hairline 全部加入现有动效实验室。原实验室 1.12.0 的 142 项和 23 分类保留,新增 33 项、1 类,现为 175 项、24 分类。实验室沿用本机运行,没有另建服务器部署,也没有改动企业网站、业务数据或 Skill。 ## 入口与使用 专题页:[/hairline/index.html](index.html)。主目录:[/#hairline-terrain](/#hairline-terrain)。当前检查使用既有本机服务 http://127.0.0.1:23341/;默认启动端口仍可通过 PORT 配置。 专题提供全部图形、八个用途分类、搜索、浅/深主题、全局与逐项强度、暂停、回放和减少动态。接近视口后挂载,离开视口/隐藏标签页后休眠。原版鼠标接管自动演示,触摸保留响应。暂停冻结绘图与CSS过渡;减少动态停止自动演示和两种环境运动,保留即时手动响应。系统减少动态优先,取消后恢复此前选择。 每项说明先描述对象与实际响应,再给出用途建议和操作提示,最后提供参数与主目录入口。排序继承上游公开列表,保留与原图形ID的对应;分组和搜索服务实验室选型,不据此生成客户网站栏目。强度含0与1端点。原版没有通用速度参数,主面板禁用速度和任意颜色,主题在专题页选择;没有伪造控制能力。 ## 实际工作流 执行者:Codex 单一执行者。辅助工具为 Git、HTTP/官网阅读、PowerShell文件操作、Node.js 24.19.0、esbuild 0.28.2、Playwright和真实浏览器。最初Edge运行中途关闭,最终复验使用已安装的Chromium headless 151.0.7922.34;没有子代理或独立评审者。 | 步骤 | 输入与实际调用 | 输出与交接 | 检查及证据 | |---|---|---|---| | 上游研究 | Git浅克隆;读取 main 的 README、package.json、core、mount、React、33图形、Skill、CI与测试;官网 docs/inspo | 锁定上游0.5.0、提交a2217852fed6d1a4f20bc7d43d4fad1a3de117b8 | 源码与官方说明研究;官方浏览器打开超时,没有倒写为原版视觉验收 | | 定位原工程 | 读取现有实验室README、主目录、渲染器、运行器、打包脚本与测试;本机healthz | 原工程1.12.0,142项/23类,既有23341服务 | 保留原目录、偏好存储、案例、许可证和历史记录 | | 保留上游 | 复制包src、package.json及MIT许可证到vendor/hairline/upstream | 原始TS源码与许可作为可核对来源 | 原始文件SHA-256见sources.json | | 构建适配 | Node运行tests/build-hairline.cjs;esbuild0.28.2打包 | 共享ESM 123242 bytes,gzip 52613 bytes;交给framework/hairline.js | 上游源码不覆盖;暂停时钟、每stage减少动态、输入暂停、构建补丁明示 | | 主目录接入 | tests/integrate-hairline.cjs;新增catalog/renderer;现有MotionInstance外部引擎标记 | 主目录33项可单独挂载,无重复外部绘图RAF | framework.test.mjs 五项检查;原142项ID保留 | | 专题与状态 | 原创hairline/index.html、app.js、style.css和中文catalog | 可筛选长页、逐项控制、深链、本机偏好 | 搜索/无结果、八组、主题、强度端点与响应布局 | | 真实浏览器 | Node tests/hairline.cjs、tests/hairline-lifecycle.cjs及tests/hairline-visual.cjs,Playwright驱动Chromium | 浏览器检查JSON、截图与状态对比 | 33项桌面实际指针SVG变化、逐项暂停和回放通过;浏览器151.0.7922.34;33项手机尺寸减少动态触摸检查通过 | | 画面观察与交付 | 阅读最新桌面33项、手机33项接触表,主预览320px画面,六项实际起中止截图;更新README与来源 | 主入口与专题入口、完整源码与许可 | Codex读取最新截图,确认图形可见、没有截断/控件遮挡;ZIP校验及文件摘要见evidence/hairline/package.json | ## 改写边界与来源 共享stage增加每个实例的暂停与减少动态状态;暂停偏移时钟避免恢复后基于绝对时间跳过整个过渡。图形里的performance.now调用统一改为该stage时钟。减少动态标志只在各stage绘图回调期间设置并还原,不影响其他实例;减少动态的tick使用dt=0,并在一次绘图后休眠,保留输入wake,避免荧光点阵的余辉继续衰减或空转。指针在暂停期间离开后,恢复时解除自动演示的接管状态。绘图、投影、默认构图、物理参数和原版命中算法保留。 实验室主运行器对这个外部引擎不再生成额外持续RAF。控制器负责resize、视口、文档可见性、系统偏好和清理。专题与主目录共用一个vendored模块。独立接入需复制 framework/hairline*.js、vendor/hairline/ 和 hairline/preview.css(主预览)或使用专题style.css;保留第三方MIT许可。重建可安装esbuild0.28.2并运行tests/build-hairline.cjs;ESBUILD_MODULE用于指定已有安装,不含本机绝对路径配置。 | 模块 | 来源与处理 | |---|---| | 主导航、主目录、参数面板 | 继承实验室1.12.0,新增Hairline分类与入口;原案例未重写 | | 专题导航、筛选、卡片、说明、控件与链接 | 本次原创;图形名与行为参照上游,中文说明与用途建议原创 | | 图形与共用几何、弹簧、缓动、主题 | Hairline0.5.0 / MIT;暂停与每实例减少动态按上述范围改写 | | 图片、字体、图标 | 没有外部图片/字体新增;SVG几何来自上游,文字使用系统字体,无附加装饰箭头 | | 搜索与偏好 | 无外部提交;新偏好键motion-lab-hairline,旧主面板键沿用 | | 逐项图形 | 下表;共同适配来源framework/hairline.js与tests/build-hairline.cjs | | 图形 | 用途分组 | 可核对来源 | 类型 | |---|---|---|---| | 卡片翻阅 / riffle | 界面 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/riffle.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 柱阵地形 / terrain | 数据 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/terrain.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 窗口分层 / exploded | 界面 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/exploded.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 荧光点阵 / phosphor | 数据 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/phosphor.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 减速传送带 / slow | 机械 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/slow.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 惯性转台 / turntable | 机械 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/turntable.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 键盘涟漪 / keyboard | 设备 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/keyboard.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 楼层电梯 / elevator | 机械 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/elevator.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 手机拆层 / phone | 设备 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/phone.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 笔记本开合 / laptop | 设备 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/laptop.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 终端历史 / terminal | 代码 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/terminal.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 服务器机架 / cabinet | 设备 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/cabinet.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 提交分支 / branches | 代码 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/branches.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 保险库转盘 / vault | 安全 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/vault.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 储物柜门 / lockers | 安全 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/lockers.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 挂锁开合 / padlock | 安全 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/padlock.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 配线面板 / patch | 连接 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/patch.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 卫星天线 / dish | 连接 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/dish.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 路由器天线 / router | 连接 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/router.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 空白纸放大镜 / loupe | 空状态 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/loupe.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 筛网分层 / sieve | 空状态 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/sieve.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 空衣架轨道 / rail | 空状态 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/rail.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 插头连接 / plug | 空状态 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/plug.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 立体问号 / query | 空状态 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/query.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 空抽屉 / drawer | 空状态 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/drawer.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 空购物篮 / basket | 空状态 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/basket.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 零数据图表 / plot | 空状态 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/plot.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 中心连接 / hub | 连接 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/hub.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 逐段路由 / relay | 连接 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/relay.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 散点归树 / settle | 连接 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/settle.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 代码格式化 / format | 代码 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/format.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 依赖重建 / rebuild | 代码 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/rebuild.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | | 调用栈展开 / stack | 代码 | [原版源码](https://github.com/lucasmarkes/hairline/blob/a2217852fed6d1a4f20bc7d43d4fad1a3de117b8/packages/hairline/src/figures/stack.ts) | 引用图形 / 原创中文与用途 / 改写生命周期 | ## 失败、修正与验证限制 最初尝试官方浏览器演示打开超时;后续在本机实际集成页进行验证,不能据此宣称官方页面视觉通过。构建首试遇系统Node22进程异常,改用已安装的Node24;CRLF导致补丁目标不匹配,统一构建输入换行后成功。初轮浏览器测试把滑块数值写成“.5”,浏览器拒绝该输入,改用实际Home/End键与合法数值;保留initial-test-failure.json。Edge两次中途关闭,原因未定位,记录browser-interruption.json,改用已安装的Chromium完成复验。自动演示有每实例错峰等待,测试改为等待实际画面变化;系统偏好事件异步到达,测试等待控件恢复。手机检查发现Phosphor触摸后在减少动态下仍衰减,按上文dt=0/一次绘图休眠修正共享适配,并重新运行两套33项检查。六项起中止截图使用具体命中点,Relay与Rebuild按上游tour点选中叶节点/根包,避免在空白处宣称触发。最终结果见最新JSON,失败记录不作为通过证据。 测试环境为桌面Chromium和浏览器手机/触摸模拟,不是实体手机或微信。手机中心点触摸29项产生变化,4项中心点不是有效命中,保持静止;桌面四个命中位置检查33项均产生实际SVG变化。所有历史142案例未逐项复验,执行既有规格/参数/状态测试,并抽查未改类别。没有运行上游完整CI,也没有宣称通过上游所有测试。图形是概念展示,没有接入真实库存、网络、安全、运输或构建数据。体积是本次适配文件实测,不引用原官网数字作为实测。没有性能跑分或中端手机帧率认证。 逐模块与逐文件摘要见[sources.json](sources.json)。上游[MIT许可证](../framework/vendor/hairline/LICENSE)保留;参考研究发生在本次增量,不改写历史设计来源。