deepseek-harness
deepseek-ai
DeepSeek Harness: Everything is a Plugin.
PROJECT TOPICS
PROJECT README
把文字、文件、图片和散落的 HTML 模板放进一张无限画布,经过分析、推荐、自由组合与反馈迭代,生成真正可交付的单文件 HTML。
个人开源项目 by KratosLee · 默认中文 · 离线规则引擎可用 · AI 可选增强
简体中文 · English

中文版 1920×1080 · 50s · 带配乐 · English cut · 53s · 34s 静帧速览版 · 34s English · 全部文件
这不是动画,是录屏:光标真的移动、27 个字真的一个个被敲进去、节点真的一个个长出来、导出中心真的被点开。片子由
scripts/record_demo_film.py驱动 v0.6.0 的真实运行服务录下,全部画面来自真实操作,字幕里的数字也是产品当场报出来的——置信度 67%、需求分析 8ms、保存交付 40ms、兼容性 100 分、「未发现阻塞性兼容问题」。没有一帧是画的,也没有一帧是生成的。唯一由 MiniMax-H3 生成的是开场的 3.5 秒抽象氛围(暖纸、方格、钴蓝与薄荷光),它不含任何文字。界面演示刻意不用文生视频模型:模型会把中文渲染成乱码、按钮位置随机、连线毫无逻辑,那样的画面恰好与「可正常演示」相反。
| 时间 | 真实发生的事 |
|---|---|
| 0–3.5s | H3 抽象氛围开场 |
| 3.5–12s | 光标点开「输入需求」,逐字打出一句真实需求 |
| 12–19s | 「AI 分析并推荐」返回置信度 67% 与推荐模板(实时渲染的预览) |
| 19–28s | 「采用推荐并生成」→ 节点与连线逐个长出,底部实时计时 8ms → 40ms |
| 28–38s | 六个真实内容区块落到画布,点开产物节点看 rev0 |
| 38–50s | 导出中心:兼容性 100、11 KB 单文件、「未发现阻塞性兼容问题」 |
很多 HTML、设计模板、参考文件和 AI Skill 散落在不同目录里。传统生成工具又常常只给出模板名字或线框,让人必须“猜”最终效果。
Html九尾狐把创作路径收束成一条可视化流程:
文字 / 文件 / 图片 / HTML
↓
AI 或离线规则分析
↓
推荐内容类型 + 真实模板 + 页面组合
↓
A. 采用推荐直接生成
B. 进入无限画布,自定义组合版式 / 内容 / 风格 / 文件 / Skill
↓
生成单文件 HTML
↓
导出 PDF / 逐页 PNG / 长图 + 兼容性报告
↓
用自然语言反馈,按版本继续迭代
当前应用包版本为 0.6.4,发布标签 v0.6.4。v0.6.4 是门禁收口版,不新增用户可见功能,
它做的是把「绿灯」变成可信的,并因此修掉两处真实缺陷:
colors/fonts——每个消费方读的都是 tokens 键,而它根本不存在。composition["blocks"] 会把结构化分块压成字符串,页面分块无法穿过流水线。这一版还做了三件把「已验证」变成事实的事:
cryptography
从未声明,在 CI 上一次都没跑过(本机全绿只是因为这台机器恰好装了);另一条
把有效期 ±1 天的自签证书缓存下来,从第一次运行起 24 小时后就开始失败。index.html 抽成独立文件,
扩展层的 13 行顶层语句清空由内核显式装配——6 个纯函数第一次可以单测,
index.html 的加载顺序不再是硬约束。v0.6.2 的设计吸收抓取是坏的,请跳过 v0.6.2。 v0.6.1(幻灯片编辑器竞态修复 + 真实操作录屏)与 v0.6.0(设计吸收 + 可编辑 PPTX 两条主线)的内容不受影响,内容见各自的发布说明。 建议从 v0.6.1 或 v0.6.3 直接升级到 v0.6.4。
| 轨道 | 当前状态 | 查看 |
|---|---|---|
| 应用 Release | v0.6.4 已发布(2026-10-06) |
发布页 · 上一版 v0.6.3 |
| 发布验证 | 全量测试 499 passed, 1 skipped;8 个变异脚本共 67 个变异全部捕获;发布物字节级回读 |
v0.6.4 发布说明 · C7 第二步设计 |
| DeepSeek Harness 插件 | 0.1.0-preview.1,独立于应用版本 |
插件预览版 |
以下 6 张拍摄自 v0.6.0 当前代码(顶栏版本徽标为 v0.6.0),包含本轮设计收敛后的字号、字重、间距与画布适配:
![]() Pixel Paper 桌面工作台 三栏层级:素材库 · 无限画布工作区 · 检查器。 |
![]() 夜蓝主题桌面工作台 同一组件层级的完整暗色主题;主按钮与弱化文字均已提到 WCAG AA 以上。 |
![]() 多工作区管理 工作区导航卡按真实几何参与画布避让,首屏缩放 81%,不再把内容缩成一团。 |
![]() 平板 768 布局 侧栏折叠为顶栏抽屉,画布语义缩放。 |
![]() 移动任务视图 以工作区动作和节点卡片替代不可读的缩小画布;进度条只显示当前与失败步骤。 |
![]() 侧栏 REAL HTML 模板库 模板名与描述上下堆叠、各夹 2 行,同屏比收敛前多露出一张卡。 |
![]() 统一需求入口 文字、文件、图片走同一个入口,AI 分析后推荐组合。 |
![]() 命令面板 Ctrl+K 键盘打开、输关键词直达,每个动作都带快捷键提示。 |
![]() 需求节点检查器 选中即编辑文字与附件,一键向所属工作区推进。 |
![]() 产物节点检查器 版本徽标、运行轨迹、采用学习、口语反馈与导出入口。 |
Project Memory、命令与版本
![]() 项目记忆 品牌、受众、语气、禁忌、模板与长期说明本地保存,下次生成直接复用。 |
![]() 版本历史与恢复 反馈、重跑、恢复都保留快照;恢复生成新版本,历史不覆盖。 |
![]() 取消生成 等待期可取消:排队任务真取消,执行中诚实转为“停止等待”。 |
![]() 经典表单模式 一句话 Brief 直接生成,和工作台同一套品牌系统。 |
导出中心(真实导出全流程)
![]() 导出分析就绪 兼容性评分、分页模型、动态特性与本地引擎状态;deck 产物额外放开 PPTX。 |
![]() PPTX 导出结果 导出完成给出 pptx 与报告两个下载项,报告列出可编辑元素与降级清单。 |
| 目录 | 张数 | 内容 |
|---|---|---|
assets/screenshots/v0.6.3/ |
23 | 当前版本实拍:工作台与画布 7 张、输入与检查器 4 张、Project Memory / 版本 / 取消 / 经典模式 4 张、设计吸收 3 张、幻灯片编辑与 PPTX 导出 3 张、移动端素材库 1 张 |
assets/screenshots/v0.5.0/ |
24 | v0.5.0 完整实拍集(含 6 张真实产物输出图) |
assets/screenshots/v0.4.0/ |
5 | Pixel Garden、LLM、Docker、Export Center 的历史记录 |
v0.6.0 的 23 张全部由可复跑的门禁产出(
tests/test_v060_visual_evidence_states.py与tests/test_v061_visual_evidence_states.py),不是手工截图;清单与重采命令见截图说明。 仍引用v0.5.0/的只有六类生成器产物——它们由生成器实跑产出而非 UI 截图,产物结构在 v0.6.0 未变。

