@wallbreakerno4/opencode-commandcode 0.1.0

package/dist/models/snapshot.js

@@ -0,0 +1,16 @@
+/**
+ * 包内快照（docs/spec/model-pipeline.md §5）：与构建产物同 schema 的「最后已知
+ * 良好产物」，随插件发版从最新产物复制进来，是运行时永远可用的兜底层——不占
+ * modelsUrls 列表位，产物/API 全部失败或从未成功时顶替产物角色（§5 降级表）。
+ *
+ * 产物原文在同目录 `snapshot.json`（逐字节来自构建产物，sha256 可与渠道产物对
+ * 账）；刷新走 `pnpm embed-snapshot`（scripts/embed-snapshot.ts：运行时同款
+ * parseArtifact schema 校验通过才写入，发布流程见 docs/release/release-process.md）。
+ * build 脚本在 tsc 之后 `cp` 一份原文进 dist——tsc 自带的 JSON 复制会重排版，
+ * 逐字节一致靠 cp 保住。空快照占位形态不存在——校验拒绝空清单入库；运行时任何
+ * 降级路径都不会因快照缺位而崩（loadPackageSnapshot 的防御分支兜底）。
+ * 快照 `sourceCliVersion` 同时是版本头兜底链 ④（disguise.md §6）。
+ */
+import snapshotJson from "./snapshot.json" with { type: "json" };
+/** 包内快照原文（unknown：非可信数据，消费方一律经 parseArtifact 解析） */
+export const PACKAGE_SNAPSHOT_JSON = snapshotJson;

package/dist/models/snapshot.json

