Skip to content

v0.8.0

Choose a tag to compare

@github-actions github-actions released this 05 Sep 09:27
· 9 commits to main since this release

tf v0.8.0

本版由 GitHub Actions 构建,产物与校验和见下。

破坏性变更

  • TF_API_KEY 改为仅供本次启动使用,不再覆盖已保存账户的凭据。默认连接默认网关,自建网关需显式传入 --host;指定 -k 时优先使用对应的本地 Key。tf statustf 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@latesttf 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