@lightharu/krouter 1.8.0 → 1.8.2

package/dist-web/index.html

@@ -9,7 +9,7 @@
       http-equiv="Content-Security-Policy"
       content="default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:"
     />
-    <script type="module" crossorigin src="/assets/index-DCslvfUR.js"></script>
+    <script type="module" crossorigin src="/assets/index-C23DvwqV.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-CM4-0adf.css">
   </head>
 

package/docs/API-Proxy-Guide.en.md

@@ -0,0 +1,213 @@
+# Krouter API Proxy Guide
+
+Krouter API Proxy exposes one OpenAI, Claude and Gemini compatible endpoint for AI clients. The backend selects a usable Kiro account, refreshes tokens, checks model capability, logs requests, and rotates accounts according to your strategy.
+
+![API Proxy flow](./images/api-proxy-overview.svg)
+
+## 1. Install And Open The Dashboard
+
+Install or update Krouter:
+
+```bash
+npm install -g @lightharu/krouter
+```
+
+Open the CLI:
+
+```bash
+krouter
+```
+
+The CLI starts the backend, opens the local dashboard, and prints the access URL. Defaults:
+
+```text
+Dashboard: http://127.0.0.1:4010
+API Proxy: http://127.0.0.1:5580/v1
+```
+
+On a VPS, prefer a dashboard tunnel instead of exposing raw HTTP:
+
+```bash
+krouter tunnel start
+```
+
+## 2. Prepare Kiro Accounts
+
+Open **Accounts** and import valid Kiro accounts. Then run **refresh/check** so the backend can load quota, subscription, tokens, and profile ARN data.
+
+ARN notes:
+
+- Enterprise/Power accounts can have a real account-specific ARN.
+- GitHub/Google social accounts usually use the shared social ARN expected by Kiro.
+- Builder ID accounts can use a compatibility placeholder ARN. If a model rejects that account, multi-account mode can fail over to another account.
+
+## 3. Start API Proxy
+
+Open **API Proxy Service**.
+
+![API Proxy settings](./images/api-proxy-dashboard.svg)
+
+Recommended settings:
+
+| Setting | Recommended value |
+| --- | --- |
+| Host | `127.0.0.1` for local-only use |
+| Port | `5580` |
+| Auto Start | On if the service should restart automatically |
+| Multi-Account | On |
+| Strategy | `Smart` |
+| Log Requests | On while testing, optional later |
+| Max Retries | `3` or higher on unstable networks |
+| Disable Tools | Off when agent/dev tasks need tool calls |
+
+The **Smart** strategy scores accounts by remaining quota, recent errors, request count, latency, and token freshness. When an account hits quota, rate limit, or suspension errors, Krouter marks it and selects a better account.
+
+## 4. Create A Client API Key
+
+In **API Proxy Service**, open **Configure Clients** or **Configure API Keys**, then create an `sk-...` key.
+
+![Create key and connect clients](./images/api-proxy-client-setup.svg)
+
+Clients should send:
+
+```text
+Authorization: Bearer sk-...
+```
+
+Never expose the proxy publicly without API keys and access rules.
+
+## 5. Client Endpoints
+
+### OpenAI Compatible
+
+```text
+Base URL: http://127.0.0.1:5580/v1
+Chat:     POST /v1/chat/completions
+Models:   GET  /v1/models
+```
+
+Example:
+
+```bash
+curl http://127.0.0.1:5580/v1/chat/completions \
+  -H "Authorization: Bearer sk-..." \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "claude-sonnet-4.5",
+    "messages": [{"role": "user", "content": "Reply pong"}],
+    "stream": false
+  }'
+```
+
+### Claude Compatible
+
+```text
+Base URL: http://127.0.0.1:5580
+Messages: POST /v1/messages
+```
+
+Example:
+
+```bash
+curl http://127.0.0.1:5580/v1/messages \
+  -H "Authorization: Bearer sk-..." \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "claude-sonnet-4.5",
+    "max_tokens": 256,
+    "messages": [{"role": "user", "content": "Reply pong"}],
+    "stream": false
+  }'
+```
+
+### Gemini Compatible
+
+```text
+Base URL: http://127.0.0.1:5580
+Models:   GET  /v1beta/models
+Generate: POST /v1beta/models/{model}:generateContent
+```
+
+## 6. Connect OpenClaw
+
+Fast path:
+
+```bash
+krouter openclaw import
+```
+
+Or from the dashboard:
+
+```text
+API Proxy Service -> Configure Clients -> select OpenClaw -> Import
+```
+
+After import, select the `krouter` provider in OpenClaw and run `/models` to list the models exposed by Krouter.
+
+## 7. Connect Other AI Tools
+
+Use this generic setup:
+
+```text
+Provider: OpenAI Compatible
+Base URL: http://127.0.0.1:5580/v1
+API Key:  sk-...
+Model:    claude-sonnet-4.5
+```
+
+This works for OpenClaw, Codex-compatible clients, Continue, Cline, Cursor, OpenCode, or custom clients.
+
+## 8. Verify The Service
+
+Backend health:
+
+```bash
+curl http://127.0.0.1:4010/healthz
+```
+
+Proxy health:
+
+```bash
+curl http://127.0.0.1:5580/health
+```
+
+Model list:
+
+```bash
+curl http://127.0.0.1:5580/v1/models \
+  -H "Authorization: Bearer sk-..."
+```
+
+If `/v1/models` returns `401`, the API key is missing or incorrect.
+
+## 9. Safe Operations Checklist
+
+- Bind `127.0.0.1` for local use.
+- On a VPS, use a dashboard tunnel and keep API proxy auth enabled.
+- Enable Auto Start if the proxy should survive backend restarts.
+- Use `Smart` as the default multi-account strategy.
+- Watch request logs while testing a new model.
+- Do not route model traffic through suspended accounts; let Krouter skip them or remove them from the pool.
+
+## 10. Troubleshooting
+
+### `401 Unauthorized`
+
+The API key is missing or invalid. Check:
+
+```text
+Authorization: Bearer sk-...
+```
+
+### `profileArn is required`
+
+The selected account does not have a usable ARN for that endpoint/model. Run **Sync Accounts**, **Refresh Models**, or use **Smart** strategy so Krouter can select a better account.
+
+### `All models are temporarily rate-limited`
+
+Many accounts are rate-limited or cooling down. Wait for cooldown, reduce request rate, or inspect request logs.
+
+### `All accounts quota exhausted`
+
+All accounts in the selected scope are out of quota or cooling down. Check account quota, group scope, and API key bindings.
+

