README.md
September 21, 2026 · View on GitHub
Html九尾狐 · HTML 创作工作台
把文字、文件、图片和散落的 HTML 模板放进一张无限画布，经过分析、推荐、自由组合与反馈迭代，生成真正可交付的单文件 HTML。
个人开源项目 by KratosLee · 默认中文 · 离线规则引擎可用 · AI 可选增强
简体中文 · English
它解决什么问题
很多 HTML、设计模板、参考文件和 AI Skill 散落在不同目录里。传统生成工具又常常只给出模板名字或线框，让人必须“猜”最终效果。
Html九尾狐把创作路径收束成一条可视化流程：
文字 / 文件 / 图片 / HTML
↓
AI 或离线规则分析
↓
推荐内容类型 + 真实模板 + 页面组合
↓
A. 采用推荐直接生成
B. 进入无限画布，自定义组合版式 / 内容 / 风格 / 文件 / Skill
↓
生成单文件 HTML
↓
导出 PDF / 逐页 PNG / 长图 + 兼容性报告
↓
用自然语言反馈，按版本继续迭代
当前版本与 main 最新进展（2026-09-21）
当前应用包版本为 0.5.0rc2，对应预发布标签 v0.5.0rc2；稳定版仍是 v0.4.2。在发布 RC2 之后，main 已完成基于 mattpocock/skills 的全仓工程审计、RC3-A 工程基线和 RC3-B1 共享测试 server fixture；这些是源码与工程文档迭代，尚未创建新的应用 Release，因此不会改变安装包版本号。
| 轨道 | 当前状态 | 查看 |
|---|---|---|
| 应用 Release | v0.5.0rc2 预发布版，可直接下载安装 | 下载与发布说明 |
main 最新增量 | RC3-B1 已完成：13 个工作台测试统一 server fixture，修复测试顺序依赖；下一步进入生成用例 Design It Twice | RC3-B1 记录 · RC3 计划 |
| RC3-B1 完整复验 | 198 passed, 1 skipped，Chromium 验收 22 / 22 | 验证记录 · main Actions |
| DeepSeek Harness 插件 | 0.1.0-preview.1，独立于应用版本 | 插件预览版 |
v0.5.0 RC2 已发布基线（2026-09-18）
RC2 已将 Project Memory、版本历史与恢复、原生动效、100 节点验收和无障碍增量合并为可安装的应用预发布版。
| 增量 | 已完成内容 | 入口与记录 |
|---|---|---|
| 版本历史与恢复 | 每次反馈、重跑和恢复保留 HTML + 生成状态快照；支持命名、源码差异、父版本与恢复来源；恢复会生成新版本，不覆盖历史 | RC2 迭代记录 · 测试报告 |
| 并发、兼容与无障碍 | 过期恢复返回版本冲突；原子文件替换与失败回滚；兼容旧 HTML-only 历史；弹窗 Tab 循环、Escape 焦点恢复、390px 手机布局 | 版本 API 与边界 |
| 100 节点画布验收 | 100 个节点 / 99 条连线覆盖渲染、框选、整体移动、保存和数量一致性；这是操作耗时门禁，不宣称 60fps | 实测 JSON |
| 原生动效系统 | 系统 / 减少 / 关闭三档偏好；可取消动画、并发预算、离屏跳过、重试竞态清理、阶段提示合并；/motion-lab 提供六类样例 | 动效交付记录 · 动效计划 |
| DeepSeek Harness | 原生 Cordis dsh.bundle 注册 htmlninefox 技能，复用 CLI 完成生成 → 反馈 → PDF / PNG；发布 tarball、SHA-256 和 dsh-plugin topic | 下载插件 · 安装说明 |
本轮真实截图
 DSH 插件已启用 最终 tarball 安装进新的 Web profile；插件列表显示 htmlninefox 为全局插件并处于启用状态。 |
 生成、修改与导出链路 离线生成中文海报，执行 dry-run 与真实反馈，再导出 PDF 和完整 PNG；兼容性报告 100 分。 |
 版本历史与恢复 查看父版本、恢复来源、命名与源码差异，历史版本恢复为新版本。 |
 动效实验室 操作反馈、选中素材、建立连接、阶段切换、产物就绪与版本恢复六类动效。 |
