核心用法
ezBookkeeping API Tools 是一套命令行脚本工具，用于与自托管的个人记账应用 ezBookkeeping 进行交互。用户可通过 ebktools.sh（Linux/macOS）或 ebktools.ps1（Windows）执行多种财务操作，包括：记录新交易、查询历史交易、获取账户信息、检索分类与标签、以及获取汇率数据。
使用前需配置两个必要环境变量：EBKTOOL_SERVER_BASEURL（服务器地址）和 EBKTOOL_TOKEN（API 令牌），可通过系统环境变量或用户主目录的 .env 文件设置。
显著优点
1. 自托管隐私保障：数据完全由用户掌控，无需上传至第三方云服务
2. 跨平台支持：提供 Bash 和 PowerShell 双版本脚本，覆盖主流操作系统
3. 功能完整：涵盖记账核心场景（交易记录、查询、分类管理、汇率参考）
4. 命令行高效性：适合自动化脚本、批量操作和开发工作流集成
潜在缺点与局限性
- 部署门槛：需自行搭建 ezBookkeeping 服务端，对非技术用户有学习成本
- 令牌安全管理：
EBKTOOL_TOKEN相当于账户凭证，泄露将导致财务数据风险 - 无图形界面：纯命令行交互，不适合偏好可视化操作的用户
- 网络依赖：所有操作需连接自托管服务器，离线无法使用
适合人群
- 注重数据隐私的技术用户
- 已使用或计划部署 ezBookkeeping 的开发者
- 需要将记账操作集成到自动化工作流的高级用户
- 偏好命令行效率的极简主义者
常规风险
- 令牌泄露风险：API 令牌需妥善保管，避免硬编码在共享代码或日志中
- 服务器安全责任：自托管意味着用户自行承担服务器安全防护（HTTPS、访问控制等）
- 数据备份义务：无云服务商兜底，需自行建立备份机制