Markdown 折叠树

使用本 Skill 自带的 scripts/markdown-tree-view.mjs 执行转换。它是唯一的可执行交付文件，包含解析器、页面资源和许可证；运行仅需 Node.js 24 或更新版本，不依赖源码 checkout、同级资源或 npm 安装。不要用 AI 重写、摘要或重新分类输入内容。

转换与检查

按用户指定的路径选择单个 UTF-8 Markdown 输入和 HTML 输出。生成模式未指定输出时，优先在输入同目录生成 <文件名>.tree.html；若该目标已存在且用户未要求覆盖，选择未占用的名称。检查模式使用用户指定或从当前上下文可明确确定的输出路径，不因目标已存在而换名；目标缺失时按实际检查结果报告，不改用新名称。仅在无法确定检查目标时询问路径。

将以下占位路径替换为实际绝对路径，Skill 目录以当前加载的 SKILL.md 所在目录为准：

node "<skill-directory>/scripts/markdown-tree-view.mjs" --input "<input.md>" --output "<output.html>"
node "<skill-directory>/scripts/markdown-tree-view.mjs" --input "<input.md>" --output "<output.html>" --check

-i / -o 是输入输出参数的简写；--help 查看用法。生成模式创建输出目录并替换指定输出；输入输出不能为同一文件。--check 只比较已有结果，不写文件或创建目录；用户只要求检查时不要自动重新生成。

退出码：0 为成功或一致，1 为检查时输出缺失或不一致，2 为参数、编码、读取、转换或写入失败。根据命令的实际诊断处理，不把检查失配表述为转换成功。若随附脚本缺失，按安装说明取得构建后的完整 Skill 目录；不要把维护源码目录或单个指令文件当作安装包。维护源码入口见本目录的 README.md。

生成后执行 --check，确认完整交付文件（含默认图标和页面元信息）与当前输入及转换器一致。可用浏览器时，使用工具允许的本地预览方式，抽查标签页标题、图标、正文、配色和折叠操作：支持 file:// 时直接打开输出；文件协议受限时使用允许的本地 HTTP 预览。说明实际采用的方式，仅通过 HTTP 验证不代表已验证文件直开；无可用预览方式时说明未做交互检查。交付 HTML 的可点击文件链接，并说明实际检查结果及与该输入有关的渲染限制。

内容边界

文档级标题按真实 Markdown 级别建树，不要求编号。重复标题和跳级标题允许存在；引用或列表内部的标题仍在相应正文中。页面默认展开根节点、折叠下级章节，并显示源文件名和源行定位；源文件 SHA-256 保留在 HTML 元数据中。需要核对原始语法时请查看输入 Markdown 文件。

原始 HTML 按文字呈现。图片只显示替代文字和地址，不加载资源；相对文件链接显示目的地址。支持点击 http:、https:、mailto: 和页内片段链接，外部链接需要相应网络或应用。脚注、数学公式、Mermaid 等没有专门的渲染扩展，按普通 Markdown 或代码文字显示。HTML 包含转换后的文档内容，折叠章节中的内容也会随文件一起分享。

默认 CSP 保持离线资源限制。为启用 Cloudflare Web Analytics 的托管页面生成 HTML 时，读取托管说明，按用户要求决定是否添加 --allow-cloudflare-analytics；生成与 --check 使用相同选项。该选项不会注入统计脚本或配置站点，不能将允许加载等同于已完成线上验证。