Skip to content

v1.1.33

Choose a tag to compare

@github-actions github-actions released this 22 May 12:03
· 10 commits to master since this release

v1.1.33 / 版本 v1.1.33

This is the first full public release of this fork. It includes all functional changes made in this fork, plus Docker Hub publishing, prebuilt binaries, and updated documentation.

这是本 fork 的第一个完整公开版本。更新日志包含本 fork 已完成的全部功能改动,并包含 Docker Hub 镜像发布、预编译二进制和文档更新。


中文更新日志

下载内容

  • Linux x86_64:kiro-rs-linux-x86_64.tar.gz
  • macOS Apple Silicon / aarch64:kiro-rs-macos-aarch64.tar.gz
  • Windows x86_64:kiro-rs-windows-x86_64.zip
  • 源代码包:kiro-rs-v1.1.33-source.tar.gz

macOS 当前提供 Apple Silicon / aarch64 版本。Intel Mac 用户可暂时从源码编译。

Docker 镜像

本版本开始发布到 Docker Hub:

docker pull foxfishs/kiro-rs:v1.1.33
docker pull foxfishs/kiro-rs:latest

运行示例:

docker run -d \
  --name kiro-rs \
  -p 8990:8990 \
  -v $(pwd)/config:/app/config \
  foxfishs/kiro-rs:v1.1.33

请确保 config/config.jsonconfig/credentials.json 已准备好,并且不要把真实 API key、refresh token 或 credentials 提交到仓库。

Admin UI / 管理后台

  • 修复使用 admin-api-key 进入后台后白屏的问题。
  • 新增/完善凭据管理界面的余额、额度、状态展示。
  • 优化 Overages 状态展示:已开启时按钮显示为“关闭 Overages”,避免状态与操作含义混淆。
  • 凭据卡片余额展示改为使用有效额度,能够正确显示基础额度 + overage cap 后的可用情况。
  • 移除每个凭据详情里重复展示的“可用模型”列表。
  • 新增全局“可用模型”入口,集中展示当前后端 /v1/models 支持的固定模型列表。
  • 可用模型列表说明已改为全局能力说明,不再暗示每个凭据有不同模型能力。

Overages / 额度超限支持

  • 修复 overage 状态同步语义:上游缺失 overageEnabled / overageConfiguration 字段时,不再错误视为关闭 overage。
  • 只有上游明确返回 false 时,才覆盖本地已开启的 overage 状态。
  • Admin 单个余额查询会优先使用上游明确 overage 状态;当上游未返回时,回退到 token manager / 凭据持久化状态。
  • 启用 overage 时,余额和使用率按“基础额度 + overage cap”计算有效额度。
  • 余额缓存新增并保留:
    • usage_limit
    • overage_enabled
    • overage_cap
  • /api/admin/credentials/balances/cached 返回缓存中的真实额度、使用率、overage 状态和 overage cap。
  • 周期刷新、异步刷新和初始化余额时都会同步完整 overage 缓存。
  • 自动禁用凭据时按有效剩余额度判断,避免开启 overage 后被错误禁用。

Claude / Anthropic API 兼容性

  • 修复 claude-opus-4-7-thinking 的 thinking 转换逻辑,使其与 claude-opus-4-6-thinking 一样使用:
    • thinking.type = "adaptive"
    • output_config.effort = "high"
  • 客户端只要传入 thinking 参数,即使模型名不带 -thinking 后缀,也会启用 Kiro 上游 adaptive thinking。
  • thinking 强度优先级:
    1. 模型名 -thinking-* 后缀
    2. 客户端 thinking.budget_tokens
    3. 默认 high:24576
  • 修复无效或小于等于 0 的 budget_tokens:自动回退到 high 档位。
  • 增加相关回归测试,覆盖 opus 4.6 / 4.7 thinking 以及客户端 thinking 参数场景。

模型列表

  • 验证并统一 /v1/models 返回的全局模型列表。
  • Admin UI 改为展示全局可用模型,不再在每个凭据详情中重复显示固定模型列表。
  • 明确当前模型列表是服务级固定能力,不按单个 credential 动态变化。

余额缓存与凭据状态

  • 后台余额刷新会写入完整缓存信息,而不只保存 remaining balance。
  • 缓存恢复、缓存初始化、缓存插入和缓存返回路径均补齐新增字段。
  • 修复 cached balances 路径丢失 overage 语义导致的展示不一致问题。
  • 修复余额刷新和自动禁用之间的有效额度判断不一致问题。

Release / CI / Docker 发布

  • 恢复 GitHub Release 自动构建 workflow。
  • v* tag 自动构建并上传:
    • Linux x86_64 二进制
    • macOS aarch64 二进制
    • Windows x86_64 二进制
    • 源代码包
  • 新增/修复 Docker Hub 自动构建与推送 workflow。
  • Docker 镜像命名空间改为:foxfishs/kiro-rs
  • Docker workflow 使用标准 GitHub Actions secrets 名称:
    • DOCKERHUB_USERNAME
    • DOCKERHUB_TOKEN
  • README 中的 Docker pull、buildx、docker-compose 示例已全部更新为 foxfishs/kiro-rs
  • 版本号更新为 v1.1.33,并同步更新二进制下载教程和 Docker 示例。

文档

  • README 新增 fork 功能说明。
  • README 新增预编译二进制使用教程:
    • Linux 下载、解压、运行
    • macOS Apple Silicon 下载、解压、运行和 quarantine 处理
    • Windows PowerShell 下载、解压、运行
  • README 新增 Docker Hub 镜像使用说明。
  • README 更新 Docker 镜像名和版本示例。

