通过命令行脚本操作自托管记账工具ezBookkeeping,支持记账、查询、汇率获取等功能,需配置API令牌。
说明:
## 核心用法
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、访问控制等)
– **数据备份义务**:无云服务商兜底,需自行建立备份机制








