机器解剖室 v2

机器解剖室 v2

做了什么

v1 只有六个构件讲「数据怎么流」,回答不了「这台机器到底用了哪些技术」。v2 把项目真实在用的全部技术栈和工具解剖上墙:

  • 装备铭牌区:每个构件的抽屉在「真实机制」和「活数据」之间新增第四层——铭牌(装备名 + 一句人话职责 + 版本号/真实路径,铆钉点随构件色)。六构件共 24 项:点火器×2、图纸室×4、传动间×4(hooks 四件套 / CodeGraph / 技能体系 / Playwright)、仓库×2(Obsidian / content-inbox)、蒸馏塔×3(脚本车间 / analyze / content:weekly)、发货台×9(Astro / TS / three / GSAP / Phaser / rss+sitemap / GitHub→CF Pages / CF Functions+KV+火山搜索 / HyperFrames)。
  • 全车装备清单:头栏新增「装备清单」按钮,打开全屏覆盖层,六构件分栏总览 24 项,点任意一项关掉清单直达对应构件抽屉。桌面 3 列、平板 2 列、手机 1 列,flat 渲染器天然继承同一份数据。
  • 活数据扩编:版本号构建时读 package.json(HyperFrames 读 video/site-intro 的),数量构建时数文件(hooks×4、脚本×9、视频 8 期囤稿)。手写的只有名字和人话——本次施工就抓到一颗化石:记忆库里写着「Astro 5」,实际早已升到 7.1.3,首页流水线窄带的「Astro 5 构建」也顺手改成了读真实版本。
  • 口径裁决(grill 五问定稿):vision 路由(环境层配置)与 git/系统环境(公共地基)不入册;Remotion 不入册——仓库视频管线实际是 HyperFrames,remotion-markup 仅作动效语系参考,体检报告不写没装上的螺丝。

过程与坑

  • grill 五问定稿:形态(铭牌附着 vs 推翻重做)→ 口径(24 项边界)→ 位置(抽屉四层 + 覆盖层,3D 不加物体)→ 活数据(能量则量)→ Remotion 归属,逐问确认后才动手。
  • hidden 属性被 class 的 display 顶掉:清单覆盖层用 [hidden] 控制显隐,但 .mt-inventory { display: flex } 同优先级且作者样式压 UA 样式,导致覆盖层永远可见。补 .mt-inventory[hidden] { display: none } 修复。
  • headless 整页截图全黑、元素截图正常:GPU ReadPixels 疑似竞态,QA 截图改走 locator.screenshot() 元素级截屏,稳定出图。
  • QA:构建 82 页通过;Playwright 双端 14 项断言全过(清单 24 项 / 版本铭文 / 活计数 / 点击跳转抽屉 / Esc 逐层撤退 / 移动 flat 继承)。

下一步

  • 四层全链路视图迁 /workbench 的债仍在(v1 遗留)。
  • 各构件「最近活动时间」、传动间触发趋势等更深的活数据可继续加。