chore(cowork): Kimi CLI follow-ups (pip install / stream-json / CliAppType / button placement)

[stephenlzc]

背景

这是 PR #35（Kimi CLI 引擎） 推上之后的 follow-up 集。在 PR #35 落地的过程中，maintainer 可能希望拆成更小的 review 单元，所以本 PR 单独立项。

包含 4 个 commit，全部在 Kimi CLI 引擎框架内做补强：

commit	类别
10c2f3b	feat(kimi): 真实 pip install kimi-cli runner
c4f9795	feat(kimi): Kimi stream-json 完整事件 schema
0e8dd07	refactor(cowork): CliAppType 合并去重
4d2d5e7	fix(cowork): "Use Local CLI for all engines" 按钮挪位置

改动细节

1. 10c2f3b 真实 pip install kimi-cli

之前 buildInstallScript 的 pip 分支是 stub，返 exit 64 + "not implemented" 提示。Settings → More Agent Engines 卡片里的 "Install This Agent" 按钮点了会报错。

现在实现真正的安装流程：

• 优先用 uv tool install kimi-cli（如果 PATH 上有 uv）
• fallback 到 python3 -m pip install --user kimi-cli（用 ensurepip bootstrap，macOS 13+ 自带）
• 验证 ~/.local/bin/kimi 落位 + 输出 __WESIGHT_BINARY_PATH__ 让 runner 解析回结构化结果
• python3 缺失时返 exit 65 + 清晰提示

INSTALL_TARGETS.kimi 条目不再有 TODO 注释，packageName 填 kimi-cli。

2. c4f9795 Kimi stream-json 完整事件 schema

Kimi CLI --output-format stream-json --include-partial-messages 事件 schema 是 Claude Code 的超集。之前的归一化器只认平面 text/content/message/delta，tool_use / tool_result / content_block_delta 全部落 none，导致 Kimi CLI 调用工具时 WeSight 不会渲染。

新的 normalizeKimiCliCliEvent 处理：

• assistant 消息：扫 content: [...] blocks — tool_use → tool_use，text blocks 拼接 → assistant_text
• user 消息：content: [...] blocks — tool_result → tool_result（content 兼容 string / array 两种 shape）
• stream_event 信封：内层 content_block_delta + text_delta → 流式 assistant_text
• result success → assistant_text replace=true
• 不可识别的事件 → none（不破坏现有行为）

handleKimiCliEvent 在 adapter 里只负责路由，不再做事件 shape 解析。

3. 0e8dd07 CliAppType 合并去重

仓库里 CliAppType 有 3 份重复定义：

文件	行号
src/main/libs/externalAgentEnvironment.ts	27
src/renderer/types/cowork.ts	271
src/renderer/types/electron.d.ts	132

新增 'kimi' 时三处必须同步，否则 Record<CliAppType, ...> exhaustive check 报 TS2741——Kimi PR 当时是手工改的，容易漏。

合并到 src/shared/cowork/constants.ts 单点定义：

export const CliAppType = {
  Claude: 'claude', Codex: 'codex', Hermes: 'hermes', OpenClaw: 'openclaw',
  OpenCode: 'opencode', Grok: 'grok', Qwen: 'qwen', DeepSeekTui: 'deepseek_tui',
  Kimi: 'kimi',
} as const;

三处 re-export 共享定义。新增 app type 现在只动 1 个文件。

4. 4d2d5e7 修 "Use Local CLI for all engines" 按钮放置

之前按钮埋在 renderAgentConfigSourceSettings() 里，函数有 if (!selectedExternalAgentAppType || !selectedAgentConfigSource) return null;——用户必须先点中一个引擎才能看到这个按钮。这违反"一键全局迁移"的设计意图。

挪到 Agent Engine tab 内容最底部（跟引擎列表同级），无论选不选引擎都渲染。功能本身没变。

验证

• ✅ tsc --noEmit（renderer）→ 0 错
• ✅ tsc --project electron-tsconfig.json --noEmit（main）→ 0 错
• ✅ vitest run → 12 failed / 33 errors（预存基线，未引入新失败）
• ✅ 手动 E2E：Kimi Install 按钮（pip 路径需 python3 ≥ 3.10） + 按钮位置可见

Out of scope

• Kimi MCP --mcp-config-file 透传：需要 coworkRunner 把 MCP server list 透传给 adapter 写 temp JSON，跨层耦合大，放独立 issue。
• pip install kimi-cli 的 Windows / Linux 路径：当前只测了 macOS 实现思路（~/.local/bin/kimi 落位）。
• Bug A 根因（PR feat(cowork): add Kimi CLI as a Cowork engine #35 提的 "Failed to switch engine"）：只加了 console.error 诊断，没复现到根因。

关联

• 依赖 PR #35 Kimi CLI 引擎 已 merged 后才能合
• 修复了 issue #34 跟进过程中暴露的 follow-up