miao 编码代理

先看懂,再修改。

读仓库、改代码、运行检查,结果交由你确认。上下文精简,费用逐轮记录。

预算按金额、token、轮次与时长设定。

macOS / Linux

curl -fsSL https://mtty.dev/miao/install | bash

Windows (PowerShell)

irm https://mtty.dev/miao/install.ps1 | iex

单个二进制 · macOS、Linux 与 Windows · MIT

当前 miao 终端界面:示例代码审阅、行内编辑 diff、回复和上下文用量。
Build 代理 · 行内代码改动与上下文用量 · 示例会话

01 中途改要求

任务进行中,可补充要求。

新输入先持久化,至安全边界并入会话;正在执行的调用不中断。

显式排队的输入待会话空闲处理;新输入被采纳后,轮次额度重新计算。

  1. ›

    定位此测试失败的原因,完成修复,运行相关检查,并解释代码差异。

  2. ›

    保持公共 API 不变,不引入新的运行时依赖。

    steer · 已保存,在下一个轮次边界并入
  3. ›

    随后准备一份草稿 PR 描述。

    queue · 等会话即将空闲时再处理

02 为什么是 miao

机制

  1. 01

    上下文

    基线固定,变化按序追加,提示缓存跨轮命中。缓存策略与 TTL 可按供应商配置。

  2. 02

    压缩

    接近阈值时开始,摘要复用当前前缀。旧输出默认裁剪;超大结果留存磁盘,仍可召回。

  3. 03

    费用

    逐轮记录 token、缓存命中率、首 token 延迟与估算费用。预算用至五分之四时提醒,到限即停。

  4. 04

    安装

    单个二进制,无引擎或 TUI。一行覆盖 macOS、Linux、Windows。

费用为估算值,以供应商账单为准。历史保存不等于崩溃续跑;未完成的轮次需显式恢复。

03 日常工程

日常工作。

工程需求miao 的能力
理解陌生仓库文件读取、搜索、项目指令、技能、专项子代理
实现功能并验证文件编辑与补丁、Shell 命令、可选 LSP 诊断和格式化
比较模型而不换工具会话内模型切换、自定义供应商、按代理配置模型、受支持模型的推理档位
推进较大的任务待办、中途补充要求、持久化会话、可选自治续跑
接入自己的工具本地与远程 MCP、自定义命令、技能、插件
检查并复用工作成果差异查看、会话分叉、历史导出、权限确认
接入其他应用HTTP 服务、浏览器界面、CLI 自动化、工作区内生成的客户端

04 界面

终端内运行。

审阅改动,选择模型示例代码审阅会话中直接查看 diff 和上下文用量;打开模型选择,不用离开当前会话。放大查看 ↗
自带模型服务商打开供应商选择器,浏览可用服务;连接 OpenAI、Anthropic、GitHub Copilot、Google 或自己的端点。放大查看 ↗
同一个会话,也能在浏览器里看在 miao 浏览器界面展开编辑 diff、打开文件审阅面板;与终端截图使用同一个示例会话。放大查看 ↗
紧凑的交互模式开发构建中可选的 mini 界面:任务进度、编辑 diff 和多选问题,使用内置演示模式录制。放大查看 ↗
mini 界面的编辑权限确认展示拟议 diff,以及单次允许、始终允许和拒绝选项。来自内置演示模式。
允许编辑前,先看清改动mini 界面的编辑权限确认展示拟议 diff,以及单次允许、始终允许和拒绝选项。来自内置演示模式。放大查看 ↗
当前终端启动界面,输入框旁直接显示所选代理、模型和推理档位。
从一个提示开始当前终端启动界面,输入框旁直接显示所选代理、模型和推理档位。放大查看 ↗

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 可以列出可用模型。

模型自选,终端不变。