Skip to content

Model Profiles and Agent Launch CN

Jump to bottom
Jazzen Chen edited this page May 24, 2026 · 3 revisions

Model Profiles 与 Agent Launch

Profile 是保存好的 provider route。Launch 会把 profile、agent、terminal、workspace、session 组合起来启动。

Launch 布局

当前 Launch 流程：

  1. 从左侧竖条选择 Agent。
  2. 选择 Profile。Direct 表示使用 CLI 原生登录态。
  3. 选择 Terminal。
  4. 选择 Workspace。
  5. 选择 New session 或已有 session。
  6. 点击 Launch。

Profile 网格会尽量紧凑展示，让大量 provider routes 能放进一屏。

Profile 包含什么

Profile 可以包含：

字段 作用
Provider DeepSeek、DashScope、Kimi、MiniMax、xAI、NVIDIA NIM、Gemini、OpenRouter、Azure、Custom 等
Credentials API key 或 provider 特定认证字段
API types OpenAI Responses、OpenAI Chat、Anthropic Messages、Gemini Generate Content
Model list 展示给 Agent 或模型选择器的模型列表
Context metadata 已知的 context window 等模型 metadata
Custom model name 用户手填模型名，VibeAround 不做合法性判断
Bridge route 从 Agent API 形态到 Provider API 形态
Provider options DeepSeek reasoning、proxy opt-in、endpoint overrides、headers

Model List、Fake ID 与 Alias

有些 Agent 需要的是模型列表，而不是单个模型。VibeAround 可以为 profile 暴露模型列表：

  • 内置已知模型
  • provider-specific display description
  • 已知 context-window metadata
  • 用户手动添加的 custom model name
  • 兼容用 fake ID，内部再映射回 upstream provider model

Agent 可能展示 fake ID 或 description。VibeAround 在真正请求 provider 前会把选中的模型映射回 upstream model。用户手填的 custom model 如果 provider 不认识，就直接返回 provider error。

旧的 upstreamModel / fakeModelId 仍然保留，用于兼容和默认模型。后续 0.7.x 会更新到新的 profile schema。

API Bridge Route

VibeAround 本地 bridge 可以在这些 API 形态之间转换：

Client shape Provider shape
OpenAI Responses OpenAI Responses、OpenAI Chat、Anthropic Messages、Gemini
OpenAI Chat Completions OpenAI Chat、Anthropic Messages、Gemini
Anthropic Messages Anthropic Messages、OpenAI Chat、OpenAI Responses
Gemini Generate Content Gemini 和支持转换的 routes

常见组合：

  • Codex CLI -> DeepSeek OpenAI Chat Completions
  • Codex CLI -> Kimi Anthropic Messages
  • Claude Code -> DeepSeek OpenAI Chat Completions
  • Claude Code -> MiniMax Anthropic Messages

Claude 后缀归一化

Claude Code 可能给选中的模型名追加类似 [1m] 的内部后缀。VibeAround 会在映射 provider model 前去掉这个后缀，避免 provider 收到 deepseek-v4-pro[1m] 这种非法模型名。

Auth Token 冲突

Claude Code 同时检测到 Claude account token 和 ANTHROPIC_API_KEY 时会报警，这是 Claude Code 自己的机制。建议一次只使用一种模式：

  • Direct 模式使用 Claude 原生账号登录态
  • Profile/Bridge 模式使用 ANTHROPIC_API_KEY 或 VibeAround 本地 bridge endpoint

本地 API Endpoint

手动配置 client 时可以使用：

http://127.0.0.1:12358/va/local-api/<profile-id>/<scope>/<target-api-type>

建议每个项目或 client 使用稳定的 scope，避免 bridge state、reasoning replay、tool-call repair 混到其他会话里。

Provider 建议

Provider 常见用途
DeepSeek Codex/Claude via bridge，处理 reasoning 和后缀归一化
Alibaba DashScope Coding Plan / Token Plan endpoints
Kimi / Moonshot OpenAI-compatible 和 Anthropic-style routes
MiniMax OpenAI-compatible 和 Anthropic-style routes
Xiaomi MiMo 区域化 Token Plan endpoints
xAI / Grok Responses 和 Chat routes
NVIDIA NIM OpenAI Chat-compatible route
Gemini Gemini native profile
Custom endpoint 自定义 base URL、headers、API type、model list

Clone this wiki locally