Vyane 核心概念
四层架构
provider / protocol / harness / model —— Vyane 的心智模型
Vyane 所有功能都建在一个不可混淆的四层模型上。搞懂这四层,你就懂了 Vyane 为什么这么设计。
四层是什么
| 层 | 一句话 | 例子 |
|---|---|---|
| provider | 谁给账号、endpoint、key、额度、计费 | 官方账号、聚合网关、云厂商、私有网关 |
| protocol | 请求 / 响应长什么样(wire 格式) | OpenAI Responses、OpenAI Chat Completions、Anthropic Messages |
| harness | 任务在哪个「壳」里跑,决定能不能碰文件 / shell / MCP | Codex CLI、Claude Code、OpenCode、direct-chat |
| model | 真正做推理的模型 | 具体模型 ID,随配置变 |
为什么要拆开
因为它们会自由组合。同一个模型可以走不同 provider(官方账号 vs 聚合网关)、装进不同 harness(Codex CLI vs 纯 API)。如果把它们混成一坨,就没法灵活调度、也没法在一个额度用光时换另一个。
别混层
聚合网关、云厂商是 provider;Responses / Chat Completions 是 protocol; Codex CLI / Claude Code 是 harness。别把 Codex CLI 叫成 provider,也别把网关叫成 protocol。
一个具体例子
用 Codex 审代码,四层是这样的:
| 层 | 取值 |
|---|---|
| provider | 官方 OpenAI 账号 |
| protocol | OpenAI Responses |
| harness | Codex CLI(能读本地文件、跑 shell、动 git) |
| model | 具体的 GPT 模型 ID |
vyane dispatch 时你只填一个 --provider codex(这是个便捷选择器),Vyane 内部把它解析成上面完整的四层组合去执行。
AgentRun:谁在干、干什么
除了四层,Vyane 还用几个字段记录「一次任务执行」:
- agent —— 长期身份,如 Assistant、Project Agent、System
- role —— 短期职责,如 Developer / Reviewer / Researcher / Operator
- harness / provider / protocol / model —— 上面那四层
记住一句话
不要把模型名当 agent 名,也不要把 harness 当 role。模型只是「用什么脑子」,agent 是「谁」,role 是「这次扮演什么」。