技能介绍

解决的问题

当你拿到一份 PPT、Word 文档、Markdown 笔记、Excel 表格，甚至 JSON 分析契约时，想把内容变成能直接分享或打印的 HTML 报告，通常会面临三个问题：一是手动排版耗时，改一次样式可能就要花掉半小时；二是不同格式的内容逻辑混乱，标题、表格、图表无法统一呈现；三是 AI 直接生成的 HTML 容易出现格式溢出、样式错乱，甚至丢失核心内容。这个技能专门解决这些痛点，把「提取内容 + 重新排版」这一步自动化。

核心能力与工作流程

它的核心逻辑是格式无关，只看内容。无论你输入的是 .pptx（用 python-pptx 解析每页标题和正文）、.docx（用 python-docx 提取标题样式和表格）、.html（用 BeautifulSoup 抽取正文，去除 script/style 标签），还是 .csv/.xlsx（自动识别表格结构并生成图表），最终都会统一到一个内容模型：{"meta": {...}, "sections": [...]}。

渲染时，所有样式都遵循 Design Tokens 设计系统。比如色彩上，品牌色和涨跌语义色严格分离（A 股习惯锁死涨红 #E11D48、跌绿 #16A34A）；图表编码固定，分享类用环形图，趋势类用折线，对比类用分组柱；数字格式统一千分位、¥、万-亿缩写，日期统一 YYYY-MM-DD。

渲染模式分两种：文档式（report）是向下滚动的长页面，适合详细报告；幻灯片（deck）是全屏翻页模式，支持横向滑动、淡入淡出、3D 翻转等 5 种翻页样式，参考了 reveal.js 的设计，适合演示。
图表与媒体：图片支持 HTTP 链接、本地路径、Base64 三种格式，加载失败会显示占位提示；视频带控件不自动播放；链接自动生成带域名的卡片，段落里的裸网址会自动转成超链接，并且通过安全转义拦截 javascript: 等危险地址。
输出优化：默认 ECharts 走 CDN，离线环境可用 --inline-echarts 把图表库内联到 HTML，生成完全自包含的单文件，断网也能正常显示。

适用边界与注意点

这个技能只做内容吸收和可视化重排，不负责数据分析、计算结论或生成洞察。如果输入文档里没有 insight 区块，输出也不会凭空创造；文档式模式下，标记为 auto_chart:true 的表格会自动生成图表，但这只是「呈现」，不是「分析」。

幻灯片模式遵循「一屏一个信息」的原则，每个图表、KPI 或要点都会独占一屏，适合演示场景；如果是长文档，建议用文档式模式。另外，品牌色可以通过 --brand-color 参数覆盖，页眉会自动标注来源文件名，方便追溯。

宽表会自动套横向滚动容器和粘性表头，KPI 大数字用 clamp 自适应字号，避免溢出或重叠；分类图表超过 8 个切片时，多余的会归入「其他」，不会静默丢弃数据。整个过程不依赖外部网络，生成的 HTML 可以直接用浏览器打开，也支持通过 @media print 导出为 A4 尺寸的 PDF。