最新验证结果
| 验证 | 结果 | 证据 |
|---|---|---|
最新 main GitHub CI 全量 Python / HTTP / Chromium | 199 passed，62.30 秒 | Actions #35510548370 |
| Chromium 生成、反馈、画布与导出验收 | 22 / 22 通过 | 同一 CI |
| DSH 插件注册、重载、卸载、tarball 独立安装 | 2 / 2 通过 | 插件测试 |
| 本机动效与竞态专项 | 196 passed，1 skipped | 动效测试日志 |
| 发布附件回读与 SHA-256 | 一致 | 发布记录 |
当前限制：没有完成 Safari / WebView2 实机、跨进程并发写入与断电事务恢复，也没有用真实模型验收 DSH 对话自动选用技能。DSH 首版是技能工作流，尚未提供专用工具卡片或聊天内 HTML 预览。
RC3 架构加固：审计已完成，开始执行（2026-09-21）
项目已按 mattpocock/skills 的 research、domain-modeling、codebase-design 与 code-review 方法完成全仓审计，RC3-A 文档与工程基线已经进入 main。接下来从共享测试 server fixture 和生成用例 seam 开始，让 CLI、HTTP、DSH 与未来桌面 sidecar 逐步复用同一应用实现。
| 优先级 | 结论 | 下一步 |
|---|---|---|
| P0 | 旧架构与贡献指南仍描述早期目录和门禁 | 已更新当前架构、领域词汇和真实测试命令 |
| P1 | HTTP handler 同时承担 transport 与业务编排 | RC3 提取 CLI / HTTP / DSH 可复用的生成、反馈、恢复和导出用例 |
| P1 | 多套文件写入规则并存，跨进程和断电事务未闭环 | 统一 durable write、Project commit、锁与崩溃恢复测试 |
| P2 | 工作台状态仍集中在大页面 | 按 Project、Generation、Revision、Export 生命周期拆分 |
| P2 | 多个浏览器测试重复启动本地 server | 先建立共享 pytest fixture，降低后续重构风险 |
完整证据与阶段门槛见 工程审计报告、上游技能研究和 RC3 架构加固计划。动效仍沿用动效执行方案，并作为生命周期反馈进入前端 Module 迭代。
v0.5.0 RC2 核心能力
- 🧠 Project Memory：品牌、受众、语气、禁忌、模板、主色和字体保存在本地，可查看、编辑、关闭或清空。
- ♡ 明确采用后学习：只有在产物检查器点击“采用此版本并学习”才会进入长期记忆，测试稿和失败稿不会污染偏好。
- 🔎 可解释复用：分析、Recipe Run 和产物检查器会显示本次复用了什么，以及哪些记忆被本次明确要求覆盖。
- 🔒 隐私边界：不把 API Key、附件正文或完整反馈原文写入长期记忆。
- ✅ RC1 验收：179/179 Python、API、存储、安全与 Chromium 浏览器测试通过。
RC1 建立本地项目记忆闭环；RC2 在其上加入版本历史、恢复、100 节点门禁、键盘操作和用户可控动效。
工作台完整能力
- 📤 Export Center：产物节点直接导出 PDF、逐页 PNG 或完整长图，支持页码范围、画布尺寸、1x/2x/3x 和兼容性报告。
- ✅ 可信发布链路：版本、CLI、API、安装包、Docker 标签、测试证据和 Git 标签保持一致。
- 🎨 Pixel Garden 设计系统：深钴蓝
#173C8F+ 薄荷绿#49B894+ 暖纸白#F4F0E7统一设计令牌，5 大视觉产物一致体验。 - 🤖 真实 LLM 接入：MiniMax-M3 / Claude / GPT-4o 三家 API，环境变量自动配置，离线规则引擎兜底。
- 🖥️ Web 工作台：
htmlninefox workbench一键启动本地 Web UI，实时预览 + 智能体日志 + 模板选择。 - 🐳 Docker 镜像：
docker run htmlninefox跨平台部署，多阶段构建，compose.yaml 注入环境变量。 - 真实 HTML 模板库：6 套完整模板、34 个可单独预览和抽取的页面，不再只展示线框。
- 统一需求入口：支持文字、TXT、Markdown、JSON、CSV、HTML 和常见图片。
- 推荐与自由组合双路径：可以直接接受推荐，也可以在工作区拖入版式、页面、风格、文件和 Skill。
- 无限画布工作区：支持整体拖动、重命名、独立颜色、多工作区导航、吸附和端口连线。
- AI 模型自主配置：支持 OpenAI-compatible、Ollama 和自定义兼容接口；API Key 只保存在本地。
- 离线可用：没有 API Key 时继续使用确定性的规则引擎，不阻塞生成。
- 反馈迭代：自然语言反馈转成设计 Token 修改并重渲染，保留
rev1 / rev2 / ...历史。 - 跨平台使用：Windows 便携包/安装器、Linux
.run/.tar.gz、Python CLI、Web/PWA、Docker。
Export Center 已完成 PDF / PNG 第一阶段。下一阶段提供高保真 PPTX，再推进受控范围内的可编辑 PPTX / DOCX。
- 🎨 Multiple PPT styles via Skill Alliance (v0.3): baoyu-slide-deck (image) · frontend-slides (HTML, no AI gradient) · beautiful-html-templates (28 stable presets)
看得见的真实效果
 Pixel Garden 统一设计 5 大视觉产物统一为深钴蓝 + 薄荷绿 + 暖纸白，杂志感与像素识别并存。 |
 Web 工作台 htmlninefox workbench 一键启动，实时预览 + 智能体日志 + 模板选择。 |
 真实 LLM 接入 MiniMax-M3 / Claude / GPT-4o 三家 API，环境变量自动配置，离线兜底保留。 |
 Docker 一键部署 docker run htmlninefox 跨平台运行，多阶段构建，环境变量注入。 |
