Skip to content

🤖 Open-source, local-first alternative to Grok Bot, OpenAI dots and Claude Duet. Your own AI bots on any model: GPT, Claude, Gemini, Grok, DeepSeek, Kimi, GLM and 70+ more through one Modelflare key. Reach them in the app, WeChat or Feishu; they remember you, work in the background, run commands and use your computer. Pay per use.

8.0 KB
Raw Blame
/**
 * Modelflare:本程序唯一的模型来源。
 * - 三个 API 域名:modelflare.dev、origin.modelflare.dev、cf.modelflare.dev;
 *   飞行中的 POST 不跨主机重定向,所以线路由用户事先选定,不自动切换。
 * - 连接前用 GET {base}/models + Bearer 校验密钥;错误按状态码给出可操作的说明。
 */
import { t } from "./i18n/index.js";

// 保留历史配置值;auto/global 都指向主域名,cn 指向 origin,不代表地域或质量差异。
export type ModelflareLine = "auto" | "global" | "cn" | "cf";

export const MODELFLARE_LINES: Record<Exclude<ModelflareLine, "auto">, string> = {
  global: "https://modelflare.dev/v1",
  cn: "https://origin.modelflare.dev/v1",
  cf: "https://cf.modelflare.dev/v1",
};

export const MODELFLARE_PROVIDER = "modelflare";

/** Modelflare 官网:登录、注册、充值、控制台都在这里(origin 域名只开放 /v1,不提供网页) */
export const MODELFLARE_WEB = "https://modelflare.dev";

/**
 * 账户登录(OIDC 授权码 + PKCE,RFC 8252 原生应用)。client_id 是公开值:本程序是公共客户端,
 * 没有也不需要客户端密钥;回调到本机 127.0.0.1 的临时端口。
 */
export const MODELFLARE_CLIENT_ID = "anymodel-bot";
export const MODELFLARE_SCOPES = "openid profile offline_access account api_keys";

/**
 * 注册来源(Modelflare 后台按 utm_source 统计从本程序来的注册与充值)。
 * 全项目统一:utm_source=anymodelbot&utm_campaign=amb_<位置>。应用内 amb_signup / amb_topup / amb_console …,
 * README 与仓库文档 amb_readme,官网 amb_homepage。
 */
export const UTM = { utm_source: "anymodelbot" } as const;

/** 开发/测试:AMB_MODELFLARE_ISSUER 把登录与账户接口指向本地 mock(界面无法设置) */
export function modelflareIssuer(env: NodeJS.ProcessEnv = process.env): string {
  return (env.AMB_MODELFLARE_ISSUER?.trim() || MODELFLARE_WEB).replace(/\/+$/, "");
}

/** 官网页面链接,带上来源参数 */
export function webUrl(pathname: string, campaign?: string): string {
  const u = new URL(pathname, MODELFLARE_WEB);
  for (const [k, v] of Object.entries(UTM)) u.searchParams.set(k, v);
  if (campaign) u.searchParams.set("utm_campaign", campaign);
  return u.toString();
}

export const SIGNUP_URL = webUrl("/sign-up", "amb_signup");
export const TOPUP_URL = webUrl("/billing", "amb_topup");
export const CONSOLE_URL = webUrl("/dashboard/overview", "amb_console");

/**
 * 调用归因:每个经 Modelflare 的请求都带 X-Modelflare-Skill(Modelflare 只记到用量日志,
 * 用来统计各集成的调用量)。版本必须是纯数字的 1–3 段。
 */
export function skillHeader(version: string): Record<string, string> {
  return /^\d{1,4}(\.\d{1,4}){0,2}$/.test(version) ? { "X-Modelflare-Skill": `anymodel-bot/${version}` } : {};
}

/** 每个开启了预算的机器人有自己的内置网关 provider(自己的 API Key) */
export const BOT_PROVIDER_PREFIX = "mfb-";
export const botProviderId = (botId: string) => BOT_PROVIDER_PREFIX + botId;

const QUALIFIED = /^(modelflare|mfb-[A-Za-z0-9_-]+)\//;

/** 去掉内置网关的 provider 前缀:modelflare/openai/x、mfb-abc/openai/x → openai/x */
export function bareModel(model: string): string {
  return model.replace(QUALIFIED, "");
}

/** 某个机器人专属 provider 列出的模型(模型列表里不展示,避免同一模型出现多次) */
export function isBotProviderModel(model: string): boolean {
  return model.startsWith(BOT_PROVIDER_PREFIX) && model.includes("/");
}

/**
 * 把模型 id 限定到某个 provider。每个请求都显式带 provider:多个 provider 提供同名模型时,
 * 不带前缀的 id 会被内置网关当成一组在它们之间路由,预算就管不住了。
 */
