Gen-HTML 使用手册
更新 ：2026-10-08
Gen-HTML 使用手册
目录快速开始 单页生成 模板系统 网页编辑器 主题、阴影与变换 版本与历史 发布与分享 我的网页 / 模板 / 风格 站点构建 设计系统 页面管理与列表页 发布站点 下载、导出与迁移 自定义域名 GEO 与 SEO 上架到「发现」 REST API 与 AI Agent 计费 最佳实践 常见问题
1. 快速开始1.1 启用进入 设置 → 功能/扩展，找到
1.3 生成第一张网页打开一篇文档，点工具栏的 网页生成 按钮 选一个模板（可选填定制需求） 点生成，等待（通常 30 秒到 2 分钟） 生成完可以预览、编辑、发布
2. 单页生成2.1 生成弹窗左侧是当前文档的历史生成记录，点击可切换查看；主区从上到下是模板选择 → 生成中动画 → 结果编辑器。2.2 选模板与定制需求模板卡片点一下即选中。模板下方的输入框可以写额外要求，例如「主色调改成深蓝」「顶部加个导航栏」「适合手机阅读的版式」。不确定怎么写就点 ⚡ 优化提示词：AI 会把你的粗略想法整理成一份设计规范（配色、字体、布局、组件逐条列出），再拿去生成。2.3 生成过程中界面上会显示进度。生成期间可以离开去做别的事，完成后回来继续。
3. 模板系统3.1 预设模板（78 套）内置模板按分类组织：
每个模板是一个目录，内含
4. 网页编辑器生成结果可以在四种模式间切换：
编辑模式点中元素会浮出操作条；可以改链接、换图片、调样式。改完点 保存改动。
5. 主题、阴影与变换编辑器里有两个专门的浮层工具，加上一个主题面板：
属性面板（选中元素后出现在右侧）覆盖：链接、图片（地址 / alt / 宽高）、布局对齐、外观尺寸、定位、间距、填充、字体、描边、效果、类名。
6. 版本与历史每次「重新生成」「保存改动」「对话改稿」都会产生一个新版本，编辑器顶部有版本下拉可随时切换回看，点恢复即回到那一版。几点要知道：
7. 发布与分享7.1 发布点 发布 打开发布弹窗，可以填/改：
发布后网页获得公开地址，任何人可访问。
8. 我的网页 / 模板 / 风格主页面有四个 Tab：我的网站 / 我的网页 / 我的模板 / 我的风格。我的网页：
9. 站点构建把整棵文档树构建成多页面网站，适合项目文档、知识库、产品手册。9.1 创建站点先准备好文档树（根文档 + 子文档） 打开根文档，点工具栏的「创建站点」 选站点模板（推荐 系统生成首页，并为每个子文档建一个「待生成」的页面占位 审首页，不满意就改（编辑 / 对话 / 重新生成） 提取设计系统（见第 10 章）——这一步是全站统一的关键 逐页或批量生成子页面 需要时调整结构（增删页面、改层级） 发布
10. 设计系统设计系统是站点「长得像同一个网站」的保证。10.1 它是什么提取设计系统会把首页里的这些部分抽出来，变成全站共享：
11. 页面管理与列表页11.1 页面树站点编辑界面左侧是页面树。每个节点可以：
12. 发布站点点 发布 后，站点获得公开地址：https://www.2ryun.com/s/{站点ID}绑定了已通过验证的域名时，对外地址会改用你的域名（分享卡、canonical、sitemap 都跟着走）。12.1 增量发布发布不是每次都重建全站——系统会算发布指纹来判断哪些页面真的变了：
13. 下载、导出与迁移13.1 打包下载把整个站点导出成一个 ZIP，目录结构已经可以直接扔到任何静态托管上：index.html css/style.css js/global.js js/analytics.js uploads/ favicon.ico robots.txt sitemap.xml llms.txt 404.html audit-report.txt <每页>/index.html + index.md（内容 Markdown） <列表页>/page/N/index.html列表页会切成静态目录式分页。打包过程有进度显示。
14. 自定义域名在「我的网站」里对某个站点点 域名，分两步：输入要绑定的域名 配置 DNS 并验证所有权 验证方式是给
15. GEO 与 SEOGen-HTML 的输出是「给 AI 和搜索引擎看的」，站点会自动带上：
16. 上架到「发现」「发现」是平台的内容推荐区。发布网页或站点时勾选 公开到「发现」，或在「我的网页 / 我的网站」列表里点 上架到发现，条目就会出现在推荐列表里，其他人也能看到。
17. REST API 与 AI AgentGen-HTML 的能力都有 REST API，Agent 也可以直接用。
完整端点见 REST API 技术说明书。
18. 计费生成消耗积分：单页生成、重新生成、对话改稿、站点里每个页面的生成、提示词优化，都按 token 计。站点生成 / 发布与单页生成的积分分开记账，便于区分成本。积分不足时会直接提示，不会生成半成品。
19. 最佳实践19.1 文档准备
20. 常见问题Q：改了页头 / 页脚，线上没变？发布是增量的，靠指纹判断。改设计系统后设计指纹变化会触发全站重发；如果你只是改了某个子页，请确认发布确实跑完了。Q：列表页的卡片数量和设置不一致？列表页只显示直接子页面，且受「每页显示条数」限制（1–60）。子页面数超过一页会分页。Q：滑动 / 分页点不动？动态访问用
版本历史
版本：2.0 | 最后更新：2026-10-04Gen-HTML 是 2Ryun 的可视化发布引擎：把文档一键变成网页，可以只出一张单页，也可以把整棵文档树构建成多页面网站。
- 78 套预设模板，覆盖文章、幻灯片、卡片、海报、仪表盘、简历、邮件等 13 个分类
- 生成后可在四种模式里修改：预览 / 编辑 / 代码 / 对话
- 网站支持设计系统（导航、页脚、配色统一管理）、列表页、自定义域名、打包下载
- 所有能力都有 REST API，可供 AI Agent 调用
目录
1. 快速开始1.1 启用进入 设置 → 功能/扩展，找到
网页生成，打开开关。1.2 两个入口2. 单页生成2.1 生成弹窗左侧是当前文档的历史生成记录，点击可切换查看；主区从上到下是模板选择 → 生成中动画 → 结果编辑器。2.2 选模板与定制需求模板卡片点一下即选中。模板下方的输入框可以写额外要求，例如「主色调改成深蓝」「顶部加个导航栏」「适合手机阅读的版式」。不确定怎么写就点 ⚡ 优化提示词：AI 会把你的粗略想法整理成一份设计规范（配色、字体、布局、组件逐条列出），再拿去生成。2.3 生成过程中界面上会显示进度。生成期间可以离开去做别的事，完成后回来继续。
⚠️ 一个需要知道的行为差异：流式生成不做完整性校验、也不会自动续写；只有同步生成（REST API 那条路）在内 </html> 缺失时会自动续写，最多 3 次。所以内容特别长的文档，用流式可能拿到被截断的页面——发现页面没结尾，重新生成一次或改用 API 更稳。2.4 结果工具栏生成完成后工具栏上有：存为模板、存为风格（仅自定义需求生成时）、下载 HTML、重新生成封面、发布、复制链接、取消发布、重新生成。3. 模板系统3.1 预设模板（78 套）内置模板按分类组织：
SKILL.md（模板说明 + 设计约束）与可选的示例文件。幻灯片类模板（slides-*）是特殊的：AI 输出的是结构化数据，成品由内置渲染器渲染出来，所以它在编辑器里的表现和其他模板不同。3.2 自定义模板把一张满意的生成结果存为模板，之后就能用它生成风格一致的新页面。- 保存：结果工具栏 → 存为模板 → 起个名字
- 管理：主页面「我的模板」Tab，可重命名 / 删除 / 预览
- 导入：支持导入
.html文件作为模板。导入时会自动移除脚本等可执行内容，只保留页面结构与样式（安全考虑）。文件上限 2MB
- 生成后点 🎨 保存为风格，或从「我的风格」导入
.md/.markdown/.txt设计规范文件（上限 20KB） - 「我的风格」Tab 里可编辑（改设计提示词，同样能用 ⚡ 优化）和删除
- 生成时选中一个风格，AI 会结合模板结构与风格规范产出页面
4. 网页编辑器生成结果可以在四种模式间切换：
对话模式的一个细节：如果 AI 的改动一条都没匹配上，不会产生新版本——页面保持原样。所以你看到「版本没变」时，说明它没改成功，换个说法再试。
5. 主题、阴影与变换编辑器里有两个专门的浮层工具，加上一个主题面板：
6. 版本与历史每次「重新生成」「保存改动」「对话改稿」都会产生一个新版本，编辑器顶部有版本下拉可随时切换回看，点恢复即回到那一版。几点要知道：
- 只保留最近 10 个版本，更早的会被清掉
- 从编辑器保存时，默认存为新版本；代码模式下的覆盖保存则原地改当前版本
- 「重新生成」是以新内容 + 上一版 HTML 为参考整页重生成，和「对话改稿」只动局部是两回事
7. 发布与分享7.1 发布点 发布 打开发布弹窗，可以填/改：
「上架到发现」和「发布」是解耦的：不上架也照样有公开地址，只是不出现在推荐列表里。7.2 分享与取消
- 复制链接 —— 把公开地址复制到剪贴板
- 取消发布 —— 设为私密，公开地址随即失效
- 「我的网页」里已发布的条目带 ✓ 已发布 标签
8. 我的网页 / 模板 / 风格主页面有四个 Tab：我的网站 / 我的网页 / 我的模板 / 我的风格。我的网页：
- 按来源文档分组展示，每篇文档下的生成记录一目了然
- 可按 全部 / 已发布 / 私密 筛选
- 卡片带封面缩略图，操作有：统计（仅已发布）、上架/下架发现（仅已发布）、发布/取消发布、删除
仪表盘上还有一个「最近网页」小部件，列出最近 6 次生成，点击直达。
9. 站点构建把整棵文档树构建成多页面网站，适合项目文档、知识库、产品手册。9.1 创建站点
magazine-minimal）一个文档树只能建一个站。重复创建会被拒绝（409）。9.2 从首页到全站创建后大致是这个节奏：
未发布的站点，公开地址是 404，只有站内预览能看到。
10. 设计系统设计系统是站点「长得像同一个网站」的保证。10.1 它是什么提取设计系统会把首页里的这些部分抽出来，变成全站共享：
- 导航（NAV）、页脚（FOOTER）、头部（HEADER）、侧栏（SIDEBAR）
- CSS 变量、全局 CSS、全局 JS
- 自定义插槽（你可以在模板里预留位置）
- 在站点设置里可以修改设计系统并保存，每次保存前自动存一份快照
- 保留最近 10 个设计快照，可随时回退版本
- 除了首页，也支持「用当前首页的设计同步到子页」
回退是有代价的：如果当前页面有未保存的修改，回退会让它们丢失——点回退前系统会提醒你。
11. 页面管理与列表页11.1 页面树站点编辑界面左侧是页面树。每个节点可以：
- 选中编辑
- 切换为列表页（见下）
- 进入子列表
- 打开页面设置
- 改名（首页的 slug 固定为
/，不可改） - 删除
- 拖拽排序
「显示在主导航」关掉再打开时，链接会放回原来的位置，不会跑到最后。11.3 列表页列表页不是一篇内容页，而是它下面所有子页面的索引——自动生成卡片列表。
- 把某个页面切换为列表页即可
- 卡片从子页面自动取值：标题、摘要、日期、标签、封面
- 支持分页，每页条数在页面设置里配（1–60，默认 10）
- 动态访问用
?page=2 - 打包下载的静态站会切成
page/2/index.html这样的目录
- 动态访问用
列表页目前只做分页，没有关键词或分类筛选。要筛选得自己在模板里加。11.4 文档变了怎么办文档树增删改之后，站点可以：
- 同步文档树：把新增的文档补成新页面（会检测新增/删除/改位的文档）
- 同步列表子项：只刷新某个列表页的子项
- 同步共享模块：把共享的导航 / 页脚等刷新到所有页面
12. 发布站点点 发布 后，站点获得公开地址：https://www.2ryun.com/s/{站点ID}绑定了已通过验证的域名时，对外地址会改用你的域名（分享卡、canonical、sitemap 都跟着走）。12.1 增量发布发布不是每次都重建全站——系统会算发布指纹来判断哪些页面真的变了：
- 页面指纹：页面内容、标题、slug、封面、是否列表页、每页条数…… 列表页还会并入所有子项的信息
- 设计指纹：导航 / 页脚 / 头部 / 侧栏 / CSS 变量 / 全局 CSS+JS / favicon / 发布根 / 自定义插槽
这套指纹是历史上反复修「改了不生效」的地方——以前只看页面 ID，改了页头页脚、标题、每页条数都不会触发重发。现在这些都在指纹里了。12.2 取消发布点 取消发布 后公开地址失效。
13. 下载、导出与迁移13.1 打包下载把整个站点导出成一个 ZIP，目录结构已经可以直接扔到任何静态托管上：index.html css/style.css js/global.js js/analytics.js uploads/ favicon.ico robots.txt sitemap.xml llms.txt 404.html audit-report.txt <每页>/index.html + index.md（内容 Markdown） <列表页>/page/N/index.html列表页会切成静态目录式分页。打包过程有进度显示。
下载前会问你要目标域名——因为包里的绝对地址需要它。13.2 站点迁移（导出 / 导入）
- 导出站点：导出一个可用于迁移的包
- 导入站点：只支持由 2Ryun「导出站点」生成的包，其它来源的压缩包无法正确导入
14. 自定义域名在「我的网站」里对某个站点点 域名，分两步：
_ryun-verify.<你的域名> 添加一条 TXT 记录，值为平台给出的校验串。验证通过后，站点即可通过该域名访问。15. GEO 与 SEOGen-HTML 的输出是「给 AI 和搜索引擎看的」，站点会自动带上：
robots.txt、sitemap.xml、llms.txt、404.html- 每页的 Markdown 版本：在页面地址后加
.md直接取到正文 <link rel="alternate" type="text/markdown">指向该 Markdown- 逐页的 head 审计：自动补齐 canonical、og:url、description、Organization 等；复杂情况会由 AI 提出修改建议
audit-report.txt，列出审计结果。16. 上架到「发现」「发现」是平台的内容推荐区。发布网页或站点时勾选 公开到「发现」，或在「我的网页 / 我的网站」列表里点 上架到发现，条目就会出现在推荐列表里，其他人也能看到。
- 不上架不影响发布 —— 页面照样有公开地址，只是不进推荐
- 取消发布或删除后，会自动从「发现」摘掉
17. REST API 与 AI AgentGen-HTML 的能力都有 REST API，Agent 也可以直接用。
18. 计费生成消耗积分：单页生成、重新生成、对话改稿、站点里每个页面的生成、提示词优化，都按 token 计。站点生成 / 发布与单页生成的积分分开记账，便于区分成本。积分不足时会直接提示，不会生成半成品。
19. 最佳实践19.1 文档准备
- 内容完整：文档越完整，网页信息越丰富
- 结构清晰：用 H1/H2/H3 组织内容，AI 更容易理解层级
- 去掉无关内容：写给自己看的临时笔记别留在里面
- 按内容类型选模板：文章用文章类、数据用报告类、演示用幻灯片类
- 固定品牌风格：做出满意的一页后存为模板或风格，后续统一复用
- 站点先定设计系统再生成子页：顺序反了会白生成一遍
- 具体明确：「主色调改为深蓝 #1a1a70」比「好看一点」有效
- 一次一两个重点：比一次罗列十几条效果好
- 善用 ⚡ 优化：先写关键词，让 AI 帮你补成完整规范
- 多视口过一遍：桌面 / 平板 / 手机
- 点一遍链接：尤其是站内跳转
- 看一眼封面：分享出去的卡片图是否合适，不满意可以重新生成
- 站点确认导航：改了设计系统后，导航与页脚在子页上是否同步
20. 常见问题Q：改了页头 / 页脚，线上没变？发布是增量的，靠指纹判断。改设计系统后设计指纹变化会触发全站重发；如果你只是改了某个子页，请确认发布确实跑完了。Q：列表页的卡片数量和设置不一致？列表页只显示直接子页面，且受「每页显示条数」限制（1–60）。子页面数超过一页会分页。Q：滑动 / 分页点不动？动态访问用
?page=N，静态包里是 page/N/index.html 目录式——如果是从本机直接打开 HTML 文件，链接可能因为缺服务器而不工作，传到静态托管上就正常了。Q：站点公开地址 404？站点可能还没发布。未发布的站点只有站内预览可见。Q：绑了域名，但地址还是 /s/ 那串？域名需要通过 TXT 验证后才会被用作对外地址。Q：导入的站点打不开？只支持由 2Ryun 导出站点生成的 zip 包，其它来源的包导入不会成功。Q：长文档生成的网页没有结尾？流式生成不做完整性校验、不自动续写。重新生成一次，或改用同步 API（会自动续写，最多 3 次）。Q：版本下拉里找不到更早的版本？只保留最近 10 个版本，更早的已清理。版本历史
提示：如有问题或建议，请联系 2Ryun 团队。