用途:把 markdown、wiki 页面或主题描述渲染成 macOS 液态玻璃风格的文档站/展示页,输出为自包含 HTML(无 JS 库、无构建步骤),写入 llmwiki/html/ 并本地托管预览。
主要能力:单文件或多文件模式(多文件生成 DDMMYY-index.html 加每主题一页);侧边栏导航(仅侧边栏,不用顶栏);由文档自动生成的折叠思维导图;明暗主题切换;可拖拽节点图;代码块复制按钮;水波纹交互;无障碍支持(skip link、focus-visible、reduced-motion、SVG 文本替代)。
使用方式:先按主题划分 section,搭建页面骨架并生成内联 CSS,再绘制图表(节点少用内联 SVG,节点多或有分支用 Mermaid 引擎,已有 archify 图用 iframe 嵌入),补齐必需组件后写入 llmwiki/html/DDMMYY-<slug>.html,用 npx serve -p 8765 托管,最后跑 Playwright 审计。字体需执行 python3 fdk/tools/html_font.py --apply <页面> 嵌入,未执行则回退系统字体,视为未完成。
限制:输出 HTML 必须零外部请求(不得引 CDN、远程字体、远程图片);文件只能写入 llmwiki/html/ 且以日期前缀命名;禁止渐变文字与单边粗边框;间距须落在指定刻度;审计或门禁未通过不得报告完成;端口 8765 被占用视为服务已运行;浏览器缺少 DecompressionStream 时 Mermaid 不渲染。