package/docs/API-Proxy-Guide.md

@@ -0,0 +1,9 @@
+# Krouter API Proxy Guide
+
+Choose a language:
+
+- [Tiếng Việt](./API-Proxy-Guide.vi.md)
+- [English](./API-Proxy-Guide.en.md)
+
+![Krouter API Proxy overview](./images/api-proxy-overview.svg)
+

package/docs/API-Proxy-Guide.vi.md

@@ -0,0 +1,213 @@
+# Hướng Dẫn Dịch Vụ API Proxy Của Krouter
+
+Krouter API Proxy tạo một endpoint tương thích OpenAI, Claude và Gemini để các công cụ AI gọi vào một nơi duy nhất. Backend sẽ tự chọn tài khoản Kiro phù hợp, làm mới token khi cần, kiểm tra model, ghi log và xoay tài khoản theo cấu hình.
+
+![Luồng API Proxy](./images/api-proxy-overview.svg)
+
+## 1. Cài Đặt Và Mở Dashboard
+
+Cài hoặc cập nhật Krouter:
+
+```bash
+npm install -g @lightharu/krouter
+```
+
+Mở CLI:
+
+```bash
+krouter
+```
+
+CLI sẽ khởi động backend, mở dashboard local và hiển thị địa chỉ truy cập. Mặc định:
+
+```text
+Dashboard: http://127.0.0.1:4010
+API Proxy: http://127.0.0.1:5580/v1
+```
+
+Nếu chạy trên VPS, dùng tunnel dashboard thay vì mở HTTP public trực tiếp:
+
+```bash
+krouter tunnel start
+```
+
+## 2. Chuẩn Bị Tài Khoản Kiro
+
+Vào **Tài khoản** và nhập các tài khoản Kiro hợp lệ. Sau đó bấm **Làm mới / kiểm tra** để backend lấy quota, subscription, token và profile ARN.
+
+Lưu ý về ARN:
+
+- Tài khoản Enterprise/Power có thể có ARN thật riêng.
+- Tài khoản GitHub/Google social thường dùng ARN social cố định.
+- Tài khoản Builder ID có thể dùng placeholder ARN tương thích. Nếu model không nhận tài khoản đó, proxy sẽ chuyển sang tài khoản khác khi bật multi-account.
+
+## 3. Bật API Proxy
+
+Vào **API Proxy Service**.
+
+![Màn hình cấu hình API Proxy](./images/api-proxy-dashboard.svg)
+
+Thiết lập khuyến nghị:
+
+| Mục | Giá trị khuyến nghị |
+| --- | --- |
+| Host | `127.0.0.1` nếu chỉ dùng local |
+| Port | `5580` |
+| Auto Start | Bật nếu muốn service tự chạy lại sau restart |
+| Multi-Account | Bật |
+| Strategy | `Smart` |
+| Log Requests | Bật khi đang test, có thể tắt khi chạy ổn |
+| Max Retries | `3` hoặc cao hơn nếu mạng không ổn |
+| Disable Tools | Tắt nếu dùng agent/dev task cần tool calls |
+
+Chiến lược **Smart** sẽ ưu tiên tài khoản còn quota, ít lỗi, ít request, latency tốt và token chưa gần hết hạn. Khi tài khoản lỗi quota/rate-limit/suspended, proxy đánh dấu trạng thái rồi tự chọn tài khoản khác.
+
+## 4. Tạo API Key Cho Client
+
+Trong **API Proxy Service**, bấm **Configure Clients** hoặc **Configure API Keys**, tạo key dạng `sk-...`.
+
+![Tạo key và kết nối client](./images/api-proxy-client-setup.svg)
+
+Client sẽ gọi bằng header:
+
+```text
+Authorization: Bearer sk-...
+```
+
+Không public API Proxy ra internet nếu chưa có API key và rule bảo mật.
+
+## 5. Endpoint Cho Các Client AI
+
+### OpenAI Compatible
+
+```text
+Base URL: http://127.0.0.1:5580/v1
+Chat:     POST /v1/chat/completions
+Models:   GET  /v1/models
+```
+
+Ví dụ:
+
+```bash
+curl http://127.0.0.1:5580/v1/chat/completions \
+  -H "Authorization: Bearer sk-..." \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "claude-sonnet-4.5",
+    "messages": [{"role": "user", "content": "Reply pong"}],
+    "stream": false
+  }'
+```
+
+### Claude Compatible
+
+```text
+Base URL: http://127.0.0.1:5580
+Messages: POST /v1/messages
+```
+
+Ví dụ:
+
+```bash
+curl http://127.0.0.1:5580/v1/messages \
+  -H "Authorization: Bearer sk-..." \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "claude-sonnet-4.5",
+    "max_tokens": 256,
+    "messages": [{"role": "user", "content": "Reply pong"}],
+    "stream": false
+  }'
+```
+
+### Gemini Compatible
+
+```text
+Base URL: http://127.0.0.1:5580
+Models:   GET  /v1beta/models
+Generate: POST /v1beta/models/{model}:generateContent
+```
+
+## 6. Kết Nối OpenClaw
+
+Cách nhanh nhất:
+
+```bash
+krouter openclaw import
+```
+
+Hoặc dùng dashboard:
+
+```text
+API Proxy Service -> Configure Clients -> chọn OpenClaw -> Import
+```
+
+Sau khi import, trong OpenClaw chọn provider `krouter`, rồi dùng `/models` để xem model Krouter đang xuất ra.
+
+## 7. Kết Nối Công Cụ Khác
+
+Dùng cấu hình chung:
+
+```text
+Provider: OpenAI Compatible
+Base URL: http://127.0.0.1:5580/v1
+API Key:  sk-...
+Model:    claude-sonnet-4.5
+```
+
+Phù hợp với các client như OpenClaw, Codex-compatible client, Continue, Cline, Cursor, OpenCode hoặc client tự viết.
+
+## 8. Kiểm Tra Hoạt Động
+
+Kiểm tra backend:
+
+```bash
+curl http://127.0.0.1:4010/healthz
+```
+
+Kiểm tra proxy:
+
+```bash
+curl http://127.0.0.1:5580/health
+```
+
+Kiểm tra danh sách model:
+
+```bash
+curl http://127.0.0.1:5580/v1/models \
+  -H "Authorization: Bearer sk-..."
+```
+
+Nếu `/v1/models` trả `401`, API key chưa đúng hoặc chưa gửi header `Authorization`.
+
+## 9. Gợi Ý Vận Hành An Toàn
+
+- Chỉ bind `127.0.0.1` khi dùng local.
+- Nếu chạy VPS, dùng tunnel dashboard và giữ proxy API có key.
+- Bật Auto Start để backend tự bật lại proxy sau restart.
+- Dùng `Smart` cho multi-account mặc định.
+- Theo dõi tab request logs khi test model mới.
+- Không dùng tài khoản bị suspended cho request model; hãy để proxy tự bỏ qua hoặc gỡ khỏi pool.
+
+## 10. Lỗi Thường Gặp
+
+### `401 Unauthorized`
+
+Thiếu API key hoặc key sai. Kiểm tra header:
+
+```text
+Authorization: Bearer sk-...
+```
+
+### `profileArn is required`
+
+Account chưa có ARN phù hợp cho endpoint/model đó. Bấm **Sync Accounts**, **Refresh Models**, hoặc dùng chiến lược **Smart** để proxy chọn account khác có capability tốt hơn.
+
+### `All models are temporarily rate-limited`
+
+Nhiều account đang rate-limit/cooldown. Đợi cooldown, giảm tốc độ request hoặc kiểm tra request logs để xem account nào đang bị lỗi.
+
+### `All accounts quota exhausted`
+
+Các tài khoản trong scope đã hết quota hoặc đang cooldown. Kiểm tra quota từng tài khoản, group scope và API key binding.
+

