cli-anything-novita 是做什么的?
Novita AI 的命令行工具 —— 一个兼容 OpenAI API 的服务,支持 DeepSeek、GLM 等多种 AI 模型。
安装
本 CLI 作为 cli-anything-novita 包的一部分安装:
pip install cli-anything-novita
前提条件:
- Python 3.10+
- 来自 novita.ai 的 Novita API 密钥
使用方法
基本命令
# 显示帮助
cli-anything-novita --help
# 启动交互式 REPL 模式
cli-anything-novita
# 与模型对话
cli-anything-novita chat --prompt "什么是 AI?" --model deepseek/deepseek-v3.2
# 流式对话
cli-anything-novita stream --prompt "写一首关于代码的诗"
# 列出可用模型
cli-anything-novita models
# JSON 输出(供 Agent 使用)
cli-anything-novita --json chat --prompt "你好"
REPL 模式
当不提供子命令时,CLI 会进入交互式 REPL 会话:
cli-anything-novita
# 进入交互模式,支持 Tab 补全和历史记录
命令组
对话
通过 Novita API 与 AI 模型对话。
| 命令 | 描述 |
|---|---|
chat | 与 Novita API 对话 |
stream | 流式对话补全 |
会话
对话历史管理。
| 命令 | 描述 |
|---|---|
status | 显示会话状态 |
clear | 清除会话历史 |
history | 显示命令历史 |
配置
配置管理。
| 命令 | 描述 |
|---|---|
set | 设置配置值 |
get | 获取配置值(或显示全部) |
delete | 删除配置值 |
path | 显示配置文件路径 |
工具
| 命令 | 描述 |
|---|---|
test | 测试 API 连接 |
models | 列出可用模型 |
示例
配置 API 密钥
# 通过配置文件设置 API 密钥(推荐)
cli-anything-novita config set api_key "sk-xxx"
# 或使用环境变量
export NOVITA_API_KEY="sk-xxx"
与 DeepSeek 对话
# 简单对话
cli-anything-novita chat --prompt "解释量子计算" --model deepseek/deepseek-v3.2
# 流式对话
cli-anything-novita stream --prompt "编写一个计算阶乘的 Python 函数"
测试连接
# 验证 API 密钥和连接
cli-anything-novita test --model deepseek/deepseek-v3.2
# 列出所有可用模型
cli-anything-novita models
默认模型
Novita API 支持多种模型提供商:
| 模型 ID | 提供商 | 描述 |
|---|---|---|
deepseek/deepseek-v3.2 | DeepSeek | DeepSeek V3.2 模型(默认) |
zai-org/glm-5 | 智谱 AI | GLM-5 模型 |
minimax/minimax-m2.5 | MiniMax | MiniMax M2.5 模型 |
输出格式
所有命令均支持双输出模式:
- 人类可读(默认):表格、颜色、格式化文本
- 机器可读(
--json标志):供 Agent 消费的结构化 JSON
# 人类可读输出
cli-anything-novita chat --prompt "你好"
# 供 Agent 使用的 JSON 输出
cli-anything-novita --json chat --prompt "你好"
针对 AI Agent 的使用说明
在程序化使用此 CLI 时:
- 始终使用
--json标志 以获取可解析的输出 - 检查返回码 —— 0 表示成功,非零表示错误
- 解析 stderr 以获取失败时的错误信息
- 对所有文件操作使用绝对路径
- 在导出操作后验证输出是否存在
更多信息
- 完整文档:请参见包内的 README.md
- 测试覆盖:请参见包内的 TEST.md
- 方法论:请参见 cli-anything-plugin 中的 HARNESS.md
版本
1.0.0