API Proxy Bridge 使用指南

1. 1
   安装插件

   下载并通过“从 VSIX 安装”导入 Kiro IDE。

2. 2
   激活授权

   打开左侧 API Proxy Bridge 面板，输入 CDK 激活码。

3. 3
   配置服务

   填写 Base URL、API Key，获取并选择模型。

4. 4
   测试保存

   测试连接成功后保存配置并打开代理开关。

5. 5
   开始使用

   返回 Kiro Agent，选择已添加的模型并发送消息。

• 已安装并可正常启动的 Kiro IDE
• api-proxy-bridge-1.1.5.vsix 安装包
• 有效的 CDK 激活码
• API 服务商提供的 Base URL 和 API Key
• 服务商支持的模型名称及端点协议

Base URL 示例

https://api.example.com
https://api.example.com/v1
https://api.example.com/v1/responses

请填写服务商实际提供的地址，不要直接使用示例域名。

从 VSIX 安装

1. 打开 Kiro IDE，进入左侧 Extensions / 扩展 页面。
2. 点击扩展页面右上角的更多操作按钮。
3. 选择 Install from VSIX... / 从 VSIX 安装...。
4. 选择下载的 api-proxy-bridge-1.1.5.vsix。
5. 等待安装完成，按提示重新加载窗口。

确认安装成功

重新加载后，左侧活动栏应出现 API Proxy Bridge 图标。也可以打开命令面板并搜索：

API Proxy Bridge: Open Settings

1. 点击左侧活动栏的 API Proxy Bridge 图标。
2. 在“授权激活”区域输入 CDK 激活码。
3. 点击 激活，等待页面显示授权状态和有效期。

CPROXY-XXXX-XXXX-XXXX-XXXX

1. 在“当前使用”区域点击 新增中转站。
2. 填写中转站名称，例如 Primary API。
3. 填写服务商提供的 Base URL。
4. 保持中转站为启用状态，点击 测试连接。

添加令牌

1. 点击 新增令牌，填写令牌名称。
2. 粘贴服务商提供的 API Key。
3. 选择与服务商匹配的端点位置。
4. 点击页面底部 保存。

端点位置

获取并添加模型

1. 点击 获取模型。
2. 勾选需要使用的模型，可点击 检测选中 检查可用性。
3. 点击 添加选中，设置推理强度后保存。

日常任务建议先使用 medium 或 high。推理强度越高，通常会消耗更多 Token，并增加首字等待时间。

1. 完成配置后点击 保存。
2. 打开页面顶部的代理开关，确认没有授权或端口错误。
3. 返回 Kiro Agent，选择 API Proxy Bridge 提供的模型。
4. 发送测试消息验证响应。

请只回复：连接成功

• 将常用服务设置为较高优先级。
• 为同一服务商的不同 API Key 添加清晰名称。
• 修改后使用 测试全部 检查每个配置。
• 暂时不用的中转站可以关闭，无需立即删除。

自动切换备用 Provider

开启后，当前服务遇到指定 HTTP 状态码时，可尝试其他可用服务。默认重试状态码：

429,500,502,503,504

Token 监控用于查看当前模型的输入、输出、缓存和上下文占用。

1. 在插件设置页打开“Token 监控”开关。
2. 使用 Kiro Agent 发起请求。
3. 返回设置页查看累计统计。

示意数据仅用于说明界面结构，不代表实际调用记录。

升级插件

1. 下载新版本 VSIX。
2. 在扩展页面选择“从 VSIX 安装”，确认覆盖安装。
3. 重新加载 Kiro IDE，检查授权和配置。
4. 测试连接并发送测试消息。

卸载插件

1. 先执行 Restore Kiro Official Service。
2. 如需释放设备名额，点击“注销激活”。
3. 在扩展页面卸载 API Proxy Bridge。
4. 重新加载 Kiro IDE。

• 不要在聊天、截图或公开文档中展示完整 API Key、CDK 或 Cookie。
• 只从正式渠道下载安装包，并在安装前核对 SHA-256。
• 调试日志不应包含消息正文、工具输出、凭据或响应正文。
• 开启备用 Provider 前，确认各服务商的数据处理规则。

校验安装包

Get-FileHash .\api-proxy-bridge-1.1.5.vsix -Algorithm SHA256