export function routeModel(model: string, providerId: string): string {
  const bare = bareModel(model.trim());
  return bare ? `${providerId}/${bare}` : bare;
}

export function normalizeLine(v: unknown): ModelflareLine {
  if (v === "origin") return "cn";
  return v === "global" || v === "cn" || v === "cf" ? v : "auto";
}

/** 线路 → 基址。AMB_MODELFLARE_BASE_URL 仅供开发/测试(指向本地 mock),不经界面设置。 */
export function modelflareBaseUrl(line: ModelflareLine, env: NodeJS.ProcessEnv = process.env): string {
  const override = env.AMB_MODELFLARE_BASE_URL?.trim();
  if (override) return override.replace(/\/+$/, "");
  return MODELFLARE_LINES[line === "auto" ? "global" : line];
}

/**
 * 交给内置网关的三种对话接口地址:Chat Completions、Responses 都在 {base}(…/v1)下,Anthropic Messages
 * 的地址是根(网关自己拼 /v1/messages)。网关按模型挑:Claude 走 Messages(提示缓存和思考过程只有它保留),
 * 其余走 Chat;上游说某个模型不在这个接口上时,网关换另一个接口再试并记住。
 */
export function modelflareApiBases(baseUrl: string): { chat: string; responses: string; anthropic: string } {
  return { chat: baseUrl, responses: baseUrl, anthropic: baseUrl.replace(/\/v1\/?$/, "") };
}

export type VerifyFailure = "invalid_key" | "forbidden" | "rate_limited" | "upstream" | "network" | "bad_response";

export type VerifyResult =
  | {
      ok: true;
      models: string[];
      /**
       * 能对话的模型(Modelflare 标为 kind=text 的;旧版网关没有 kind 时为全部)。
       * 连接时把它们全部写进内置网关的 picks:网关对超过 24 个模型、又没有 picks 的服务商
       * 只放出列表前 24 个,而 Modelflare 的列表按字母排,后面的模型会被截掉。
       */
      chatModels: string[];
    }
  | { ok: false; code: VerifyFailure; status?: number; message: string };

/** 校验密钥:只发一次 GET /models,不重试、不换线路。 */
export async function verifyModelflareKey(
  baseUrl: string,
  apiKey: string,
  opts: { fetchImpl?: typeof fetch; timeoutMs?: number; line?: ModelflareLine } = {},
): Promise<VerifyResult> {
  const f = opts.fetchImpl ?? fetch;
  let res: Response;
  try {
    res = await f(`${baseUrl}/models`, {
      headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
      signal: AbortSignal.timeout(opts.timeoutMs ?? 15_000),
    });
  } catch (e) {
    const host = safeHost(baseUrl);
    return {
      ok: false,
      code: "network",
      message: t("modelflare.unreachable", { host, reason: (e as Error).name === "TimeoutError" ? t("modelflare.timeout") : (e as Error).message }),
    };
  }
  if (res.status === 401) return { ok: false, code: "invalid_key", status: 401, message: t("modelflare.invalid_key") };
  if (res.status === 403) return { ok: false, code: "forbidden", status: 403, message: t("modelflare.forbidden") };
  if (res.status === 429) return { ok: false, code: "rate_limited", status: 429, message: t("modelflare.unavailable", { status: 429, retry: retryAfter(res) }) };
  if (!res.ok) return { ok: false, code: "upstream", status: res.status, message: t("modelflare.unavailable", { status: res.status, retry: "" }) };
  try {
    const body = (await res.json()) as { data?: Array<{ id?: unknown; kind?: unknown }> };
    if (!Array.isArray(body.data)) throw new Error("no data[]");
    const rows = body.data.map((m) => ({ id: String(m.id ?? ""), kind: typeof m.kind === "string" ? m.kind : "" })).filter((m) => m.id);
    const classified = rows.some((m) => m.kind);
    return {
      ok: true,
      models: rows.map((m) => m.id).sort(),
      chatModels: rows.filter((m) => !classified || m.kind === "text").map((m) => m.id).sort(),
    };
  } catch {
    return { ok: false, code: "bad_response", status: res.status, message: t("modelflare.bad_models") };
  }
}

function retryAfter(res: Response): string {
  const s = res.headers.get("retry-after");
  return s ? t("modelflare.retry_after", { s }) : "";
}

function safeHost(url: string): string {
  try {
    return new URL(url).host;
  } catch {
    return url;
  }
}

/** 只用于展示的密钥尾号 */
export function keyTail(key: string): string {
  return key.length > 4 ? key.slice(-4) : "";
}