sailvanai-cli

sailvanai-cli 是用于调用 Sailvan AI 助手接口的命令行工具，支持：

• sailvanai auth：交互式写入鉴权信息到用户配置文件 config.toml
• sailvanai list：列出可用应用（助手）
• sailvanai chat：按 app_id 或 assistant_id 发起对话

环境要求

• Node.js >= 20
• 可用的 AIBOT_ACCESS_TOKEN

安装与构建

npm install
npm run build

本地调试：

npm run dev -- --help

全局命令：

npm link

鉴权配置

执行交互式录入：

sailvanai auth

检查状态：

sailvanai auth status

配置文件路径：

• Unix/macOS: ~/.sailvanai-cli/config.toml
• Windows: %APPDATA%\sailvanai-cli\config.toml

config.toml 关键字段：

• AIBOT_BASE_URL，默认 https://aizs.sailvan.com
• AIBOT_ACCESS_TOKEN

命令说明

列出助手

sailvanai list
sailvanai list --keyword 财务
sailvanai list --json

发起对话

默认输出仅为助手回复文本（response 字段）；需要完整返回时加 --json。

按应用 ID（自动解析 unique_id）：

sailvanai chat --app-id 300 --query "请总结本月报销异常"

按助手 unique_id：

sailvanai chat --assistant-id 7337223700010001 --app-id 300 --query "你好"

流式与 JSON 输出：

sailvanai chat --app-id 300 --query "测试" --stream
sailvanai chat --app-id 300 --query "测试" --json

常见问题

• Missing AIBOT_ACCESS_TOKEN
  • 先执行 sailvanai auth
• HTTP 401/403
  • token 失效，重新执行 sailvanai auth 更新
• 网络超时或接口异常
  • 检查网络与 AIBOT_BASE_URL 设置