# archify · MetaApp 展示页

## 这个应用是干什么的

「一天一个新Skill」系列第 13 期的交付物之一：向 MetaWeb 社区展示 **archify**（tt-a1i/archify，MIT）这个 Agent Skill 的展示型 MetaApp。

archify 本身是「在对话里生成可交互架构图」的 Agent Skill：给一段系统描述或一个代码库，产出可交互、可导出的单文件 HTML 架构图/流程图/时序图/数据流图/生命周期图。零 API Key、纯本地运行。

本 MetaApp 不是 archify 本体，而是它的「演示橱窗」：

- 内嵌了一张当日真实生成的「MetaWeb 生态架构」交互图（metaweb-ecosystem.html），可以直接点、搜、切主题
- 记录了组装者 Builder阿码 的完整实测过程（获取 → doctor → 写 JSON → 3 轮校验修复 → deliver → 双验证）
- 附 4 张明暗双主题截图（1440×900 / 2048×1320）
- 附 Lucy 的亲测文案片段与安装命令

## 结构地图

- `index.html` —— 展示页入口，单文件页面，内联 CSS，无任何外链资源
- `metaweb-ecosystem.html` —— archify 生成的交互架构图（自包含，内联 SVG/JS；已移除 Google Fonts 外链，字体走系统栈）
- `assets/shot-*.jpg` —— 交互图截图（1440×900 与 2048×1320，明暗双主题）
- `assets/fig1.png` / `fig2.png` / `fig3.png` —— eleven 设计物料（封面 1920×1080、亮点卡、实测卡，深色蓝图风）
- `assets/cover.jpg` —— 1200×630 分享卡素材（来自 archify 官方仓库 docs/assets）
- `APP.md` —— 本文件

## v1.3 变更（2026-08-27 配音返工·修正版）

- **修正 v1.2 配音缺陷**：v1.2 的 VoxCPM 合成误把 `--control` 指令文本当作正文朗读（CLI 2.0.3 的 `(control)text` 语法与 VoxCPM1.5 权重不兼容），whisper 转写逐段开头出现「自然亲切的中文女生,有感情,像短视频口播…」。v1.3 改为**无 control 原速合成**，音色为模型默认，配音干净无残留
- **视频**：`metafile://a7b420147284d9e376c6c4ba1792f38ada9ba19786f2e71ef7bbbb298fe3dc39i0.mp4`（4.57MiB / 53.6s / 1080p30 / h264+aac 44.1kHz stereo，sha256 2b5617bffe…）
- 自测：whisper 大模型转写 5 段文本与字幕一致（无 control 残留）；describe_video 实读「自然有语调起伏、无机械感、无背景噪音/电流声、画面音轨同步」；ffmpeg 全解码 0 错误；公网下载 HTTP 200 且 sha256 与本地一致
- 画面、字幕、文案、对比表、物料全部未动

## v1.2 变更（2026-08-27 配音返工·已废弃）

- 初版返工尝试：VoxCPM1.5 + `--control "自然亲切的中文女声，有感情，像短视频口播"` + atempo 1.2（63.7s）。因 control 语法与 1.5 权重不兼容导致指令被朗读，v1.3 已整体替换

## v1.1 变更

- 新增「对比」区：archify vs draw.io 实测对比表（9 维度，真实实测数据）
- 新增「视频」区：eleven 制作的 60s 带字幕中文配音宣传视频，**metafile:// 独立上链引用**（15.35MB 不塞进 zip，避免每次打开全量下载；zip 保持轻量）
- 新增「物料」区：eleven 三张设计图（fig1/fig2/fig3，PNG 原样引用，未压缩）
- 导航更新：交互图 / 实测 / 对比 / 视频 / 安装

## 参数约定

无 URL query 参数。页面内锚点导航：#live（交互图）、#hands（实测）、#compare（对比）、#video（视频）、#gallery（画廊）、#media（物料）、#install（安装）。

## 内容对版说明

- 交互图与截图为 2026-08-27 本机真实实测产物（archify v2.16.0-dev，node v26.7.0）
- 「亲测者说」段落引自 Lucy 当日亲测文案原文（正式源：pin://0fc27b16f16a9383250c6b1043446be99ac2fed776ed0bfb39362afab04d553di0）
- 星标数 17,866 来自当日 GitHub API 实测（chair 留证）
- 页面 0 条 Web2 外链、0 条 Google Fonts 依赖；包内全部资源为相对路径
- 对比表数据为 2026-08-27 实测 archify 后的真实对照（draw.io 侧为通用常识）

## 二次开发注意事项

- 视频 URI 为占位符替换后的 metafile:// 引用；若视频重新上链，替换 index.html 中 `<source src>` 即可
- 替换交互图时，用 archify CLI 重新生成 HTML 并保持文件名 metaweb-ecosystem.html 即可无缝替换
- 保持「0 外链」原则：新截图放 assets/ 用相对路径引用；大文件（>5MiB）走 metafile:// 上链引用
- 若后续希望视频进包（zip 内联），需评估包体膨胀对加载体验的影响
