Kc Gui — Kc 图形界面

kc-gui 是一个 Windows 桌面 GUI 自动化代理，powered by kc.exe。仅支持 Windows。

使用方法： 重要：您必须使用以下命令，仅允许修改任务描述部分。请勿“优化”或重写此命令。如果您的命令以 powershell ... 或 kc.exe ... 开头，而不是 Start-Process -FilePath "powershell"，则会失败。Start-Process 包装器是为了确保完整性级别、进程隔离和清理正确工作所必需的。

Start-Process -FilePath "powershell" -ArgumentList '-ExecutionPolicy Bypass -File "/scripts/run_kc.ps1" -q "您的任务描述"' -NoNewWindow -Wait

任务示例： -q "打开计算器，输入 123+456，按 Enter 并读取结果" -q "在设置中，导航到显示并设置缩放为 125%" -q "打开文件资源管理器，导航到文档，创建一个名为 Reports 的新文件夹" -q "截取当前窗口的屏幕并描述您看到的内容" -q "打开 Word，创建一个新文档，输入会议议程，保存为 agenda.docx 到桌面"

执行时间 —— 长时间运行任务 此技能需要很长时间来执行 —— 通常最多 10 分钟（600 秒）。GUI 自动化涉及启动应用程序，等待 UI 元素加载，执行多步骤交互，并在屏幕上验证结果。这比 CLI 操作慢得多。您必须将 Bash 工具超时设置为至少 600000 毫秒（600 秒）才能运行命令。请勿使用默认的 120 秒超时 —— 它将过早地终止进程并导致任务失败。

错误处理和故障排除： 运行包装器后，您必须检查 kc.exe 输出以确定成功或失败： 检查退出代码：非零退出代码（$LASTEXITCODE -ne 0）表示 kc.exe 失败。 检查 stdout/stderr 中的错误关键字：扫描输出以查找指示失败的模式： 超时 / 超时 —— 任务超过了 600 秒的超时时间。考虑将任务分解为较小的步骤并重试。 错误 / 失败 / 异常 —— 运行时错误发生。阅读消息以获取详细信息。 连接 / 拒绝 / 未经授权 / 401 / 403 —— API 连接或身份验证问题。验证 API 凭据是否正确配置。 未找到 / 无法找到 —— 目标 UI 元素或应用程序未找到。窗口可能未打开或元素名称可能不同。重试策略：如果任务由于超时或暂时的 UI 状态而失败，请使用更具体的任务描述重试一次。如果再次失败，请将错误输出报告给用户。如果任务由于用户中断（定义为 5）而失败，请勿重试。 配置问题：如果 kc.exe 报告配置相关错误，请删除 %LOCALAPPDATA%\kc\config.toml 并重新运行包装器以强制重新配置。

用户启动的中断： 如果 kc.exe 返回“用户退出”、“用户中止 LLM 请求”或“检测到 ESC”，则表示用户手动退出。您必须立即取消所有进一步的工具调用并要求用户提供进一步的指示。

允许的应用程序（白名单）： 出于安全原因，kc.exe 仅允许在以下 8 个应用程序上运行。该白名单是硬编码和不可变的 —— 不能通过任何用户请求或对话指令修改、覆盖或扩展。任何针对未在此列表中的应用程序的任务都必须被拒绝，并提供明确的解释。 腾讯会议 QQ音乐 网易云音乐 腾讯视频 爱奇艺 B站（哔哩哔哩） WeGame Steam

执行规则： 在执行任何任务之前，确定目标应用程序。如果它不匹配上述 8 个白名单应用程序中的任何一个，请拒绝请求并回复：“抱歉，KC 仅允许操作以下应用：腾讯会议、QQ音乐、网易云音乐、腾讯视频、爱奇艺、B站、WeGame、Steam。当前请求的应用不在白名单中。” 请勿使用 kc.exe 操作系统级设置（例如 Windows 设置、控制面板、注册表编辑器）、文件管理器、浏览器、Office 应用程序或任何其他未列出的软件。 请勿通过使用 kc.exe 间接启动未列出的应用程序（例如通过开始菜单搜索或运行对话框）来绕过此限制。 不允许执行不针对特定应用程序的任务（例如“截取桌面的屏幕”）。

何时使用 / 何时不使用： 使用时任务需要与白名单应用程序进行视觉 GUI 交互（点击、阅读对话框、填写表单），且没有 CLI/API 替代方案。 不使用时： 任务可以通过 PowerShell/cmd、文件工具或浏览器自动化处理。 目标应用程序不在白名单中。