← Back to Skills Marketplace
cosmos180

家庭财务管理系统

by cosmos180 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
92
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install family-finances
Description
家庭财务管理系统——资产负债表、现金流量表、投资组合追踪与财务健康报告。当用户提到:管理家庭资产/负债、查看净资产、资产负债表、现金流表、投资组合、财务健康评分、家庭财务报表、月度收支报告时触发。
README (SKILL.md)

家庭财务管理系统

管理家庭资产负债表、现金流量表、投资组合,生成中文财务健康报告。

数据存储

  • 路径~/.openclaw/workspace/data/family-finances/
  • 文件
    • balance_sheet.json — 资产负债表
    • cashflow.json — 现金流量表(月度)
    • portfolio.json — 投资组合
  • 脚本scripts/finances.py

核心功能

1. 资产负债表

操作 方法
查看当前报表 python scripts/finances.py balance
计算净资产 python scripts/finances.py net-worth
添加/更新资产 update_asset(name, amount, category, note)
添加/更新负债 update_liability(name, amount, category, note)
删除科目 delete_asset(name) / delete_liability(name)

资产/负债分类

  • 资产:现金存款、股票、基金、债券、保险、房产、车辆、数字资产、应收账款、其他
  • 负债:房贷、消费贷、车贷、信用卡负债、亲友借款、其他

添加示例

python scripts/finances.py add-asset "招商银行存款" 150000 "现金存款" ""
python scripts/finances.py add-asset "自住房产" 5000000 "房产" "北京朝阳"
python scripts/finances.py add-liability "房贷余额" 2800000 "房贷" "公积金贷款"

2. 现金流量表

操作 方法
查看月度报表 python scripts/finances.py cashflow YYYY-MM
收入/支出记录 add_cashflow_item(year_month, "income"/"expense", category, amount, description)

收入分类:工资收入、奖金、兼职、投资收益、租金、其他收入
支出分类:餐饮、日用、交通、医疗、教育、住房、娱乐、购物、旅游、保险、税费、其他支出

添加示例

python scripts/finances.py add-cashflow 2026-04 income "工资" 35000 "月薪"
python scripts/finances.py add-cashflow 2026-04 expense "餐饮" 3000 "在家做饭"
python scripts/finances.py add-cashflow 2026-04 expense "房贷" 12000 "公积金贷款"

3. 投资组合

操作 方法
查看组合汇总 python scripts/finances.py portfolio
添加/更新持仓 update_holding(name, amount, category, note)
删除持仓 delete_holding(name)

分类:股票、基金、债券、保险、房产、车辆、现金存款、数字资产、其他

4. 综合报告

生成带财务健康评分的完整报告:

python scripts/finances.py report YYYY-MM

财务健康评分(满分100):

  • 储蓄率(满分25):年储蓄率 ≥40% 满分
  • 净资产(满分25):净资产 ≥100万满分
  • 资产结构(满分25):负债率越低分越高
  • 投资比率(满分25):投资资产占比 ≥50%满分
评分 等级
≥90 优秀
70-89 良好
50-69 一般
\x3C50 需改善

对话式工作流

当用户请求时,通过对话收集数据,调用脚本读写 JSON:

初始化/录入数据

  • 用户说"录入我的资产"→询问具体科目,逐条添加到资产负债表
  • 用户说"录入本月收支"→逐笔记录收入和支出

查询报表

  • 用户说"我的净资产是多少"→运行 net-worth 命令并解读
  • 用户说"本月花了多少钱"→运行 cashflow 命令并解读
  • 用户说"生成财务报告"→运行 report 命令,生成完整中文报告

格式规则

  • 所有金额单位:人民币(元)
  • 报告使用中文,数字加千分位分隔符
  • 定期(每月初)提醒用户更新资产快照

首次使用引导

首次触发时,引导用户建立基础数据:

  1. 先录入主要资产(存款、房产、车辆等)
  2. 录入负债(房贷、车贷等)
  3. 录入投资组合(股票、基金、保险等)
  4. 建议每月固定日期更新一次快照
Usage Guidance
该技能在本地运行并将财务数据以明文 JSON 保存到 ~/.openclaw/workspace/data/family-finances/。在安装/使用前请注意: - 若数据敏感,考虑对这些文件加密或仅在受信任环境使用; - 备份或导出数据前检查文件内容; - 若担心隐私,可手动审查 scripts/finances.py(当前代码未包含网络/外部上传逻辑); - 该技能不需要 API 密钥或外部访问权限,因此主要风险是本地数据泄露而非远程数据外泄。
Capability Analysis
Type: OpenClaw Skill Name: family-finances Version: 1.0.0 The skill bundle provides a legitimate family financial management system for tracking assets, liabilities, and cash flow. The core logic in `scripts/finances.py` manages local JSON data storage within the user's home directory and provides a CLI for the OpenClaw agent to perform CRUD operations and generate financial health reports. No evidence of data exfiltration, network activity, or malicious execution was found.
Capability Assessment
Purpose & Capability
名称/描述(家庭财务管理)与所需资源和代码一致:脚本实现资产负债表、现金流、投资组合和报告功能,均通过本地 JSON 文件读写完成。没有请求与功能不相关的凭据或二进制。
Instruction Scope
SKILL.md 指示通过对话收集数据并调用 scripts/finances.py 来读写位于 ~/.openclaw/workspace/data/family-finances/ 的 JSON 文件;代码实现与说明匹配。没有指示读取系统上无关文件或将数据发送到外部端点。
Install Mechanism
无安装规范(instruction-only + 附带 Python 脚本)。没有从不受信任的 URL 下载或安装第三方包。仅依赖本地 Python 运行脚本。
Credentials
技能不要求任何环境变量或外部凭据(这是合适的)。注意:它会在用户主目录下创建并以明文 JSON 存储敏感财务数据(~/.openclaw/workspace/data/family-finances/),这可能构成隐私/本地安全风险,需用户自行决定是否接受未加密的本地存储。
Persistence & Privilege
技能不会请求常驻(always)权限且不修改其他技能配置;但会在用户主目录下长期保存数据文件(持久化)。这是预期行为,但用户应知悉文件位置与持久性。
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install family-finances
  3. After installation, invoke the skill by name or use /family-finances
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
首发版本:资产负债表、现金流量表、投资组合、财务健康评分
Metadata
Slug family-finances
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 家庭财务管理系统?

家庭财务管理系统——资产负债表、现金流量表、投资组合追踪与财务健康报告。当用户提到:管理家庭资产/负债、查看净资产、资产负债表、现金流表、投资组合、财务健康评分、家庭财务报表、月度收支报告时触发。 It is an AI Agent Skill for Claude Code / OpenClaw, with 92 downloads so far.

How do I install 家庭财务管理系统?

Run "/install family-finances" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 家庭财务管理系统 free?

Yes, 家庭财务管理系统 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 家庭财务管理系统 support?

家庭财务管理系统 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 家庭财务管理系统?

It is built and maintained by cosmos180 (@cosmos180); the current version is v1.0.0.

💬 Comments