术语表
Vyane 核心术语速查;区分共享概念、个性化版与开源 Rust 版的实现边界。
Vyane 的个性化版与开源 Rust 版共享一套核心概念,但两条实现线的功能范围和接口并不完全相同。 这一页先解释每个词的稳定含义;涉及具体能力时,会明确说明适用边界。
概念相同,不代表实现进度相同
“有这个概念”“代码已有实现”“已经形成可用入口”是不同状态。具体命令与当前限制以各功能页、 版本与仓库以及公开实现仓的文档为准。
执行目标的四个坐标
一次运行最终要解析出 provider、protocol、harness、model 四个坐标。它们分别记录, 但不能任意拼接:protocol 必须同时得到 provider 与 harness 支持,model 也只在对应 provider 的范围内有效。
provider
提供账号资源、endpoint、凭据、额度、计费与可用性的来源。 官方账号、云厂商、聚合网关和私有网关都可以是 provider。 provider 不等于请求协议,也不等于执行壳;同一个 provider 可以支持多种 protocol 和 model。
protocol
请求与响应在线上采用的 wire 格式。 OpenAI Responses、OpenAI Chat Completions、Anthropic Messages 都是 protocol。实际运行只能选择 provider 与 harness 都支持的 protocol。
harness
承载任务执行的环境。 Codex CLI、Claude Code、OpenCode 等 harness 决定文件、shell、MCP、skills、 session 与权限能力。裸 HTTP 调用是无 harness 的 direct-chat 路径,默认不具备这些本地工具能力。
model
真正执行推理的模型 ID。 model 隶属于具体 provider 的可用范围;即使两个 provider 使用相似名称, 失败切换时也不能未经验证就把一个 provider 的 model ID 带到另一个 provider。
→ 四层架构 · 配置与 profile
配置与执行
profile
一套命名后的运行配置。 profile 通常组合 provider、protocol、harness、model 及相关参数, 让常用目标可以重复选择。它不会绕过 target 解析、能力检查或权限限制;无效组合仍会被拒绝。
dispatch
把一个任务交给一个解析完成的 target 执行。 调用方可以通过 selector、profile 或路由结果指定目标, Vyane 再解析四个坐标、检查能力、执行并记录结果。dispatch 面向的是完整 target,不只是一个模型名。
→ dispatch 与 broadcast · 一个任务怎么跑通
broadcast
把同一个任务并发交给多个 target。 每个 target 独立执行,适合比较输出、交叉验证或收集不同视角。 broadcast 本身不让参与者互相读取产出;需要多轮反馈时,应使用协作或 workflow 能力。
→ dispatch 与 broadcast · 多 agent 协作
failover
当前 target 失败后,按已配置的候选顺序尝试其他 target。 failover 需要调用方或配置明确启用, 不会因为回答质量不理想而自行换模型,也不会把原 provider 的 model ID 偷带到候选 provider。 配额、能力与权限条件仍需分别检查。
连续性与目标
session
保存一段连续工作上下文的会话记录。 Vyane 的话题级 session 可以记录消息、dispatch 历史与上下文摘要; 具体 harness 还可能有自己的 native session 或 resume handle。两者不能混为同一个 ID。
话题级 session 可以绑定不同执行目标的 native session,但这不表示每个 harness 都已经支持无损恢复。 开源 Rust 版已有 owner-scoped session 记录和 direct-HTTP transcript continuity;native harness resume 仍在接入。
goal
带生命周期、进度和验收条件的持久目标。 goal 关注“事情是否达到验收条件”,session 关注“上下文是否接得上”。 连续性机制可以记录阻塞、准备下一步并生成可见的 approval;它不会仅凭配额恢复或一次执行成功就自动判定目标完成。
需要启动 takeover、review、repair 或 primary continuation 时,必须满足对应证据与显式批准/执行边界。
执行与编排
AgentRun
一次可追踪的执行实例。 AgentRun 把身份与职责、任务、session、解析后的执行目标、权限策略和运行状态关联起来; 同一个 Task 可以产生多个 AgentRun,用于并行、接力、审查或修复。
AgentRun 的 run ID 不等于进程 ID,也不等于 native session ID。不同执行路径可以由独立子进程承载, 也可以进入常驻服务中的 native lane;稳定边界是“这一次执行及其证据”,不是某一种进程形态。
workflow
把多个执行步骤组织成可重复运行的流程。 个性化版提供可编程的 JavaScript workflow,支持并行、流水线、 预算、并发限制与运行记录;开源 Rust 版提供声明式 DAG、journal、resume 与 replay。两者解决相同的编排问题, 但配置格式和当前能力范围不同。