miao 编码代理
先看懂,再修改。
读仓库、改代码、运行检查,结果交由你确认。上下文精简,费用逐轮记录。
预算按金额、token、轮次与时长设定。
macOS / Linux
curl -fsSL https://mtty.dev/miao/install | bashWindows (PowerShell)
irm https://mtty.dev/miao/install.ps1 | iex单个二进制 · macOS、Linux 与 Windows · MIT

01 中途改要求
任务进行中,可补充要求。
新输入先持久化,至安全边界并入会话;正在执行的调用不中断。
显式排队的输入待会话空闲处理;新输入被采纳后,轮次额度重新计算。
- ›
定位此测试失败的原因,完成修复,运行相关检查,并解释代码差异。
- ›
保持公共 API 不变,不引入新的运行时依赖。
steer · 已保存,在下一个轮次边界并入 - ›
随后准备一份草稿 PR 描述。
queue · 等会话即将空闲时再处理
02 为什么是 miao
机制
- 01
上下文
基线固定,变化按序追加,提示缓存跨轮命中。缓存策略与 TTL 可按供应商配置。
- 02
压缩
接近阈值时开始,摘要复用当前前缀。旧输出默认裁剪;超大结果留存磁盘,仍可召回。
- 03
费用
逐轮记录 token、缓存命中率、首 token 延迟与估算费用。预算用至五分之四时提醒,到限即停。
- 04
安装
单个二进制,无引擎或 TUI。一行覆盖 macOS、Linux、Windows。
费用为估算值,以供应商账单为准。历史保存不等于崩溃续跑;未完成的轮次需显式恢复。
03 日常工程
日常工作。
| 工程需求 | miao 的能力 |
|---|---|
| 理解陌生仓库 | 文件读取、搜索、项目指令、技能、专项子代理 |
| 实现功能并验证 | 文件编辑与补丁、Shell 命令、可选 LSP 诊断和格式化 |
| 比较模型而不换工具 | 会话内模型切换、自定义供应商、按代理配置模型、受支持模型的推理档位 |
| 推进较大的任务 | 待办、中途补充要求、持久化会话、可选自治续跑 |
| 接入自己的工具 | 本地与远程 MCP、自定义命令、技能、插件 |
| 检查并复用工作成果 | 差异查看、会话分叉、历史导出、权限确认 |
| 接入其他应用 | HTTP 服务、浏览器界面、CLI 自动化、工作区内生成的客户端 |
04 界面
终端内运行。


05 续跑
长任务。
自治续跑需手动开启,受迭代上限与停滞检测约束。费用达到阈值后,不再调度新的模型轮次。
预算不是供应商账单的硬上限,也不会中止已经发出的那一轮。项目级配置放在 .miao/miao.jsonc,全局配置放在 ~/.config/miao/miao.jsonc。
// .miao/miao.jsonc
{
"loop": { "enabled": true, "max_iterations": 25 },
"cost": { "budget_usd": 5 },
"compaction": { "prune": true },
}06 隔离
命令沙箱。
Rust 层仅处理两件事:bash 的内核级隔离,以及 edit 与 apply_patch 的匹配与补丁。
macOS seatbelt 与 Linux Landlock 限制写入范围:当前 Location、命令目录与已批准路径。
写入被拦时报告所需路径并停止;批准目录后,命令带权限重跑。
原生匹配与补丁经 addon 运行;MIAO_NATIVE=0 关闭,由 TypeScript 接管。
沙箱默认关闭,需手动开启;Windows 尚无后端。无后端时默认放行,除非 on_unavailable 设为 "fail"。
07 现状
1.0 之前:能力与限制。
| 能力 | 可用性 |
|---|---|
| 会话保存、中途输入与项目内会话消息 | 已实现 |
| 自治续跑与费用预算 | 可选开启 |
| 旧工具输出裁剪与自动压缩 | 默认开启 · 可配置 |
| Code Mode | 实验性 |
| bash 的内核级沙箱;edit 与 apply_patch 的原生加速 | 沙箱需开启 · 加速默认启用 |
| 生成的客户端与嵌入式宿主 | API 仍在演进 |
08 快速开始
三条命令,开始第一个会话。
$ curl -fsSL https://mtty.dev/miao/install | bash # macOS / Linux
PS> irm https://mtty.dev/miao/install.ps1 | iex # Windows
$ miao providers login # 选择供应商,连接账户或 API Key
$ cd /path/to/project
$ miao # 启动终端界面
# 一次性执行,不进 TUI
$ miao run "Explain this repository's architecture"
$ miao web # 打开浏览器界面
$ miao upgrade # 更新正式版在 TUI 内用 ctrl+p 打开命令面板,用 ctrl+x m 选择模型。miao models 可以列出可用模型。