使用自定义模型

将 Vibecape 连接到 Downcity Federation，使用本地或私有的文本与图片模型。

Vibecape 通过 Downcity Federation 发现 AI 模型。连接本地或私有 Federation、完成登录后，就能选择当前账户可用的文本或图片模型。

配置流程

启动一个发布模型目录的 Federation Server；
在 Vibecape Account 设置中填写服务 URL；
测试连接并保存；
登录该 Federation；
刷新模型目录并选择模型。

Federation URL 同时代表账户授权服务。切换服务后需要重新登录。

启动本地 Federation

downcity-local-proxy skill 可以为 Codex、Claude Code 或两者自动配置本地服务。

为 Coding Agent 安装 skill：

npx skills add https://github.com/wangenius/downcity-local-proxy-skill \
  --skill downcity-local-proxy \
  --agent codex \
  --global \
  --yes

然后把下面的提示词交给 Agent：

请创建并启动一个本地 Downcity Federation Server，让 Vibecape 可以使用
本机的 Codex 或 Claude Code 模型。请使用 downcity-local-proxy skill，
在 ./downcity/local-proxy 创建项目、安装依赖，并启动我选择的模型来源。
如需 OAuth 请完成登录。最后告诉我 Federation URL，并指导我在 Vibecape
中完成连接。

生成的项目通常使用下面的命令启动：

cd ./downcity/local-proxy
pnpm install
pnpm start --codex --claude-code

第一次 OAuth 授权时使用 --login，例如 pnpm start --codex --login。默认本地地址通常是 http://127.0.0.1:3000。

模型发现原理

Provider 把稳定的公开模型 ID 映射到上游模型，AIService 发布模型目录，Vibecape 再使用选中的公开 ID 发起请求。

import { AIService, Federation } from "@downcity/city";

const models = [
  provider.model({
    id: "team-codex",
    name: "Team Codex",
    meta: { upstream_model: "gpt-5-codex" },
  }),
];

const federation = new Federation({ db });
federation.use(new AIService().use(models));