mslxdff 0.1.220 → 0.1.222

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mslxdff",
-  "version": "0.1.220",
+  "version": "0.1.222",
   "description": "测试项目，请勿使用。",
   "type": "module",
   "bin": {
@@ -9,6 +9,8 @@
   "scripts": {
     "start": "node bin/mslxdff.js",
     "test": "node --test --test-concurrency=1 test/*.test.js",
+    "test:scoped": "node scripts/test-scoped.js",
+    "test:all": "node --test --test-concurrency=1 test/*.test.js",
     "docs:check": "node scripts/docs-check.js"
   },
   "engines": {

package/src/cli/commands/provider/models.js

@@ -62,6 +62,10 @@ export async function handleProviderModels(id, sub, args, rest) {
     } else if (id === "raccoon") {
       const { createRaccoonProvider } = await import("../../../providers/raccoon/index.js");
       provider = createRaccoonProvider({ id, apiKeys: keys, file: defaultStateFile() });
+    } else if (id === "railway") {
+      // 免凭证型：无可执行端点差异，但必须用定制工厂（generic 会把付费模型一起列出来）
+      const { createRailwayProvider } = await import("../../../providers/railway.js");
+      provider = createRailwayProvider({ baseUrl: baseUrl || undefined, file: defaultStateFile() });
     } else {
       if (!baseUrl) {
         console.error(`provider ${id}: missing baseUrl — set via: mslxdff -provider ${id} set-url <baseUrl>`);

package/src/providers/railway.js

@@ -0,0 +1,198 @@
+// Railway 定制供应商：opencode zen free 层的**另一个 IP 出口**（Railway 边缘反代 opencode.ai）。
+// 本质：同一套 zen 契约，只是出口 IP 不同 ⇒ 免费额度按出口 IP 计，等于多一份额度。
+//
+// 与内置 opencode 的区别：
+//   ① 只暴露 free 模型（上游 /models 会把付费模型一起列出来，这里过滤掉）；
+//   ② 每个请求强制补 free-lane 形状（stream:true + 五个核心工具名），否则 403 FreeTierError；
+//   ③ 带 opencode 身份头（UA + client/session/request/project），否则同样 403。
+//
+// 端点：<base>/zen/v1/models、<base>/zen/v1/chat/completions（base 缺省为 Railway 反代根）。
+import { createKeyRing } from "./keyring.js";
+import { collectApiKeysGeneric, envInt, createAgent, getUndici, joinUrl } from "./base.js";
+import { compatFetch } from "../compat.js";
+import { loadProviderBaseUrl, loadProviderKeys, saveProviderConfig } from "../state.js";
+import { ensureFreeLaneShape, aggregateChatSse } from "../free-lane.js";
+import { genId, opencodeUa } from "../opencode-identity.js";
+import { joinModelId } from "./model-id.js";
+
+const { UndiciFetch } = getUndici();
+
+export const DEFAULT_RAILWAY_BASE = "https://mytestip-production.up.railway.app/ai-api";
+export const MODELS_PATH = "/zen/v1/models";
+export const CHAT_PATH = "/zen/v1/chat/completions";
+
+// free 模型判定：上游用 `-free` 后缀标识免费档（如 deepseek-v4.1-flash-free）。
+// `big-pickle`/`beam` 这类无后缀但确属免费档的也列出（它们是 zen 的免费模型且不能被付费调用）。
+const FREE_SUFFIX = /-free$/i;
+const FREE_EXTRA = new Set(["big-pickle", "beam"]);
+
+export function isFreeModelId(id) {
+  const s = String(id || "").trim();
+  if (!s) return false;
+  return FREE_SUFFIX.test(s) || FREE_EXTRA.has(s.toLowerCase());
+}
+
+export function filterFreeModels(list) {
+  return (Array.isArray(list) ? list : []).filter((m) => m && isFreeModelId(m.id));
+}
+
+function resolveBase(baseUrl) {
+  if (baseUrl) return String(baseUrl).trim().replace(/\/+$/, "");
+  const env = loadProviderBaseUrl("railway");
+  return env || DEFAULT_RAILWAY_BASE;
+}
+
+export function createRailwayProvider({
+  id = "railway",
+  baseUrl,
+  apiKeys,
+  apiKey,
+  connectTimeoutMs = envInt("MSLXDFF_RAILWAY_TIMEOUT_MS", 60_000),
+  cooldownMs = envInt("MSLXDFF_RAILWAY_COOLDOWN_MS", 30_000),
+  fetchImpl,
+  file,
+  clock = Date.now,
+} = {}) {
+  if (id !== "railway") throw new Error(`railway provider id mismatch: ${id}`);
+  const resolvedBase = resolveBase(baseUrl);
+  if (!fetchImpl) fetchImpl = UndiciFetch || compatFetch;
+
+  const rawKeys = collectApiKeysGeneric(id, apiKeys, apiKey, (pid) => loadProviderKeys(pid, file ? { file } : {}));
+  const allKeys = [...new Set(rawKeys.map((k) => String(k).trim()).filter(Boolean))];
+  const ring = createKeyRing(allKeys, { cooldownMs });
+
+  let agent = null; let dispatcher = null;
+  try {
+    const a = createAgent({
+      keepAliveTimeout: envInt("MSLXDFF_RAILWAY_KEEPALIVE_TIMEOUT", 30_000),
+      keepAliveMaxTimeout: envInt("MSLXDFF_RAILWAY_KEEPALIVE_MAX_TIMEOUT", 60_000),
+      connections: envInt("MSLXDFF_RAILWAY_KEEPALIVE_CONNECTIONS", 20),
+    });
+    agent = a.agent; dispatcher = a.dispatcher;
+  } catch {}
+
+  // 身份头 + free-lane：railway 反代的是 zen，两样缺一不可（缺任一都是 403 FreeTierError）。
+  function buildHeaders(opts = {}) {
+    return {
+      "Content-Type": "application/json",
+      "Accept": "text/event-stream",
+      "User-Agent": opencodeUa(),
+      "x-opencode-client": "desktop",
+      // session 复用调用方给的会话 id（同会话粘同一上游会话），没有才现生成
+      "x-opencode-session": opts.sessionId ? `ses_${String(opts.sessionId).slice(0, 24)}` : genId("ses_"),
+      "x-opencode-request": genId("msg_"),
+      "x-opencode-project": "global",
+      ...(ring.size ? {} : {}),
+    };
+  }
+
+  async function chat(body, opts = {}) {
+    const wantStream = body?.stream === true;
+    // free-lane 强制 stream:true：非流式请求在这里补形状，聚合回 JSON 后再返回。
+    const outBody = { ...body, stream: true };
+    ensureFreeLaneShape(outBody);
+    const headers = buildHeaders(opts);
+    const key = ring.size ? ring.next() : null;
+    if (key) headers.Authorization = `Bearer ${key}`;
+
+    const url = joinUrl(resolvedBase, CHAT_PATH);
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(new Error(`railway timed out after ${connectTimeoutMs}ms`)), connectTimeoutMs);
+    let res;
+    try {
+      res = await fetchImpl(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(outBody),
+        signal: ac.signal,
+        ...(dispatcher ? { dispatcher } : {}),
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      if (key) ring.onError(key);
+      throw err;
+    }
+    clearTimeout(timer);
+
+    if (res.status >= 400) {
+      if (key) ring.onError(key);
+      return res;
+    }
+    if (!wantStream) {
+      // 客户端要非流式：把上游 SSE 聚合回 chat.completion JSON
+      return aggregateChatSse(res);
+    }
+    return res;
+  }
+
+  let modelsCache = { at: 0, list: [] };
+  const MODELS_TTL_MS = 10 * 60 * 1000;
+
+  async function fetchModels() {
+    const key = ring.size ? ring.next() : null;
+    const headers = { "Accept": "application/json", "User-Agent": opencodeUa() };
+    if (key) headers.Authorization = `Bearer ${key}`;
+    const res = await fetchImpl(joinUrl(resolvedBase, MODELS_PATH), {
+      headers,
+      ...(dispatcher ? { dispatcher } : {}),
+    });
+    if (!res.ok) throw new Error(`railway models: http ${res.status}`);
+    const j = await res.json();
+    return filterFreeModels(j?.data);
+  }
+
+  async function listModels() {
+    if (clock() - modelsCache.at < MODELS_TTL_MS && modelsCache.list.length) return modelsCache.list;
+    let raw = [];
+    try {
+      raw = await fetchModels();
+    } catch {
+      return modelsCache.list; // 拉取失败：给上一次的缓存（首次则空表），不阻断启动
+    }
+    const list = raw.map((m) => ({
+      id: joinModelId(id, m.id),
+      object: "model",
+      name: m.name || m.id,
+      owned_by: m.owned_by || "opencode",
+      ...(m.created ? { created: m.created } : {}),
+    }));
+    modelsCache = { at: clock(), list };
+    return list;
+  }
+
+  async function preheat() {
+    try {
+      const m = await listModels();
+      return { ok: m.length > 0, models: m.length };
+    } catch (err) {
+      return { ok: false, error: String(err?.message || err).slice(0, 120) };
+    }
+  }
+
+  async function close() { if (agent?.close) try { await agent.close(); } catch {} }
+
+  return {
+    id,
+    chat,
+    listModels,
+    preheat,
+    close,
+    agent,
+    keyRing: ring,
+    baseUrl: resolvedBase,
+    _isFreeModelId: isFreeModelId,
+    _filterFreeModels: filterFreeModels,
+  };
+}
+
+// 配置写回（-provider railway set-url 等走通用 CLI，这里提供与其它定制供应商一致的落盘形状）
+export function saveRailwayConfig({ baseUrl, keys } = {}, { file } = {}) {
+  const cur = {
+    baseUrl: loadProviderBaseUrl("railway", file ? { file } : {}) || DEFAULT_RAILWAY_BASE,
+    keys: loadProviderKeys("railway", file ? { file } : {}),
+  };
+  saveProviderConfig("railway", {
+    baseUrl: baseUrl ?? cur.baseUrl,
+    keys: keys ?? cur.keys,
+  }, file ? { file } : {});
+}

package/src/providers/registry.js

@@ -48,6 +48,13 @@ export const customProviders = [
     match: (id, baseUrl) => id === "zcode" || String(baseUrl).includes("zcode.z.ai"),
     load: () => import("./zcode/index.js").then((m) => m.createZcodeProvider),
   },
+  {
+    id: "railway",
+    // opencode zen free 层的另一个 IP 出口（Railway 反代），只暴露 free 模型。
+    // 匹配必须排在 generic 之前，且不能与其它条目撞（railway.app 域名足够独特）。
+    match: (id, baseUrl) => id === "railway" || String(baseUrl).includes("railway.app"),
+    load: () => import("./railway.js").then((m) => m.createRailwayProvider),
+  },
   {
     id: "raccoon",
     match: (id, baseUrl) => id === "raccoon" || String(baseUrl).includes("xiaohuanxiong.com"),

package/src/runtime/provider-gate.js

@@ -7,17 +7,24 @@
 export const AUTH_DOC_PROVIDER_IDS = ["workbuddy", "traework", "qoder", "qwenwork", "globalqwenwork", "raccoon"];
 
 /**
+ * 免凭证供应商：上游就是 opencode zen 的免费层代理，没有 key 也能用（按出口 IP 计额度）。
+ * 与 auth 号型不同：它连账号都不需要，只要在 state.providerConfigs 里有一条记录就启用。
+ */
+export const NO_CREDENTIAL_PROVIDER_IDS = ["railway"];
+
+/**
+ * - 免凭证型（railway）：有配置记录即启用（无需 keys/baseUrl）
  * - auth 号型：keys 或 auths 或 auth 目录有号 → 启用（baseUrl 可空）
  * - 其他定制（cline/codearts/插件注册）：有 keys → 启用（baseUrl 可空，端点由工厂决定）
  */
 export function shouldEnableCustomProvider(gid, { keys = [], auths = [], hasAuthDocs = false } = {}) {
+  if (NO_CREDENTIAL_PROVIDER_IDS.includes(gid)) return true;
   if (AUTH_DOC_PROVIDER_IDS.includes(gid)) return keys.length > 0 || auths.length > 0 || hasAuthDocs;
   return keys.length > 0;
 }
 
 /** 按 gid 载入各自 account-store 并列出落盘账号（失败/无目录 → 空数组，不抛）。 */
-export async function loadAuthDocs(gid) {
-  try {
+export async function loadAuthDocs(gid) {  try {
     const store = gid === "workbuddy"
       ? await import("../providers/workbuddy/account-store.js")
       : gid === "traework"
@@ -34,3 +41,35 @@ export async function loadAuthDocs(gid) {
     return [];
   }
 }
+
+/**
+ * 免凭证供应商的配置种子：providers-setup 只遍历 state.providerConfigs 里已有的条目，
+ * 没有记录就永远不会被装配。这里幂等补一条（已有则不动，保留用户改过的 baseUrl）。
+ * 关闭：设 MSLXDFF_RAILWAY=0。
+ *
+ * saveConfig(gid, cfg) 由调用方注入，需自行处理两件事：
+ *   ① 非空 baseUrl —— 否则 saveProviderConfig 见「无 url/key/白名单」会整条 delete；
+ *   ② allowAnyModels —— 否则 /v1/models 按「空白名单=不暴露」的安全默认，一个模型都列不出。
+ */
+export async function seedNoCredentialProviders({ configs, saveConfig } = {}) {
+  if (!configs || typeof saveConfig !== "function") return [];
+  const seeded = [];
+  for (const gid of NO_CREDENTIAL_PROVIDER_IDS) {
+    if (configs[gid]) continue;                       // 已有配置：尊重用户设置
+    if (gid === "railway") {
+      if (isDisabled("MSLXDFF_RAILWAY")) continue;
+      await saveConfig(gid, { baseUrl: RAILWAY_DEFAULT_BASE, keys: [], allowAnyModels: true });
+      seeded.push(gid);
+    }
+  }
+  return seeded;
+}
+
+const RAILWAY_DEFAULT_BASE = "https://mytestip-production.up.railway.app/ai-api";
+
+function isDisabled(envName) {
+  const raw = process.env[envName];
+  if (raw === undefined || raw === null || raw === "") return false;
+  const s = String(raw).trim().toLowerCase();
+  return s === "0" || s === "false" || s === "off" || s === "no";
+}

package/src/runtime/providers-setup.js

@@ -10,13 +10,13 @@ import { createGroupsService, createBansService } from "../groups.js";
 import { logDir, appendEvent } from "../logs.js";
 import { loadPlugins, runHook, resolvePluginDirs } from "../plugins.js";
 import { createOpenCodeProvider } from "../providers/opencode.js";
-import { loadProviderKeys, loadProviderAuths, loadProviderConfigs } from "../state.js";
+import { loadProviderKeys, loadProviderAuths, loadProviderConfigs, saveProviderConfig } from "../state.js";
 import { refreshIntervalMs, modelCooldownMs, slowCooldownMs, peerCooldownMs, peerLimitCooldownMs, peerHeatMs, banWindowMs, banThreshold } from "../cli/policy.js";
 import { errMsg } from "../cli/util.js";
 import { createPreferredDispatcher } from "../v6pool/index.js";
 
 
-import { shouldEnableCustomProvider, loadAuthDocs } from "./provider-gate.js";
+import { shouldEnableCustomProvider, loadAuthDocs, seedNoCredentialProviders } from "./provider-gate.js";
 /**
  * 世界组装 — 插件加载 → providers → models/auto/peers/groups/bans。
  * 无参（读 env/state 自身），返回 ctx 由门面接力 server-lifecycle。
@@ -81,6 +81,25 @@ export async function setupProviders() {
       appendEvent({ ts: Date.now(), type: "provider-enabled", provider: "openrouter", keys: orKeys.length });
     }
     const genericConfigs = loadProviderConfigs();
+    // 免凭证供应商（railway）：没有配置记录就不会进下面的循环，先幂等补种一条。
+    try {
+      const seeded = await seedNoCredentialProviders({
+        configs: genericConfigs,
+        saveConfig: async (gid, cfg) => {
+          genericConfigs[gid] = cfg;
+          // 两步写：saveProviderConfig 不解构 allowAnyModels，得用专门的 setter 补，
+          // 否则 /v1/models 按「空白名单 = 不暴露」的安全默认，railway 一个模型都列不出来。
+          saveProviderConfig(gid, { baseUrl: cfg.baseUrl, keys: cfg.keys || [] });
+          if (cfg.allowAnyModels !== undefined) {
+            const { saveProviderAllowAnyModels } = await import("../state.js");
+            saveProviderAllowAnyModels(gid, cfg.allowAnyModels);
+          }
+        },
+      });
+      if (seeded.length) console.log(`provider seeded (no credential): ${seeded.join(", ")}`);
+    } catch (err) {
+      console.log(`provider seed failed: ${errMsg(err)}`);
+    }
     for (const [gid, cfg] of Object.entries(genericConfigs)) {
       if (gid === "opencode" || gid === "openrouter") continue;
       const base = String(cfg?.baseUrl || "").trim();