package/docs/CHANGELOG-v1.2.5.md

@@ -0,0 +1,85 @@
+# Kiro 账户管理器 v1.2.5 更新日志
+
+**发布日期**: 2025-12-09
+
+---
+
+## 🎨 主题系统升级
+
+### 主题颜色扩展
+- 主题颜色从 **13 个增加到 21 个**，提供更丰富的个性化选择
+- 按色系分组显示，便于用户快速定位喜欢的颜色：
+  - **蓝色系**: 天空蓝、靛蓝、清新青、晴空蓝、水鸭蓝
+  - **紫红系**: 优雅紫、紫罗兰、洋红、粉红、玫瑰红
+  - **暖色系**: 热情红、活力橙、琥珀金、明黄
+  - **绿色系**: 翠绿、草绿、青柠
+  - **中性色**: 石板灰、锌灰、暖灰、中性灰
+
+### 主题选择器优化
+- 新增 **收缩/展开** 功能，收缩时显示当前选中颜色
+- 点击即可展开完整的主题选择面板
+- 减少页面占用空间，界面更整洁
+
+---
+
+## 📊 主页增强
+
+### 额度统计卡片
+- 新增 **额度统计** 模块，实时汇总所有有效账号的用量数据
+- 显示内容：
+  - 总额度
+  - 已使用
+  - 剩余额度
+  - 使用率百分比
+- 可视化进度条，根据使用率变色：
+  - 🟢 绿色: < 50%
+  - 🟡 黄色: 50% - 80%
+  - 🔴 红色: > 80%
+
+---
+
+## 💾 导出功能升级
+
+### 多格式导出支持
+- 新增导出格式选择弹窗，支持 4 种导出格式：
+  - **JSON**: 完整数据，可用于导入恢复
+  - **TXT**: 纯文本格式，便于阅读
+  - **CSV**: Excel 兼容格式，支持中文
+  - **剪贴板**: 直接复制到剪贴板
+
+### 导出选项
+- JSON 格式可选择是否包含凭证信息（Token 等敏感数据）
+- 支持多选账号导出，选中账号时只导出选中的
+- 设置页面和账户管理页面共用相同的导出组件
+
+---
+
+## 🔧 机器码管理优化
+
+### 当前机器码卡片
+- 新增 **最后修改时间** 显示，与原始机器码备份布局保持一致
+
+### 账户机器码管理弹窗
+- 新增 **搜索功能**，支持按邮箱、昵称、机器码搜索
+- 搜索无结果时显示友好提示
+
+---
+
+## 🐛 问题修复
+
+- 修复部分主题颜色切换无效的问题
+- 补全所有新增主题的 CSS 变量定义
+- 修复 `applyTheme` 函数未包含新主题类名的问题
+
+---
+
+## 📝 技术改进
+
+- 主题配置重构为分组结构，便于维护和扩展
+- 导出功能组件化，提高代码复用性
+- 优化额度统计使用 `useMemo` 提升性能
+
+---
+
+**完整版本**: 1.2.5  
+**兼容性**: Windows / macOS / Linux

