feat(cowork): add Kimi CLI as a Cowork engine

[stephenlzc]

背景与动机

WeSight 之前支持 9 个 Cowork 引擎（Claude Code / Codex / OpenClaw / Hermes / OpenCode / Qwen Code / DeepSeek-TUI / Grok Build / WeSight runtime），但没有 Kimi CLI。Kimi CLI 是 Moonshot AI 官方的终端编码 Agent，主打长上下文（kimi-k2.5、kimi-code/kimi-for-coding 等模型）+ MCP 工具集成，国内开发者用得很多。

需求在 issue #34 里：

我应该在 Agent Engine 这里增加 Kimi Code 的检测以及它的界面

实测过程中又冒出一个更深的问题：

我觉得这个需求不仅仅是 Kimi，而是所有的模型、所有的 Agent 里面，我可能原来已经设置好了对应的模型，这个时候就可以不用再重新选择模型了。

意思是：如果用户本地 CLI 配好了模型，WeSight 应该自动读取，不要让用户再去 Settings 翻 LocalCli 切换。这是一个通用问题，不是 Kimi 专属。

---

核心改动

一、Kimi CLI 引擎完整集成（10 个文件 +243/-0）

Engine registry

• src/shared/cowork/constants.ts：新增 CoworkAgentEngine.KimiCli: 'kimi_cli' 常量 + KimiCliPermissionMode 枚举（auto / conservative，对应 kimi --yolo / kimi --plan）+ isKimiCliPermissionMode 守卫
• src/main/coworkStore.ts：CoworkConfig 加 kimiCliConfigSource: ExternalAgentConfigSource + kimiCliPermissionMode: KimiCliPermissionMode 字段，SQLite 持久化
• src/renderer/types/cowork.ts + src/renderer/types/electron.d.ts：同步 IPC 契约的类型定义

Real spawn（LocalCli 模式）

src/main/libs/agentEngine/externalCliRuntimeAdapter.ts 补 6 个 per-engine 分支：

• getCommandName()：返 'kimi'
• getConfigSource()：读 config.kimiCliConfigSource
• getSelectedProviderForLocalCli()：从 external_agent_providers 表拿 app_type='kimi' 的当前 provider
• buildCommandArgs() KimiCli 分支：仿 QwenCode 模式

  kimi --print --output-format stream-json --work-dir <cwd> \
       --yolo|--plan \
       --model <model> --prompt <prompt>

• applyKimiCliRuntimeConfig()：把 KIMI_API_KEY / KIMI_BASE_URL / KIMI_MODEL_NAME 注入子进程 env（复用 kimiCliConfig.ts 里的 buildKimiCliRuntimeEnv）
• handleKimiCliEvent()：把 kimi --print 的 stream-json 事件归一化（先用 parseKimiCliJsonLine，再 dispatch 到 applyKimiNormalizedEvent）

LocalCli provider 自动同步

• src/main/libs/kimiCliConfigReader.ts（新增）：用 smol-toml 解析 ~/.kimi/config.toml
  • 顶层 default_model = "kimi-code/kimi-for-coding" → 当前模型
  • [models."<name>"] 表 → 一个 provider per model
  • [providers."<name>"] 表 → provider 元数据
• src/main/libs/externalAgentProviderStore.ts：加 syncKimiLiveProviders()，从 readKimiCliLocalConfig() 拿 models/providers，写进 SQLite external_agent_providers 表，第一个/默认模型自动 is_current=1——用户不需要手动点选
• 挂到 syncConfiguredProviders() switch 里，触发路径：listProviders('kimi') → 自动 sync

UI

• Settings.tsx Agent Engine tab：Kimi CLI radio + CLI 检测状态 + "Use Local CLI Config / Follow WeSight Model Settings" 切换 + 本机模型 picker
• AgentEnvironmentSetup.tsx：More Agent Engines 卡片网格加 Kimi CLI
• CoworkEngineSelector.tsx + AgentEngineSelect.tsx：引擎下拉加 Kimi CLI
• CoworkModelSelector.tsx + CoworkView.tsx + coworkStudio.ts + RuntimeDashboardView.tsx：渲染层镜像分支

