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 進程的權限運行，請確保在安裝前檢查源碼與許可證。