package/docs/CHANGELOG-v1.2.7.md

@@ -0,0 +1,59 @@
+# Kiro 账户管理器 v1.2.7 更新说明
+
+发布日期：2024-12-09
+
+## 🎨 界面美化
+
+### 全局页面美化
+- **统一页面头部设计**：所有页面采用渐变背景 + 模糊光效 + 主题色标题
+- **统一卡片样式**：所有卡片添加悬停阴影效果和图标背景框
+- **颜色主题化**：移除所有硬编码颜色，统一使用主题变量，确保深色/浅色模式和主题色切换时颜色一致
+
+### 新增自定义 UI 组件
+- **Toggle 开关组件**：替换原生 checkbox，提供平滑动画和主题色支持
+- **Select 下拉组件**：替换原生 select，支持选项描述、勾选标记和主题色高亮
+
+### 美化的页面
+- **首页 (HomePage)**：头部渐变、统计卡片悬停效果、特色功能卡片主题化
+- **账户管理 (AccountManager)**：头部渐变背景和图标
+- **设置页面 (SettingsPage)**：头部渐变、所有卡片图标统一样式、检查间隔布局优化
+- **Kiro 设置 (KiroSettingsPage)**：头部渐变、Toggle 开关、Select 下拉框、通知设置分组
+- **关于页面 (AboutPage)**：头部渐变、所有卡片图标统一样式、功能列表颜色统一
+
+## 🔧 功能优化
+
+### OIDC 凭证批量导入
+- **支持 GitHub 和 Google 账号**：批量导入时可通过 `provider` 字段指定账号类型
+- **自动识别认证方式**：根据 provider 自动设置正确的 `authMethod` (IdC/social) 和 `idp`
+- **更新帮助文本**：添加 GitHub/Google 示例和说明
+
+### 批量导入 JSON 格式示例
+```json
+[
+  {
+    "refreshToken": "xxx",
+    "clientId": "xxx",
+    "clientSecret": "xxx",
+    "provider": "BuilderId"
+  },
+  {
+    "refreshToken": "yyy",
+    "provider": "Github"
+  },
+  {
+    "refreshToken": "zzz",
+    "provider": "Google"
+  }
+]
+```
+
+## 📁 新增文件
+
+- `src/renderer/src/components/ui/Toggle.tsx` - 自定义开关组件
+- `src/renderer/src/components/ui/Select.tsx` - 自定义下拉选择组件
+
+## 🐛 修复
+
+- 修复设置页面检查间隔下拉框布局问题
+- 修复 Kiro 设置页面上下下拉框宽度不一致问题
+- 统一设置页面和 Kiro 设置页面的宽度设置

