用途：qbo 是 QuickBooks Online 的命令行工具，用于查询、创建、更新和管理 QBO 实体（发票、客户、账单、付款等），适合在终端或智能体中自动化处理财务数据。
安装：macOS/Linux 用 brew install voska/tap/qbo；Windows 用 scoop bucket add voska https://github.com/voska/scoop-bucket && scoop install qbo；Go 用 go install github.com/voska/qbo-cli/cmd/qbo@latest；也可从 GitHub Releases 下载二进制。
认证：需 Intuit 开发者账号与 QuickBooks 应用获取 OAuth 凭据。先执行 qbo auth set-client --client-id your_client_id --client-secret your_client_secret 存入系统钥匙串；沙箱用 qbo auth login --sandbox，生产用 qbo auth login --redirect-uri https://yourdomain.com，或设置 QBO_REDIRECT_URI。无浏览器时用 qbo auth login --manual 打印 URL。凭据解析优先级为环境变量、钥匙串、config.json；无头主机可设 QBO_KEYRING_BACKEND=file。
主要能力：list/query 支持 --where 过滤与 --results-only 解包；get 按 ID 获取；create/update/void 支持从 stdin 或文件输入，update 可用 --sparse 做部分更新；report 生成利润表、资产负债表等；attach、download、pdf 处理附件与交易 PDF；void 可作废交易，支持 --dry-run 与 --sync-token；recurringtransaction 管理定期交易模板；schema 与 exit-codes 提供智能体自省。
用法要点：程序化解析时始终加 --json；响应结构为 QueryResponse、实体包装或 Header/Rows，可用 jq 提取。常见流程为创建客户、项目、发票并记录付款。
限制：需自行申请 Intuit 凭据；生产环境不允许 localhost 回调，需隧道或自有域名；作废不可撤销；令牌过期需 qbo auth refresh 或重新登录；未提供公司 ID 时需设置 QBO_COMPANY_ID 或 qbo company switch。