project_busy。export-report.json。![]() 素材审核台 · 待审核 许可三档徽标、来源徽标、令牌色板、骨架大纲与吸收指标面板。 |
![]() 已采纳 · 六层入库 生成风格预设 / 导入组件 / 吸收动效,指标同步更新。 |
![]() CSP 沙箱预览 候选页面在无脚本沙箱内渲染,候选脚本永不执行。 |
![]() 动效实验室 吸收到的原创动效经预算钳制,并尊重三档减少动效偏好。 |
把全世界的优秀设计变成自己的素材——模板、风格、组件、装饰、动效、内容六个层面,三条吸收通道:
所有素材经审核台人工确认后入库(沙箱预览 + 许可三档治理:开放可入库 / 仅参考重写 / 仅灵感板),审核台支持批量采用 / 拒绝与按来源筛选,吸收指标面板记录候选与入库情况;风格进面板、组件可拖拽参与生成、动效进 motion-lab——且全部尊重动效偏好与预算。六个层面(模板、风格、组件、装饰、动效、内容)都走同一条「吸收 → 审核 → 入库 → 使用」通路。
![]() 工作台内幻灯片编辑 按页列出全部可编辑文本节点,保存即生成新版本。 |
![]() 导出中心 · PPTX deck 产物放开 PPTX 格式,导出完成给出 pptx 与报告两个下载项。 |
.pptx,在 PowerPoint / WPS 中文本框真正可编辑;无法映射的能力在降级报告中如实列出(报告实录)。PUT /slides 带 expected_revision 写回,版本冲突时明确提示而不是静默覆盖。htmlninefox app 一键启动本地 Web UI,实时预览 + 智能体日志 + 模板选择。rev1 / rev2 / ... 历史。#173C8F + 薄荷绿 #49B894 + 暖纸白 #F4F0E7 统一设计令牌,5 大视觉产物一致体验。docker run htmlninefox 跨平台部署,多阶段构建,compose.yaml 注入环境变量。.run/.tar.gz、Python CLI、Web/PWA、Docker。Export Center 支持四种真实导出格式:
PNG、完整长图PNG,以及 v0.6 补齐的.pptx。前三者产出真实文件与export-report.json;.pptx经 python-pptx 受控映射,文本框在 PowerPoint / WPS 中真正可编辑,无法映射的能力在降级报告中如实列出。DOCX 语义导出已出列至 v0.6.x。
以下 4 张拍摄自
v0.4.0(2026-09-08),是 Pixel Garden 设计语言定型的历史记录。这些界面(模板预览、AI 模型配置、Docker 部署)功能仍然存在,但版式已随 v0.5 / v0.6 的设计收敛变化,当前列表观感以 v0.6.0 实拍为准。
Pixel Garden 统一设计 5 大视觉产物统一为深钴蓝 + 薄荷绿 + 暖纸白,杂志感与像素识别并存。 |
![]() 模板预览对话框 真实 HTML 模板逐页预览,整套加入工作区或抽取当前页。 |
![]() AI 模型配置 OpenAI-compatible 接口 + API Key 本地保存、可测连接;无 Key 时离线规则兜底。 |
![]() Docker 一键部署 docker run htmlninefox 跨平台运行,多阶段构建,环境变量注入。 |
以下产物图由 v0.5.0 发布版的 e2e 验收流程真实生成(六类生成器的产物结构在 v0.6.0 未变;这 6 张由生成器实跑产出而非 UI 截图,因此仍是 v0.5.0 版式):
| 落地页 | 数据看板 | 发布会 PPT |
|---|---|---|
![]() |
![]() |
![]() |
| 翻页交互 | 海报 | 架构文档 |
|---|---|---|
![]() |
![]() |
![]() |
RC3-A~E 按 mattpocock/skills 的 research、domain-modeling、codebase-design、TDD 与 code-review 方法完成架构加固,并以 v0.5.0 稳定版收口;v0.6 在其上交付设计吸收流水线与可编辑 PPTX。
| 版本 | 日期 | 交付 | 记录 |
|---|---|---|---|
| v0.6.0 | 2026-10-01 | 设计吸收流水线(多 URL / ZIP 导入、12 个内置设计源、三档许可、CSP 沙箱审核台、AI 设计分析、吸收指标);可编辑 PPTX 导出 + 工作台内幻灯片编辑器;发布前设计收口(字号 7 档 / 字重 4 档 / 间距尺度 token、首屏画布缩放 0.33→0.80、对比度达 AA);修 Windows 便携包启动即崩,并把产物验证加到内容级;门禁 387 passed, 1 skipped、Chromium / WebKit 各 22/22 |
Release · 发布说明 · 门禁证据 |
| v0.5.0 稳定版 | 2026-09-25 | RC3 收口,发布 Windows / Linux / wheel / Docker 附件与 SHA-256 | Release · 测试报告 |
| RC3-E | 2026-09-25 | 浏览器生命周期 Module 拆分、生成取消、导出竞态守卫 | 迭代记录 |
| RC3-D | 2026-09-25 | 崩溃可恢复 Project 提交(journal 回滚)、跨进程文件锁、生成原子发布 | 迭代记录 |
| RC3-B2 / C | 2026-09-24 | 共享 Generation / Feedback / Restore / Export 应用用例,CLI Restore | RC3-C 记录 |
| RC3 视觉收敛 | 2026-09-24 | 顶栏双主动作、四档响应式、语义缩放、组件状态统一、经典模式回归 Pixel Garden | 视觉收敛记录 |
| v0.5.0rc2 | 2026-09-18 | 版本历史与恢复、原生动效三档偏好、100 节点验收、无障碍、DSH 插件预览 | RC2 报告 |
| v0.5.0rc1 | 2026-09-14 | Project Memory、命令面板、Recipe Run、交互系统 | RC1 说明 |
| v0.4.2 稳定版 | 2026-09-08 | Export Center(PDF / PNG + 兼容性报告) | 发布说明 |
历史版本的真实证据截图:
![]() DSH 插件已启用(rc2) 最终 tarball 安装进新的 Web profile;插件列表显示 htmlninefox 为全局插件并处于启用状态。 |
![]() 生成、修改与导出链路(rc2) 离线生成中文海报,执行 dry-run 与真实反馈,再导出 PDF 和完整 PNG;兼容性报告 100 分。 |
![]() 版本历史与恢复(rc2) 查看父版本、恢复来源、命名与源码差异,历史版本恢复为新版本。 |
![]() 动效实验室(rc2) 操作反馈、选中素材、建立连接、阶段切换、产物就绪与版本恢复六类动效。 |
v0.6.3 已于 2026-10-04 发布,安装包随 v0.6.3 Release 提供。v0.6.0 / v0.6.1 用户可直接升级,项目 schema 与数据目录不变。DeepSeek Harness 插件使用独立预览版,不要把插件版本当成应用版本。
包体命名规则保持不变,版本号随发布版本推进。下列文件名按 v0.6.3 列出,与 Release 附件逐一对应:
| 平台 | 推荐文件 | 使用方式 |
|---|---|---|
| Windows 10/11 | HtmlNineFox-Setup-0.6.3.exe |
安装到当前用户,创建开始菜单入口 |
| Windows 10/11 | HtmlNineFox-Windows-x64-0.6.3.zip |
解压后运行 HtmlNineFox.exe,免安装 |
| Linux | HtmlNineFox-Linux-0.6.3.run |
chmod +x 后运行,安装到当前用户目录 |
| Linux/审计 | HtmlNineFox-Linux-0.6.3.tar.gz |
可查看完整安装内容 |
| macOS 14+(Apple Silicon) | HtmlNineFox-macOS-arm64-0.6.3.zip |
解压后右键 HtmlNineFox.app →「打开」绕过 Gatekeeper(未做公证) |
| Python 3.10+ | htmlninefox-0.6.0-py3-none-any.whl |
python -m pip install ./htmlninefox-0.6.0-py3-none-any.whl |
| Docker | 源码构建 | docker compose up --build;标签 CI 验证镜像但不上传镜像仓库 |
已验证范围:Windows 便携包已在本机真实启动验证(
/api/health回报0.6.0 / windows-portable,首页与六项静态资源正常,进程干净退出)。Linux 与 macOS 产物在 CI 中只验证了构建成功与 SHA-256,未实跑——本机是 Windows,无法在此验证。安装器(Setup.exe)同样只验证了构建,未实跑安装流程。
# 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 app
# 打开 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 "标题更大,颜色更稳重"
htmlninefox restore --project output/html9n-<时间戳> --revision 0 --expected-revision 2
htmlninefox export output/html9n-<时间戳> --format png --scope long
完整说明:安装指南 · 多种运行方式 · UI 手册 · VI 手册
共 6 套 / 34 页,均为 Html九尾狐原创演示;采用归藏式编辑设计方法启发,没有复制许可不明的第三方模板。
data-page、.page 与 .slide,并提取页面角色、常见颜色和字体。.library/gallery/,不会自动提交到 Git 仓库。Ctrl+K 搜索定位。使用说明:私人 HTML 模板导入 · v0.4 产品迭代与竞品拆解
deck 发布会 PPT · doc 文档 · poster 海报 · landing 落地页 · dashboard 数据看板 · archdoc 架构文档。
内置基础预设与 Pixel Garden、Duotone Studio、Editorial Ink、Swiss Signal、Soft Silver 等结构级视觉系统。模板差异不仅是换颜色,而是排版、间距、卡片、网格和信息节奏的整体变化。
.settings/ai.json,不会写入项目快照、诊断包或 Git 仓库。api_key_set,不返回 Key 明文。.inputs/;单文件默认上限 8MB。v0.6.0 的全部门禁已在 2026-09-29 复验通过:
| 验证项 | 结果 | 证据 |
|---|---|---|
| Python + 浏览器测试套件 | 387 passed, 1 skipped(v0.5.0 基线 303,本轮新增 84 条) | v0.6.0 门禁证据 |
| —— 设计体检 / 版式层级 / 动效行为 | 6 + 8 + 6 条 | 发布说明 · 验证 |
| —— 生成质量 | 50 条(板块划分顺序、内容质量、最终效果、端到端产物自足) | 同上 |
| —— 动作派发表 / 写回协议 / 冻结入口 | 4 + 2 + 5 条 | 同上 |
| JavaScript 语法(13 个 static JS + inline 检查) | 全部通过 | 同一证据 |
| Chromium 验收(bundled Chromium) | 22 / 22 | 同一证据 |
| WebKit(Safari 引擎)验收 | 22 / 22 | 同一证据 |
| 打包产物实跑 | Windows / Linux / macOS / Docker 四个 job 全绿;Windows 便携包真实启动通过 | 发布说明 · 验证 |
发布元数据一致性(check_release_version.py) |
一致 | 同一证据 |
| DSH 插件与最终 tarball 安装 | 2 / 2 通过 | 接入与发布记录 |
| 版本历史、恢复与 100 节点 | 通过(含在 pytest 套件内) | RC2 报告 |
| 动效、减少动态效果、竞态与资源打包 | 通过 | 动效交付记录 |
| Docker 镜像 | 标签 CI 独立 job 构建并验证 | 构建工作流 |
| LLM 接入 | MiniMax-M3 / Claude / GPT-4o 环境变量自动配置 | 配置文档 |
本轮门禁的做法:每一条新门禁都做过反向验证——把对应修复去掉,测试必须变红;否则视为无效门禁并重写。这条纪律是必要的,因为本轮被拦下的多数缺陷形态一致:服务端能力实现齐备,界面却没有可达入口,也没有任何测试点击过它。打包流水线也据此改成了「构建后必须真实执行产物」,否则一个启动即崩的包能一路带着全绿的四个 job 进入 Release。
v0.5.0 稳定版的发布证据保留在 v0.5.0 测试报告(含发布附件与 SHA-256、Windows 便携包真机烟测),更早的证据见 v0.5.0rc3 测试报告与 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.6.3(已于 2026-10-04 发布):纯安全补丁,关闭设计吸收出站抓取的 SSRF TOCTOU 窗口——socket 现连到已校验的地址,TLS 的 SNI 与证书校验仍用真实主机名。门禁 409 passed / 1 skipped,新增 6 条走真实 socket 的用例并做过反向验证。v0.6.1 是上一稳定版(幻灯片编辑器竞态修复 + 真实操作录屏),v0.6.0 交付设计吸收与可编辑 PPTX 两条主线。下一阶段按 ROADMAP-v0.6.1-v0.7 推进:网页反向拆解。
查看完整路线:ROADMAP · 查看变更:CHANGELOG
欢迎提交 Issue、模板、视觉系统、测试和 Skill 联盟适配。设计方法受到归藏、花叔 Design 和 Archify 等开源社区工作的启发;详细来源和许可审查见 DESIGN-SOURCES。
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_image intent.
🎨 张咋啦 (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.6 的可编辑 PPT 能力建立在两位前辈的工作之上,诚挚致谢:
#173C8F + 薄荷绿 #49B894 + 暖纸白 #F4F0E7 统一设计令牌,灵感来自电子杂志 × 电子墨水美学。MIT License © 2026 KratosLee · Html九尾狐项目组
CLASSIFICATION EVIDENCE
系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。当前命中: 无有效分类标签。