---
name: kimi-use
description: >-
  Two scopes: (1) drives Kimi.app via computer-use for Work/Agent data-plugin queries
  (天眼查、同花顺 iFinD、SEC、IMF etc.) and Chat's built-in 深度研究 report;
  (2) kimi-cu macOS desktop-automation playbook — AX set_value / keyboard / click
  channel selection, foregrounding, AX-tree recovery, form & dialog recipes.
  Use for "用 Kimi 查" / "操作 Kimi 客户端" / "Kimi 插件" / "Kimi 深度研究" /
  driving any macOS desktop app (Electron/webview/native) via kimi-cu.
  Not for kimi.com browser automation (use kimi-webbridge) or direct iFinD API access.
---

# kimi-use — Kimi 桌面客户端的插件取数与 Chat 深度研究

## 先按交付物选模式

| 要得到什么 | 客户端入口 | 结果判据 |
|---|---|---|
| 指定插件的字段、原始记录或接口能力 | **Work/Agent + K3 极致思考**，下文「插件取数循环」 | 实际调用插件的轨迹、带来源字段与独立权威源复核 |
| 独立的长篇研究报告 | **Chat → 深度研究 + K3 极致**，见 `references/driving-kimi-app.md`「Chat 深度研究」 | 任务完成后的原始报告及附件、来源和承重断言复核 |

一次 Chat 深度研究实测产出了 Markdown 与图表 ZIP；**这不是 Work/Agent 插件取数成功的证据**。若同一任务要求两种结果，分别派发、保留各自原件和模式标签，不把报告当成插件接口回执。

## 插件取数通道是什么

Kimi 桌面客户端（Kimi.app，`com.moonshot.kimichat`）自带一个插件生态：天眼查、同花顺 iFinD、财新数据、标普全球市场财智、恒生聚源、SEC、IMF、世界银行、学术数据库、法律数据库等。这些插件跑在**用户自己的登录态**上——不需要额外 API key，不需要爬虫，权限来自用户账号已有的订阅。**能访问不等于免费调用**：部分接口仍按次扣账户积分。

用 computer-use 驱动这个客户端的 GUI，agent 就把这一整排数据源变成了自己的取数通道。具体工具和输入方式以当前宿主加载的 API 为准，见 `references/driving-kimi-app.md`。

这个通道有两个不显而易见、且都付出过真实代价的性质，决定了本 skill 一半讲驱动、一半讲核验：

1. **「已安装」≠「可调用」，且「不可调用」的证词依赖模式 × 模型。** 插件列表要打开客户端「插件 → 已安装」页才看得到；能不能调只能实跑探针。⚠️ 探针的**否定**结论只在 **Work/Agent 模式 + K3 极致思考**下取得才可信——Chat/快速模型（K2.6）下的「不可调用」证词实测被推翻过（详见能力边界页的万得条目）；肯定结果（真调到了、数据带来源标）不受此限。
2. **答案是渲染在屏幕上的。** 屏幕转录会静默抄错中文专名、会把截断当全量（实测：20 个股东名抄错 6 个、持股比例却逐位全对；「全 20 条」实为 50 条）。从这条通道落盘的数据，**不过权威源复核不许写进交付物**。

## 路由：什么时候用这条通道

有专用通道的先走专用通道——本 skill 是「没有专用通道时的宽面网关」，不是万能首选：

| 需求 | 走哪条 |
|---|---|
| 企业工商数据，且本机有专用 CLI（如 qcc） | 专用 CLI 为权威源；Kimi 天眼查插件当**对照通道** |
| 有 iFinD 自己的账号凭据 | 直连 API 类工具（本机若装有 iFinD API skill/客户端）——结构化、无 GUI 开销 |
| **A 股券商研报** | 先走**东方财富研报公开 JSON API**（`reportapi.eastmoney.com`，免费免代理、无 GUI 开销；参数与实测见 `references/plugin-capabilities.md`）；Kimi 侧恒生聚源当**第二通道取并集**——两条实测互不包含 |
| 驱动浏览器里的 kimi.com 网页版 | `kimi-webbridge` skill（Kimi Browser Extension 的 skill，不在本仓；本地 daemon，不走 GUI） |
| Kimi 客户端生成独立深度研究报告 | 本 skill 的 **Chat 深度研究**分支；不沿用插件探针的模式限制 |
| **用 kimi-cu 驱动任意 macOS 桌面应用**（Electron / webview / 原生；表单填写、弹窗、前台化、AX 树恢复） | **`references/kimi-cu-desktop-automation.md`**——可靠性分层与操作配方，与 Kimi.app 业务无关、可独立使用 |
| **无凭据 / 只有插件形态的数据源 / 一次要横跨多个源** | **本 skill** |

