Skip to main content
配置中心 是 Vibex 的配置入口,从侧栏的 配置中心 按钮或系统托盘打开。它把 Agent 运行时、MCP 服务器和技能集中在一处管理,并为每项资源显示状态和验证结果。

分区

配置中心顶部有三个标签页:
配置中心当前只提供这三个分区。 模型供应商不是独立标签页——它在 Agent 标签页的详情区里,见Agent 与供应商配置。

通用操作

保存与验证

  1. 填写字段并保存。
  2. 在资源卡片上点击 验证 运行校验。校验是离线的:它检查必填字段、格式和作用域,不会启动进程或发起网络请求。
  3. 对模型供应商可以额外运行 测试连接,它会真实调用一次模型接口。
测试连接 和 拉取模型 会访问供应方网络并可能产生费用。确认地址、模型和权限后再运行。

作用域

部分资源可以设定作用范围,取值通常是 global、user、project 或 workspace。作用域决定资源在哪些会话和项目里可见。 开始配置时先选最小作用域:
  • 只给自己所有项目使用的资源放在 user。
  • 团队或仓库约定放在 project。
  • 只服务当前检出的资源放在 workspace。
  • 需要全局默认时才使用 global。
MCP 服务器的编辑器目前只提供 用户 和 工作区 两种作用域。

启用与停用

资源和 Agent 之间是逐 Agent 启用的关系。资源卡片下方的 Agent 启用范围 区域为每个已添加的 Agent 提供一个开关;只有打开开关的 Agent 才会加载该资源。 不需要某个资源时先停用,而不是立刻删除——停用会保留记录,便于之后恢复。

凭据

使用 secret reference 或操作系统的安全存储引用凭据。不要把 token、私钥、完整环境变量、提示词或文件内容粘贴到配置描述或诊断日志中。 桌面端把凭据存在操作系统的钥匙串里。没有可用钥匙串的主机会退回写入仅属主可读的文件,详见自托管无头运行时。

导出到 Agent 原生配置

在资源卡片上可以使用 预览导出 / 应用 / 回滚,把 Vibex 里的 MCP 或技能写入对应 Agent 自己的配置文件(例如 Codex 的 ~/.codex/config.toml、Claude 的 ~/.claude/settings.json、以及各 Agent 的技能目录)。
应用之前一定要看预览。 Vibex 默认不会改写 Agent 的原生 home 配置,只有你明确应用时才会写入。应用后可以从同一处 回滚 恢复。

配置出现问题时

  1. 确认资源的作用域和启用状态。
  2. 运行 验证 看是否有结构化错误。
  3. 确认该资源已在目标 Agent 的 Agent 启用范围 里打开。
如果重启后状态不一致,见故障排查。不要直接删除 SQLite 数据库。