开始使用

Mirri Code 是什么

Mirri Code 是一个 AI Agent，帮助你完成软件开发任务——阅读和修改代码、执行 Shell 命令、搜索文件、抓取网页，并在执行过程中根据反馈自主规划和调整下一步行动。它以桌面应用为主推形态，同时在终端里提供 mirri 命令行。

它适用于以下场景：

• 编写和修改代码：实现新功能、修复 bug、完成重构
• 理解项目：探索陌生的代码库，解答架构和实现层面的问题
• 自动化任务：批量处理文件、运行构建与测试、串联多个脚本

命令行以 Rust 编写，官方安装脚本分发的是自包含的原生可执行文件，无需预装任何运行时；npm 渠道已停止更新（见下文迁移说明）。

安装

Mirri Code 以桌面应用为主推分发渠道，同时提供官方安装脚本安装 CLI。npm 渠道已停止更新，仅存量用户可用。

桌面应用（推荐）

从 GitHub Releases 页面下载对应平台的安装包（macOS .dmg 或 .zip、Windows .exe、Linux .AppImage / .deb）并安装，macOS 安装包已签名并公证。

脚本安装

在终端中安装 CLI，无需预装 Node.js：

• macOS / Linux：

curl -fsSL https://mirricode.com/install.sh | bash

• Windows（PowerShell）：

irm https://mirricode.com/install.ps1 | iex

Windows 用户如果需要使用 Bash 工具（Unix 语法），首次启动前请先安装 Git for Windows；PowerShell 工具开箱即用。如果 Git Bash 安装在非标准路径，请把 MIRRICODE_SHELL_PATH 设为 bash.exe 的绝对路径。

脚本会自动下载最新版本、校验 checksum，并把 mirri 可执行文件放到你的 PATH 中。

注意

脚本按 v 前缀定位 GitHub Release。在首个 vX.Y.Z Release 发布之前，最新版本解析会 404——这是预期行为，请先使用桌面安装包；指定旧版本号（如 1.10.0）同样会 404，因为旧 Release 使用 scoped tag 且大概率没有 manifest.json。

npm 存量用户迁移

npm 包（@mirri-ai/mirri-code、@mirri-ai/mirri-node）在最后一次发布后已停止更新：

• 历史版本可以继续使用，npm 上的安装与运行不受影响；但不会再发布新版本，也不会再收到更新提示。
• 建议迁移到桌面应用：从 GitHub Releases 下载桌面安装包，或改用脚本安装安装 CLI。迁移后如需保留历史配置，数据默认存放在 ~/.mirri-code/（见数据存放在哪里），可直接沿用。
• npm 卸载方式：npm uninstall -g @mirri-ai/mirri-code。

升级与卸载

安装完成后，验证可执行文件是否就绪：

mirri --version

升级：重新运行安装脚本即可覆盖安装到最新版本（CLI 没有 mirri upgrade 子命令）。桌面应用用户从 GitHub Releases 下载新版本安装包覆盖安装。

卸载：脚本安装的用户删除 mirri 可执行文件（默认在 ~/.mirri-code/bin/mirri）即可；npm 存量用户执行：

npm uninstall -g @mirri-ai/mirri-code

第一次启动

打开桌面应用即可开始。如果更习惯浏览器，也可以在项目目录下启动本地的 Web UI：

cd your-project
mirri web

mirri web 在前台运行引擎并在默认浏览器中打开 Web UI，按 Ctrl-C 即停止。只想跑一条指令、不打开界面时，用 mirri print：

mirri print "帮我看一下这个项目的目录结构"

首次启动时需要配置模型供应商。在设置中添加供应商及其 API 密钥（例如 Mirri AI Open Platform），或添加自定义 registry，然后选择默认模型。~/.mirri-code/config.toml 里的供应商配置同样生效。

使用其他 AI 供应商

如果你想接入 Anthropic、OpenAI、Google 等其他供应商，需要直接编辑 ~/.mirri-code/config.toml 配置 API 密钥，详见平台与模型。配置项完整说明见配置文件、环境变量和配置覆盖。

第一个对话

配置好模型后，用自然语言描述任务即可。先让它熟悉当前项目：

帮我看一下这个项目的目录结构，简单介绍一下每个目录是做什么的

Mirri Code 会自动调用文件读取、搜索等工具浏览相关内容后给出回答。只读操作默认自动执行无需确认；对于会修改文件或执行 Shell 命令的操作，默认会在执行前征求确认。

也可以直接描述更具体的任务：

在 src/utils 里新增一个函数，用来把任意字符串转成 kebab-case，并补一个单元测试

Mirri Code 会规划步骤、修改代码、运行测试，并在每一步告诉你它做了什么。

斜杠命令

在输入框里输入 / 会列出当前可用的斜杠命令，菜单随输入实时过滤。常用的几条：

命令	说明
/new	创建新会话
/compact	压缩会话历史，释放 token
/fork	把当前会话 fork 出一个新会话
/plan	切换计划模式
/auto	自动批准安全的读写
/yolo	自动批准一切（yolo 模式）
/status	查看会话状态

数据存放在哪里

Mirri Code 的本地数据默认保存在 ~/.mirri-code/ 下，包含配置文件、会话记录、日志和更新缓存。如需迁移到别处，通过 MIRRICODE_HOME 环境变量指定新路径。完整说明见数据路径和环境变量。

下一步

• 交互与输入 — 输入框操作、审批流程、Plan 模式和 YOLO 模式详解
• 会话与上下文 — 恢复会话、上下文压缩、导出会话
• 常见使用案例 — 典型任务的 prompt 示例