SOLO CLI

概述

使用 solo-cli 通过命令行界面（CLI）或交互式 TUI 访问 SOLO.ro 会计平台的数据。

安装

如果系统中尚未提供 solo-cli 命令，可通过 Homebrew 安装：

brew install rursache/tap/solo-cli

默认配置与安全性

• 配置文件路径：~/.config/solo-cli/config.json（首次运行时自动创建）
• 使用 --config 或 -c 指定自定义配置文件路径
• 凭据仅本地存储，绝不会以命令行参数形式传递
• 会话 Cookie 缓存至 ~/.config/solo-cli/cookies.json，以加快后续登录速度

快速上手

• 配置：编辑 ~/.config/solo-cli/config.json，填入用户名和密码
• 汇总信息：solo-cli summary
• 指定年份汇总：solo-cli summary 2025
• 收入列表：solo-cli revenues
• 支出列表：solo-cli expenses
• 待处理队列：solo-cli queue
• 电子发票（e-Factura）：solo-cli efactura
• 公司信息：solo-cli company
• 上传文件：solo-cli upload file.pdf
• 删除队列条目：solo-cli queue delete
• TUI 模式：solo-cli（不带任何子命令）
• 演示模式：solo-cli demo

配置

配置文件结构如下：

{
  "username": "your_email@solo.ro",
  "password": "your_password",
  "company_id": "12345",
  "page_size": 100,
  "user_agent": "Mozilla/5.0 ..."
}

命令

summary [year]

显示指定年份的账户汇总信息。

solo-cli summary          # 当前年份
solo-cli summary 2025     # 指定年份

输出内容：年份、收入、支出、税额

revenues

列出收入类发票。

solo-cli revenues
solo-cli rev              # 别名

输出内容：发票编号、金额、币种、是否已支付、客户名称

expenses

列出支出记录。

solo-cli expenses
solo-cli exp              # 别名

输出内容：金额、币种、分类、供应商名称

queue

列出支出待办队列中的文档，或删除其中条目。

solo-cli queue            # 列出队列
solo-cli q                # 别名
solo-cli queue delete 123 # 按 ID 删除条目
solo-cli q del 123        # 别名

输出内容：文档名称、等待天数、是否逾期（含 ID）

efactura

列出 e-Factura 文档。

solo-cli efactura
solo-cli ei               # 别名

输出内容：序列号、金额、币种、日期、交易方名称

company

显示公司档案信息。

solo-cli company

输出内容：公司名称、CUI（罗马尼亚税务识别号）、注册号、地址

upload

上传支出类文档（PDF 或图片格式）。

solo-cli upload invoice.pdf
solo-cli up invoice.pdf   # 别名

输出内容：上传状态及确认信息

demo

使用模拟数据启动 TUI，适用于截图或测试（不调用真实 API）。

solo-cli demo

tui

启动交互式 TUI 模式（未指定子命令时的默认行为）。

solo-cli tui
solo-cli                  # 等效于上一条命令

全局选项

示例

# 基本用法
solo-cli summary
solo-cli revenues

# 使用自定义配置
solo-cli -c ~/work-config.json summary

# 管道配合 grep 过滤
solo-cli expenses | grep -i "food"

# 查看特定年份
solo-cli summary 2024

# 上传文档
solo-cli upload invoice.pdf

# 删除队列中某一项
solo-cli queue delete 123456

认证流程

1. 启动时从 ~/.config/solo-cli/cookies.json 加载 Cookie
2. 通过一次测试 API 调用来验证 Cookie 是否有效
3. 若有效，则复用缓存的会话
4. 若无效或缺失，则使用配置文件中的凭据执行登录
5. 将新生成的 Cookie 保存至本地，供下次会话使用

故障排查

• “credentials missing”（缺少凭据）：在 config.json 中填写正确的 SOLO.ro 用户名和密码
• “authentication failed”（认证失败）：检查用户名和密码是否正确
• “invalid JSON in config”（配置文件 JSON 格式错误）：修正 config.json 中的语法错误
• 公司信息未显示：在配置中添加 company_id 字段（可选）