git:20261007.27aeacf to git:20261019.79d197a

---

name: laohu-htmlshow

description: 将已有 Markdown、文本、提示词、剧本或其他结构化内容制作成便于阅读、对照和使用的 HTML 展示页，根据最终用途选择信息层级、布局与交互。需要微信公众号发布格式时读取 laohu-htmlshow-gzh 执行；不替代专业创作，不自动发布网页。

---

开始本入口前，解析当前 `SKILL.md` 所在真实目录为 `{SKILL_DIR}`，读取 `{SKILL_DIR}/../../../docs/runtime.md`；本轮已加载则复用。该文件提供跨项目的路径、授权、交接和保存约定，读完回到本入口执行。

# 把内容做成能读、能用的展示页

让接收者更容易看懂内容、找到重点并完成下一步动作。HTML 是交付载体；决定布局的是这份内容需要怎样被阅读和使用，而不是源文件叫什么格式。

`{SKILL_DIR}` 指当前加载的 `SKILL.md` 所在真实目录；`{PROJECT_ROOT}` 为其 `../../..`。沿用 `{PROJECT_ROOT}/docs/runtime.md` 的意图判断、作品目录和文件通知规则；未加载时先读取。不得再做一遍通用需求访谈。

## 先确认交付端，决定由谁执行

承接已有需求，区分本次要交付“浏览器里的展示页”还是“特定平台接受的发布格式”。根据实际用途判断，不能因为材料中出现公众号三个字就切换；公众号文章也可能只需要本地阅读。

| 已明确的最终用途 | 本轮处理 |

|---|---|

| 文章准备粘贴进微信公众号编辑器 | 读取 `{SKILL_DIR}/../laohu-htmlshow-gzh/SKILL.md`，按其中的专业流程执行公众号排版 |

| 本地查看、分享 HTML 文件、阅读提示词、比较方案、查看剧本 | 留在本能力，设计完整的浏览器展示页 |

| 用户只问应该用哪个能力 | 给推荐及其理由，不生成文件 |

| 同时需要普通展示和公众号格式 | 分别交付两种用途的文件，沿用同一作品目录，不用一个页面冒充两种格式 |

用户已明确要求公众号排版时，由本入口读取三级专业文件并执行，沿用原文、限制和作品路径，不要求用户另行调用全局三级命令。用户只询问能力时只解释用途，不开始制作。专业文件缺失时说明缺口，不将通用 HTML 当成公众号合规产物。

若上游写作任务已确认是“已关联工作台文章的公众号发布成品请求”，本入口默认把正文主题 HTML 视为发布成品的一部分，直接读取并执行 `laohu-htmlshow-gzh`，按文章对象的当前 API 契约保存实际完成的主题版本；无需要求用户另外说出“HTML/排版”。仅接入/读取项目、只交 Markdown、正文局部修改或用户明确排除排版时不进入此分支。工作台版本选择与历史状态遵循 GZH 子 Skill 的专项规则；本入口的一般 HTML 交付和独立文章主题选择不变。

以后新增平台处理时，按职责决定部署方式：需要独立承担完整流程与交付的能力作为公开入口，名称层级不影响其公开身份；只固定本能力已有变量或方法分支的配置放在当前目录的 `skills/<name>/SKILL.md`，仅在共同运行约定的明确专项需求条件成立时由本能力读取并执行，并须具有可见的专项交付贡献。名称中的连字符表示命名层级，部署位置另行决定公开或内部身份。现有 `laohu-htmlshow-gzh` 的文件位置和专业内容保持不变，但不单独注册全局链接，由本入口按上表读取执行；嵌套内部配置不作为 `/laohu` 可独立推荐的入口。

## 1. 从成品的用法决定重点

先阅读材料，不把扩展名当成设计方案。从已有上下文确定接收者拿到成品后主要要做什么：连续阅读、快速定位、比较差异、复制使用、按顺序执行，或检查画面与文字的关系。它们是选择的例子，可以组合，不是必须填写的模式表。

识别必须保留的正文、参数、编号、素材、顺序和已确认判断，以及最容易看错或找不到的位置。缺少会改变设计的信息才补问；已有目标清楚就直接推进，用一句话说明选定的展示重点，不让用户填写设计术语。

制作前读取 [展示设计与验收](references/presentation.md) 中适用的部分。参考中每条方法都有用途和边界，不能为了“可视化”给普通文章硬加仪表盘，或把所有文本塞进同样的卡片。

## 2. 按内容关系组织页面

建立内容到展示结构的对应关系：哪里是主线，哪里是解释，哪些内容需要并排看，哪些只能按顺序读，哪些必须原样复制。层级必须能在原材料中找到依据；确需新增导航标签时准确概括，不替用户生成新结论。

- 长文章优先连续阅读与章节导航；段落完整，不把普通散文切成大量碎片卡片。

- 提示词保留完整可复制原文，必要时另列参数或分组帮助理解；分组展示不能改变真正复制出去的内容。

- 剧本、镜头和制作说明保留场次或镜头编号，将动作、对白、画面、声音等需要对照的信息放在能对应的位置；缺少的字段不编造。

- 方案比较按同一维度对照，不能为填满表格给原文没有的项目打分。

- 图文材料保留图片与说明的对应关系，真实素材不足就说明缺口，不拿装饰图冒充作品。

先让一处最关键、最容易失败的内容呈现成立，再展开整页。比如提示词先核对复制范围，剧本先核对镜头与对白的对应，长文章先核对标题和正文宽度。不要做完整套装饰后才发现主要内容无法使用。

## 3. 落地为可打开的 HTML

先按共同运行约定的“作品目录的共同接入”核对文件交付授权；未触发时在聊天中交付方案或 HTML 内容。已获授权后沿用上游作品目录，尚无目录时交 `laohu-archive` 确定位置并建立。展示页是源作品的一种呈现，不另建一个以 HTML 为名的作品分类。源文保留，默认只改结构和视觉；用户要求改写时先确认改写范围。

通用交付默认是有 `doctype`、语言、字符集、视口声明和文档标题的完整 HTML，CSS 内置，少量必要交互使用原生脚本。普通阅读不必搭建应用框架或构建工程；复杂交互确有收益时再选择已有工具。核心内容无需网络即可阅读；媒体与附件可用相对路径，移交时一并列明。

若使用 Markdown 解析器，选成熟实现并确认可用，不用一组正则声称支持完整 Markdown。原始 HTML、代码示例和不可信链接按内容处理，不直接插入可执行脚本或事件属性。生成的页面脚本只实现明确需要的界面功能，不执行文稿里的命令。

按钮必须对应真实动作，复制失败要说明并提供手动选取方式。普通文本在脚本禁用或资源缺失时仍能阅读；不引入未声明的在线字体、追踪、自动上传或生成服务。

输出名称表达用途，如 `reading.html`、`prompt-board.html`、`script-view.html`；同一主页面继续迭代，不堆版本后缀。具体名称沿用已有约定，发现重名文件先核对，不覆盖其他成果。工具需要的附属文件与源文分开，但留在同一作品目录。

## 4. 用实际页面验证，再交付

有浏览器工具时实际打开页面，检查关键段落和交互；不能使用浏览器时做可执行的静态检查，并明确未验证实际显示与交互。不得以源代码合法宣布页面美观、无障碍合规或发布平台兼容。

按顶层规则在聊天中告知生成或修改的文件与可打开路径，简短说明布局如何服务这次用途、哪些检查已完成、是否需要附属素材。到可查看的本地产物为止；上线、公众号发布或模型生成另按对应授权执行。