用途:将文本、分析或报告工作流产出的 Markdown 正文转换为一个可自包含的 HTML 文件,能直接在浏览器打开、随邮件发送、清晰打印并离线阅读。Markdown 仍是唯一事实来源,HTML 只是额外分支。
主要能力:六种模式(status、incident、plan、explainer、financial、pr)决定报告结构;受众层级(expert、basic、learn)决定解释深度,两者正交。输出位于 <cwd>/reports/<slug>-<YYYYMMDD>.html 与同名 .md。图表以手写内联 SVG 呈现;basic/learn 层级可额外使用 mermaid CDN 结构图,并必须配 <noscript> 回退;expert 层级保持零 JS。HTML 不依赖外部 JS 库、CSS 框架;仅允许一个字体 CDN <link>,并给出各模式字体映射与 8 个设计令牌 CSS 变量。
使用方式:提供 markdown(必填)、mode(必填)、可选 audience、slug、output_path、font_stack。audience 默认由当前 outputStyle 推导:MoAI→expert,MoAI-Easy→basic,MoAI-Learn→learn,其他→expert;显式参数优先。渲染后需简要汇报模式、层级、标题与关键章节,并用平台命令(Darwin 用 open,Linux 用 xdg-open,Windows Git-Bash/MSYS 用 start)自动打开文件,失败则打印绝对路径。
限制:Markdown 孪生文件只保留结论、数字、表格、行动项等核心事实,不得加入层级增强内容;作为智能体上下文时应使用 .md 而非 .html。未提供的信息在资料中未涉及。