Nox-Lumen AutoNox-Lumen Auto

CLI 命令行

CLI 的定位

combo-cli 是面向运维 / 管理员 / 数据工程师的命令行工具,覆盖管理台和 API 不太方便做的批量、脚本化、调试场景。

安装

Python 环境

pip install combo-cli
# 或:从私有化交付包里
pip install /path/to/combo_cli-*.whl

初始化

combo-cli config init
# 交互式输入 base URL + API Key

配置文件默认在 ~/.combo/config.yaml

常用命令

认证 & 基础

combo-cli auth login              # 登录
combo-cli auth whoami             # 当前身份
combo-cli config show             # 查看当前配置
combo-cli config set base-url ... # 改 base URL

Agent / Session

combo-cli agent list
combo-cli agent create --name "代码审查" --scenario code-review
combo-cli agent show <agent_id>
combo-cli agent delete <agent_id>
 
combo-cli session list --agent <agent_id>
combo-cli session show <session_id>
combo-cli session archive <session_id>
combo-cli session export <session_id> -o session.json  # 导出会话

对话(脚本化)

combo-cli chat \
  --session <session_id> \
  --question "审查 https://gerrit.../c/12345"
 
# 流式
combo-cli chat --stream --session <session_id> --question "..."
 
# 从文件输入
combo-cli chat --session <session_id> --input-file question.md

知识库 & 文档

combo-cli kb list
combo-cli kb create --name "ABZ 项目规范"
combo-cli kb show <kb_id>
 
# 批量导入
combo-cli doc upload --kb <kb_id> ./docs/*.pdf
combo-cli doc upload --kb <kb_id> --recursive ./docs/
combo-cli doc list --kb <kb_id>
 
# 解析进度
combo-cli doc wait --kb <kb_id>
 
# 重新解析
combo-cli doc reparse <doc_id> --parser patent

技能

combo-cli skill list
combo-cli skill show <skill_id>
 
# 从 SKILL.md 发布自定义技能
combo-cli skill publish ./my-skill/
 
# 激活到 Session
combo-cli skill activate <skill_id> --session <session_id>

定时任务

combo-cli cron list
combo-cli cron create --name "每日代码审查" \
  --expr "0 9 * * *" \
  --agent <agent_id> \
  --prompt "审查昨天的所有 PR"
 
combo-cli cron delete <cron_id>

事件触发

combo-cli trigger list
combo-cli trigger create --from ./trigger.yaml
combo-cli trigger test <trigger_id> --event-file ./event.json  # 干跑

用户 / 租户管理(需管理员)

combo-cli tenant list
combo-cli tenant create --name "Corp A" --quota "tokens=10M/month"
 
combo-cli user list --tenant <tenant_id>
combo-cli user create --tenant <tenant_id> --email "alice@corp-a.com"
combo-cli user disable <user_id>

凭据管理(需管理员)

combo-cli credential list
combo-cli credential add \
  --name "DNG-Production" \
  --type oauth2 \
  --config ./dng-config.yaml
 
combo-cli credential rotate <credential_id>
combo-cli credential revoke <credential_id>

批量操作

批量导入需求(CSV / Excel)

combo-cli import requirements \
  --kb <kb_id> \
  --source req.csv \
  --mapping req-mapping.yaml

req-mapping.yaml 示例:

columns:
  id: "REQ_ID"
  title: "Title"
  description: "Description"
  type: "Req_Type"
  asil: "ASIL"
relations:
  satisfies: "Satisfies"   # 另一列指向父级 ID

批量导出 Session

combo-cli session export \
  --tenant <tenant_id> \
  --since "2026-01-01" \
  --output-dir ./exports/

数据迁移(租户间)

# 从租户 A 导出
combo-cli export --tenant <tenant_a> -o a-data/
 
# 导入到租户 B
combo-cli import --tenant <tenant_b> -i a-data/ --mapping-file map.yaml

调试

查看 Session 的 Ledger

combo-cli debug ledger <session_id>
# 输出:按 Round 打印每步 action / result / confidence

重放某一步

combo-cli debug replay <session_id> --from-round 5

查看 Hook 执行记录

combo-cli debug hooks <session_id>

抓取一次完整 trace

combo-cli debug trace <trace_id> --format jaeger > trace.json

健康检查 & 运维

combo-cli health                 # 系统健康
combo-cli health --verbose       # 详细(含依赖服务状态)
 
combo-cli stats usage --tenant <tenant_id> --last 7d
combo-cli stats cost --tenant <tenant_id> --breakdown model
 
combo-cli maintenance gc         # 手动触发垃圾回收
combo-cli maintenance reindex --kb <kb_id>

环境变量

所有命令都可以用环境变量替代参数:

export COMBO_BASE_URL=https://api.combo.example.com
export COMBO_API_KEY=ragflow-...
export COMBO_TENANT=t_corp_a
 
combo-cli agent list

Shell 补全

combo-cli completion bash >> ~/.bashrc
combo-cli completion zsh >> ~/.zshrc
combo-cli completion fish > ~/.config/fish/completions/combo-cli.fish

常见问题

Q:命令执行后提示权限不足? A:检查当前身份(combo-cli auth whoami)的角色是否有该操作权限。管理员操作需要管理员身份。

Q:批量导入几万条失败一半? A:加 --on-error continue 让它跳过错误继续;结束时会输出错误清单到 errors.log

Q:能不能把 CLI 集成到 CI? A:可以。用 COMBO_API_KEY 环境变量注入,--format json 让输出易于机器解析。

相关文档

On this page