kiro-account-manager

# Kiro Account Manager

智能管理 Kiro IDE 账号，一键切换，配额监控

官方网站 | 立即下载 | Telegram 讨论组 | English | Русский

> ** 语言支持**：本项目支持**简体中文、English、Русский**三种语言界面。 --- ## ️ 项目概览 Kiro Account Manager 是一个基于 **Tauri 2.x** 的桌面应用，用于集中管理 **Kiro IDE** 账号与本地配置。 **技术栈**：React 18 + Vite + shadcn/ui + TailwindCSS 4 | Rust + Tauri 2.x | Windows / macOS / Linux **核心模块**： - 账号管理：导入、导出、刷新、验证、分组、标签、远程删除 - 登录认证：Google / GitHub Social OAuth；AWS IAM Identity Center（BuilderId / Enterprise）；微软 Entra ID / Azure AD（`external_idp`，导入 + Token 刷新，无应用内交互登录） - Kiro 集成：切换账号、同步模型 / 代理 / MCP / Steering / Skills / Hooks / Custom Agents / Powers - 自动化能力：Token 自动刷新、余额不足自动换号、机器 ID 绑定与重置 - 桌面端能力：Deep Link OAuth 回调、单实例、系统托盘、自动更新 - 网关能力：内置 Kiro API Gateway，支持 Anthropic Messages、OpenAI Responses、Chat Completions 与流式转发；OpenAI 侧用 tiktoken 精确估算 token --- ## 下载 **最新版本 v1.9.2**（发布于 2026-06-17）：请前往 [Releases](https://github.com/hj01857655/kiro-account-manager/releases/latest)（自动保持最新） > 以下下载链接可能滞后，以 Releases 为准。 > **Windows 选哪个包？**（同一版本任选其一，功能完全相同） > > | 文件特征 | 安装位置 | 管理员权限 | 适合谁 | > |---------|---------|-----------|--------| > | `..._x64_zh-CN.msi` | 默认 `%LOCALAPPDATA%\Apps\KiroAccountManager`，安装界面可选 `C:\Program Files` | 默认**不需要**；选「为所有用户安装」时需要 | **推荐**。个人使用、公司/学校电脑无本地管理员权限，以及 IT 统一部署 | > | `..._portable.zip` | 解压位置自定 | 不需要 | 不想写入注册表；解压后直接双击 exe 运行（需系统已装 Edge WebView2 运行时，Win10/11 一般自带），**需手动下载新版本覆盖** | > | 平台 | 架构 | 文件格式 | 下载链接 | |------|------|---------|---------| | **Windows** | x64 | MSI 安装包 | [KiroAccountManager_1.9.2_x64_zh-CN.msi](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager_1.9.2_x64_zh-CN.msi) | | **Windows** | ARM64 | MSI 安装包 | [KiroAccountManager_1.9.2_arm64_zh-CN.msi](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager_1.9.2_arm64_zh-CN.msi) | | **macOS** | x64 / Intel | DMG 镜像 | [KiroAccountManager_1.9.2_x64.dmg](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager_1.9.2_x64.dmg) | | **macOS** | x64 / Intel | App 压缩包 | [KiroAccountManager_x64.app.tar.gz](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager_x64.app.tar.gz) | | **macOS** | ARM64 / Apple Silicon (M1/M2/M3/M4) | DMG 镜像 | [KiroAccountManager_1.9.2_aarch64.dmg](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager_1.9.2_aarch64.dmg) | | **macOS** | ARM64 / Apple Silicon (M1/M2/M3/M4) | App 压缩包 | [KiroAccountManager_aarch64.app.tar.gz](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager_aarch64.app.tar.gz) | | **Linux** | x86_64 | AppImage | [KiroAccountManager_1.9.2_amd64.AppImage](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager_1.9.2_amd64.AppImage) | | **Linux** | x86_64 | DEB 包 | [KiroAccountManager_1.9.2_amd64.deb](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager_1.9.2_amd64.deb) | | **Linux** | x86_64 | RPM 包 | [KiroAccountManager-1.9.2-1.x86_64.rpm](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager-1.9.2-1.x86_64.rpm) | | **Linux** | ARM64 | AppImage | [KiroAccountManager_1.9.2_arm64.AppImage](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager_1.9.2_arm64.AppImage) | | **Linux** | ARM64 | DEB 包 | [KiroAccountManager_1.9.2_arm64.deb](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager_1.9.2_arm64.deb) | | **Linux** | ARM64 | RPM 包 | [KiroAccountManager-1.9.2-1.aarch64.rpm](https://github.com/hj01857655/kiro-account-manager/releases/download/v1.9.2/KiroAccountManager-1.9.2-1.aarch64.rpm) | > **macOS 样式说明**：若出现样式显示异常，请基于当前仓库源码自行调整（我没有 macOS 设备，无法复现与调试）。 **系统要求**： - **Windows**: Windows 10/11 (64-bit)，需要 [WebView2](https://developer.microsoft.com/microsoft-edge/webview2/) (Win11 已内置) - **macOS**: macOS 10.15+ (Catalina 及以上) - **Linux**: x86_64 / ARM64 架构，需要 WebKitGTK 4.0+ **安装说明**： - **Windows**: - `.msi`：双击安装，默认当前用户安装，**不需要管理员权限**（推荐） - `_portable.zip`：解压后直接运行目录内的 `kiro-account-manager.exe` - **macOS**: 打开 `.dmg`，拖动到 Applications，首次运行在「安全性与隐私」中允许 - **Linux AppImage**: `chmod +x` 后直接运行 - **Linux DEB**: `sudo dpkg -i` 安装 - **Linux RPM**: `sudo rpm -i` 安装，或使用发行版对应包管理器安装 --- ## 更新日志 以下内容按 GitHub Release 的实际发布时间窗口整理。 **「未发版」** 为 `public` 分支已合入、尚未打 GitHub Release 的改动（用户安装包仍以 Releases 为准）。 ### 未发版（public，相对 v1.9.2） - **新增**: 微软 Entra ID / Azure AD 账号（`external_idp`）导入与 Token 刷新 — 刷新走微软 OAuth2 token 端点，不走 AWS OIDC；仅支持导入，不支持应用内微软登录 - **修复**: 企业 IdC 导入时从 `clientSecret` JWT 提取 `startUrl` / 纠正 provider，并优先企业域，减少误判 BuilderId 导致刷新 400 - **修复**: `getUsageLimits` 不再携带 `profileArn`（企业号带了会 400）；Enterprise 查配额与普通账号统一路径，region 优先账号自身再回退 `us-east-1` / `eu-central-1` - **加固**: Skill 分支名注入防护、提权重启确认、OAuth deep link 锁中毒恢复 - **网关**: 增加 GPT-5.6 系列与 Claude Sonnet 5；OpenAI token 估算改用 tiktoken-rs（`o200k_base`）；移除已下线的 Claude 3 别名映射 - **适配**: 跟进 Kiro IDE 1.0 的本地配置格式 — Hooks 支持新的 `.json` 格式（单文件可含多个 hook，字段改为 `trigger` / `action`）并支持用户级全局 hooks（`~/.kiro/hooks`），Custom Agents 支持新的 JSON 格式（替代 Markdown front-matter）；旧格式的 `.kiro.hook` 与 `.md` 文件仍可识别与编辑 - **适配**: 权限管理从旧版 Trusted Commands 迁移到 Kiro IDE 1.0 的 `permissions.yaml` 能力模型 — 新增全局权限规则编辑器（capability / effect / match / exclude / policies），后端直接读写 `~/.kiro/settings/permissions.yaml`；首次读取时兜底迁移旧 `kiroAgent.*` 配置，并移除所有旧 Trusted Commands 死代码 ### ️ v1.9.2 - 2026-06-17 — Linux ARM64 架构支持与 macOS 启动修复 > 本版本新增 **Linux ARM64** 架构完整支持，现在树莓派、ARM 服务器等设备也可以原生运行本应用；同时修复了部分 macOS 用户反馈的启动后窗口不显示问题，并将 API 请求 UA 与真实 Kiro IDE 对齐。 #### ️ 架构支持 - **新增**: Linux ARM64 (aarch64) 完整构建支持 — 提供 AppImage、DEB、RPM 三种格式 - **修复**: macOS Intel (x86_64) 构建环境更新 #### ️ macOS 兼容 - **修复**: macOS 启动后窗口不显示的问题 — 新增 3 秒兜底机制，前端未能及时触发窗口显示时自动强制 show，避免应用进程在跑但窗口看不见的情况。 #### UA 对齐 - **修复**: API 请求 User-Agent 与真实 Kiro IDE 完全对齐 — management API（`getUsageLimits`、`ListAvailableModels`）使用 `aws-sdk-js/1.0.0` + `codewhispererruntime#1.0.0` + `m/N,E`；streaming API（`generateAssistantResponse`）使用 `aws-sdk-js/1.0.39` + `codewhispererstreaming#1.0.39` + `m/N`。 #### 账号机器码隔离 - **新增**: 账号级 `machineId` 持久化 — 导入、在线登录和账号数据规范化时，会为缺失机器码的账号生成独立随机值，后续不再依赖当前系统机器码临时补值。 - **修复**: 手动切号与自动换号都会写入目标账号自己的机器码 — 解决“账号已经切换，但请求头 / Kiro IDE 仍沿用旧机器码或当前系统机器码”的状态串用问题。 - **调整**: 移除旧版全局机器码兼容配置 — 现在切号逻辑统一以账号自身 `machineId` 为准，减少“配置开关”和“账号字段”同时存在造成的行为分歧。 #### 单账号代理与 BuilderId 兼容 - **新增**: 单账号代理配置 — 在账号编辑页可为特定账号配置独立代理，Kiro2API / Kiro API 请求按账号走对应出口，不影响 Kiro IDE、Kiro CLI 或系统代理。 - **修复**: profileArn 正确处理（[#132](https://github.com/hj01857655/kiro-account-manager/issues/132)）— 修复 Social 账号（Google/GitHub）被错误分配 BuilderId 默认 profileArn 导致 403 "User is not authorized to make this call" 的问题；BuilderId 账号补齐 fallback 逻辑，避免缺少 profileArn 时 Kiro API 请求失败。 - **优化**: 账号编辑页布局 — 分组、标签、代理、机器码等区域重新整理，避免搜索框和输入区域被标签区挤到下一行。 #### 账号文件保存与恢复 - **调整**: 账号保存只保留最近一次 `.bak` — 不再每次保存都生成 `accounts.backup-*.json`，避免 AppData 下长期堆积大量备份文件。 - **修复**: `accounts.json` 缺失或写入失败时优先从备份恢复 — 解决保存过程中异常中断后账号列表直接变空的问题。 #### Kiro2API 错误与协议兼容 - **新增**: Anthropic 429 原始错误透传 — 上游限流时调用端可直接看到真实错误体，而不是被统一包装成普通失败。 - **修复**: 非 200 响应尽量保留上游 JSON — 认证失败、限流、模型不可用等错误保留关键字段，方便客户端和日志判断真实原因。 - **修复**: OpenAI Responses 响应体结构 — 减少 `/v1/responses` 客户端因为输出字段不完整而解析失败。 - **调整**: MCP 配置从代理设置中独立 — 避免 MCP 与网络代理混在同一个设置区导致误配置。 #### Linux 软件渲染与 ARM64 发布 - **新增**: Linux WebKit 软件渲染线程限制 — 针对无 GPU、远程桌面、云服务器环境中 WebKitWebProcess 长时间占满 CPU 的问题，启动时限制 llvmpipe 线程占用。 - **新增**: Linux ARM64 Release 构建 — 发布流程会额外在 ARM64 Linux runner 上生成对应架构的 AppImage / DEB / RPM，并让自动更新元数据按实际 DEB / RPM 平台条目生成，避免 ARM64 用户只能看到 x86_64 包。 ### ️ v1.9.1 - 2026-06-02 — 工具调用链路与错误透传修复 > 本版本聚焦 Kiro2API 协议兼容：修复 Chat Completions 工具结果双重序列化、Responses 输出结构、非 200 错误透传和请求日志结构化，解决第三方客户端在工具调用、Responses 和失败响应场景下难以解析的问题。 #### Chat Completions 工具调用 - **修复**: 工具结果双重序列化 — OpenAI Chat Completions 的 tool result 不再被二次包装成字符串，避免客户端收到“看似 JSON、实际是字符串”的结果后解析失败。 - **修复**: `messages[].content` 可选 — 兼容部分客户端在 tool call 或 assistant 消息中省略 / 置空 `content` 的请求格式。 - **调整**: 工具结果按前序 tool use 关系排序 — 多工具并发或连续调用时，结果更容易回到对应的工具调用位置，减少客户端关联错位。 #### Responses 与非 200 错误 - **修复**: `/v1/responses` 输出结构 — 补齐 output、事件结果和工具调用相关字段，减少 Responses 客户端字段缺失。 - **新增**: 非 200 原始 JSON 透传 — 上游认证失败、限流、模型不可用等错误会按原始结构返回，方便调用端按真实错误类型处理。 #### 请求日志与账号调度 - **新增**: 结构化请求日志 — 记录账号、模型、Region、状态码、耗时、流式状态和错误摘要，方便定位“哪个账号、哪个模型、哪个 Region”导致失败。 - **新增**: 配额恢复自动重新启用 — 因封顶或不可用被停用的账号，在同步到可用额度后自动回到可用池，减少手动维护账号状态。 ### v1.9.0 - 2026-06-01 — Kiro IDE 切号文件顺序与 CLI 退出修复 > 本版本修复账号切换和退出登录的状态写入顺序，重点解决 Kiro IDE 读取到旧账号、半更新 token 文件或 CLI 旧 token 残留的问题。 #### Kiro IDE 切号顺序 - **修复**: 切换账号 / 退出登录的文件写入顺序对齐 Kiro IDE — 避免 IDE 在写入过程中读取到旧账号或未完整更新的 token 状态。 - **修复**: 退出登录与切换账号门禁拆分 — 退出只清理当前账号，切换才写入目标账号，避免退出动作误触发切号流程。 - **调整**: Social、BuilderId、Enterprise 中文认证术语统一，减少不同页面名称不一致。 #### CLI 与 Region 探测 - **修复**: CLI 账号退出清理旧 token — 重复退出或账号已退出时不再留下异常状态。 - **调整**: usage 探测覆盖全部后端支持 Region — 减少因探测区域不足导致的配额同步失败或用量显示不准。 ### v1.8.9 - 2026-06-01 — 登录回调、profileArn 与自动换号边界修复 > 本版本围绕账号登录和切换边界修复：处理 AWS SSO 回调地址、BuilderId / Social 写入格式、overage 自动换号，以及 Kiro2API 的 Region、UTF-8 截断和模型缓存问题。 #### 登录与账号缓存 - **修复**: AWS SSO `redirect_uri` 去掉端口 — 解决部分 BuilderId / Enterprise 在线登录注册回调失败的问题。 - **修复**: Social `expiresAt` 格式对齐 Kiro IDE — 减少 IDE 与本应用读取同一份账号缓存时的格式差异。 - **修复**: BuilderId token 写入 `profileArn` — 避免 Kiro IDE 或 Kiro API 调用因缺少 profileArn 字段失败。 #### 账号操作与自动换号 - **新增**: 账号列表独立“退出登录”操作 — 用户可以明确退出当前账号，而不是把退出混在切号流程里。 - **修复**: overage 账号自动换号判断 — 主额度封顶但仍有 overage 余量的账号不会被过早跳过。 - **修复**: kiro-cli 切号错误处理 — 切号前刷新 token，并清理旧 key，减少 CLI 切过去后继续使用旧凭证。 #### Kiro2API 与发布 - **修复**: UTF-8 多字节截断 — 中文、emoji、多语言内容不会因为截断破坏字节边界而乱码。 - **修复**: 前端 Region 与后端支持范围对齐 — 避免页面能选但请求实际不可用。 - **修复**: Kiro2API 通配符连接地址 — 自定义监听地址或远程访问时生成更准确的客户端连接地址。 - **新增**: Claude Opus 4.8 模型支持。 - **修复**: 可用模型缓存 provider 标识 — 避免不同账号 / provider 的模型列表缓存串用。 - **新增**: 更新签名校验与 MSI 产物选择修复，降低发布无法自动更新或安装包选错的风险。 ### v1.8.8 - 2026-05-31 — Bun、多语言与账号状态自动识别 > 本版本提升构建效率、补齐英文 / 俄文界面，并重点完善账号状态识别链路：封禁、失效、封顶、suspended、overage 等状态会在同步、刷新、用量查询和模型列表查询中被统一识别。 #### ️ 构建与安全 - **调整**: 构建流程迁移到 Bun，移除 npm lockfile，减少安装和打包时间。 - **修复**: token 文件写入 TOCTOU 符号链接风险，降低异常路径写入风险。 - **调整**: 收紧 CSP 与 HTTP 权限，减少不必要的前端访问面。 - **调整**: 移除 keyring 依赖，保留 JSON 存储方式，减少额外平台依赖。 #### 账号状态识别 - **新增**: suspended / banned / invalid / capped / overage 状态识别 — `getUsageLimits`、`ListAvailableModels`、刷新和同步流程都会参与判断。 - **新增**: 不可用账号自动停用 — 封禁、失效或无可用额度账号不再参与自动换号和 Kiro2API 路由。 - **修复**: `getUsageLimits` 后立即刷新账号状态，减少页面显示滞后。 - **修复**: CLI 切号前刷新 token，切换后通知前端更新账号列表。 #### 多语言与 Kiro2API - **新增**: 英文和俄文界面，并在设置页加入语言切换入口。 - **修复**: 多语言重复 key、缺失 key 和封顶状态翻译。 - **调整**: 默认关闭“关闭窗口最小化到托盘”，避免用户误以为应用已退出但仍在后台运行。 - **修复**: 流式 `tool_use` 恢复 MCP 原始工具名，避免 Claude Code / MCP 客户端收到内部规范化名称。 - **修复**: input delta 早于 tool_use start 到达时补发工具开始事件，减少流式工具调用缺事件。 - **修复**: Enterprise 网关账号不再发送不适用的 profileArn。 ### v1.8.7 - 2026-05-20 — Kiro2API 主功能与账号池大版本 > 本版本是 Kiro2API 主功能扩展版本：补齐 OpenAI / Anthropic 多协议、Prompt Cache、请求日志、账号池路由、API Key、模型映射、Prompt 过滤和 Claude Code / Codex 快速配置，同时重构账号与设置界面。 #### 多协议 Kiro2API - **新增**: Anthropic `/v1/messages`、OpenAI `/v1/chat/completions`、OpenAI `/v1/responses` 多协议兼容。 - **新增**: 图片内容、thinking 参数、工具调用、Responses 会话恢复和模型映射支持。 - **修复**: Chat Completions 流式输出补齐 `completion_id` 与首个 `role`。 - **修复**: Responses 会话恢复继承 tools / tool_choice，并过滤不应重复发送的 tool_calls。 - **修复**: 多处 Kiro API 400 — 改进消息格式校验、工具 schema 处理和超长上下文控制。 #### ⚡ Prompt Cache 与上下文控制 - **新增**: Anthropic `cache_control` 到 Kiro `cache_point` 自动映射。 - **新增**: 系统提示词、工具定义、流式和非流式响应的 Prompt Cache 支持。 - **新增**: Prompt Cache 模拟器，用于观察缓存命中和 t