Finance Tools

这是纯Python开发的本地财务分析工具，无外部依赖，自动识别CSV中的金额、日期、类别列。含7个子命令，可实现收支汇总、财务比率计算、趋势分析等功能，适用于个人理财、小企业财务、团队预算管理场景，输入为CSV数据，输出可视化文本结果，纯本地运行更安全。

cqdev-ai

热度 17.14

最近更新 2026-07-20 11:25:38

分类：数据依赖：代码执行 / 读写文件应用场景：数据处理 / 财务 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add finance-tools

Metadata

name: finance-tools
description: 财务分析工具集 v1.1.0。7个子命令覆盖财务分析全流程。自动识别CSV中的金额、日期、类别列。纯Python标准库，无外部依赖。 Use when: 需要快速分析交易数据、计算财务比率、查看收支趋势、分类汇总、预算对比、同比环比、趋势预测。 🎉 v1.1.0 功能: - analyze — 收支汇总 + 分位数 + 月度净额 - ratios — 财务比率(毛利率/净利率/ROE/ROA/ROI/负债率) - trend — 月度趋势(含MA移动平均和YoY) - category (NEW) — 分类汇总(ASCII条形图+占比) - budget (NEW) — 预算 vs 实际对比(执行率) - yoy (NEW) — 同比/环比增长分析 - forecast (NEW) — 趋势预测(线性回归/移动平均) 触发关键词：财务分析、收入支出、财务比率、趋势分析、分类汇总、预算管理、同比环比、数据预测适用范围：CSV 格式的财务/交易数据运行模式：纯本地，无网络请求 ❎ 外部依赖：Python标准库（无需额外安装）

💰 Finance Tools v1.1.0

Overview

自动识别CSV中的金额列(amount/收入/支出)、日期列(date/日期)、类别列(category/类型)，无需手动指定列名。7个子命令覆盖从基础分析到预测的全流程。

Usage

analyze — 收支分析（扩展版）

python3 scripts/finance_tools.py analyze --file transactions.csv

# 📊 财务分析 — transactions.csv
#    总交易数: 1,200
#    收入合计:         485,230.00
#    支出合计:         312,450.00
#    净额:            172,780.00
#    收支比:               1.55x
#    P25:            120.00 | P75: 850.00
#
#    月度净额:
#     2026-01:  145,000.00

ratios — 财务比率（扩充版）

python3 scripts/finance_tools.py ratios --file financials.csv

# 📈 财务比率分析 — financials.csv
#    revenue: 1,250,000.00   cost: 875,000.00
#    毛利率: 30.00%
#    ROE(净资产收益率): 18.50%
#    ROI(投资回报率): 12.30%

trend — 月度趋势（含移动平均）

python3 scripts/finance_tools.py trend --file income.csv --ma 3

# 📈 月度趋势分析 — income.csv
#    月份       金额          环比     同比     MA-3
#    2026-01   98,500.00     —       —     98,500.00
#    2026-02  102,300.00  +3.9%      —    100,400.00

category — 分类汇总 (NEW)

python3 scripts/finance_tools.py category --file transactions.csv

# 📂 分类汇总 — transactions.csv
#    ████████████████ 工资                350,000.00 (72.1%)
#    ██████           餐饮                 45,200.00 ( 9.3%)

budget — 预算对比 (NEW)

python3 scripts/finance_tools.py budget --file actual.csv --budget-file budget.csv

# 📋 预算 vs 实际
#    类别        实际       预算        差异       执行率
#    工资     350,000  360,000   -10,000   97.2%

yoy — 同比环比 (NEW)

python3 scripts/finance_tools.py yoy --file revenue.csv

# 📊 同比/环比增长分析
#    月份       金额       环比(MoM)   同比(YoY)
#    2026-01  98,500       —           —
#    2026-02 102,300     +3.9%       +5.2%

forecast — 趋势预测 (NEW)

python3 scripts/finance_tools.py forecast --file revenue.csv --periods 6

# 🔮 趋势预测 — revenue.csv
#    模型: 线性增长 (斜率=+2,350.00/月, R²=0.923)
#    2026-07: 112,000.00  (+3.2% 预测增长)

列名自动识别

角色	匹配关键词
金额	amount, 金额, revenue, 收入, expense, 支出, cost, 成本, profit, 利润, actual, budget
日期	date, 日期, time, 时间, month, 月份, period, 期间
类别	category, 类别, type, 类型, name, 名称, department, project

Use Cases

个人理财: analyze 月度汇总 + category 分类 + forecast 支出预测
小企业: ratios 财务比率 + yoy 同比 + budget 预算管理
团队预算: budget 执行率 + trend 趋势 + forecast 预测

Security

✅ 纯本地运行，无网络请求
✅ 只读输入文件
❌ 无任意代码执行
❌ 无系统命令执行