验证

本版本相关改动已通过以下本地验证:

cargo fmt --check
cargo check
cargo build
cargo test remaining_balance -- --nocapture
cargo test usage_limits -- --nocapture
cargo test anthropic::handlers::tests -- --nocapture
cd admin-ui && npm run build

English Changelog

Downloads

  • Linux x86_64: kiro-rs-linux-x86_64.tar.gz
  • macOS Apple Silicon / aarch64: kiro-rs-macos-aarch64.tar.gz
  • Windows x86_64: kiro-rs-windows-x86_64.zip
  • Source archive: kiro-rs-v1.1.33-source.tar.gz

The macOS binary currently targets Apple Silicon / aarch64. Intel Mac users should build from source for now.

Docker Image

This release publishes the Docker image to Docker Hub:

docker pull foxfishs/kiro-rs:v1.1.33
docker pull foxfishs/kiro-rs:latest

Run example:

docker run -d \
  --name kiro-rs \
  -p 8990:8990 \
  -v $(pwd)/config:/app/config \
  foxfishs/kiro-rs:v1.1.33

Make sure config/config.json and config/credentials.json are prepared. Never commit real API keys, refresh tokens, or credentials to the repository.

Admin UI

  • Fixed the blank screen issue after entering admin-api-key in the admin frontend.
  • Improved credential balance, quota, and status display in the admin dashboard.
  • Improved Overages state display: when enabled, the action button now shows “Disable Overages” / “关闭 Overages”.
  • Credential cards now use the effective quota when showing balances, including base quota plus overage cap.
  • Removed the duplicated “Available Models” section from each credential detail dialog.
  • Added a global “Available Models” entry to show the service-level fixed model list returned by /v1/models.
  • Clarified that available models are global service capabilities, not per-credential dynamic capabilities.

Overages Support

  • Fixed overage synchronization semantics: missing overageEnabled / overageConfiguration fields from upstream no longer mean overage is disabled.
  • Local enabled overage state is overwritten only when upstream explicitly returns false.
  • Admin single-balance queries now prefer explicitly reported upstream overage state; if missing, they fall back to token manager / persisted credential state.
  • When overage is enabled, effective quota and usage percentage are calculated with base quota plus overage cap.
  • Balance cache now stores and preserves:
    • usage_limit
    • overage_enabled
    • overage_cap
  • /api/admin/credentials/balances/cached now returns real cached quota, usage percentage, overage state, and overage cap.
  • Periodic refresh, asynchronous refresh, and initial balance refresh now all write complete overage-aware cache data.
  • Auto-disabling credentials now uses effective remaining quota, preventing credentials with enabled overage from being disabled incorrectly.

Claude / Anthropic API Compatibility

  • Fixed claude-opus-4-7-thinking conversion so it follows the same adaptive thinking behavior as claude-opus-4-6-thinking:
    • thinking.type = "adaptive"
    • output_config.effort = "high"
  • Client-provided thinking now enables upstream Kiro adaptive thinking even when the model name does not include a -thinking suffix.
  • Thinking strength priority is now:
    1. model-name -thinking-* suffix
    2. client thinking.budget_tokens
    3. default high: 24576
  • Invalid or non-positive budget_tokens now falls back to high effort automatically.
  • Added regression tests covering opus 4.6 / 4.7 thinking behavior and client-provided thinking parameters.

Model List

  • Verified and unified the global model list returned by /v1/models.
  • Admin UI now shows available models once globally instead of repeating the same fixed list inside every credential detail dialog.
  • Clarified that the current model list is a service-level fixed capability list and does not vary by individual credential.

Balance Cache and Credential State

  • Background balance refresh now writes complete cached balance information, not only remaining balance.
  • Cache restore, initialization, insertion, and response construction paths now include the newly added fields.
  • Fixed inconsistent UI and API behavior caused by cached balance responses losing overage semantics.
  • Fixed inconsistent effective-quota logic between balance refresh and auto-disable decisions.

Release / CI / Docker Publishing

  • Restored the GitHub Release binary workflow.
  • v* tags now automatically build and upload:
    • Linux x86_64 binary
    • macOS aarch64 binary
    • Windows x86_64 binary
    • source archive
  • Added/fixed the Docker Hub build and push workflow.
  • Changed the Docker image namespace to foxfishs/kiro-rs.
  • Docker workflow uses standard GitHub Actions secret names:
    • DOCKERHUB_USERNAME
    • DOCKERHUB_TOKEN
  • README Docker pull, buildx, and docker-compose examples now use foxfishs/kiro-rs.
  • Bumped the project version to v1.1.33 and updated binary download instructions and Docker examples.

Documentation

  • Added README documentation for fork-specific features.
  • Added prebuilt binary usage guides for:
    • Linux download, extract, and run
    • macOS Apple Silicon download, extract, run, and quarantine handling
    • Windows PowerShell download, extract, and run
  • Added Docker Hub image usage documentation.
  • Updated Docker image names and version examples throughout the README.

Verification

The changes in this release were verified locally with:

cargo fmt --check
cargo check
cargo build
cargo test remaining_balance -- --nocapture
cargo test usage_limits -- --nocapture
cargo test anthropic::handlers::tests -- --nocapture
cd admin-ui && npm run build

Release URL: https://github.com/Foxfishc/kiro.rs/releases/tag/v1.1.33

Full Changelog: v1.1.32...v1.1.33