KiroCrew 桥接zoahdev/dsh-kirocrew

dsh-kirocrew

CI
npm

将 KiroCrew 桥接到 DeepSeek Harness：让你的 dsh 智能体通过
ACP（基于 stdio 的 JSON-RPC 2.0）将一轮对话
委托给一个持久的、可自我演化的开发工作区。

KiroCrew 是一个开源工作区，运行在你自己的硬件上，能够跨会话记忆，
并持续无人值守地工作。本插件将该工作区以单个 kiro_send 工具的形式
暴露给 DeepSeek Harness 智能体。

功能说明

- 注册一个面向模型的工具：kiro_send。
- kiro_send 会启动 kiro-cli acp，执行 ACP 握手
（initialize → session/new → session/prompt），转发你的提示词，收集
智能体的文本片段，并返回最终文本。
- 默认自动批准 ACP 的 session/request_permission（allow_once）；
将 autoApproveTools 设为 false 则改为拒绝。

这是一个轻量、诚实的桥接：它转发提示词并返回文本。
它不会重新实现 KiroCrew。

环境要求

- Node.js 18+
- 已安装并登录 kiro-cli（KiroCrew 的 CLI）。ACP 后端位于
kiro-cli acp 之后。

使用官方一行命令安装 KiroCrew（macOS / Linux / Windows WSL）：

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh

桌面应用、Docker 和 Windows 源码安装方式请参见
KiroCrew 仓库。

安装

dsh plugin add dsh-kirocrew

或全局安装：

npm install -g dsh-kirocrew

用法

You: kiro_send("Write a failing test and fix it")

配置（插件配置）：

{
"bin": "kiro-cli",          // optional: path to kiro-cli
"cwd": "/path/to/work",     // optional: session working directory
"mode": "coder",            // optional: KiroCrew agent mode id
"model": "anthropic/...",   // optional: model id
"timeoutMs": 120000,        // optional: turn timeout
"autoApproveTools": true    // optional: auto-allow tool permissions
}

kiro_send 也接受每次调用的覆盖参数：cwd、mode、model。

故障排查

failed to spawn kiro-cli (is kiro-cli installed and on PATH?)

桥接程序找不到 kiro-cli。请安装 KiroCrew，确保 kiro-cli 位于
PATH 中，并登录（kiro-cli 在首次运行时会引导进行设备码登录）。
你可以通过 "bin": "/absolute/kiro-cli" 为插件指定明确的路径。

kiro-cli exited before the turn completed

kiro-cli acp 在握手或对话轮次期间失败。请直接重新运行 kiro-cli
以确认已登录，然后检查错误中包含的 stderr 末尾输出。

request cancelled or timed out

该轮次超过了 timeoutMs。对于长时间运行的无人值守任务，请调高该值。

开发

pnpm install --frozen-lockfiletext
pnpm typecheck
pnpm build
pnpm test
pnpm pack

测试覆盖 ACP 协议（握手、文本分块收集、思考分块跳过、权限批准/拒绝、错误路径），
无需真实的 KiroCrew。stdio 传输的失败路径也已验证（缺失二进制）。

诚实状态

这是一个社区插件，不是 DeepSeek 或 KiroCrew 官方项目。它已在协议与传输失败层面
验证；完整的端到端运行需要你自己的 kiro-cli 安装与登录。

许可证

MIT

dsh-kirocrew（中文）

把 KiroCrew 桥接进 DeepSeek Harness：让 dsh 的 agent 通过
ACP（stdio 上的 JSON-RPC 2.0）把一次对话委托给一个
持久的、自我进化的开发工作区。

KiroCrew 是一个跑在你自己的硬件上、跨会话记住上下文、并能无人值守继续工作的
开源开发工作区。本插件把它暴露成一个 kiro_send 工具。

作用

- 注册一个面向模型的工具：kiro_send。
- 它启动 kiro-cli acp，完成 ACP 握手（initialize → session/new → session/prompt），
转发你的提示词，收集 agent 的文本分块，返回最终文本。
- 默认自动批准 ACP 的 session/request_permission（allow_once）；设
autoApproveTools: false 改为拒绝。

这是一个轻薄、诚实的桥接：转发提示词、返回文本，并不重新实现 KiroCrew。

前置条件

- Node.js 18+
- 已安装并登录 kiro-cli（KiroCrew 的 CLI，ACP 后端就是 kiro-cli acp）

安装 KiroCrew（macOS / Linux / Windows WSL）：
bash
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh

桌面应用、Docker、Windows 源码安装见
KiroCrew 仓库。

安装
bash
dsh plugin add dsh-kirocrew

或全局安装：
bash
npm install -g dsh-kirocrew

使用
text
你：kiro_send("写一个会失败的测试，然后修好它")

配置（插件 config）：
jsonc
{
"bin": "kiro-cli",          // 可选：kiro-cli 路径
"cwd": "/path/to/work",     // 可选：会话工作目录
"mode": "coder",            // 可选：KiroCrew agent 模式 id
"model": "anthropic/...",   // 可选：模型 id
"timeoutMs": 120000,        // 可选：单轮超时
"autoApproveTools": true    // 可选：自动批准工具权限
}

kiro_send 也支持按调用覆盖 cwd、mode、model。

排障

failed to spawn kiro-cli (is kiro-cli installed and on PATH?)

找不到 kiro-cli。请安装 KiroCrew，确认 kiro-cli 在 PATH 上并已登录。也可以用
"bin": "/absolute/kiro-cli" 指定绝对路径。

kiro-cli exited before the turn completed

握手或回合失败。请先直接跑一次 kiro-cli 确认已登录，再看错误里附带的 stderr 尾部。

request cancelled or timed out

超过了 timeoutMs。长时间无人值守任务可适当调大。

开发
bash
pnpm install --frozen-lockfile
pnpm typecheck
pnpm build
pnpm test
pnpm pack

测试在无需真实 KiroCrew 的情况下覆盖 ACP 协议（握手、文本分块收集、思考分块跳过、
权限批准/拒绝、错误路径），并验证 stdio 传输的失败路径（缺失二进制）。

诚实声明

这是社区插件，不是 DeepSeek 或 KiroCrew 官方项目。已在协议与传输失败层面验证；
完整的端到端运行需要你自己的 kiro-cli 安装与登录。

许可证

MIT