---
name: html-doc
description: >-
生成人类可读的单文件 HTML 文档（参考手册、报告、字段说明、清单等），统一深色主题
与版式（侧边目录 + 表格 + callout + 徽标 + 代码块），并可选挂载标准化的「批注模块」——
让读者逐字段/逐区块填备注、自动暂存、一键导出带备注的 HTML 副本回传，作者打开即见全部批注。
当用户要「做一份给人看的 HTML 文档/参考手册/说明页/报告」，或提到「统一 HTML 样式」、
「让别人写批注/注释」、「可批注文档」时使用。
---
# html-doc
把「给人阅读的 HTML 文档」标准化：统一主题 + 统一版式 + 可选批注模块。**产出单文件自包含 HTML**（CSS/JS 全内联，一个 `.html` 直接发人）。
## 资产
| 文件 | 作用 | 生成时怎么用 |
|------|------|------|
| `assets/theme.css` | 通用深色主题（tokens + 版式 + 表格/callout/徽标/目录/代码块） | 内联进 `