DeepSeek Harness Kiro Provider

DeepSeek Harness (DSH) 采用插件化架构。接入 Kiro 服务通常涉及复杂的认证配置。dsh-kiro 插件封装了 Kiro 的接入流程，支持多种认证方式、动态模型发现以及推理控制。

插件定位¶

dsh-kiro 是 DeepSeek Harness 的 Kiro 提供商插件，由 dat-lequoc 维护，遵循 MIT 许可证。它解决了手动配置 cordis.yml 和管理 Token 的繁琐问题，提供了一套完整的 Kiro 接入方案。该插件注册了 kiro 提供商路由，安装后自动挂载，无需手动编写配置。

安装与启用¶

通过官方命令行安装插件：

dsh plugin --profile web add github:dat-lequoc/dsh-kiro

安装完成后，直接启动 DSH：

dsh --profile web

认证方式¶

Web 界面登录¶

在 DSH 的 Settings → Kiro 页面，支持以下登录方式：

AWS Builder ID：使用标准的设备码流程。
IAM Identity Center：使用设备码流程，需提供 https://<company>.awsapps.com/start URL 和区域。
Google / GitHub：使用 Kiro 的社交设备码流程，需在授权页面输入一次性验证码。
凭证导入：支持导入 Kiro 刷新令牌、API Key 或兼容 CLIProxyAPI 的 Microsoft 外部 IdP JSON 凭证。

终端登录¶

插件提供了 kiro-login 命令用于终端认证。常用示例包括：

# 使用 AWS Builder ID 登录
kiro-login --region eu-central-1

# 使用 IAM Identity Center 登录
kiro-login --method idc --start-url https://company.awsapps.com/start --region eu-central-1

# 使用 GitHub 登录
kiro-login --method github

# 使用刷新令牌
KIRO_REFRESH_TOKEN='...' kiro-login --method refresh-token

# 使用 API Key
KIRO_API_KEY='...' kiro-login --method api-key

# 使用外部 IdP 凭证文件
kiro-login --method external-idp --credentials-file ./kiro-auth.json

# 配置代理
kiro-login --proxy http://user:pass@proxy.example:8080

环境变量支持：KIRO_REGION、KIRO_PROXY_URL、KIRO_START_URL、KIRO_REFRESH_TOKEN、KIRO_API_KEY。

凭证存储¶

插件管理的凭证默认存储在 $DSH_HOME/storages/kiro-auth（通常为 ~/.dsh/storages/kiro-auth）。Token 和设备注册文件权限为 0600，确保安全性。

优先级：插件管理的凭证 > Kiro IDE/CLI 的 SSO 缓存。
刷新机制：Builder ID、Google、GitHub 和 IDC 管理的凭证通过区域 AWS OIDC 自动刷新；刷新后的 Token 和 Profile ARN 会原子上位写入存储。
Fallback：当没有插件管理的凭证时，插件会读取 Kiro IDE/CLI 的 ~/.aws/sso/cache/kiro-auth-token.json 进行复用。

模型发现与推理控制¶

模型列表¶

插件会查询 Kiro 的 ListAvailableModels 接口，获取当前账户可用的模型列表（包括 Opus、Sonnet、Haiku 及开源权重路由）。模型列表缓存 5 分钟，可在设置页手动刷新。配置的选择会持久化到 $DSH_HOME/storages/kiro-auth/model-settings.json。

推理参数¶

插件会自动发现每个模型的推理能力。支持的努力等级包括 none、low、medium、high、xhigh 和 max。

在 DSH 的模型菜单中，仅显示选中模型支持的等级。配置会通过 Kiro 原生字段发送。如果使用旧版手动配置的回退目录，则使用旧的提示标记行为。

配置覆盖¶

可在全局配置文件中设置默认推理努力等级：

llm-kiro:
  reasoningEffort: medium

高级功能¶

流式输出：支持通过 Amazon EventStream 协议流式接收文本、推理内容和工具调用。
图像支持：支持向支持的模型发送图片，以解锁图片附件和 Harness 自带的图片阅读工具。
代理支持：支持直接出口或经过认证的 HTTP/HTTPS CONNECT 代理。
热重载：修改 llm-kiro 设置无需重启 DSH 即可生效。

注意事项¶

这是一个独立的集成项目，与 AWS 或 Kiro 无官方关联。Kiro 及其徽标为 Amazon 商标。
无需手动创建 cordis.yml 条目或提供 API Key。
插件以当前 DSH 进程的权限运行，请确保在安装前检查源码与许可证。