内容
# Kimi 代码桌面版
一款非官方、开源的 Windows 桌面客户端和代理程序,用于 [Kimi Code CLI](https://github.com/MoonshotAI/kimi-cli)。
使用您自己的 Kimi 账户,自己的计划和配额,打开本地项目,通过原生桌面界面运行 Kimi 编码会话。
> [!IMPORTANT]
> Kimi Code 桌面版是一个社区项目。它与 Moonshot AI 无关,也不受 Moonshot AI 的支持或认可。
## 下载
从 [GitHub Releases](https://github.com/Leonxlnx/kimi-code-desktop/releases/latest) 下载最新的签名更新程序。
当前版本:`0.8.3`
系统需求:
- Windows 10 或 Windows 11
- Microsoft WebView2
- 具有 Kimi Code 访问权限的 Kimi 账户
安装程序包括桌面调度服务使用的本地 Node.js 运行时。终端用户不需要 Node.js、pnpm 或 Rust。
## 入门指南
1. 安装并打开 Kimi Code 桌面版。
2. 完成初始化。应用程序检查 Kimi Code CLI,并在需要时运行 Kimi 的官方 Windows 安装程序。
3. 选择 **开始登录**,并使用您自己的 Kimi 账户批准设备代码。
4. 打开一个文件夹用于项目工作或创建独立聊天。
身份验证由官方 Kimi Code CLI 拥有。桌面应用程序不附带账户、不复制 OAuth 令牌,也不创建第二个凭证存储。
## 亮点
- 具有多个可恢复聊天的项目工作空间
- 独立聊天,与项目文件和 Git 状态保持分离
- 流式 Markdown 响应,带有折叠思考和工具活动
- 提示队列、引导、取消、复制和回退控制
- 实时 Kimi 模型、推理、权限、上下文和配额显示
- Kimi 命令、技能、子代理、插件和 MCP 配置
- 集成 Git 更改、差异、暂存、取消暂存和提交工作流
- 工作区终端、文件预览和代理控制的 localhost 应用程序预览
- 可配置的主题、字体排版、密度、布局、快捷键和面板大小
- 带有明确安装和重启控制的签名应用更新
有关完整的桌面工作流程,请参阅 [用户指南](docs/USER_GUIDE.md)。
## 快捷键
| 操作 | 快捷键 |
| --- | --- |
| 新聊天 | `Ctrl+N` |
| 切换侧边栏 | `Ctrl+B` |
| 打开终端 | `Ctrl+J` |
| 打开设置 | `Ctrl+,` |
| 发送提示 | `Enter` |
| 插入换行符 | `Shift+Enter` |
发送快捷键可以在常规设置中更改。
## 隐私和安全
- 本地调度服务仅绑定到 `127.0.0.1`。
- 打包连接需要每个启动的随机令牌。
- Kimi 凭证保留在官方 Kimi CLI 主目录中,渲染器从不读取这些凭证。
- 文件资源绑定到工作区,仅限文本,大小有限。
- 应用程序预览仅接受 `localhost` 和 `127.0.0.1` URL。
- 预览截图使用隔离的临时 Microsoft Edge 配置文件,从不使用用户的正常浏览器配置文件。
- 未实现应用程序遥测。
在报告漏洞之前,请阅读 [SECURITY.md](SECURITY.md)。
## 开发
贡献者要求:
- Node.js 22 或更高版本
- pnpm 10
- Rust 和 Cargo
- WebView2
- Kimi Code CLI 0.26.0 或兼容版本
安装并启动原生开发应用程序:
```powershell
pnpm install --frozen-lockfile
pnpm dev
```
在没有可用帐户的情况下使用确定性伪造 ACP 运行时:
```powershell
$env:KIMI_FAKE='1'
pnpm dev
```
验证更改:
```powershell
pnpm typecheck
pnpm test
pnpm build:services
git diff --check
```
为开发测试创建未签名的本地安装程序:
```powershell
pnpm bundle:local
```
已发布的安装程序必须由标记的 GitHub Actions 发布工作流生成。它使用存储库的保护签名机密生成安装程序、更新程序签名、更新清单和 SHA-256 校验和。
## 架构
此 pnpm monorepo 包含三个应用程序:
- `apps/desktop`:Tauri v2 shell 和原生 Windows 集成
- `apps/web`:React 投影层和桌面 UI
- `apps/server`:ACP 客户端、持久事件投影、身份验证代理、Git、终端、预览和更新支持
Kimi Code CLI 仍然是模型、权限、会话、命令、技能、子代理、MCP 工具、身份验证和订阅使用的真实来源。有关信任边界和数据流,请阅读 [架构](docs/ARCHITECTURE.md)。
## 文档
- [用户指南](docs/USER_GUIDE.md)
- [架构](docs/ARCHITECTURE.md)
- [设计系统](docs/DESIGN.md)
- [贡献](CONTRIBUTING.md)
- [安全策略](SECURITY.md)
- [发布流程](docs/RELEASING.md)
- [Kimi ACP 运行时说明](docs/acp-runtime-notes.md)
- [第三方通知](THIRD_PARTY_NOTICES.md)
## 许可证和商标
源代码在 [MIT License](LICENSE) 下获得许可。
Kimi、Moonshot AI 及其名称、徽标和商标归其各自所有者所有。它们不受 MIT 许可的约束。分支和重新分发的构建必须保持明确的非官方性质,不得暗示支持。