@@ -0,0 +1,535 @@
+{
+  "schemaVersion": 1,
+  "generatedAt": "2026-09-06T16:21:38.693Z",
+  "sourceCliVersion": "1.49.1",
+  "models": [
+    {
+      "id": "deepseek/deepseek-v4-pro",
+      "name": "DeepSeek V4 Pro (latest)",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "efforts": [
+        "high",
+        "max"
+      ],
+      "context": 1000000,
+      "maxOutput": 384000
+    },
+    {
+      "id": "deepseek/deepseek-v4-flash",
+      "name": "DeepSeek V4 Flash (latest)",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "efforts": [
+        "high",
+        "max"
+      ],
+      "context": 1000000,
+      "maxOutput": 384000
+    },
+    {
+      "id": "deepseek/deepseek-v4-flash-vision-exp",
+      "name": "DeepSeek V4 Flash Vision (exp)",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "high",
+        "max"
+      ],
+      "context": 1000000,
+      "maxOutput": 384000
+    },
+    {
+      "id": "deepseek/deepseek-v4-flash-fast",
+      "name": "DeepSeek V4 Flash Fast",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "efforts": [
+        "low",
+        "high",
+        "max"
+      ],
+      "context": 1000000,
+      "maxOutput": 32000
+    },
+    {
+      "id": "moonshotai/Kimi-K3",
+      "name": "Kimi K3",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "low",
+        "high",
+        "max"
+      ],
+      "context": 1000000,
+      "maxOutput": 131072
+    },
+    {
+      "id": "moonshotai/Kimi-K2.7-Code",
+      "name": "Kimi K2.7 Code",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 256000,
+      "maxOutput": 262144
+    },
+    {
+      "id": "moonshotai/Kimi-K2.7-Code-Highspeed",
+      "name": "Kimi K2.7 Code HighSpeed",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 262000,
+      "maxOutput": 262144
+    },
+    {
+      "id": "moonshotai/Kimi-K2.6",
+      "name": "Kimi K2.6",
+      "reasoning": false,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 256000,
+      "maxOutput": 262144
+    },
+    {
+      "id": "moonshotai/Kimi-K2.5",
+      "name": "Kimi K2.5",
+      "reasoning": false,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 256000,
+      "maxOutput": 262144
+    },
+    {
+      "id": "z-ai/glm-5.3-flash",
+      "name": "GLM-5.3 Flash",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "low",
+        "high",
+        "max"
+      ],
+      "context": 1048576,
+      "maxOutput": 131072
+    },
+    {
+      "id": "zai-org/GLM-5.3",
+      "name": "GLM-5.3",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "efforts": [
+        "low",
+        "high",
+        "max"
+      ],
+      "context": 1000000,
+      "maxOutput": 131072
+    },
+    {
+      "id": "zai-org/GLM-5.2",
+      "name": "GLM-5.2",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "efforts": [
+        "high",
+        "max"
+      ],
+      "context": 1000000,
+      "maxOutput": 131072
+    },
+    {
+      "id": "zai-org/GLM-5.2-Fast",
+      "name": "GLM-5.2 Fast",
+      "reasoning": false,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 1000000,
+      "maxOutput": 131072
+    },
+    {
+      "id": "zai-org/GLM-5.1",
+      "name": "GLM-5.1",
+      "reasoning": false,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 200000,
+      "maxOutput": 131072
+    },
+    {
+      "id": "zai-org/GLM-5",
+      "name": "GLM-5",
+      "reasoning": false,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 200000,
+      "maxOutput": 131072
+    },
+    {
+      "id": "MiniMaxAI/MiniMax-M3",
+      "name": "MiniMax M3",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 1000000,
+      "maxOutput": 512000
+    },
+    {
+      "id": "MiniMaxAI/MiniMax-M2.7",
+      "name": "MiniMax M2.7",
+      "reasoning": false,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 200000,
+      "maxOutput": 131072
+    },
+    {
+      "id": "MiniMaxAI/MiniMax-M2.5",
+      "name": "MiniMax M2.5",
+      "reasoning": false,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 200000,
+      "maxOutput": 131072
+    },
+    {
+      "id": "xiaomi/mimo-v2.5-pro",
+      "name": "MiMo V2.5 Pro",
+      "reasoning": false,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 1000000,
+      "maxOutput": 131072
+    },
+    {
+      "id": "xiaomi/mimo-v2.5",
+      "name": "MiMo V2.5",
+      "reasoning": false,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 1000000,
+      "maxOutput": 131072
+    },
+    {
+      "id": "Qwen/Qwen3.8-Max-0902",
+      "name": "Qwen 3.8 Max 0902",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "low",
+        "medium",
+        "xhigh"
+      ],
+      "context": 1000000,
+      "maxOutput": 32768
+    },
+    {
+      "id": "Qwen/Qwen3.8-Max",
+      "name": "Qwen 3.8 Max",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "low",
+        "medium",
+        "xhigh"
+      ],
+      "context": 1000000,
+      "maxOutput": 32768
+    },
+    {
+      "id": "Qwen/Qwen3.8-27B",
+      "name": "Qwen 3.8 27B",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "low",
+        "medium",
+        "xhigh"
+      ],
+      "context": 262144,
+      "maxOutput": 32768
+    },
+    {
+      "id": "Qwen/Qwen3.8-Flash",
+      "name": "Qwen 3.8 Flash",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "low",
+        "medium",
+        "xhigh"
+      ],
+      "context": 1000000,
+      "maxOutput": 32768
+    },
+    {
+      "id": "Qwen/Qwen3.7-Max",
+      "name": "Qwen 3.7 Max",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 1000000,
+      "maxOutput": 32768
+    },
+    {
+      "id": "Qwen/Qwen3.7-Plus",
+      "name": "Qwen 3.7 Plus",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 1000000,
+      "maxOutput": 32768
+    },
+    {
+      "id": "Qwen/Qwen3.7-Flash",
+      "name": "Qwen 3.7 Flash",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 1000000,
+      "maxOutput": 32768
+    },
+    {
+      "id": "Qwen/Qwen3.6-Max-Preview",
+      "name": "Qwen 3.6 Max Preview",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 1000000,
+      "maxOutput": 32768
+    },
+    {
+      "id": "Qwen/Qwen3.6-Plus",
+      "name": "Qwen 3.6 Plus",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 1000000,
+      "maxOutput": 32768
+    },
+    {
+      "id": "meituan/LongCat-2.0:free",
+      "name": "LongCat 2.0",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 1048576,
+      "maxOutput": 32000
+    },
+    {
+      "id": "stepfun/Step-3.7-Flash",
+      "name": "Step 3.7 Flash",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 256000,
+      "maxOutput": 256000
+    },
+    {
+      "id": "stepfun/Step-3.5-Flash",
+      "name": "Step 3.5 Flash",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 1000000,
+      "maxOutput": 256000
+    },
+    {
+      "id": "tencent/hy3-paid",
+      "name": "Tencent Hy3",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 262144,
+      "maxOutput": 32000
+    },
+    {
+      "id": "tencent/hy4-preview",
+      "name": "Tencent Hy4 Preview",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "efforts": [
+        "low",
+        "medium",
+        "high"
+      ],
+      "context": 1048576,
+      "maxOutput": 64000
+    },
+    {
+      "id": "nvidia/nemotron-3-ultra-550b-a55b",
+      "name": "Nemotron 3 Ultra",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 1000000,
+      "maxOutput": 65536
+    },
+    {
+      "id": "thinkingmachines/inkling",
+      "name": "Inkling",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 256000,
+      "maxOutput": 65536
+    },
+    {
+      "id": "thinkingmachines/inkling-small",
+      "name": "Inkling Small",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "context": 1000000,
+      "maxOutput": 32768
+    },
+    {
+      "id": "poolside/laguna-s-2.1-free",
+      "name": "Laguna S 2.1",
+      "reasoning": true,
+      "inputModalities": [
+        "text"
+      ],
+      "context": 256000,
+      "maxOutput": 32768
+    },
+    {
+      "id": "gpt-5.6-luna",
+      "name": "GPT-5.6 Luna",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "low",
+        "medium",
+        "high",
+        "xhigh",
+        "max"
+      ],
+      "context": 1050000,
+      "maxOutput": 128000
+    },
+    {
+      "id": "meta/muse-spark-1.2-contributor",
+      "name": "Muse Spark 1.2 Contributor",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "low",
+        "medium",
+        "high",
+        "xhigh"
+      ],
+      "context": 1048576,
+      "maxOutput": 131072
+    },
+    {
+      "id": "meta/muse-spark-1.3-contributor",
+      "name": "Muse Spark 1.3 Contributor",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "low",
+        "medium",
+        "high",
+        "xhigh"
+      ],
+      "context": 1048576,
+      "maxOutput": 131072
+    },
+    {
+      "id": "xai/grok-4.5",
+      "name": "Grok 4.5",
+      "reasoning": true,
+      "inputModalities": [
+        "text",
+        "image"
+      ],
+      "efforts": [
+        "low",
+        "medium",
+        "high"
+      ],
+      "context": 500000,
+      "maxOutput": 500000
+    }
+  ]
+}

