← 返回 Skills 市场

Beancount

Name: Beancount
Author: bytesagain-lab

作者 bytesagain-lab · GitHub ↗ · v2.0.0 · MIT-0

cross-platform ✓ 安全检测通过

385

总下载

当前安装

版本数

在 OpenClaw 中安装

/install beancount

功能描述

Personal bookkeeping assistant for local income and expense tracking, monthly reports with comparisons, budget alerts, and savings goal management.

使用说明 (SKILL.md)

bookkeeping

记账管家。收支记录、月度报表（含同比环比）、预算管理、存钱目标追踪。数据存本地JSON。

Commands

All commands via scripts/book.sh:

Command	Usage	Description
`add`	`book.sh add "金额" "类别" "备注" [--type income\|expense]`	记一笔账（默认expense）
`list`	`book.sh list [--month 2026-03]`	查看记录（默认当月）
`report`	`book.sh report [--month 2026-03]`	月度收支报表（含同比环比+分类饼图+支出TOP3）
`budget`	`book.sh budget "类别" "月预算"`	设置类别月预算（超支自动提醒）
`goal`	`book.sh goal "目标名" "金额" "月数"`	设置存钱目标（计算每月需存）
`goal-save`	`book.sh goal-save "目标名" "金额"`	往目标里存钱
`goals`	`book.sh goals`	查看所有存钱目标进度
`help`	`book.sh help`	显示帮助信息

Data Storage

记录文件: ~/.bookkeeping/records.json
预算文件: ~/.bookkeeping/budgets.json
目标文件: ~/.bookkeeping/goals.json
自动创建目录和文件

Examples

# 记一笔支出
bash scripts/book.sh add 35.5 餐饮 "午餐外卖"

# 记一笔收入
bash scripts/book.sh add 15000 工资 "3月工资" --type income

# 查看当月记录
bash scripts/book.sh list

# 查看指定月份
bash scripts/book.sh list --month 2026-02

# 生成月度报表（含同比环比）
bash scripts/book.sh report

# 设置餐饮预算
bash scripts/book.sh budget 餐饮 2000

# 设置存钱目标（6个月存8000）
bash scripts/book.sh goal "买相机" 8000 6

# 往目标存钱
bash scripts/book.sh goal-save "买相机" 1500

# 查看所有目标进度
bash scripts/book.sh goals

Categories (建议)

支出: 餐饮、交通、购物、娱乐、居住、医疗、教育、其他
收入: 工资、奖金、理财、兼职、其他

Reference

参考文档: tips.md — 记账理财小贴士（50-30-20法则、存钱技巧等）

Notes

数据存储在 ~/.bookkeeping/ 目录
JSON 格式，可手动编辑
纯本地运行，无需联网
Python 3.6+ 兼容

💬 Feedback & Feature Requests: https://bytesagain.com/feedback Powered by BytesAgain | bytesagain.com

安全使用建议

This skill implements a local bookkeeping tool and appears to do only local file read/write in your home directory. Before installing: (1) review and trust the source (files include an extra scripts/script.sh that is not referenced by SKILL.md), (2) be aware it will create ~/.bookkeeping/records.json, budgets.json, goals.json (and scripts/script.sh may use ~/.local/share/beancount), (3) if your records are sensitive consider encrypting/backing up those files or placing them in an encrypted directory, and (4) if you don't need the extra scripts, remove them after inspection. If you want higher assurance, ask the maintainer for provenance (commit history or release page) or run the scripts in a sandbox first.

功能分析

Type: OpenClaw Skill Name: beancount Version: 2.0.0 The skill provides local bookkeeping and financial management functionality, including expense tracking, budgeting, and savings goals. All data is stored locally in JSON format within the user's home directory (~/.bookkeeping), and the scripts (scripts/book.sh and scripts/script.sh) contain no network calls, obfuscation, or unauthorized file access. The logic is transparent and aligns perfectly with the stated purpose in SKILL.md.

能力评估

ℹ Purpose & Capability

SKILL.md and scripts/book.sh align: personal bookkeeping, local JSON storage in ~/.bookkeeping, commands implemented in scripts/book.sh. One extra companion script (scripts/script.sh) is included that uses a different data directory (~/.local/share/beancount) and provides a generic CLI; it is not referenced by the SKILL.md commands. The extra script is likely benign but unnecessary and should be noted.

✓ Instruction Scope

Runtime instructions (SKILL.md) say data is stored locally and scripts/book.sh only reads/writes files under the user's home (~/.bookkeeping). There are no network calls, no reads of unrelated system files, and no access to credentials in the provided code.

✓ Install Mechanism

No install spec; this is an instruction+script bundle. No downloads or archive extraction are present in the package, so nothing is written to disk beyond the included files and the data files the scripts deliberately create.

✓ Credentials

The skill declares no required environment variables or credentials. The scripts respect common environment conventions: scripts/script.sh will honor BEANCOUNT_DIR or XDG_DATA_HOME if set, and both scripts expand $HOME for data storage. That use is reasonable and optional, not required.

✓ Persistence & Privilege

always is false and the skill does not modify other skills or system-wide settings. It creates and writes its own data files under the user's home directory only.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install beancount
安装完成后，直接呼叫该 Skill 的名称或使用 /beancount 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v2.0.0

v2.5 standard: Use-when desc, homepage, source, security fix

v1.0.4

yaml-fix+quality

v1.0.3

yaml-fix+quality

v1.0.2

Quality upgrade

v1.0.1

Quality upgrade: custom functionality

v1.0.0

Initial release

元数据

Slug beancount

版本 2.0.0

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 6

常见问题

Beancount 是什么？

Personal bookkeeping assistant for local income and expense tracking, monthly reports with comparisons, budget alerts, and savings goal management. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 385 次。

如何安装 Beancount？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install beancount」即可一键安装，无需额外配置。

Beancount 是免费的吗？

是的，Beancount 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Beancount 支持哪些平台？

Beancount 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Beancount？

由 bytesagain-lab（@bytesagain-lab）开发并维护，当前版本 v2.0.0。