financial-report-render-claw

# 财务报表渲染虾 🦐 将数据分析结果转化为精美、可汇报的正式文件。交付即用，无需人工排版。 ## 工作流程 ### 1. 接收分析结果 明确输入： - **数据来源**：已有分析结果（Markdown 文本、JSON 数据、Python DataFrame、或直接描述的结论） - **报告类型**：财务报告、经营分析、月报/季报/年报、项目汇报、数据看板 - **输出格式**：PDF / Word（.docx） / HTML / Markdown / 图片（PNG） - **受众**：管理层、投资人、内部团队、外部审计？（决定措辞和详略） 如果输入不完整，先向用户确认缺少的部分。 ### 2. 规划报告结构 根据报告类型选择模板结构： | 报告类型 | 推荐结构 | |---------|---------| | 财务报告 | 执行摘要 → 核心指标 → 收入分析 → 成本分析 → 利润分析 → 现金流 → 风险提示 → 建议 | | 经营分析 | 执行摘要 → 业务概览 → KPI 达成 → 趋势分析 → 问题诊断 → 行动建议 | | 月报/季报 | 本期概览 → 同比环比 → 重点项目 → 下期计划 | | 项目汇报 | 项目背景 → 进展概览 → 关键成果 → 问题与风险 → 下一步 | 详细模板规范见 `references/report-templates.md`。 ### 3. 生成图表 使用 `scripts/chart_generator.py` 生成专业图表： ```bash # 折线图（趋势） python3 scripts/chart_generator.py line -i {数据文件} -x {X轴列} -y {Y轴列} -o {输出路径} --title "{标题}" # 柱状图（对比） python3 scripts/chart_generator.py bar -i {数据文件} -x {分类列} -y {数值列} -o {输出路径} --title "{标题}" [--horizontal] [--stacked] # 饼图（占比） python3 scripts/chart_generator.py pie -i {数据文件} -x {分类列} -y {数值列} -o {输出路径} --title "{标题}" # 组合图（柱+线） python3 scripts/chart_generator.py combo -i {数据文件} -x {X轴列} -y-bar {柱状列} -y-line {折线列} -o {输出路径} --title "{标题}" ``` 图表样式规范： - 配色使用 `assets/chart_theme.json` 中的专业商务色板 - 中文字体自动适配（macOS: PingFang SC，Linux: Noto Sans CJK） - 尺寸默认 10x6 英寸，300 DPI，适合印刷 - 图表标题使用报告语言（中文报告用中文标题） ### 4. 渲染报告文件 #### HTML 报告（推荐，支持丰富排版） ```bash python3 scripts/report_renderer.py html {report_config.json} -o {输出目录} --theme professional ``` HTML 报告特点： - 响应式布局，桌面和移动端均可阅读 - 支持图表嵌入、数据表格、高亮框 - 内置打印优化 CSS，Ctrl+P 可直接导出 PDF - 可选深色/浅色主题 #### PDF 报告 方式一：HTML 转 PDF（推荐） ```bash python3 scripts/report_renderer.py html {report_config.json} -o {输出目录} --theme professional # 然后使用系统工具转换，或让用户在浏览器中打印为 PDF ``` 方式二：直接生成 PDF（需 weasyprint） ```bash python3 scripts/report_renderer.py pdf {report_config.json} -o {输出路径} --theme professional ``` #### Word 报告（.docx） ```bash python3 scripts/report_renderer.py docx {report_config.json} -o {输出路径} ``` Word 报告特点： - 使用标准样式，兼容 Microsoft Office 和 WPS - 图表以高分辨率 PNG 嵌入 - 目录自动生成 - 页眉页脚包含公司名称和日期 ### 5. 报告配置 所有格式共用相同的 JSON 配置结构： ```json { "title": "2025年度财务分析报告", "subtitle": "内部管理报告 · 机密", "metadata": { "period": "2025-01 至 2025-12", "author": "数据分析部门", "date": "2025-01-15", "version": "1.0" }, "company": { "name": "XX有限公司", "logo": "assets/logo.png" }, "sections": [ { "title": "执行摘要", "type": "summary", "content": "本期实现营业收入 1,234 万元，同比增长 15.2%...", "highlights": [ {"label": "营业收入", "value": "1,234万", "change": "+15.2%", "positive": true}, {"label": "净利润", "value": "156万", "change": "+8.7%", "positive": true} ] }, { "title": "核心指标", "type": "kpi-cards", "items": [ {"label": "毛利率", "value": "42.3%", "target": "40%", "status": "达标"}, {"label": "应收账款周转天数", "value": "45天", "target": "<60天", "status": "达标"} ] }, { "title": "收入趋势分析", "type": "chart", "image": "charts/revenue_trend.png", "caption": "图1：2025年各月营业收入及同比增长率", "analysis": "Q3收入增速放缓，主要受..." }, { "title": "成本结构", "type": "chart", "image": "charts/cost_structure.png", "caption": "图2：成本构成分析", "analysis": "原材料成本占比 38%，同比上升 2.1 个百分点..." }, { "title": "风险与建议", "type": "advisory", "risks": [ {"level": "高", "description": "应收账款增速高于收入增速，关注回款风险"}, {"level": "中", "description": "原材料价格波动可能影响毛利率"} ], "recommendations": [ "加强应收账款管理，缩短账期", "建立原材料价格对冲机制" ] } ], "appendix": [ {"title": "数据来源说明", "content": "本报告数据来源于公司财务系统..."}, {"title": "计算方法", "content": "同比增长率 = (本期 - 去年同期) / 去年同期 × 100%"} ] } ``` 详细的 section type 和配置选项见 `references/report-config-spec.md`。 ### 6. 质量检查 渲染完成后，检查： - [ ] 所有图表清晰可读，无乱码 - [ ] 数字格式统一（千分位分隔、小数位数） - [ ] 同比/环比标注完整 - [ ] 页面布局无溢出、无截断 - [ ] 公司名称、日期等元信息正确 - [ ] 如有要求，确认敏感信息已脱敏 ## 设计原则 1. **专业优先**：商务配色、清晰层级、适当留白，拒绝花哨 2. **数据准确**：所有数字必须与源数据一致，图表标注数据来源 3. **结论前置**：执行摘要放在最前面，让读者 30 秒抓住重点 4. **一图胜千言**：能用图表表达的，不用纯文字堆砌 5. **可复现**：保存配置文件，下次更新数据只需替换数据源 ## 依赖 - Python 3.8+ - 必需：`pandas`、`matplotlib`、`jinja2` - 可选：`weasyprint`（PDF 直出）、`python-docx`（Word 输出） - 运行前检查依赖：`pip3 list | grep -E "pandas|matplotlib|jinja2"` ## 与数据分析虾的协作 本 skill 专注**渲染和排版**，与 `auto-data-analysis-claw`（数据分析虾）形成上下游关系： - 数据分析虾完成数据清洗、分析计算、产出结论 - 本 skill 接收分析结论，负责排版、图表生成、文件导出 两个 skill 可在同一个对话中串联使用，也可独立工作。