package/dist/models/urls.d.ts

@@ -0,0 +1,39 @@
+/**
+ * modelsUrls 覆盖解析（契约：docs/spec/model-pipeline.md §1.3 覆盖机制条款 +
+ * docs/research/models-url-override.md §4 定案）。
+ *
+ * 三通道优先级 config > env > 默认列表，语义为**整列表替换**——解析结果完整取代
+ * 内置列表，不拼接不插位；包内快照不占列表位（快照兜底归 pipeline 的降级层，
+ * 不经本函数）。非法值逐项校验：可解析且 http/https 的绝对 URL，非法项丢弃 +
+ * 逐项 warn；值为非数组/非字符串或合法项为零时整体回退默认列表 + warn（config
+ * 非法 → 试 env → 仍非法 → 默认，每级 warn）。任何路径不抛错、不阻断启动。
+ *
+ * 本函数为纯解析：`config` / `env` 以参数注入直测（models-url-override.md §3.2
+ * 纪律——测试不使用 COMMANDCODE_MODELS_URLS 变量本身，保证「变量存在 ≠ 测试后门」）；
+ * 生产侧由 pipeline 构造时传入 `process.env.COMMANDCODE_MODELS_URLS` 原值。
+ */
+/** 内置默认 URL 列表（ADR 0001：Release → npmmirror files → unpkg → raw data 分支） */
+export declare const DEFAULT_MODELS_URLS: readonly string[];
+/** 统一环境变量兜底通道（逗号分隔；用户配置面，非测试通道） */
+export declare const MODELS_URLS_ENV_VAR = "COMMANDCODE_MODELS_URLS";
+/** 解析结果来源：命中哪个通道 */
+export type ModelsUrlsSource = "config" | "env" | "default";
+/** 结构上与 disguise 的 DisguiseLogger 同形；有意不跨模块共享类型——models 对
+ * disguise 保持零依赖，glue 注入同一个适配器即可同时满足两边 */
+export interface ModelsUrlsLogger {
+    debug(message: string): void;
+    warn(message: string): void;
+}
+export interface ResolvedModelsUrls {
+    readonly urls: readonly string[];
+    readonly source: ModelsUrlsSource;
+}
+export interface ResolveModelsUrlsInput {
+    /** config 通道原样值：v1 工厂 options.modelsUrls / v2 settings 透传的顶层键，未解析 */
+    readonly config?: unknown;
+    /** env 通道原值（process.env[MODELS_URLS_ENV_VAR]）；undefined = 未设置，空串视为未配置 */
+    readonly env?: string | undefined;
+    readonly logger: ModelsUrlsLogger;
+}
+/** 解析 modelsUrls：绝不抛错，任何非法输入都落到某个可用列表上 */
+export declare function resolveModelsUrls(input: ResolveModelsUrlsInput): ResolvedModelsUrls;

package/dist/models/urls.js

