问题描述
MindFS v0.2.1 在 Windows 上无法检测到任何 ACP 协议的
Agent(kiro、cursor、augment、cline、copilot、kimi、openclaw、opencode、qwen、qoder、pi
)。/api/agents 接口返回空数组。
之前安装了 Claude Code(非 ACP 协议)时,claude 能被正常检测和探测(虽然因为没有 API key
而探测失败)。但所有 ACP 类 Agent 从未出现在探测日志中——既不在 probe_missing_commands
列表中,也没有被实际探测。
环境信息
- 操作系统: Windows 11 (NT 10.0.26200.0),AMD64
- MindFS: v0.2.1(通过
install.ps1 安装)
- kiro-cli: 2.1.1(路径:
C:\Users\<user>\AppData\Local\Kiro-Cli\kiro-cli.exe)
复现步骤
- 在 Windows 上通过 PowerShell 安装脚本安装 MindFS v0.2.1
- 确认
kiro-cli 已安装且在 PATH 中(where.exe kiro-cli 返回正确路径)
- 确认
kiro-cli acp --help 能正常工作
- 启动 MindFS:
mindfs -foreground
- 查询已检测的 Agent:
GET http://127.0.0.1:7331/api/agents
期望行为
kiro(以及其他已安装的 ACP Agent)应出现在 agents 列表中。
实际行为
/api/agents 返回 [](空数组)。日志中没有任何 kiro 相关的记录。
排查过程
-
确认 agents.json 配置正确: {"name": "kiro", "command": "kiro-cli", "args": ["acp"]}
-
确认命令可执行:
where.exe kiro-cli → C:\Users\<user>\AppData\Local\Kiro-Cli\kiro-cli.exe
kiro-cli acp --help 正常输出帮助信息
kiro-cli acp 能正常启动(通过 stdin 接收 JSON-RPC 消息)
-
尝试将 kiro-cli.exe 放到 mindfs.exe 同目录下 → 仍然无法检测
-
之前 claude(非 ACP)被安装时的日志表现:
[agent/probe] probe_missing_commands count=2 agents=gemini,codex
[agent/probe] probe_failed_installed count=1 agents=claude
- 注意:kiro 和所有其他 ACP Agent 完全没有出现在任何列表中
-
卸载 claude 后: /api/agents 返回空数组,说明 ACP Agent 的检测逻辑完全没有生效
可能的原因
ACP 类 Agent 的命令存在性检查在 Windows 平台上可能存在问题。推测可能是使用了 Unix
风格的路径查找,没有正确处理 Windows 的 .exe 扩展名或 PATH 解析逻辑。
问题描述
MindFS v0.2.1 在 Windows 上无法检测到任何 ACP 协议的
Agent(kiro、cursor、augment、cline、copilot、kimi、openclaw、opencode、qwen、qoder、pi
)。
/api/agents接口返回空数组。之前安装了 Claude Code(非 ACP 协议)时,claude 能被正常检测和探测(虽然因为没有 API key
而探测失败)。但所有 ACP 类 Agent 从未出现在探测日志中——既不在
probe_missing_commands列表中,也没有被实际探测。
环境信息
install.ps1安装)C:\Users\<user>\AppData\Local\Kiro-Cli\kiro-cli.exe)复现步骤
kiro-cli已安装且在 PATH 中(where.exe kiro-cli返回正确路径)kiro-cli acp --help能正常工作mindfs -foregroundGET http://127.0.0.1:7331/api/agents期望行为
kiro(以及其他已安装的 ACP Agent)应出现在 agents 列表中。实际行为
/api/agents返回[](空数组)。日志中没有任何 kiro 相关的记录。排查过程
确认
agents.json配置正确:{"name": "kiro", "command": "kiro-cli", "args": ["acp"]}确认命令可执行:
where.exe kiro-cli→C:\Users\<user>\AppData\Local\Kiro-Cli\kiro-cli.exekiro-cli acp --help正常输出帮助信息kiro-cli acp能正常启动(通过 stdin 接收 JSON-RPC 消息)尝试将
kiro-cli.exe放到mindfs.exe同目录下 → 仍然无法检测之前 claude(非 ACP)被安装时的日志表现:
[agent/probe] probe_missing_commands count=2 agents=gemini,codex[agent/probe] probe_failed_installed count=1 agents=claude卸载 claude 后:
/api/agents返回空数组,说明 ACP Agent 的检测逻辑完全没有生效可能的原因
ACP 类 Agent 的命令存在性检查在 Windows 平台上可能存在问题。推测可能是使用了 Unix
风格的路径查找,没有正确处理 Windows 的
.exe扩展名或 PATH 解析逻辑。