核心用法
ezBookkeeping 是一款开源、自托管的个人财务管理应用，通过 ebktools.sh（Linux/macOS）或 ebktools.ps1（Windows）命令行脚本暴露完整 API 能力。用户仅需配置两个环境变量——服务器地址 EBKTOOL_SERVER_BASEURL 与 API 令牌 EBKTOOL_TOKEN——即可在无图形界面的场景下完成记账操作。
技能支持的功能覆盖记账全生命周期：
- 交易管理：增删改查收支记录，支持多币种
- 账户体系：银行账户、现金、信用卡等资产账户的创建与余额追踪
- 分类标签：自定义收支类别与标签，实现多维度的财务分析
- 数据查询：按时间、账户、分类等维度筛选交易流水
AI Agent 可通过调用 list 获取全部命令清单，通过 help <command> 查询具体参数，进而以声明式方式拼接指令完成自动化记账。
显著优点
1. 隐私优先：完全自托管，财务数据不出本地服务器，规避 SaaS 服务的隐私泄露风险
2. 轻量无依赖：纯 Shell/PowerShell 脚本实现，无需额外运行时，适合 NAS、树莓派等低资源环境
3. API 原生设计：所有功能均通过 RESTful API 暴露，便于与 Home Assistant、n8n 等自动化平台集成
4. 跨平台一致：单一代码仓库维护双平台脚本，降低多环境部署成本
5. 开源透明：GitHub 公开源码，社区可审计无后门
潜在缺点与局限性
- 技术门槛：需自行部署后端服务、配置反向代理与 SSL，非技术用户上手困难
- 无内置可视化：纯 CLI 交互，财务分析需依赖前端网页或第三方工具二次处理
- 令牌安全：API Token 以明文环境变量存储，共享主机或多用户场景下存在泄露风险
- 功能边界：定位为个人轻量记账，缺乏企业级多账簿、权限分级、发票管理等进阶能力
- 社区规模：相比 Firefly III、Actual 等竞品，生态插件与迁移工具较少
适合人群
- 隐私敏感型用户：不愿将财务数据托管至云端
- 自托管爱好者：已拥有 NAS/服务器，追求基础设施一体化
- 自动化极客：希望将记账融入现有 CLI 工作流或 CI/CD 流水线
- 极简主义者：排斥功能臃肿的综合性财务软件
常规风险
| 风险类别 | 说明 |
|---------|------|
| 部署安全 | 默认 HTTP 传输，公网暴露需额外配置 HTTPS 与防火墙规则 |
| 凭证管理 | API Token 长期有效，泄露后可完全操控账户数据，建议配合 Vault 等密钥管理工具 |
| 数据持久化 | 自托管场景下备份策略由用户自行负责，单点故障可能导致数据丢失 |
| 供应链风险 | 脚本通过 `curl`/`Invoke-WebRequest` 直接下载执行，需校验 checksum 或锁定特定 commit |
综合来看，ezBookkeeping 是技术向用户在隐私与便利之间的务实折中方案，适合作为个人财务管理的"最后一公里"工具。