@@ -0,0 +1,96 @@
+/**
+ * modelsUrls 覆盖解析（契约：docs/spec/model-pipeline.md §1.3 覆盖机制条款 +
+ * docs/research/models-url-override.md §4 定案）。
+ *
+ * 三通道优先级 config > env > 默认列表，语义为**整列表替换**——解析结果完整取代
+ * 内置列表，不拼接不插位；包内快照不占列表位（快照兜底归 pipeline 的降级层，
+ * 不经本函数）。非法值逐项校验：可解析且 http/https 的绝对 URL，非法项丢弃 +
+ * 逐项 warn；值为非数组/非字符串或合法项为零时整体回退默认列表 + warn（config
+ * 非法 → 试 env → 仍非法 → 默认，每级 warn）。任何路径不抛错、不阻断启动。
+ *
+ * 本函数为纯解析：`config` / `env` 以参数注入直测（models-url-override.md §3.2
+ * 纪律——测试不使用 COMMANDCODE_MODELS_URLS 变量本身，保证「变量存在 ≠ 测试后门」）；
+ * 生产侧由 pipeline 构造时传入 `process.env.COMMANDCODE_MODELS_URLS` 原值。
+ */
+/** 内置默认 URL 列表（ADR 0001：Release → npmmirror files → unpkg → raw data 分支） */
+export const DEFAULT_MODELS_URLS = [
+    "https://github.com/WallBreakerNO4/opencode-commandcode-provider/releases/latest/download/models.json",
+    "https://registry.npmmirror.com/@wallbreakerno4/opencode-commandcode-models/latest/files/models.json",
+    "https://unpkg.com/@wallbreakerno4/opencode-commandcode-models@latest/models.json",
+    "https://raw.githubusercontent.com/WallBreakerNO4/opencode-commandcode-provider/data/models.json",
+];
+/** 统一环境变量兜底通道（逗号分隔；用户配置面，非测试通道） */
+export const MODELS_URLS_ENV_VAR = "COMMANDCODE_MODELS_URLS";
+/** 解析 modelsUrls：绝不抛错，任何非法输入都落到某个可用列表上 */
+export function resolveModelsUrls(input) {
+    const configParsed = parseUrlList(input.config, input.logger);
+    if (configParsed !== null) {
+        input.logger.debug(`modelsUrls 生效来源=config，URL 列表：[${configParsed.join("，")}]`);
+        return { urls: configParsed, source: "config" };
+    }
+    // env 未设置/空串静默跳过（视为未配置）；设了但整体非法才 warn 并逐级回退
+    const envValue = input.env?.trim();
+    if (envValue !== undefined && envValue.length > 0) {
+        const envParsed = parseUrlList(envValue, input.logger);
+        if (envParsed !== null) {
+            input.logger.debug(`modelsUrls 生效来源=env，URL 列表：[${envParsed.join("，")}]`);
+            return { urls: envParsed, source: "env" };
+        }
+    }
+    input.logger.debug(`modelsUrls 生效来源=default，URL 列表：[${DEFAULT_MODELS_URLS.join("，")}]`);
+    return { urls: DEFAULT_MODELS_URLS, source: "default" };
+}
+/**
+ * 单通道值解析：数组或逗号分隔字符串 → 合法 URL 列表。
+ * 逐项校验，非法项丢弃 + 逐项 warn；整体非法（非数组/非字符串、合法项为零）
+ * warn 一次并返回 null（调用方逐级回退）。
+ * 返回 null 只代表「该通道整体不可用」——通道内仍有合法项时不回退（逐项丢弃 ≠ 整体回退）。
+ */
+function parseUrlList(value, logger) {
+    if (value === undefined)
+        return null;
+    // 逗号分隔字符串先滤掉空段再进循环："a,,b"、尾逗号是格式噪音，静默跳过；
+    // 数组不经预滤——显式写出的空串/空格串是用户笔误，照常 warn
+    const rawItems = typeof value === "string"
+        ? value.split(",").filter((segment) => segment.trim().length > 0)
+        : Array.isArray(value)
+            ? value
+            : null;
+    if (rawItems === null) {
+        logger.warn(`modelsUrls 值非法（${preview(value)}）：须为 URL 数组或逗号分隔字符串，回退内置默认列表`);
+        return null;
+    }
+    const urls = [];
+    for (const [index, raw] of rawItems.entries()) {
+        const item = typeof raw === "string" ? raw.trim() : undefined;
+        if (item === undefined || item.length === 0) {
+            logger.warn(`modelsUrls[${index}] 非法项已丢弃（${preview(raw)}）：须为 http(s) 绝对 URL 字符串`);
+            continue;
+        }
+        if (!isHttpUrl(item)) {
+            logger.warn(`modelsUrls[${index}] 非法项已丢弃：「${item}」：须为 http(s) 绝对 URL`);
+            continue;
+        }
+        urls.push(item);
+    }
+    if (urls.length === 0) {
+        logger.warn(`modelsUrls 值非法（${preview(value)}）：合法项为零，回退内置默认列表`);
+        return null;
+    }
+    return urls;
+}
+/** http/https 绝对 URL 校验（§1.3：可解析且协议为 http:/https:） */
+function isHttpUrl(item) {
+    try {
+        const url = new URL(item);
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+/** 原值预览：warn 里注明被回退的原始值（截断防日志爆炸） */
+function preview(value) {
+    const text = typeof value === "string" ? value : JSON.stringify(value) ?? String(value);
+    return text.length > 80 ? `${text.slice(0, 80)}…` : text;
+}