Install
openclaw skills install @thcjp/finance-report-tool-proopenclaw skills install @thcjp/finance-report-tool-pro本系统为专业分析师和投研机构提供全功能的财报分析能力。相比免费版,PRO版新增批量处理、多格式导出、OCR识别、行业基准对比和高级预测模型,全面满足专业财报分析与报告生成的复杂需求. PRO版完全兼容免费版全部命令与报告格式,升级后原有工作流可直接使用.
| 功能 | 免费版 | PRO版 |
|---|---|---|
| 数据提取 | Excel/PDF | +扫描版PDF(OCR) |
| 报告格式 | 仅HTML | HTML/PDF/DOCX/MD |
| 批量处理 | 不支持 | 多文件并行 |
| 行业基准 | 不支持 | 同业对标+百分位 |
| 预测模型 | 基础外推 | ARIMA/ML/回归 |
| 报告模板 | 固定模板 | 自定义品牌模板 |
| 对比报告 | 不支持 | 多公司横向对比 |
处理: 解析PRO版功能增强对比的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回PRO版功能增强对比的响应数据,包含状态码、结果和日志.
| 模型 | 适用场景 | 准确度 |
|---|---|---|
| 线性回归 | 线性趋势数据 | 中 |
| ARIMA | 时间序列预测 | 高 |
| 指数平滑 | 短期预测 | 中高 |
| 机器学习 | 复杂模式 | 高(需训练数据) |
| 蒙特卡洛 | 概率区间预测 | 高 |
处理: 解析高级预测模型的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回高级预测模型的响应数据,包含状态码、结果和日志.
用input_params参数进行配置.
处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:企业级财报分析系、支持批量处理、多格式导出、行业基准与深度预、面向专业分析师与、机构的财报分析系、支持批量文件处理、Markdown、行业基准对比、高级预测模型与自、定义报告模板、Use、when、需要数据分析、报表生成、统计洞察、数据可视化时使用、不适用于实时流数、据处理、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.用户输入:"分析这20家公司的年报"
用户可通过自然语言指令触发此场景,工具将自动执行相应操作并返回结构化结果.
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 财报分析专业版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
# 批量处理多个文件
python3 (请参考skill目录中的脚本文件) \
--input-dir ./annual_reports/ \
--output-dir ./reports/ \
--format pdf \
--parallel 5
# ...
# 生成对比报告
python3 (请参考skill目录中的脚本文件) \
--input-dir ./reports/ \
--output industry_comparison.xlsx \
--benchmark "industry_average"
用户输入:"对比这家公司与行业平均水平"
# 行业基准分析
python3 (请参考skill目录中的脚本文件) \
--company "600519.SH" \
--industry "白酒" \
--metrics "roe,gross_margin,pe,pb" \
--output benchmark_report.pdf
用户输入:"用我们公司的模板生成财报分析"
# 使用自定义模板
python3 (请参考skill目录中的脚本文件) data.xlsx \
-o pdf \
--template "company_brand" \
--logo ./logo.png \
--colors "#1a5276,#2e86c1"
# 依赖说明
pip install -r requirements_pro.txt
# ...
# 配置报告模板
cp config_pro_template.yaml config_pro.yaml
# 批量处理
python3 (请参考skill目录中的脚本文件) --input-dir ./data/ --format pdf
# ...
# 多格式导出
xlsx -o pdf,docx,html
# ...
# OCR提取
python3 (请参考skill目录中的脚本文件) scanned_report.pdf --ocr
# ...
# 行业基准
python3 (请参考skill目录中的脚本文件) --company "000001.SZ" --industry "银行业"
# ...
# 高级预测
--forecast-model arima \
--forecast-years 3
pro_config:
processing:
batch:
max_parallel: 5 # 最大并行数
timeout: 600 # 超时(秒)
ocr:
enabled: true
engine: "tesseract"
languages: ["chi_sim", "eng"]
# ...
output:
formats: ["html", "pdf", "docx", "markdown"]
dir: "./reports"
template_dir: "./templates"
branding:
logo: "./assets/logo.png"
primary_color: "#1a5276"
font: "Microsoft YaHei"
# ...
forecast:
models: ["arima", "linear", "exponential"]
default_model: "arima"
forecast_years: 3
confidence_interval: [0.05, 0.95]
# ...
benchmark:
industry_data: "./benchmarks/"
metrics:
- roe
- roa
- gross_margin
- net_margin
- pe
- pb
- debt_ratio
percentile_ranking: true
| 实践领域 | 建议做法 |
|---|---|
| 批量处理 | 先小批量测试模板,确认后全量运行 |
| OCR质量 | 扫描版PDF建议300DPI以上,清晰度影响提取准确率 |
| 预测模型 | 数据量少用线性回归,数据充足用ARIMA或ML |
| 行业基准 | 选择3-5家可比公司,确保口径一致 |
| 报告品牌 | 使用企业模板保持视觉一致性 |
免费版命令 → PRO版命令(增强):
generate_report.py data.xlsx -o html → 多格式+批量+OCR
sparkline趋势图 → +预测模型可视化
基础指标计算 → +行业基准百分位
OCR准确率取决于扫描质量。300DPI以上的清晰扫描件准确率可达90%+。建议优先使用原生PDF或Excel格式,扫描版作为备选.
PRO版单批次支持最多50个文件的并行处理。建议根据CPU核心数调整并行度,避免内存不足.
PRO版内置常见行业的基准数据。用户也可导入自定义基准数据(如同业公司的财务数据),进行更精准的对标分析.
PRO版支持基于Jinja2的自定义模板。在templates目录创建HTML模板文件,使用变量占位符(如、),系统自动填充数据.
置信区间表示预测值的可能范围。例如95%置信区间表示预测值有95%的概率落在该范围内。区间越窄说明预测越精确,但过低可能意味着模型过拟合.
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
| Python | 运行时 | 必需 | 系统安装或conda环境 |
| pandas | Python库 | 必需 | pip install pandas |
| openpyxl | Python库 | 必需 | pip install openpyxl |
| pdfplumber | Python库 | 必需 | pip install pdfplumber |
| pytesseract | Python库 | 可选 | pip install pytesseract(OCR) |
| jinja2 | Python库 | 必需 | pip install jinja2(模板) |
| statsmodels | Python库 | 可选 | pip install statsmodels(ARIMA) |
| weasyprint | Python库 | 可选 | pip install weasyprint(PDF导出) |
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
{
"success": true,
"data": {
"result": "财报分析专业版处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "finance report pro"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置,禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令,避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议,验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
使用前请确认已阅读依赖说明章节,确保运行环境满足安全要求。