Kimi Code Desktop

源码自有的 Kimi Code Windows 与 macOS 桌面工作台。
A source-owned Kimi Code workspace for Windows & macOS.

文档入口见 文档导航，开发与提交约定见 结构与开发规范。Source Runtime 的完成态见 Runtime Cutover M4，长期维护见 Source Backend 维护策略。

Kimi Code Desktop 将 Kimi Code 的智能体能力带进一个专注、可视、可管理的桌面界面。Kimi Code 源码以 git subtree 形式收在 runtime/kimi-code，构建为随应用交付的唯一 Runtime：不依赖用户安装的 CLI，也不使用 ACP 或生产双 backend。

当前内置 Kimi Code 版本：@moonshot-ai/kimi-code@0.33.0（commit 53c832dfdf9566afd59a8b3d54ebd36d3cb03d72），冻结与验证契约见 runtime/UPSTREAM.md。

Kimi Code 的功能文档（配置、Slash Commands、MCP、快捷键、CLI 参考等）以仓内上游文档为准：runtime/kimi-code/docs/zh/（中文）/ runtime/kimi-code/docs/en/。本仓库外壳文档只覆盖桌面特有内容，不再复制上游文档。

你可以用它做什么

• 完整的桌面对话体验：流式 Markdown、代码高亮、工具调用卡片、文件差异、审批与追问均有专门界面。
• 真实还原会话进度：统一处理实时事件与本地历史回放，保留附件、工具结果、任务状态和子智能体步骤。
• 掌握整个工作区：在 Changes、Files、Agents 和 Tasks 面板之间切换，不离开对话即可查看改动和执行进度。
• 控制智能体行为：支持权限模式、Plan、Swarm、模型状态、文件上传、Slash Commands，以及忙碌时的消息队列。
• 管理大量会话：搜索、重命名、归档、恢复、批量处理，并可按 30 / 60 / 90 天一键归档长期未活跃会话；桌面端会为已访问会话保留独立 stream，切回运行中会话时自动回连补齐事件。
• 查看用量与上下文：展示当前上下文窗口、Token 明细、平台额度，以及今日 / 7 天 / 30 天本地用量趋势；/usage 与 /status 会在 Composer 上方即时呈现结果。
• 任务状态一目了然：状态条实时显示 [N task running]（与 CLI 一致）；后台任务与 Cron 调度在 Tasks 面板只读展示；子代理步骤支持任意层级嵌套，子代理派生的子代理也有独立可折叠视图。
• 融入 Windows：提供系统托盘、任务完成与审批通知、全局快捷键，并确保重复启动时聚焦已有窗口。
• 原生 macOS 体验：Apple Silicon 原生构建、Finder 中显示、super+shift+k 快捷键、原生菜单（含界面语言切换）。
• 中英界面即时切换：界面语言支持跟随系统 / English / 简体中文，无需重启。
• 直接管理运行时配置：在设置中切换深浅主题、编辑全局配置与原始 config.toml、管理 MCP Server，并可启用与配置实验性的 Secondary model。

设计与架构

界面采用 Monochrome V2 设计语言，以紧凑的信息密度、清晰的层级和低干扰动效服务长时间编码。深浅主题切换使用 View Transition 动画，并自动尊重系统的“减少动态效果”偏好。

架构为 Source-Runtime-only，不捆绑或静默回退到 ACP、外部 CLI 或旧 Python sidecar：

React 19 + Vite
  └─ stable Tauri 2 IPC / events
      ├─ RuntimeHost（runtime/host.rs）
      │   └─ source-built desktop-runtime child
      │       └─ createKimiHarnessV2 / vendored Kimi source
      ├─ desktop metadata / replay adapter
      └─ session files / Git

Runtime 作为 Tauri 监管的独立 OS 子进程运行，通过 runtime-v1 stdio JSONL 通信。React 不直接依赖 Kimi 内部类型；Rust 保留进程监管、桌面数据、文件和 Git 安全边界。

