单文件 HTML 工具体系

定位 Positioning

单文件 HTML 工具体系：每个工具都是一个完整的、可离线双击运行的 HTML 文件，无框架、无运行时依赖、无 CDN、无远程字体。构建期自动打包独立版本，文件名稳定可分享。

设计原则 Principles

• 源文件契约：每个工具只有一个源文件 tools/<tool-id>.html，front-matter 的 id 必须与文件名一致。
• 离线优先：原生 HTML/CSS/JS，构建期把共享资源内联进单文件，file:// 下可用。
• 移动端先行：320px+ 起设计，控件可换行、目标尺寸约 36px，尊重 prefers-reduced-motion。
• 圣所风格：工业面板、终端元数据、黄铜/锈色/琥珀状态，克制的动效。

构建链 Build Chain

scan-tools → astro build → bundle-tools → validate-tools

扫描器生成在线镜像与工具索引卡片，打包器把共享资源内联到独立下载版本，校验器守住离线契约。