CLI
全局参数
所有命令通用的参数、环境变量与工具清单缓存。
参数
| 参数 | 说明 |
|---|---|
--api-key <key> | 本次命令使用的 API 密钥，优先级高于 TUFTY_API_KEY 和配置文件 |
--base-url <url> | API 地址，优先级高于 TUFTY_BASE_URL；默认 https://tufty.ai |
-l, --lang <locale> | 输出语言：en-US 或 zh-CN。会写入配置文件，之后不带 -l 也沿用 |
--verbose | 在标准错误输出调试日志 |
--refresh-manifest | 跳过 10 分钟的本地工具清单缓存，直接从服务端拉取 |
-V, --version | 打印版本号 |
-h, --help | 显示帮助；写在命令后面时显示该命令的帮助 |
tufty --lang en-US tools list
tufty --refresh-manifest pet-dressup -h
tufty --api-key sk-xxxx status 3f6c2a1e-8b4d-4e7a-9c55-0d2b7e1f4a90语言不只影响提示文案：CLI 按语言拉取工具清单，工具名称、描述和帮助文本也会随之切换。
环境变量
| 变量 | 说明 |
|---|---|
TUFTY_API_KEY | API 密钥 |
TUFTY_BASE_URL | API 地址，默认 https://tufty.ai |
TUFTY_CONFIG_DIR | 配置与缓存目录，默认 ~/.tufty |
TUFTY_LANG | 输出语言，en-US 或 zh-CN |
语言的决定顺序
-l/--langTUFTY_LANG- 配置文件里记住的语言（由
-l写入） - 系统环境变量
LC_ALL、LANG - 默认
en-US
配置目录
~/.tufty/（或 TUFTY_CONFIG_DIR 指定的目录）下有：
| 文件 | 内容 |
|---|---|
config.json | API 密钥（TUFTY_API_KEY）和记住的语言（lang） |
manifest-<locale>.json | 对应语言的工具清单缓存 |
工具清单缓存
- 10 分钟内的缓存直接使用；
- 缓存过期或不存在时同步拉取（5 秒超时），拉取失败则退回过期的缓存；
- 既拉不到又没有缓存时，工具命令无法注册，返回
manifest_unavailable。
缓存记录了来自哪个 --base-url，切换地址不会串用。