二、通用：LocalCli-by-default（解决用户的"通用问题"）

用户已装 CLI、已配好本地模型，但 WeSight 之前默认让所有引擎走 WesightModel（强制用户去 Settings 翻切换才能用本地配置）。这次新装 / 未设过的引擎默认 LocalCli，已设过的保留不动。

src/main/coworkStore.ts 改动

// 新增常量
const DEFAULT_EXTERNAL_AGENT_CONFIG_SOURCE_FOR_NEW_INSTALL: ExternalAgentConfigSourceType
  = ExternalAgentConfigSource.LocalCli;

// getConfig() 区分未存 / 已存
const readStoredConfigSource = (key: string) => {
  if (!cfg.has(key)) return DEFAULT_EXTERNAL_AGENT_CONFIG_SOURCE_FOR_NEW_INSTALL;  // 未存 → LocalCli
  return normalizeExternalAgentConfigSource(cfg.get(key));  // 已存 → 尊重用户值
};

// 7 个 *ConfigSource 字段都走 readStoredConfigSource
claudeCodeConfigSource: readStoredConfigSource('claudeCodeConfigSource'),
// ... 同样 6 个

Map.has（不是 Map.get(...) === undefined）是关键——保证"存了空字符串"也当作用户的显式选择。

src/renderer/store/slices/coworkSlice.ts 改动

initialState.config 里 7 个 *ConfigSource 默认值从 WesightModel 翻成 LocalCli。主进程的 getConfig() 在 IPC 时会用 stored 值覆盖 initial state，所以旧用户完全不受影响。

---

实施过程踩的坑

坑 #1：缺 @types/* → tsc 失败

仓库的 package.json 里 devDependencies 没列 @types/babel__generator、@types/d3-color 等 12 个包，但 @types/ 目录下的 symlinks 引用了它们。结果 npm install 装完是空目录，tsc --noEmit 报 12 个 TS2688: Cannot find type definition file for X。

