Generate responsive HTML pages suitable for reporting, supporting resizing and screenshot capture.

核心用法

Report Generator 是一款面向业务汇报场景的自动化报告生成技能，通过 Python 脚本将原始内容转化为精美的 HTML 报告模板。用户只需提供标题、目标、四个象限的详细内容及摘要关键词，即可快速生成符合商业审美的四象限排版报告。

操作流程：
1. 从用户输入提取结构化数据（title、goal、q1-q4、summary）
2. 调用 scripts/generate.py 生成 HTML 文件
3. 通过 browser 工具截图转换为图片格式

四象限结构（Q1-Q4）每个包含：主标题、副标题、口号式标语及要点列表，适合 OKR 复盘、季度述职等标准化汇报场景。

显著优点

• 模板化效率高：固定四象限布局，无需设计能力即可产出专业视觉
• 输出灵活：HTML 可二次编辑，截图后便于 IM、邮件、文档嵌入
• 语义结构清晰：goal + 4 维度 + summary 关键词，契合管理层阅读习惯
• 轻量依赖：仅需 Python3 环境，无复杂运行时要求

潜在缺点与局限

• 模板固化：仅支持单一版式，复杂数据可视化（图表、趋势）需额外处理
• 无实时协作：本地文件生成，不支持在线编辑或版本管理
• 截图依赖 browser 工具：若浏览器工具不可用则无法完成最终输出
• 内容质量依赖输入：无 AI 润色或智能扩展能力，需用户提供精炼的原始素材

适合人群

• 需快速产出季度/年度述职报告的职场人
• 追求「轻设计、重内容」的敏捷团队
• 需要将结构化文字转为可视化卡片的内容运营者

常规风险

• 数据隐私：输入内容会写入本地文件，敏感信息需脱敏处理
• 路径注入：若 --output 或 title 包含特殊字符可能导致文件写入异常
• 截图一致性：不同浏览器渲染引擎可能导致视觉偏差

核心用法

report-generator 是一款轻量级报告生成工具，专为结构化汇报场景设计。用户仅需提供 JSON 格式的原始内容，即可输出精美的响应式 HTML 报告，并支持转换为图片分享。

标准流程：
1. 数据准备：提取 title（标题）、goal（目标）、q1-q4（四象限内容）、summary（底部关键词）
2. 执行生成：运行 Python 脚本，自动写入 workspace/reports 目录
3. 截图导出：通过 browser 工具将 HTML 转换为 PNG 图片，便于社交媒体或邮件传播

四象限模板：每个象限包含 title（短标题）、subtitle（副标题）、slogan（口号）、items（要点列表），形成「稳交付-促增长-提效率-建反馈」的经典述职结构。

显著优点

• 零依赖：仅使用 Python 标准库（json、argparse、os），无第三方包风险
• 本地安全：无网络请求，所有操作在本地完成，数据不出境
• 开箱即用：模板风格简洁商务，Light & Concise 设计，无需设计基础
• 多场景适配：支持述职报告、季度总结、项目复盘等多种业务场景

潜在局限

• 模板固定：仅支持单一四象限布局，无法自定义 CSS 或切换主题
• 无实时预览：需生成后通过浏览器查看效果，迭代成本较高
• 数据校验弱：输入 JSON 结构错误时，错误提示不够友好
• 输出格式单一：原生仅支持 HTML，图片转换依赖外部工具

适合人群

• 职场汇报者：需要快速产出视觉规范的季度/年度述职
• 团队管理者：统一团队汇报风格，降低成员设计负担
• 数据分析师：将分析结论封装为可分享的摘要卡片

常规风险

| 风险项 | 说明 |

|--------|------|

| 路径遍历 | 若 `--output` 参数未校验，可能被恶意利用覆盖系统文件（建议始终使用相对路径） |

| JSON 注入 | 输入内容未做 HTML 转义，若 `items` 包含恶意脚本可能存在 XSS 风险（建议仅用于受信任内容） |

| 未声明许可证 | 当前 `license: unknown`，商业使用需确认授权条款 |

总体评估：代码质量良好，安全评分 A 级，适合日常办公场景，建议定期关注版本更新。