WHC
2fde898da0
Tools - Table-driven tool registry with permission classes and default/minimal profiles; new tools: edit_file, list_dir, glob, grep, delete_file, move_file, todo_write, web_fetch, ask_user (plus read_file paging). - Built-in Myers diff; write tools return unified diffs. - Persistent permission rules (.agent/permissions.json), per-turn undo snapshots (.agent/undo), AGENTS.md project notes, auto-compact at 80% of the model context, cancellable run_shell with process-group kill. TUI - Table-driven slash commands: /provider /key /effort /status /tools /permissions /yolo /undo /retry /diff /export /copy /rename /delete /init /max-steps /todo, with / and @ completion. - Permission modal with diff and prefix rules, ask_user modal, todo panel, header with model/effort/context, bracketed paste, line editing, wide-char cursor, NO_COLOR and ASCII fallback; Esc never quits. Startup and configuration - API keys are entered in the TUI (hidden) and saved per provider in <config>/credentials (0600); env variables are only a fallback. - Last provider, per-provider model and reasoning effort are remembered in <config>/settings.json; --effort/-e and /effort send reasoning_effort (low|medium|high|max) to models that accept it. - DeepSeek preset uses deepseek-flash / deepseek-v4-pro. - Session flags --new/--continue/--resume/--list-sessions, --yolo, --confirm. Compatibility and tests - ncurses detection, macOS/Homebrew support, make install, XDG config dir, POSIX cleanups; Gitea CI (gcc/clang/asan/musl/macOS). - Unit tests for diff, fs tools, registry, undo/perms and config; e2e fixtures multi_file_refactor and ask_or_todo; vendored cJSON.
4.0 KiB
4.0 KiB
OpenAI 兼容 API 环境变量
CST-Agent 使用 OpenAI Chat Completions 协议（POST {base}/chat/completions，SSE 流式），
可对接官方 OpenAI、DeepSeek、MiniMax，以及其它兼容网关。
Provider 预设
--provider NAME（或 CST_PROVIDER，或 TUI 里的 /provider）一次性给出 base 和默认模型。
不传时沿用上次使用的 provider（记在配置目录的 settings.json）。
| provider | API Base | 默认模型 | Key 变量 |
|---|---|---|---|
minimax（默认） |
https://api.minimax.cn/v1 |
MiniMax-M2.7 |
MINIMAX_API_KEY |
deepseek |
https://api.deepseek.com/v1 |
deepseek-flash（另有 deepseek-v4-pro） |
DEEPSEEK_API_KEY |
openai |
https://api.openai.com/v1 |
gpt-4.1-mini |
OPENAI_API_KEY |
显式给出的 --api-base / --model / 下表中的环境变量优先于预设。
解析顺序
| 项 | 优先级（高 → 低） |
|---|---|
| Key | --api-key（只用于本次进程，不写盘）→ 该 provider 已保存的 key → provider 的 Key 变量 → CST_API_KEY → TUI 弹出遮罩输入框（输入后保存） |
Base（含 /v1，不带 /chat/completions） |
--api-base → CST_API_BASE → OPENAI_BASE_URL → OPENAI_API_BASE → 预设 |
| Model | --model → CST_MODEL → OPENAI_MODEL → 该 provider 上次使用的模型 → 预设 |
| 推理强度 | --effort → CST_EFFORT → 上次使用 → medium（low / medium / high / max） |
key 按 provider 保存在 credentials 文件（权限 0600），每行 <provider>.api_key=...；
TUI 里 /key 更换，命令行 --ask-key 输入（不回显）：
- Linux/macOS/Termux：
$XDG_CONFIG_HOME/cst-agent/credentials（默认~/.config/cst-agent/） - Windows：
%APPDATA%\cst-agent\credentials
旧版只有一行 api_key= 的文件仍可读：按其中的 api_base 归到对应 provider（没有 api_base 时视为 MiniMax）。
示例
DeepSeek
cst-agent --provider deepseek # 首次会询问 key；默认 deepseek-flash
cst-agent --provider deepseek --model deepseek-v4-pro -e high # 推理内容显示为 Thought
OpenAI 官方
cst-agent --provider openai
MiniMax（默认）
cst-agent --provider minimax
任意兼容网关
export OPENAI_API_KEY='...'
export OPENAI_BASE_URL='https://your-gateway.example/v1'
export OPENAI_MODEL='your-model'
./cst-agent --headless --prompt 'ping' --workspace .
网关不支持 stream_options.include_usage 时设 CST_NO_STREAM_USAGE=1。
其它环境变量
| 变量 | 说明 |
|---|---|
CST_PROTOCOL |
工具调用协议：native-eos（默认）/ native-inc / ctl / ctl-heredoc / xml |
CST_MAX_STEPS |
每个用户回合最多调用模型几次（默认 30） |
CST_TOOL_OUT_CAP |
单个工具输出发给模型的字节上限（默认 16384） |
CST_CTX_WINDOW |
发给模型的最近非 system 消息条数（默认 80） |
CST_SHELL_TIMEOUT |
run_shell 超时秒数（默认 120） |
CST_METRICS=0 / CST_METRICS_PATH |
关闭 / 指定计时埋点 JSONL |
CST_RECORD_SSE / CST_REPLAY_SSE |
录制 / 回放原始 SSE 流目录；CST_REPLAY_CHUNK 控制回放分块字节数 |
CST_MODELS |
/model 可选列表，: 或 , 分隔 |
CST_AUTO_APPROVE=1 |
自动允许 shell/写文件（headless 默认开启） |
CST_SHELL |
shell 解释器路径（覆盖 busybox/sh） |
CST_EXE_DIR |
可执行文件目录（Termux 旁路 busybox 时有用） |
网络：连接超时 30 秒；300 秒内无数据视为超时；429 / 5xx / 连接错误在尚未收到任何内容时自动重试 3 次（1s、2s、4s 退避）。
CLI 对照
--provider NAME ← CST_PROVIDER
--api-base URL ← CST_API_BASE / OPENAI_BASE_URL
--api-key KEY ← 已保存的 key / <provider key 变量> / CST_API_KEY
--model NAME ← CST_MODEL / OPENAI_MODEL
--effort LEVEL ← CST_EFFORT
--protocol P ← CST_PROTOCOL
--max-steps N ← CST_MAX_STEPS