供应商与模型
miao 自带模型层,但不自带模型本身:你连接自己已经在用的供应商,在会话内切换模型,并给不同的 agent 配不同的模型。它在本机运行,无需 miao 或 OpenCode 账号——凭证直接交给供应商。
miao auth login <integration> <key> # 保存 API keymiao auth login <integration> <key> --account workmiao auth login <integration> <token> --oauthmiao auth # 列出凭据(不显示密钥)miao auth logout <integration> [--account NAME]也可以在 TUI 里输入 /accounts,按提示完成 OAuth 或 API key 登录。凭据写入共享凭据库,在 miao / miao-dev / miao-preview 几个入口之间共享,所以只需登录一次。环境变量里已有 key 的供应商无需 login 也会被识别。
列出与选择模型
Section titled “列出与选择模型”miao models # 当前配置和凭据能寻址的 provider/modelmiao providers # 路由、插件数量和已保存凭据miao debug routes # 解析出的路由清单(JSON)没有凭证的供应商不会被列出,因为 TUI 和 miao run 都无法使用它们;需要确认解析结果时看 miao debug routes。
在 TUI 里,/model 或 ctrl+x m 切换模型;每个 agent 上次使用的模型会被记住。没有选定模型的会话使用 model 设置,写作 <provider>/<model>:
{ "$schema": "https://mtty.dev/miao/config.json", "model": "anthropic/claude-sonnet-4-5",}专业 agent 可以自带模型和权限;见使用指南。
模型元数据(名称、上下文上限、能力、价格)来自 miao 自己在 mtty.dev 提供的目录:以公开的 models.dev 目录为基础,在站点部署时合入 models.dev 尚未收录、由 miao 维护的供应商——目前是 Command Code。miao 运行时只读这一个源,没有 models.dev 回退。构建内打包了一份快照,因此离线也能启动。
也可以把它指向别的来源:
| 环境变量 | 作用 |
|---|---|
MIAO_MODELS_URL |
从另一个 URL 拉取目录 |
MIAO_MODELS_PATH |
使用指定的本地目录文件 |
Command Code 是订阅制供应商:用 miao auth login commandcode(浏览器辅助)连接,或设置 CMD_API_KEY;连接后会从你的账号发现其模型。OpenCode Zen / Go 仍作为可选的第三方供应商保留。
mtty 网关
Section titled “mtty 网关”mtty 是 mtty.dev 自带的 OpenAI 兼容网关(https://my.mtty.dev/v1),目录里同样由 miao 维护、models.dev 没有收录。连接方式:
miao auth login mtty或设置 MTTY_API_KEY。凭证是网关 API key(sk- 前缀,在 my.mtty.dev 的 /console/ 里创建),以 Authorization: Bearer 发送。目前目录中声明了 mtty/deepseek-v4-1-flash-261017,用 miao models mtty 查看该网关上可用的模型。
自定义供应商
Section titled “自定义供应商”miao.jsonc 里的 providers 记录可以新增或覆盖供应商:凭证、通信协议(api)、额外的请求头或 body、模型列表,以及以原生货币计的成本。
{ "$schema": "https://mtty.dev/miao/config.json", "providers": { "my-gateway": { "name": "My gateway", "env": ["MY_GATEWAY_API_KEY"], "currency": "USD", "models": { "llama-3.3-70b": { "name": "Llama 3.3 70B", "capabilities": { "tools": true, "input": ["text"] }, "cost": { "input": 0.2, "output": 0.6 }, "limit": { "context": 131072 }, }, }, }, },}env 指定供应商从哪些环境变量读取 key;disabled 会在即使存在凭证的情况下隐藏该供应商及其模型。api 选择通信协议,整个文件由 $schema 校验。改动后运行 miao models 确认该供应商现在报告的内容。
capabilities 声明模型能做什么,并决定引擎给它发什么:tools 控制工具调用;input 列出模型接受的输入形态(text、image、pdf)。路由省略 image 时,引擎会把附加的图片替换成省略标记并指示模型告知操作者——所以自定义供应商背后的视觉模型必须声明 ["text", "image"],例如:
"deepseek-v4-1-flash-261017": { "name": "DeepSeek V4.1 Flash", "capabilities": { "tools": true, "input": ["text", "image"] },},原生引擎路由
Section titled “原生引擎路由”放到原生引擎上的会话通过可信宿主路由清单访问同样的供应商。目录供应商到原生 transport 的映射、清单字段、凭证引用,以及明确留在 TypeScript 侧的供应商,见 原生引擎的供应商路由。供应商仍在这里配置和登录; 清单由产品生成,不需要手工编辑。
每个供应商轮次都会记录用量、首 token 时间、缓存命中情况和估算成本;会话总计显示在侧边栏。成本是按模型标价的估算——以供应商的账单为准。
价格可用供应商自己的货币声明(例如 DeepSeek 用 CNY)。成本按声明的币种记录,不做汇率换算;账本按币种分别累计,避免把 CNY 和 USD 直接相加。
供应商策略(实验性)
Section titled “供应商策略(实验性)”experimental.policies 列表即使在供应商已配置且已鉴权时也能拒绝其使用。规则按顺序匹配,最后一条匹配者生效;当前支持的 action 是 provider.use,resource 支持通配符:
{ "experimental": { "policies": [ { "effect": "deny", "action": "provider.use", "resource": "company-*" }, { "effect": "allow", "action": "provider.use", "resource": "company-eu" }, ], },}miao debug config查看生效配置,miao debug info查看安装与插件信息;miao debug列出可用子命令。- 鉴权错误会指出修复方式,通常是
miao auth login <integration> <key>;保存的 token 过期时重新登录。 - 供应商不显示任何模型,通常是缺凭证或被策略禁用;用
miao debug routes和miao debug config查看解析结果。
Synced from mttydev/miao@2f6034b.