导出中心
产物节点可直接选择 PDF、逐页 PNG 或完整长图；导出前显示分页识别、兼容性评分、动态内容与网络资源风险，导出后提供文件和 export-report.json。
六类真实产物
| 落地页 | 数据看板 | 发布会 PPT |
|---|---|---|
 |  |  |
| 海报 | 架构文档 |
|---|---|
 |  |
下载与安装
应用安装包请前往 v0.5.0rc2 Release。这是应用预发布版；稳定版本仍为 v0.4.2。DeepSeek Harness 插件使用独立预览版，不要把插件版本当成应用版本。
| 平台 | 推荐文件 | 使用方式 |
|---|---|---|
| Windows 10/11 | HtmlNineFox-Setup-0.5.0rc2.exe | 安装到当前用户，创建开始菜单入口 |
| Windows 10/11 | HtmlNineFox-Windows-x64-0.5.0rc2.zip | 解压后运行 HtmlNineFox.exe，免安装 |
| Linux | HtmlNineFox-Linux-0.5.0rc2.run | chmod +x 后运行，安装到当前用户目录 |
| Linux/审计 | HtmlNineFox-Linux-0.5.0rc2.tar.gz | 可查看完整安装内容 |
| Python 3.10+ | htmlninefox-0.5.0rc2-py3-none-any.whl | python -m pip install ./htmlninefox-0.5.0rc2-py3-none-any.whl |
| Docker | 源码构建 | docker compose up --build；标签 CI 验证镜像但不上传镜像仓库 |
快速开始
# 1. 安装（任选其一）
pip install htmlninefox
# 或下载 release 包
# 或 docker run htmlninefox
# 2. 配置 LLM（可选，离线也可用）
export MINIMAX_API_KEY="***"
# 或 export OPENAI_API_KEY="***"
# 或 export ANTHROPIC_API_KEY="***"
# 3. 启动 Web 工作台
htmlninefox workbench
# 打开 http://127.0.0.1:8620
# 4. 或 CLI 直接生成
htmlninefox expert "做一个 SaaS 落地页"
从源码运行
git clone https://github.com/KratosLee-6/Html-ninefox.git
cd Html-ninefox
# 推荐：uv
uv sync
uv run htmlninefox app
# 或传统 Python
python -m pip install -e .
htmlninefox app
浏览器默认打开本地工作台。也可以使用：
htmlninefox expert "做一个 AI 产品发布会 PPT"
htmlninefox expert --type landing --template fox-pixel-garden "创作工具官网"
htmlninefox feedback --project output/html9n-<时间戳> --note "标题更大，颜色更稳重"
完整说明：安装指南 · 多种运行方式 · UI 手册 · VI 手册
模板、内容与视觉系统
真实模板作品库
- 归藏 · 电子墨水发布会：6 页
- 归藏 · 靛蓝研究档案：6 页
- 归藏 · 瑞士信号系统：6 页
- 归藏 · 牛皮纸品牌故事：6 页
- 归藏 · 沙丘作品集：5 页
- 九尾狐 · 像素花园产品页：5 页
共 6 套 / 34 页，均为 Html九尾狐原创演示；采用归藏式编辑设计方法启发，没有复制许可不明的第三方模板。
v0.4 开发预览：私人模板资产库
- 在“版式”栏导入一个独立 HTML，或导入包含 CSS、JavaScript、图片和字体的完整文件夹。
- 自动识别多 HTML 页面、
data-page、.page与.slide，并提取页面角色、常见颜色和字体。 - 私人模板仅保存在当前输出目录的
.library/gallery/，不会自动提交到 Git 仓库。 - 生成时会使用导入模板的页面结构与视觉 Token；使用次数会成为下一次推荐信号。
- 画布支持撤销/重做、Shift 框选、多选移动、组合、锁定、小地图，以及
Ctrl+K搜索定位。
使用说明：私人 HTML 模板导入 · v0.4 产品迭代与竞品拆解
六类生成器
deck 发布会 PPT · doc 文档 · poster 海报 · landing 落地页 · dashboard 数据看板 · archdoc 架构文档。
十一套视觉系统
内置基础预设与 Pixel Garden、Duotone Studio、Editorial Ink、Swiss Signal、Soft Silver 等结构级视觉系统。模板差异不仅是换颜色，而是排版、间距、卡片、网格和信息节奏的整体变化。
AI 与隐私
- AI 是增强能力，不是运行前提。
- API Key 保存到当前输出目录的
.settings/ai.json，不会写入项目快照、诊断包或 Git 仓库。 - 设置读取接口只返回
api_key_set，不返回 Key 明文。 - 文件与图片输入保存在本地
.inputs/；单文件默认上限 8MB。 - 未启用 AI、连接失败或没有 Key 时，自动继续使用离线规则分析。
测试与信任证据
main 最新工程基线在 2026-09-21 完成 RC3-B1 本地全量复验；v0.5.0rc2 在 2026-09-18 完成应用发布验收，历史包证据继续保留：
| 验证项 | 结果 | 证据 |
|---|---|---|
| Python / API / 存储 / 安全 / 浏览器测试 | 198 passed, 1 skipped | RC3-B1 验证记录 |
| Chromium 真实生成与交互验收 | 22 / 22 passed | RC3-B1 验证记录 |
| 版本历史、恢复与 100 节点 | 通过 | RC2 报告 |
| 动效、减少动态效果、竞态与资源打包 | 通过 | 动效交付记录 |
| DSH 插件与最终 tarball 安装 | 2 / 2 通过 | 接入与发布记录 |
| RC2 发布包 | wheel 隔离安装、真实 PNG 导出与 Windows 便携包启动在本地通过；标签工作流已重建 Windows / Linux 资产、发布 SHA-256 并验证 Docker | 构建 CI · 测试报告 |
| LLM 接入 | MiniMax-M3 / Claude / GPT-4o 环境变量自动配置 | 配置文档 |
| Web 工作台 | Python 本地 HTTP 服务 + 实时预览 + 智能体日志 | E2E 日志 |
| Docker 镜像 | 多阶段构建定义 + 标签 CI 独立验证 | 构建工作流 |
发布命令、环境与限制见：v0.5.0rc2 测试报告。旧版环境记录见：v0.4.2-environment.txt。
python -m pytest tests -q -p no:cacheprovider
python e2e_verify.py
产物结构
output/html9n-<时间戳>/
├── output.html
├── brief.json / brief.md
├── style.md
├── assets.json
├── .foxstate.json
├── revisions/
└── feedback.md
.foxstate.json 会记录模板、页面区块、附件、Skill 和选择模式，确保后续反馈迭代不是重新猜测。
当前状态与路线
v0.5.0rc2 是当前应用预发布版，v0.4.2 仍是稳定版；main 已完成 RC3-B1 共享测试 seam。下一步先用 Design It Twice 选择 CLI/HTTP/DSH 共用生成用例 Interface，再推进 durable Project commit、跨进程与断电恢复，以及按 Project / Generation / Revision / Export 生命周期拆分浏览器 Module，最后决定 v0.5.0 正式版和 v0.6 桌面壳范围。
查看完整路线：ROADMAP · 查看变更：CHANGELOG
贡献与致谢
欢迎提交 Issue、模板、视觉系统、测试和 Skill 联盟适配。设计方法受到归藏、花叔 Design 和 Archify 等开源社区工作的启发；详细来源和许可审查见 DESIGN-SOURCES。
Skill Alliance 致谢（v0.3-v0.4）
Html九尾狐 v0.3-v0.4 的 PPT 生成模块参考了以下两位创作者的开源 Skill 作品，诚挚致谢：
-
🎨 宝玉 (JimLiu) — author of baoyu-skills (especially baoyu-slide-deck). The "AI 画图生成每页 PPT · 17 套风格" image-based PPT approach inspired Html九尾狐 v0.3's
ppt_imageintent. -
🎨 张咋啦 (zarazhangrui) — author of frontend-slides, beautiful-html-templates, beautiful-feishu-whiteboard. The "避开 AI 紫渐变" + "28 套稳定出片" philosophy deeply shaped Html九尾狐 v0.3-v0.4's template library design.
设计系统致谢（v0.4）
- 🎨 Pixel Garden 设计系统 — 深钴蓝
#173C8F+ 薄荷绿#49B894+ 暖纸白#F4F0E7统一设计令牌，灵感来自电子杂志 × 电子墨水美学。
许可证
MIT License © 2026 KratosLee · Html九尾狐项目组