@bte-settle/cli

DTC+ 结算系统 Admin API 命令行工具（命令名 settle），用于查询结算数据、触发数据同步、管理结算周期、导出账单。

安装与使用

# 免安装直接用（推荐）
npx @bte-settle/cli projects list

# 或全局安装后直接用 settle
npm i -g @bte-settle/cli
settle projects list

鉴权

默认连接 https://dtcplus-bte.fastgrowth.app（--base-url 或环境变量 SETTLEMENT_API_BASE 可覆盖）。

包内不含 token。向管理员索取 token 后设置环境变量：

export SETTLE_TOKEN=stl_xxx   # 也支持 SETTLEMENT_API_TOKEN 或 cwd .env 中的同名变量
settle projects list

安装 Claude Code Skill

把 settlement-cli skill 装到 Claude Code，让 Agent 自动按规范使用本 CLI：

# 项目级（.claude/skills/）
npx @bte-settle/cli skill install

# 用户级（~/.claude/skills/）
npx @bte-settle/cli skill install --global

安装到其他 AI 工具（Cursor / Codex / Gemini CLI 等）

写入通用 AGENTS.md 标准（幂等标记块，重复执行只更新不重复）：

npx @bte-settle/cli skill install --agent

常用命令

settle --json projects list [--code <code>]            # 项目列表
settle --json periods list --project <code>            # 结算周期
settle periods report --project <code>                 # 周期汇总报表
settle flows list --period <periodId>                  # 结算流水（默认 pageSize=2000）
settle configs channels --project <code>               # 渠道结算配置
settle configs projects --project <code>               # 项目结算配置
settle expense-items list --project <code>             # 支出项（结算条款）
settle contract-files list --project <code>            # 合同文件
settle exchange-rates get --from EUR                   # 汇率
settle sync logs --project <code>                      # 同步日志
settle sync data orders --project <code>               # 已同步订单原始数据
settle periods export <periodId> --out .               # 导出账单 Excel
settle --help                                          # 完整命令列表

全局选项：--json（输出原始 JSON）、--base-url <url>、--token <token>。退出码：0 成功、1 API 报错、2 网络错误。

安全注意

• 破坏性操作（periods regenerate、periods confirm、flows batch-update、periods add-manual-flow 等）执行前请确认
• token 等同于 Admin API 全权限，请妥善保管；泄露后联系管理员轮换（服务端改 SETTLEMENT_API_TOKEN，使用者更新 SETTLE_TOKEN 即可）