package/docs/CHANGELOG-v1.3.7.md

@@ -0,0 +1,56 @@
+# Kiro 账户管理器 v1.3.7 更新说明
+
+发布日期：2025-01-18
+
+## 🎯 订阅管理功能优化
+
+### 订阅流程重构
+- **统一订阅入口**：点击订阅标签统一先获取可用订阅列表，然后显示订阅计划页面
+- **首次用户支持**：正确处理首次用户订阅流程，使用 `qSubscriptionType` 参数创建订阅令牌
+- **管理账单按钮**：所有账户左下角都显示"管理账单"按钮，不管是否有订阅
+
+### 用户体验优化
+- **链接自动复制**：选择订阅计划后，支付链接自动复制到剪贴板
+- **复制成功提示**：显示绿色提示"链接已复制到剪贴板！"，800ms 后自动关闭弹窗并打开链接
+- **错误提示**：订阅相关操作失败时，在弹窗中显示红色错误提示信息
+
+## 🌐 API 反代服务改进
+
+### Claude Code 兼容性
+- **新增端点**：`/anthropic/v1/messages` - Claude Code 兼容
+- **新增端点**：`/v1/messages/count_tokens` - Token 计数
+- **新增端点**：`/api/event_logging/batch` - 遥测支持
+
+### 配置与稳定性
+- **配置持久化**：端口和 host 更改时自动保存配置
+- **CORS 头增强**：添加 Claude Code 需要的更多请求头支持
+
+### API 兼容性
+- **工具描述长度限制**：自动截断超过 10240 bytes 的工具描述
+- **内容非空检查**：确保发送给 Kiro API 的消息内容非空
+
+## 🔧 技术修复
+
+### API 调用优化
+- **修复 Header**：统一使用正确的 `x-amzn-codewhisperer-optout-preference: OPTIN` 请求头
+- **修复订阅类型参数**：`CreateSubscriptionToken` API 使用 `qSubscriptionType`
+
+## 📝 代码变更
+
+### AccountCard.tsx
+- 新增 `subscriptionError` 和 `subscriptionSuccess` 状态
+- 重构订阅相关函数
+
+### ProxyPanel.tsx
+- 端口、host 更改时自动保存配置
+- 更新 API 端点说明列表
+
+### proxyServer.ts
+- 添加新路由支持和 `handleCountTokens` 方法
+- 增强 CORS 头配置
+
+### translator.ts
+- 添加工具描述长度限制和内容非空检查
+
+### kiroApi.ts
+- 修复请求头格式