财报分析入门工具

财报分析入门工具（免费版）

概述

本工具为个人投资者提供从财务数据文件到分析报告的一站式解决方案。支持Excel和PDF格式的财务数据导入，自动计算关键财务指标，生成包含趋势走势图的交互式HTML报告。适合快速解读上市公司财报.

核心能力

报告功能

处理: 解析报告功能的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回报告功能的响应数据,包含状态码、结果和日志.

报告特性

执行报告特性操作,使用input_params参数进行配置,支持创建/查询/导出等操作.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

趋势走势图

趋势走势图：每行指标含内嵌SVG走势图（实线=实际，虚线=预测）

处理: 解析趋势走势图的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回趋势走势图的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

预测标记

预测标记：预测值用特殊符号和黄色背景标记

处理: 解析预测标记的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回预测标记的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

颜色编码

颜色编码：绿色=正面，红色=负面

处理: 解析颜色编码的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回颜色编码的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

响应式

响应式：适配手机和桌面浏览器

处理: 解析响应式的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回响应式的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

打印就绪

打印就绪：内置打印CSS样式

处理: 解析打印就绪的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回打印就绪的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

处理: 解析报告特性的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回报告特性的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：文件分析财务数据、生成含趋势图的、分析报告、面向个人投资者与、初级分析师的财务、报告分析工具、支持从本地、文件提取财务数据、自动生成包含趋势、的交互式、Use、when、需要数据分析、报表生成、统计洞察、数据可视化时使用、不适用于实时流数、据处理、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一：分析上市公司财报

用户输入："帮我分析这份Excel财报数据"

输入格式

# 从Excel生成分析报告
python3 （请参考skill目录中的脚本文件） input.xlsx \
  -o html \
  --company "示例公司" \
  --ticker "000001.SZ"
# ...
# 示例

场景二：PDF财报提取

用户输入："从这份PDF年报里提取财务数据并分析"

# 从PDF提取并生成报告
python3 （请参考skill目录中的脚本文件） annual_report.pdf \
  -o html \
  --company "某上市公司" \
  --ticker "600519.SH"

场景三：数据可视化

用户输入："把这些财务数据画成趋势图"

# 生成含趋势图的报告
python3 （请参考skill目录中的脚本文件） financial_data.xlsx \
  -o html \
  --include-sparkline \
  --include-forecast

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

环境准备

# 依赖说明
pip install pandas openpyxl pdfplumber
# ...
# 生成报告
python3 （请参考skill目录中的脚本文件） data.xlsx -o html --company "公司名"

常用命令

# 基本用法
# ...
# 指定公司信息
  -o html \
  --company "公司名" \
  --ticker "000001.SZ" \
  --output-dir ./reports
# ...
# 含预测标记
  -o html \
  --include-forecast

配置示例

报告生成配置

report_config:
  input:
    supported_formats: ["xlsx", "xls", "pdf"]
    encoding: "utf-8"
# ...
  output:
    format: "html"               # 免费版仅支持html
    dir: "./reports"
    filename_pattern: "{company}_财务分析报告_{date}"
# ...
  charts:
    sparkline: true              # 趋势走势图
    forecast_markers: true       # 预测标记
    color_coding: true           # 颜色编码
    responsive: true             # 响应式布局
# ...
  metrics:
    auto_calculate: true         # 自动计算指标
    include_definitions: true    # 包含指标定义

最佳实践

1. 数据完整性：确保Excel/PDF包含完整的三大报表数据
2. 时间跨度：至少3年数据才能生成有意义的趋势图
3. 格式规范：使用标准财务报表格式，便于自动提取
4. 报告存档：生成的HTML报告建议按公司+日期归档

常见问题

Q1：免费版支持PDF格式导出吗？

免费版仅支持HTML格式输出。如需PDF/DOCX/Markdown等多格式导出，建议升级PRO版.

Q2：PDF数据提取准确率如何？

PDF提取准确率取决于原文档格式。表格清晰的PDF提取效果较好，扫描版PDF效果较差。建议优先使用Excel格式.

Q3：支持批量处理多个文件吗？

免费版仅支持单文件处理。如需批量分析多只公司的财报并生成对比报告，建议升级PRO版.

Q4：报告中的预测数据从哪来？

预测数据基于历史趋势的简单外推，仅供参考。免费版使用基础预测算法，PRO版提供更高级的预测模型.

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python版本: 3.8+

第三方依赖

API Key 配置

• 免费版无需任何API Key
• 所有数据处理在本地完成

可用性分类

• 分类: MD+EXEC（Markdown指令+Python脚本执行）
• 说明: 从本地文件提取财务数据并生成HTML分析报告
• 免费版限制: 仅HTML输出、单文件处理、基础预测算法

错误处理

已知限制

• 本地运行，不支持多设备同步
• 报告内容质量依赖输入数据的完整性与准确性
• 免费版不支持自定义模板与品牌化样式
• 大数据量汇总时生成速度可能较慢

示例

基本用法

输出：返回执行结果,包含操作状态和输出数据

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功

输出格式

{
  "success": true,
  "data": {
    "result": "财报分析入门工具处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "finance report"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}