用途
Kimi Computer Use（服务名 kimi-cu）是一个运行在本地的 macOS MCP 服务，被多个智能体宿主共享使用，包括 Cursor CLI、Grok、WorkBuddy、Claude Code、Codex 和 Hermes。它让模型通过 MCP 协议读取应用界面状态，并在必要时执行界面操作。本技能的作用是指导安装、注册、验证、诊断和升级 kimi-cu，同时维护一份各宿主共用的操作规则。
安全边界
在发送消息、购买、删除、发布、更改账户设置或其他有实际后果的界面操作之前，必须先向用户确认。不得绕过 macOS 的 TCC 隐私授权、Gatekeeper、身份验证、密码、Touch ID 或验证码提示；当界面要求时，请用户自行完成 Kimi 账户登录和 macOS 隐私与安全设置。交互前优先进行只读检查，每次改变界面状态后重新读取应用状态以验证结果。
验证安装
常规检查包括：
/Applications/KimiCU.app/Contents/MacOS/kimi-cu service-status
/Applications/KimiCU.app/Contents/MacOS/kimi-cu xpc-ping
defaults read /Applications/KimiCU.app/Contents/Info CFBundleShortVersionString
安装或升级后，再执行签名检查：
codesign --verify --deep --strict /Applications/KimiCU.app
spctl --assess --type execute -vv /Applications/KimiCU.app
xpc-ping 是权限信息的可靠来源，它会打印服务自身的 accessibility= 和 screenRecording= 状态；不要根据宿主通用的 doctor 命令推断辅助功能或屏幕录制权限。kimi-cu 没有 help 命令：未知子命令只打印 unknown command，未知参数被忽略，kimi-cu upgrade 会立即执行，因此绝不要用 --help 探测子命令。如果应用缺失，应通过 Kimi Code 官方插件流程安装：更新 Kimi Code，打开 Plugins，选择 official，安装 Kimi Computer Use；不要从转载脚本安装二进制文件，因为这会绕过上述签名检查所依赖的签名。
注册 MCP 客户端
每个宿主使用相同的 stdio 命令：
/Applications/KimiCU.app/Contents/MacOS/kimi-cu mcp -s user
各宿主的具体配置路径、注册命令、状态命令和只读模型冒烟测试位于 references/host-configs.md，仅打开所需宿主对应的章节。应将 kimi-cu 条目合并进宿主现有配置，不要让多个宿主指向同一个符号链接文件，因为它们的 schema 和重载生命周期不同。
通过 MCP 操作
当目标应用已明确时，直接调用 get_app_state；仅在进程身份未知时调用 list_apps。get_app_state 的 mode 设为 "ax" 时以文本和辅助功能信息优先；仅在布局或像素重要时使用 image 或 full。使用能达成目标的最小操作，每次变更后再次调用 get_app_state 并验证可观察结果。当用户要求查看或验证运行中的界面时，你自己完成的 get_app_state 结果就是证据；若一次 UI 检查以零次 kimi-cu 工具调用结束，则视为未验证（UNVERIFIED）。
get_app_state 的关键参数：app 必须是 list_apps 返回的 bundle id（如 com.google.Chrome），不能是显示名称、产品名或窗口标题；pid 必须是 list_apps 返回的整数；app 和 pid 不可同时省略；mode 仅限 full、image、ax，使用 som 或 vision 会报参数错误。参数错误看起来像权限失败，但实际是参数问题。
每个宿主的只读冒烟测试：先 list_apps，再以 app=com.apple.finder、mode=ax 调用 get_app_state。应比较宿主发现的工具集与实时 schema，而非固定数量；升级后数量变化本身不代表失败。不要批量终止 kimi-cu 进程：一个服务助手运行在 PPID 1，每个宿主各自拥有 kimi-cu mcp 子进程，批量清理会破坏其他宿主的会话；应改为重新连接受影响的宿主。
选用时机
注册 kimi-cu 并不意味着它是默认方案：Codex 桌面和跨应用工作优先使用 Codex 原生 Computer Use，kimi-cu 仅作为回退或用户明确要求时使用；WorkBuddy 的浏览器、桌面和跨应用工作优先使用其原生能力，仅当原生 Computer Use 不可用或不足时使用 kimi-cu；DOM、Console、Network、Performance 等浏览器内部信息属于 Chrome DevTools MCP，而非 kimi-cu。
诊断故障
快速路径：若错误文本为 no target app 或 mode must be full, image, or ax，按上述参数表修正后重试只读 get_app_state；若客户端熔断处于激活状态，等待其冷却后再重试。只有修正后的调用成功完成，才能证明该调用路径可用；若修正后仍失败，继续分层检查。若无法重试，则将运行时验证报告为 UNVERIFIED。
否则从服务向外排查：重新运行 service-status 和 xpc-ping；运行宿主原生的 MCP 状态或测试命令；确认宿主发现已安装的工具集（包括 list_apps 和 get_app_state）；运行只读冒烟测试。报告中应区分三种状态：服务器已连接、工具已发现、模型实际发出并完成工具调用。若 Hermes 在连续 3 次失败后报告 MCP server 'kimi-cu' is unreachable，应视为客户端熔断而非根因证据；仅当前序失败调用显示参数错误时才归因于参数，否则保持原因未解决。等待冷却后以有效参数重试，若仍失败用 hermes mcp test kimi-cu 复查。不要从熔断消息推断权限健康。若前两种状态通过而第三种失败，先测试另一个官方支持的宿主模型，再判定模型适配不兼容；不要为了补偿将工具调用标记打印为文本的模型而重写可用的 MCP 配置。
升级
使用 /Applications/KimiCU.app/Contents/MacOS/kimi-cu upgrade </dev/null 原地检查并升级，它会打印已安装版本与最新版本，EOF 可防止无人值守提示挂起。签名与权限复查、新会话版本验证、宿主重连和源分发相关内容见 references/maintenance.md。升级后现有会话可能报告 Transport closed，需重新连接。应将已安装版本、独立服务器成功和每个宿主的模型接受情况作为独立证据分别记录。