Skip to content

Windows 上无法检测到 ACP 类 Agent(kiro、cursor、augment 等) #20

@imwangpan

Description

@imwangpan

问题描述

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

复现步骤

  1. 在 Windows 上通过 PowerShell 安装脚本安装 MindFS v0.2.1
  2. 确认 kiro-cli 已安装且在 PATH 中(where.exe kiro-cli 返回正确路径)
  3. 确认 kiro-cli acp --help 能正常工作
  4. 启动 MindFS:mindfs -foreground
  5. 查询已检测的 Agent:GET http://127.0.0.1:7331/api/agents

期望行为

kiro(以及其他已安装的 ACP Agent)应出现在 agents 列表中。

实际行为

/api/agents 返回 [](空数组)。日志中没有任何 kiro 相关的记录。

排查过程

  1. 确认 agents.json 配置正确: {"name": "kiro", "command": "kiro-cli", "args": ["acp"]}

  2. 确认命令可执行:

    • where.exe kiro-cliC:\Users\<user>\AppData\Local\Kiro-Cli\kiro-cli.exe
    • kiro-cli acp --help 正常输出帮助信息
    • kiro-cli acp 能正常启动(通过 stdin 接收 JSON-RPC 消息)
  3. 尝试将 kiro-cli.exe 放到 mindfs.exe 同目录下 → 仍然无法检测

  4. 之前 claude(非 ACP)被安装时的日志表现:

    • [agent/probe] probe_missing_commands count=2 agents=gemini,codex
    • [agent/probe] probe_failed_installed count=1 agents=claude
    • 注意:kiro 和所有其他 ACP Agent 完全没有出现在任何列表中
  5. 卸载 claude 后: /api/agents 返回空数组,说明 ACP Agent 的检测逻辑完全没有生效

可能的原因

ACP 类 Agent 的命令存在性检查在 Windows 平台上可能存在问题。推测可能是使用了 Unix
风格的路径查找,没有正确处理 Windows 的 .exe 扩展名或 PATH 解析逻辑。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions