名称： solo-cli
描述： 通过命令行界面（CLI）或交互式终端用户界面（TUI）监控和操作 SOLO.ro 会计平台（包括摘要、收入、支出、队列、电子发票、公司信息）。当用户要求查看会计数据、发票、支出或电子发票文档，或将任务转换为安全的 solo-cli 命令时使用。

SOLO CLI

概述

使用 solo-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
• 电子发票：solo-cli efactura
• 公司信息：solo-cli company
• 上传：solo-cli upload file.pdf
• 删除：solo-cli queue delete <ID>
• 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

列出电子发票文档。

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"：修复 config.json 中的语法错误
• 公司信息未显示：在配置中添加 company_id 字段（可选）