v0.8.0
tf v0.8.0
本版由 GitHub Actions 构建,产物与校验和见下。
破坏性变更
TF_API_KEY改为仅供本次启动使用,不再覆盖已保存账户的凭据。默认连接默认网关,自建网关需显式传入--host;指定-k时优先使用对应的本地 Key。tf status和tf keys仍查询已保存的账户。- 指定名称登录时,覆盖已有不同 Key 也需要确认,默认取消。非交互覆盖请使用
tf login <name> --force。
改进
- 容器和 CI 可直接通过
TF_API_KEY启动,无需先保存本地凭据;运行时 Key、模型目录和槽位不落盘。 tf status对没有总限额的 Key 显示账户可用额度,不再显示0/0;区分额度耗尽、真正不限额和数据缺失。tf status的“今日”一行显示实际扣费和计费单位,使用usage.today.actual_cost,最多保留四位小数;不以倍率前的费用代替实际扣费。- 模型编辑器切换 Key 前先列出将被清空的槽位并确认,默认取消。
- 窄终端中的选择器按可用行列数布局,长文本显示省略号,选中后仍使用完整模型 ID;中文和带颜色文本的宽度计算与截断保持一致。
修复
- 切换 Key 或主模型时重新校验辅助槽,避免主会话、后台任务串用旧 Key 的模型;同名模型优先保留当前绑定账户。
-k、-e、--host与-m只影响本次启动,自动补齐槽位也不会修改已保存的绑定。- 副模型选择器和模型编辑器中的 Ctrl-C 终止命令并返回 130,不再继续启动客户端;Esc 保留返回或跳过当前步骤的行为。
- 修复中文分组过滤无匹配项、退格截断多字节字符的问题。
- 带分组前缀的模型切换思考强度时保留分组,不再误报变体不存在或匹配到其他分组。
- 重复
--set会校验全部赋值后一次保存,不再只保留最后一项;重复赋值同一槽或任一赋值无效时明确报错,不部分保存。 - 并发修改配置时拒绝旧快照覆盖,避免登录恢复刚被退出命令删除的 Key;双文件事务支持进程中断后的恢复。
安全
- 网关认证请求禁止跨主机、跨端口及 HTTPS 降级重定向,避免
x-api-key被转发到其他 origin。 tf status不再将环境变量中的 Key 发送到所有已保存网关。- 代理诊断不再输出 URL 中的用户名、密码和查询参数。
- 网页导入覆盖已有 Key 时,终端确认默认选择拒绝;配置事务恢复日志权限固定为
0600,完成后删除。
安装
npm(跨平台,需 Node.js 18+)
npm install -g @tokenflux/tf升级请运行 npm install -g @tokenflux/tf@latest(tf update 不会直接修改 npm 托管的文件)。
macOS / Linux(独立脚本,无 Node 依赖)
curl -fsSL https://raw.githubusercontent.com/tokenflux/tf-cli/main/install.sh | sh默认安装到 ~/.local/bin/tf(可通过 TF_INSTALL_DIR 自定义)。升级直接运行 tf update。
手动下载
| 系统 | 文件 |
|---|---|
| macOS(Apple Silicon) | tf_0.8.0_darwin_arm64.tar.gz |
| macOS(Intel) | tf_0.8.0_darwin_amd64.tar.gz |
| Linux x86_64 | tf_0.8.0_linux_amd64.tar.gz |
| Linux ARM64 | tf_0.8.0_linux_arm64.tar.gz |
| Windows x64 | tf_0.8.0_windows_amd64.zip |
macOS 与 Linux 产物解压后将 tf 放入 PATH 即可。
Windows 产物解压后将 tf.exe 放入 PATH。当前仅支持非交互模式,请使用 --no-input 配合 -m、-k 参数明确指定。
卸载
npm
npm uninstall -g @tokenflux/tf独立脚本
仅删除 tf 二进制,保留配置、凭据与缓存:
curl -fsSL https://raw.githubusercontent.com/tokenflux/tf-cli/main/uninstall.sh | sh同时清理配置、凭据与缓存目录:
curl -fsSL https://raw.githubusercontent.com/tokenflux/tf-cli/main/uninstall.sh | sh -s -- --purge若安装时指定了 TF_INSTALL_DIR,可在管道右侧传入对应环境变量:curl -fsSL https://raw.githubusercontent.com/tokenflux/tf-cli/main/uninstall.sh | TF_INSTALL_DIR=/原安装目录 sh。
校验
sha256sum -c SHA256SUMS --ignore-missing引用版本:提交 2a9e901 / Go 1.27.0
Full Changelog: v0.7.0...v0.8.0