cli-anything-novita 是做什麼的？
一個用於 Novita AI 的 CLI 命令列工具 — 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 輸出（供代理使用）
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旗標）：結構化 JSON，供代理使用
# 人類輸出
cli-anything-novita chat --prompt "你好"
# JSON 輸出（供代理使用）
cli-anything-novita --json chat --prompt "你好"
給 AI 代理的指示
當以程式方式使用此 CLI 時：
- 務必使用
--json旗標 以取得可解析的輸出 - 檢查回傳碼 — 0 表示成功，非零表示錯誤
- 從 stderr 解析錯誤訊息 以取得失敗資訊
- 在所有檔案操作中使用絕對路徑
- 在匯出操作後確認輸出存在
更多資訊
- 完整文件：請參閱套件中的 README.md
- 測試覆蓋率：請參閱套件中的 TEST.md
- 方法論：請參閱 cli-anything-plugin 中的 HARNESS.md
版本
1.0.0