路由表管的是「默认该走哪条」；用户当面指定「就用 Kimi 查」时不挡路——Kimi 是取数通道、专用 CLI 是复核通道，两个角色不冲突。

**环境边界**：仅在 macOS 上实测过（Kimi.app 桌面客户端）。Windows 版 Kimi 客户端存在，但本流程未在 Windows 验证——在 Windows 上用时按「未验证」对待，先把驱动链路跑通再取数。

## Step 0：驱动器检查（30 秒，不可省）

不同宿主和版本的驱动机制见 `references/driving-kimi-app.md`：

- **Claude Code**：computer-use 的 MCP 工具是 **deferred tools**——先 `ToolSearch` 搜 "computer-use" 把它们加载出来，它们才出现在工具列表里。**没搜就断言「这个环境没有 computer use」是事实错误**；fallback 到 `osascript` / `screencapture` 不算 computer use，不要这么替代。⚠️ **可用性跟随当前 provider**（2026-08-18 实测钉死）：切到 Kimi(k3) provider 的会话段，harness 会**显式移除** computer-use 与 claude-in-chrome（`mcp_instructions_delta removedNames` 记录在案）；同一会话切回 Anthropic provider 段，工具重新注入、实测 57 次真实调用全部跑在 Anthropic 模型下。所以 ToolSearch 搜不到时先查当前 provider——k3 段结构性没有，要开车就换 Anthropic 段的会话或换 Codex。**搜索无果且 provider 无误 = 这个环境没配 computer-use：停下来报告用户、由用户决定配置**，别降级冒充、也别当作已经查过了。
- **Codex**：先检查当前可用的 computer-use 工具。旧 computer 插件用 `element_index`；当前 CUA 的输入选择与发送检查按 `references/driving-kimi-app.md`「文件输入与接收方确认」执行。只有可用接口都不存在或不可用时才报告环境阻塞。
- 确认 Kimi.app 已安装（`/Applications/Kimi.app`）。**登录态此刻确认不了**——看屏幕的能力要第 1 步授权之后才有；打开后首屏停在登录页 = 没登录，停下来交给用户扫码。

## 插件取数循环（仅 Work/Agent）

逐步操作细节（工具签名、坐标系、多显示器、产物路径）全部在 `references/driving-kimi-app.md`，这里是骨架：