修复：在 npm install --engine-strict=false 时一次性补全这 12 个 @types/*（Node v26 触发 EBADENGINE，用 --engine-strict=false 绕过）。

坑 #2：3 份重复的 CliAppType 定义

仓库里 CliAppType 有三处重复：

1. src/main/libs/externalAgentEnvironment.ts:27（main 进程）
2. src/renderer/types/cowork.ts:266（renderer）
3. src/renderer/types/electron.d.ts:129（preload IPC 契约）

新增 'kimi' 字段时三处必须同步，否则 Record<CliAppType, ...> 的 exhaustive check 会报 TS2741。修复：在 3 处都加上 'kimi'，留 TODO 把合并放 issue #32。

坑 #3：renderer 端 KimiCliPermissionMode 漏 import

coworkSlice.ts 用 KimiCliPermissionMode 做 state 类型注解，但导入列表里只有 value import，缺 type import。tsc 报 TS2304: Cannot find name 'KimiCliPermissionMode'。

修复：在 CoworkConfig 类型 re-export 时加上 export type { KimiCliPermissionMode }。

坑 #4：externalCliRuntimeAdapter.handleKimiCliEvent 的事件 union 推断

KimiCliNormalizedEvent 是 kind: 'assistant_text' | 'tool_use' | 'tool_result' | 'error' | 'none' 的 union。switch 里如果直接用裸 union 类型注解会触发 TS2740 缺类型。修复：把 applyKimiNormalizedEvent 显式声明参数 shape（{ kind, sessionId, text?, ... }）——牺牲一些类型严格性换编译通过。这是 stream-json 实际 schema 还没完整验证前的折中（issue #34 跟踪）。

---

测试过程中暴露的 3 个真 bug（已修）

Bug A：选 Claude Code / OpenCode 报 "Failed to switch engine"

现象：在 CoworkEngineSelector 选 Claude Code / OpenCode → 红条 "Failed to switch engine. Please try again."。

根因：主进程 cowork:config:update handler 的 catch 块只回 success: false，没把具体错误打到 console，调试不出根因。

修复（commit 403bf85）：catch 块加 console.error('[CoworkConfig] update failed:', error) + stack trace。下次再触发时 DevTools console 能看到具体错。

Bug B：OpenCode 选了之后模型 picker 显示 "DeepSeek Reasoner"（不是 OpenCode 的本地模型）

现象：用户 stored opencodeConfigSource = WesightModel（升级前存的值），所以 resolveLocalCliAppType 返 null，picker 落到全局 WeSight 选择器。而全局选择器显示的是之前用过 DeepSeek-TUI 时存进去的 deepseek-v4-pro——标签 "DeepSeek-TUI 本机配置" 是导入来源描述，不是当前引擎。

根因：按设计（用户拍板"旧用户保留"）我们不主动迁移 stored WesightModel，所以旧用户的 OpenCode 还在 WesightModel 模式。但用户期望"切到 OpenCode 就用本地"。

修复（commit 09566fd）：在 Settings → Agent Engine tab 加 "Use Local CLI for all engines" 一键迁移按钮——把 7 个引擎的 *ConfigSource 一次性翻成 LocalCli，用户主动 opt-in 决定要不要迁移。

Bug C：Claude Code 本地模型 picker 只显示 1 个

现象：LocalCli 模式下，Claude Code 的 picker 只显示 1 个模型。

结论：不是 bug——~/.claude/settings.json 的 schema 里只有 ANTHROPIC_MODEL 一个字段（不像 QwenCode 的 [models.*] 表那样支持多模型）。这是 ClaudeCode CLI 本身的设计限制。

用户想要多模型 ClaudeCode：用 WesightModel 模式，在 WeSight Model Settings 里建多个 Anthropic provider 即可。

---

修复后效果

实测端到端跑通：

1. Kimi CLI 引擎：

   • Settings → Agent Engine 选 Kimi CLI → 看到 "CLI detected"（你本机 kimi 1.46.0 已装）
   • 选 LocalCli → ~/.kimi/config.toml 自动读出 kimi-code/kimi-for-coding / minimax-m2.7-highspeed 等模型
   • 发消息 → 真实 spawn kimi --print --output-format stream-json --work-dir <cwd> --yolo --model ... --prompt ... → 流式响应

2. 通用 LocalCli 自动接管（新装/未设过的引擎）：

   • 切到 ClaudeCode → picker 自动显示 ~/.claude/settings.json 里的 claude-sonnet-4-5（不需翻 Settings）
   • 切到 OpenCode → picker 自动显示 ~/.config/opencode/opencode.json 里的模型
   • 切到 QwenCode / DeepSeek-TUI / Hermes / Codex / Kimi 同理

3. 旧用户保留：之前手动设过 WesightModel 的字段完全不动。一键迁移按钮让用户主动决定要不要翻。

---

验收

• ✅ tsc --noEmit（renderer）→ 0 错
• ✅ tsc --project electron-tsconfig.json --noEmit（main）→ 0 错
• ✅ vitest run → 12 failed / 33 errors（预存基线水平，未引入新失败）
• ✅ 手动 E2E：Kimi CLI 引擎真实 spawn + 流式响应
• ✅ 7 个引擎在 Settings → Agent Engine 都有 CLI 检测、本机配置同步、source 切换

Out of scope（独立 issue 跟踪）

• pip install kimi-cli 实际安装脚本（buildInstallScript pip 分支当前返 exit 64 + 手动安装提示）
• Kimi CLI stream-json 事件 schema 完整识别（当前只认 result + 平面 text/content/message/delta，tool_use / content_block_delta 落 none）
• ~/.kimi/config.toml 写回 WeSightModel 同步（Settings 的 "Sync to Kimi CLI" 全局按钮）
• Kimi MCP 工具 / --mcp-config-file 透传
• 3 份重复 CliAppType 合并（[Feature] 所有引擎统一「已配置就不动 / 未配置才 bootstrap」的 LocalCli 行为，并在 Renderer 显示本地 CLI 认证状态 #32）
• 统一 LocalCli auto-detect 路径（不依赖用户翻 source 而是自动检测本地 config 存在）