MiMo Desk

MiMo Desk 是一个面向 Windows 的 MiMo Code 桌面会话管理器。它为 MiMo Code 增加按项目分组的会话侧栏、多会话标签和更直观的桌面操作，同时继续使用 MiMo 原生 Web 界面处理对话、工具调用和权限交互。

English: MiMo Desk is an unofficial Windows desktop session manager for MiMo Code, with project-grouped navigation, session tabs, and native MiMo Web integration.

本项目是社区开发的非官方桌面外壳，与小米、MiMo 团队及 OpenCode 项目没有隶属或官方合作关系。MiMo、OpenCode 及相关名称归各自权利人所有。

功能

• 按工作目录自动分组 MiMo 会话。
• 使用文件夹卡片和树状列表区分项目与会话。
• 搜索、刷新、创建、重命名和删除会话。
• 新建会话时可直接选择最近项目，或通过 Windows 原生文件夹选择器选择目录。
• 新建会话无需手动填写标题，首条消息后自动同步或生成会话名。
• 同时打开多个会话，并在标签间快速切换。
• 可拖动调整项目侧栏和 MiMo Web 审查面板宽度。
• 为 MiMo Web 提供统一的 MiMo 会话加载画面。
• 支持中文 Windows 用户名、中文项目路径和中文会话标题。
• 自动启动并管理独立的本地 MiMo 服务。

安装

1. 在 Releases 下载最新的 MiMo-Desk_*_x64-setup.exe。
2. 运行安装程序。
3. 从开始菜单打开 MiMo Desk。

当前安装包尚未进行商业代码签名，Windows SmartScreen 可能显示未知发布者提示。请仅从本仓库 Release 下载，并使用同一 Release 中的 SHA256SUMS.txt 校验文件完整性。

MiMo Desk 不包含 MiMo Code。使用前请先安装 MiMo Code，并确认以下命令可用：

mimo --version
pwsh --version

系统要求

• Windows 10 或 Windows 11（x64）。
• 已安装 MiMo Code。
• PowerShell 7。
• Microsoft Edge WebView2 Runtime。

MiMo Desk 优先使用：

%USERPROFILE%\.local\bin\mimo.ps1

如果该文件不存在，则从 PATH 查找 mimo.ps1 或 mimo.cmd。

使用说明

会话管理

• 单击左侧会话即可打开。
• 单击项目卡片可以展开或折叠该项目。
• 使用顶部搜索框按项目目录或会话标题筛选。
• 创建会话时选择已有项目或其他文件夹即可，无需预先填写标题。
• 新会话会先显示为“新会话”；发送首条消息后优先同步 MiMo 原生标题，必要时使用首条消息生成简短标题。
• 删除会话前会显示确认窗口。

删除操作会调用 MiMo 的会话删除 API，无法撤销，但不会删除项目目录或项目文件。

多会话

打开过的会话会保留在顶部标签栏中。切换标签时，MiMo Web 页面不会被销毁，因此多个 会话可以保留各自的运行状态。

安全边界

• MiMo 服务仅监听随机的 127.0.0.1 端口。
• MiMo Desk 不直接读取或修改 mimocode.db。
• MiMo Desk 不读取模型 API Key 或供应商凭据。
• MiMo Desk 不删除项目文件。
• 关闭应用时，只终止由本次 MiMo Desk 实例启动的 MiMo 进程树。
• 用户自行启动的其他 MiMo 服务不会被发现或终止。

本地开发

依赖

• Node.js 20 或更高版本。
• Rust stable MSVC 工具链。
• Microsoft C++ Build Tools。
• 已安装并可运行的 MiMo Code。

启动开发环境

git clone https://github.com/0x12138/mimo-desk.git
cd mimo-desk
npm install
npm run tauri dev

测试

npm run typecheck
npm test -- --run
cargo fmt --manifest-path src-tauri/Cargo.toml -- --check
cargo test --manifest-path src-tauri/Cargo.toml

构建 Windows 安装包

npm run tauri build

NSIS 安装包生成在：

src-tauri\target\release\bundle\nsis

技术架构

• Tauri 2 / Rust：窗口、MiMo 子进程生命周期和本地 API 适配。
• React 19 / TypeScript：项目分组、会话导航和多标签状态。
• MiMo Web：对话、工具调用、权限和审查界面。
• Vitest / Testing Library：前端行为测试。

MiMo HTTP API 是会话数据的唯一来源。MiMo Desk 只暴露健康检查、会话列表、创建、 重命名和删除所需的窄接口。

当前版本针对 MiMo Code 0.1.0 完成验证。MiMo 更新后如果接口或页面结构变化，请提交 Issue 并附上 MiMo 版本和复现步骤。

贡献

参见 CONTRIBUTING.md。

许可证

MIT License