1. **请求访问并打开** Kimi.app（Claude Code 先 `request_access` 拿授权）。⚠️ **授权是同机排他锁**：同一时刻只有一个 session 持有，并行 session 会被拒；工具集没有释放接口——被拒先用 `list_granted_applications` 自查持锁者，等对方结束或请它代跑，别误判成「工具坏了」。
2. **插件取数锁定 Work/Agent 模式 + K3 极致思考；不要用 Chat 的插件否定证词。** 2026-08-18 用户针对插件取数要求不用 Chat：①Chat 模式有调不到插件的记录（点名 iFind 仍退回普通聊天复述公司简介）；②**K2.6 快速模型没有完整金融插件面**——用户同日对照实测：K2.6 声称「不可调用」的三个已装插件，在 K3 极致下同查询两个可调且返回接口细节；K2.6 自报的可用数据源枚举本身就不全。该限制不适用于上表的 Chat 深度研究。发送前在模型选择器读回「K3 极致」；当前两步选择法见 `references/driving-kimi-app.md`。Work 新建任务可在「选择项目」中选「不使用文件夹」；这样仍可能在 Kimi 自有任务目录产出文件，只有希望直接写进指定位置时才选隔离目录。先确认实际选项；若选了目录，任务产生的文件要收走归位。发出查询后按 `references/driving-kimi-app.md`「发出后的确认检查点」核对实际调用；缺证据先查原任务，不直接重发。跑偏过的会话不要继续用。
3. **打开「插件 → 已安装」页读权威列表**（分类页是全量目录、含未安装项，两者别混）。选定本次查询要点名的插件。发送 Work 任务前，按 [查询与核验纪律](references/query-and-verification.md#计费与调用前置闸)查到相关接口的 `is_free`、积分或收费规则；查不到就保留 unknown。登录态、插件已安装和用户要求“用 Kimi”都不等于任意扣点授权。若 Work 会自主选择收费/费用未知的子工具，又无法在每次调用前停下，而当前任务没有明确的调用范围和额度授权，**不要发这个 Work 任务**；改用能控制精确调用的通道或将该路线标记暂缓。提示词里的“不要付费”不能代替这道闸。
4. **设计查询**（模式库在 `references/query-and-verification.md`）：点名插件 + 诚实条款（「查不到就明说，不要用训练知识补」）+ 逐字段标来源 + 实体锚定（公司全称/股票代码）+ 时间口径。某插件/数据类型**首次使用**时，在完成上一步计费核验后，才发一个声明覆盖面内的探针查询。⚠️ 判读探针结果时分清「能力」与「承载它的东西」：**会话里没出现该插件的 MCP 工具、或网关回 503，都不等于插件不可调用**（实测两者各踩过一次，重试/换 helper 脚本后都取到了数）。
5. **发出后轮询等待**——任务彻底跑完再取，半截结果不入库。
6. **提取产物**：按 `references/driving-kimi-app.md`「提取产物」选择下载／导出或该任务的实际文件目录并核对原件。每次调用的查询参数、成功或失败的原始返回和实际积分消耗分别留存；失败重试用新文件名，不覆盖第一次失败。看到预览截断时先读已落盘的完整 CSV，再决定是否补查，避免为已返回的数据重复调用。
7. **落盘前过权威源复核**（见下方陷阱 2/3/4/6）：错有三层机制——屏幕转录抄错专名、Kimi 源头搞错数值、以及**两条通道一致地落在同一个不是你要的口径上**——所以**承重的专名与承重的数值都要用独立通道复核，且复核要连口径一起核**；Kimi 跑的间隙正好并行拉官方源（公告原文、交易所文件）。
8. **落盘时标三样**：数据源、口径（时点/报告期）、获取日期。改过的值保留「原始 + 校正」两层，不静默覆盖。

## 用真实数据换来的坑

每个都出自实测会话；战例与证据分放两处——`references/plugin-capabilities.md`（陷阱 1）与 `references/query-and-verification.md`（陷阱 2/3/4/6）：

1. **「已安装」≠「可调用」** — 且「不可调用」的证词依赖模式 × 模型：Chat/K2.6 下的否定结论一律视为未验证。判断能力只能在正确模式+模型下实跑探针。
2. **屏幕转录抄错中文专名** — 实测 20 个股东名抄错 6 个（形近/音近字错），数字逐位全对。「照抄值」纪律管不到这类错——值确实照抄了，错的是屏幕识别本身——只有换一个权威源才抓得住。
3. **计数不是全量** — 屏幕上的「全 20 条」实为 50 条（截断）；而换到 API 通道也不解除这条：接口自己给的 `hits: 10` 同样只是**它索引到的数量**，实测漏掉了另一条通道能找到的 10 篇。写「前 N 条」，覆盖类任务双通道取并集。
4. **Kimi 会硬错** — 实测它把某港股 IPO 的回拨比例写成 50%，官方公告是 20%。取数期间并行从权威源拉同一批数，落盘前对账。
5. **没加载就断言没工具** — computer-use 是 deferred 的；先 ToolSearch，别 fallback 到 osascript。
6. **两个通道一致，只证明它们对同一口径一致** — Kimi 的两个插件对同一年营收都给 1688.38 亿（逐位相同、同比也对），第三条独立通道的两家券商各自给 1720.54 亿；增速几乎相同、绝对值差 32.16 亿 = **口径差不是错**（一个是二级科目「营业收入」，一个是市场通行口径）。财务数值落盘必须连科目层级与父级科目名一起记。

## References

- `references/driving-kimi-app.md` — Claude Code MCP、Codex 旧 computer 插件与当前 CUA 的驱动流；Work 插件取数与 Chat 深度研究的模式、安全和产物提取
- `references/kimi-cu-desktop-automation.md` — kimi-cu 通用桌面自动化操作法：可靠性分层（set_value > 键盘 > 点击）、前台化与 primary、AX 树恢复、表单/弹窗配方、投递验证
- `references/plugin-capabilities.md` — 插件清单快照、已实测的能力边界（带日期与证据级别）、券商研报的两条通道及其互不包含
- `references/query-and-verification.md` — 查询 prompt 模式库 + 数据核验纪律（含战例）