本地开发

外层 Desktop 需要 Node.js 24.15.0 以上、npm 和 Rust stable toolchain。运行不需要安装 Kimi Code CLI；npm install 会安装项目固定的 pnpm（版本见 package.json），用于 nested Source Runtime workspace，不依赖全局 pnpm 或 Corepack。

git clone https://github.com/P-A-N-52/kimi-code-desktop.git
cd kimi-code-desktop
npm install
npm run desktop

常用命令：

npm run desktop:dev       # Tauri 开发模式与热重载
npm test                  # 前端测试
npm run build             # TypeScript + 前端生产构建
npm run rust:test         # Rust 测试
npm run rust:check        # Rust 编译检查
npm run check:quick       # 日常快速门禁
npm run runtime:install   # 安装固定 Kimi source workspace 依赖
npm run runtime:build     # 构建 desktop-runtime
npm run smoke:runtime     # 构建并验证 runtime-v1 协议

构建与发布

npm run desktop:release   # 本地可运行的 release exe
npm run release:msi       # MSI 与发布元数据
npm run release:macos     # Apple Silicon DMG（仅在 macOS）
npm run release:preflight # 完整发布前检查

macOS Apple Silicon

macOS 桌面包当前仅支持 Apple Silicon（aarch64-apple-darwin）和 macOS 12 及以上版本。发布工作流会生成 DMG，并按以下顺序选择信任级别：

1. Apple Developer ID 签名并公证；
2. 缺少凭据或签名/公证失败时使用 ad-hoc 签名；
3. ad-hoc 构建失败时生成未签名包。

工作流产物中的 release-manifest-macos-arm64.json 会记录实际使用的 signingMode、notarizationStatus 和降级原因。ad-hoc 或未签名包可能需要用户在 macOS“隐私与安全性”中手动允许。

完整签名和公证使用以下 GitHub Actions secrets：

• APPLE_CERTIFICATE
• APPLE_CERTIFICATE_PASSWORD
• APPLE_SIGNING_IDENTITY
• APPLE_API_ISSUER、APPLE_API_KEY、APPLE_API_KEY_CONTENT

也可以用 APPLE_ID、APPLE_PASSWORD、APPLE_TEAM_ID 替代 API Key 公证凭据。KEYCHAIN_PASSWORD 可选。

产物位置：

src-tauri\target\release\kimi-code-desktop.exe
src-tauri\target\release\bundle\msi\Kimi.Code_<version>_x64_en-US.msi

macOS 产物位置：

src-tauri/target/aarch64-apple-darwin/release/bundle/dmg/Kimi.Code_<version>_aarch64.dmg
src-tauri/target/aarch64-apple-darwin/release/bundle/macos/Kimi Code.app

不要使用裸 cargo build --release 代替桌面构建；它会绕过 Tauri 的前端构建流程。

当前边界

• 目前支持 Windows 与 macOS（Apple Silicon）；macOS 构建默认不签名、不公证，正式分发需要配置 Apple 开发者凭据。
• Runtime 随应用交付（source-built Kimi Code），不再需要安装或探测外部 CLI；模型与 provider 配置仍读取 ~/.kimi-code/config.toml。
• 当前提供手动深色 / 浅色切换；跟随系统主题尚未接入。
• 引擎仅支持整会话 fork，fork_session 保持显式错误，桌面端不伪造 fork-at-turn 能力。
• 自动化门禁与 smoke:runtime 已通过；macOS SEA sidecar、release manifest 和 Apple Silicon DMG 链路已交付，Windows SEA sidecar 已随 v1.2.0 打包进 MSI。正式 Developer ID 签名/公证，以及 auth 真机、Swarm 卡片、桌面完成通知等剩余真实 Tauri/WebView 场景仍需按桌面验收清单完成并单独报告。

License

本项目基于 Apache License 2.0 开源。