自定义模型与插件

接入自定义模型,
开发自定义插件。

01 · CUSTOM MODELS · 自定义模型

把自己的模型接入 Vibecape

在 Federation Server 中注册模型并启动服务,然后在 Vibecape Account 中填写服务地址并登录。查看自定义模型教程
server.ts
注册模型
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),
);
公开模型 ID 映射到实际的上游模型
02
启动服务

启动后会得到一个 Federation URL。

pnpm start --codex
http://127.0.0.1:3000

02 · EXTENSION · 自定义插件

一个插件,由三个部分组成

Manifest 声明插件,Main 处理需要宿主能力的逻辑,Renderer 把界面和入口放进 Vibecape。查看插件开发教程
Vibecape Extension
com.example.my-extension
01 · DECLAREmanifest.json

定义插件身份和代码入口。

id
com.example.my-extension
main
dist/main/index.js
renderer
dist/renderer/index.js
02 · LOGICmain/index.ts

注册 Action,并通过 App Bridge 使用宿主能力。

  • extension.action()业务 Action
  • app.files读写文档
  • app.system系统能力
03 · UIrenderer/index.tsx

声明插件在 Vibecape 中出现的位置。

Main ViewDocument MenuDialogSettings
@vibecape/extension-kit构建为可安装的 Vibecape 插件