dsh-decision-engine 0.6.0 → 0.7.0

package/lib/providers.js

@@ -32,10 +32,13 @@
 /**
  * 可选的 provider 标识。
  *
- * `systemone` / `bamboonode` 是内置预设（默认地址与参数由本模块提供）；
- * `custom` 使用用户在设置界面填写的 base URL 与鉴权信息。
+ * `systemone` / `bamboonode` / `siliconflow` / `siliconflow-intl` 是内置预设
+ *（默认地址与参数由本模块提供）；`custom` 使用用户在设置界面填写的
+ * base URL 与鉴权信息。
+ *
+ * 顺序即设置界面下拉的顺序：常用项在前，`custom` 收尾（它要填的东西最多）。
  */
-export const PROVIDER_IDS = ["systemone", "bamboonode", "custom"];
+export const PROVIDER_IDS = ["systemone", "bamboonode", "siliconflow", "siliconflow-intl", "custom"];
 
 /** 默认 provider。刻意选 bamboonode：老用户的 `startlux.yml` 里没有 provider 键，
  *  必须继续走原来的地址与端点风格，升级不能改变既有行为。 */
@@ -44,15 +47,26 @@ export const DEFAULT_PROVIDER = "bamboonode";
 /**
  * 自定义 base URL 的端点风格。
  *
- *   auto       已指向 /decisions 或 /systemone 就原样用，否则按 decisions 补
+ *   auto       已指向 /decisions 或 /systemone 就原样用，否则先试 decisions
  *   decisions  POST <base>/decisions
  *   systemone  POST <base>/systemone
+ *
+ * 注意：这是**首选**路径，不是唯一路径。路径后缀由服务商决定（实测
+ * SiliconFlow 的 Kev-4B 只通 /v1/systemone，bamboonode 两条都通），
+ * 因此 404 时会换另一条再试——见 endpointCandidates()。
  */
 export const ENDPOINT_STYLES = ["auto", "decisions", "systemone"];
 
 /** 端点风格 → 追加的路径段。 */
 const STYLE_SEGMENT = { decisions: "decisions", systemone: "systemone" };
 
+/**
+ * 两条路径风格互为「另一条」。
+ *
+ * 用于 404 回退：路径不存在时换另一条再试一次。
+ */
+const ALTERNATE_STYLE = { decisions: "systemone", systemone: "decisions" };
+
 /**
  * 合法的思考模式（与 startlux 服务的 `think_mode` 取值一致）。
  *
@@ -91,7 +105,22 @@ export function normalizeThinkMode(raw) {
  * 内置预设。
  *
  * 每个预设必须给出：显示名称、默认 base URL、端点风格、环境变量名、
- * 默认模型提示。用户选了预设就用这里的值，不需要在设置界面重复填写。
+ * 默认模型与三个配置字段名。用户选了预设就用这里的值，不需要在设置界面
+ * 重复填写。
+ *
+ * 两个可选标记（都是「按服务商实测」得出的，不是风格偏好）：
+ *
+ *   - `requiresModel: true`：该端点**不接受**省略 model 的请求（实测
+ *     SiliconFlow 的 /v1/systemone 省略或空串都回 400
+ *     `Model field is required.`）。这类预设在模型留空时回落到
+ *     `defaultModel`，而不是沿用「留空 = 省略字段」的通用规则——
+ *     那会导致一次注定 400 的请求，而守卫是 fail-open 的，表现为静默失效。
+ *     其余服务商（bamboonode / system one）省略 model 会由服务端回填默认
+ *     模型，保留省略语义才能在它们改名时不失效。
+ *   - `knownModels`：该服务 `/v1/models` 会一并返回大量**非决策**模型且不带
+ *     `supported_endpoint_types`（实测 SiliconFlow 返回 98 个，其中 chat
+ *     模型打到 /v1/systemone 是 400 `Model does not exist.`）。
+ *     列了这份清单就按它筛，不让下拉里出现「选了就失败」的选项。
  */
 export const PROVIDER_PRESETS = {
   systemone: {
@@ -132,6 +161,55 @@ export const PROVIDER_PRESETS = {
     hint: "StartLux 官方端点（POST /v1/decisions），本插件的原有默认值",
     hintEn: "StartLux official endpoint (POST /v1/decisions); the original default",
   },
+  siliconflow: {
+    id: "siliconflow",
+    label: "硅基流动",
+    labelEn: "SiliconFlow",
+    baseUrl: "https://api.siliconflow.cn/v1",
+    // 实测（2026-10-25，真实 key）：该站只认 /systemone，/v1/decisions 回 404。
+    // 因此这里直接给 systemone，不必让 404 回退先烧一次请求。
+    endpointStyle: "systemone",
+    // 两个 SiliconFlow 站点是**两套账号**，key 互不通用，因此各占一格。
+    apiKeyEnv: "SILICONFLOW_API_KEY",
+    legacyApiKeyEnvs: [],
+    keyField: "siliconflowApiKey",
+    // 实测省略 model 会 400 `Model field is required.`，而 bamboonode 省略会
+    // 由服务端回填默认模型。因此这个 provider 必须**总带着一个模型名**——
+    // 留空时回落到下面的 defaultModel，而不是省略字段（见 resolveProvider）。
+    // 这正是「只填一个 API key 就能用」的前提：模型名是预设给好的。
+    requiresModel: true,
+    // /v1/models 里这条就叫 Kev-4B（官方文档两处分别写作 Kev-4b 与 Kev-4B，
+    // 实测三种大小写都 200），取服务返回的写法，免得下拉里出现两条同模型。
+    defaultModel: "Kev-4B",
+    // 官方只支持这两个决策模型；/v1/models 却会一并返回 98 个 chat 模型且
+    // 不带 supported_endpoint_types（实测把 chat 模型打过来是 400
+    // `Model does not exist.`），所以按这份清单筛，不让下拉里出现选了就坏的项。
+    knownModels: ["Kev-4B", "SemIf"],
+    modelField: "siliconflowModel",
+    keyEnvField: "siliconflowApiKeyEnv",
+    hint: "硅基流动（国内站）的 System One 端点（POST /v1/systemone）；可用模型 Kev-4B / SemIf，默认 Kev-4B，只填一个 API key 即可使用",
+    hintEn: "SiliconFlow China (POST /v1/systemone); models Kev-4B / SemIf, default Kev-4B — just add an API key",
+  },
+  "siliconflow-intl": {
+    id: "siliconflow-intl",
+    label: "Silicon Flow",
+    labelEn: "Silicon Flow",
+    baseUrl: "https://api.siliconflow.com/v1",
+    // 同样只认 /systemone：实测打 /v1/decisions 回 404 Not Found。
+    endpointStyle: "systemone",
+    // 与国内站分开：两套账号的 key 不能共用一格，否则切过去就 401，
+    // 而用户看不出是「拿错了 key」还是「key 失效」。
+    apiKeyEnv: "SILICONFLOW_INTL_API_KEY",
+    legacyApiKeyEnvs: [],
+    keyField: "siliconflowIntlApiKey",
+    requiresModel: true,
+    defaultModel: "Kev-4B",
+    knownModels: ["Kev-4B", "SemIf"],
+    modelField: "siliconflowIntlModel",
+    keyEnvField: "siliconflowIntlApiKeyEnv",
+    hint: "Silicon Flow（国际站）的 System One 端点（POST /v1/systemone）；与国内站账号不通用，可用模型 Kev-4B / SemIf，默认 Kev-4B，只填一个 API key 即可使用",
+    hintEn: "Silicon Flow global (POST /v1/systemone); separate account from the CN site, models Kev-4B / SemIf, default Kev-4B — just add an API key",
+  },
   custom: {
     id: "custom",
     label: "custom",
@@ -259,6 +337,61 @@ export function buildEndpoint(baseUrl, style = "decisions") {
   return url.toString();
 }
 
+/**
+ * 列出「同一个 base URL 下所有值得一试的端点」，按优先级排列。
+ *
+ * 背景（2026-10-25 实测）：路径后缀由**服务商**决定，不由模型决定——
+ * SiliconFlow 的 Kev-4B 只认 `/v1/systemone`（`/v1/decisions` 回 404），
+ * 而 bamboonode 的决策模型两条路径都能用。因此「只拼一条路径」在换服务商
+ * 时必然踩空，而守卫是 fail-open 的，踩空表现为**静默失效**。
+ *
+ * 候选规则：
+ *
+ *   - 地址**已自带**端点段（`.../v1/decisions` 或 `.../v1/systemone`）→
+ *     只返回它自己。用户填了完整端点就是明确决定，不该被自动改写。
+ *   - `auto` → 先试 `decisions`（与历史行为一致），再试 `systemone`。
+ *   - 显式 `decisions` / `systemone` → 先试它自己，**再试另一条**。
+ *
+ * 最后一条是关键：显式指定只是「首选」，不是「唯一」。显式指定错路径时
+ * 同样会 404，届时仍应回退到另一条——否则「选错了就只能手动改」这种
+ * 死胡同会被用户当成插件的 bug。
+ *
+ * @param baseUrl - base URL。
+ * @param style - `decisions` / `systemone` / `auto`。
+ * @returns 候选端点数组（去重，优先级从高到低）。
+ */
+export function endpointCandidates(baseUrl, style = "auto") {
+  const normalized = normalizeBaseUrl(baseUrl);
+  if (normalized.length === 0) return [];
+  // 用户填了完整端点：原样用，不追加任何候选。
+  let path = "";
+  try {
+    path = new URL(normalized).pathname.replace(/\/+$/, "");
+  } catch {
+    // 非法 URL：交给调用方去报错，这里不构造候选。
+    return [];
+  }
+  if (endpointStyleOfPath(path) !== undefined) {
+    return [buildEndpoint(normalized, style)];
+  }
+  const primary = style === "auto" ? "decisions" : style === "systemone" ? "systemone" : "decisions";
+  const secondary = ALTERNATE_STYLE[primary];
+  const out = [buildEndpoint(normalized, primary)];
+  const other = buildEndpoint(normalized, secondary);
+  if (!out.includes(other)) out.push(other);
+  return out;
+}
+
+/**
+ * 端点风格 → 它对应的路径段（用于回显「当前用的是哪条路径」）。
+ *
+ * @param style - 风格取值。
+ * @returns `decisions` / `systemone`；无法识别时返回 "decisions"。
+ */
+export function styleSegment(style) {
+  return STYLE_SEGMENT[style] ?? "decisions";
+}
+
 /**
  * 解析 `customHeaders` 配置。
  *
@@ -324,6 +457,8 @@ export function resolveProvider(cfg = {}) {
       source: "custom",
       baseUrl,
       endpoint: checked.ok ? buildEndpoint(baseUrl, style) : "",
+      // 候选端点（按优先级）：404 时按顺序换下一条再试。
+      candidates: checked.ok ? endpointCandidates(baseUrl, style) : [],
       endpointStyle: style,
       model,
       defaultModel: "",
@@ -349,7 +484,17 @@ export function resolveProvider(cfg = {}) {
   // `systemoneModel` 属于 system one。共用一格会把 bamboonode 的模型名发给
   // TypeSafe，得到 400 `model not served`——「切 provider 就坏」的典型来源。
   const modelField = preset.modelField;
-  const model = typeof cfg[modelField] === "string" ? cfg[modelField].trim() : "";
+  const rawModel = typeof cfg[modelField] === "string" ? cfg[modelField].trim() : "";
+  // 模型留空有两种含义，取决于该服务商的端点接不接受「不带 model」的请求：
+  //
+  //   - requiresModel（SiliconFlow 实测）：省略或空串都回 400
+  //     `Model field is required.`，因此留空必须回落到预设的 defaultModel
+  //     ——不发一个注定失败的请求，守卫才不会又一次静默失效。
+  //   - 其余服务商：留空 = 省略字段，由服务端回填默认模型。保留省略语义，
+  //     服务商将来给模型改名时本配置不会失效（反过来把模型名钉死在这里
+  //     才是最脆的那种配法）。
+  const model =
+    rawModel.length > 0 ? rawModel : preset.requiresModel === true ? preset.defaultModel : "";
   // 密钥变量名：`apiKeyEnv` 是**历史字段**，只对 bamboonode 有覆盖意义
   //（老版本只有这一个 provider，用户可能已经在里面写了自己的变量名）。
   // 若让它参与 system one 的解析，会盖掉 TYPESAFE_API_KEY——切到 system one
@@ -371,6 +516,9 @@ export function resolveProvider(cfg = {}) {
     source: legacyBase.length > 0 ? "legacy" : "preset",
     baseUrl: checked.ok ? checked.value : baseUrl,
     endpoint: checked.ok ? buildEndpoint(baseUrl, preset.endpointStyle) : "",
+    // 候选端点（按优先级）：预设自己的路径优先，404 时换另一条再试。
+    // 实测 bamboonode 两条路径都通，SiliconFlow 只通 /systemone。
+    candidates: checked.ok ? endpointCandidates(baseUrl, preset.endpointStyle) : [],
     endpointStyle: preset.endpointStyle,
     model,
     defaultModel: preset.defaultModel,
@@ -471,8 +619,11 @@ export function buildRequestBody(provider, payload) {
  * 供设置界面展示的 provider 清单。
  *
  * 由服务端下发而不是前端硬编码：新增预设只改本文件一处，界面自动多一个选项。
+ * `keyField` / `modelField` 也一并下发——界面写回配置时必须知道「这一格在
+ * config.yml 里叫什么」，而这个名字只有预设表知道；让前端自己再抄一份，
+ * 就是「界面显示存到 A、实际写进 B」这种最难自查的偏差。
  *
- * @returns 每个预设的 id / 显示名 / 默认地址 / 说明。
+ * @returns 每个预设的 id / 显示名 / 默认地址 / 字段名 / 说明。
  */
 export function providerCatalog() {
   return PROVIDER_IDS.map((id) => {
@@ -489,6 +640,14 @@ export function providerCatalog() {
       // 界面用它说明「key 存在配置文件的哪一格」——只报变量名会让人
       // 以为 key 在 .credentials.yaml 里，而实际生效的可能是配置文件。
       keyField: preset.keyField,
+      // 该 provider 的模型字段名（`model` / `systemoneModel` / …）。
+      // 模型输入框按它写回配置，切 provider 不会把 A 的模型名写进 B 那一格。
+      modelField: preset.modelField,
+      // 「模型」那一行的语义全靠这两项：端点是否强制要 model（决定留空的
+      // 写法是「预设默认」还是「服务端默认」），以及能选的模型有哪些。
+      // 都由预设表下发，前端不必知道任何一家服务商的脾气。
+      requiresModel: preset.requiresModel === true,
+      knownModels: [...(preset.knownModels ?? [])],
       hint: preset.hint,
       hintEn: preset.hintEn,
       customizable: id === "custom",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-decision-engine",
-  "version": "0.6.0",
-  "description": "dsh-decision-engine: a cheap judgement layer for DeepSeek Harness — all nine decision points (tool authorization, model routing, delegation, compaction, turn continuation, retrieval, skill pick, session title, COT translation) are implemented and individually switchable, and it works against any system-one style API (system one, bamboonode, or a custom base URL).",
+  "version": "0.7.0",
+  "description": "dsh-decision-engine: a cheap judgement layer for DeepSeek Harness — all nine decision points (tool authorization, model routing, delegation, compaction, turn continuation, retrieval, skill pick, session title, COT translation) are implemented and individually switchable, and it works against any system-one style API (system one, bamboonode, SiliconFlow / Silicon Flow, or a custom base URL).",
   "icon": "./icon.svg",
   "type": "module",
   "main": "lib/index.js",
@@ -36,6 +36,9 @@
     "system-1",
     "typesafe",
     "jev",
+    "siliconflow",
+    "siliconflow-cn",
+    "kev-4b",
     "provider",
     "custom-base-url",
     "tool-approval",

package/lib/budget.js

@@ -1,92 +0,0 @@
-/**
- * 决策模型自身的 token 预算。
- *
- * 引入理由：StartLux 每次决策实测约 1,900 token，p50 延迟约 2 秒。
- * 把这个判断层挂到多个决策点上，调用量会成倍上升——如果不设上限，
- * 「省 token 的插件」反而会变成主要的 token 消耗方。
- *
- * 预算按滑动窗口统计（默认 1 小时）。一旦超限，所有决策点立刻退回
- * 本地启发式并 fail-open，等窗口滚过去自动恢复；不需要重启，也不会
- * 让工具调用被卡住。
- */
-export class TokenBudget {
-  /**
-   * @param getLimitTokens - 返回当前上限的取值函数；0 表示不限制。
-   *   刻意接收函数而不是数值：本插件的原则是「配置每次现读」，
-   *   若在构造时固化，用户在配置页改了预算就得重启才生效。
-   * @param getWindowMs - 返回当前窗口长度的取值函数。
-   */
-  constructor(getLimitTokens, getWindowMs) {
-    this.getLimitTokens = getLimitTokens;
-    this.getWindowMs = getWindowMs;
-    /** @type {Array<{at: number, tokens: number}>} */
-    this.entries = [];
-    this.blocked = 0;
-  }
-
-  /** 当前生效的上限（读不到时按不限制处理，绝不因预算自身出错而卡住决策）。 */
-  get limitTokens() {
-    const raw = typeof this.getLimitTokens === "function" ? this.getLimitTokens() : this.getLimitTokens;
-    const value = Number(raw);
-    return Number.isFinite(value) && value > 0 ? value : 0;
-  }
-
-  /** 当前生效的窗口长度。 */
-  get windowMs() {
-    const raw = typeof this.getWindowMs === "function" ? this.getWindowMs() : this.getWindowMs;
-    const value = Number(raw);
-    return Number.isFinite(value) && value > 0 ? value : 3600000;
-  }
-
-  /** 丢弃窗口外的记录。 */
-  prune(now = Date.now()) {
-    const cutoff = now - this.windowMs;
-    let drop = 0;
-    while (drop < this.entries.length && this.entries[drop].at < cutoff) drop += 1;
-    if (drop > 0) this.entries.splice(0, drop);
-  }
-
-  /** 窗口内已消耗的 token。 */
-  used(now = Date.now()) {
-    this.prune(now);
-    let total = 0;
-    for (const entry of this.entries) total += entry.tokens;
-    return total;
-  }
-
-  /** 预算是否已耗尽（未设置上限时永远 false）。 */
-  exhausted(now = Date.now()) {
-    if (this.limitTokens <= 0) return false;
-    return this.used(now) >= this.limitTokens;
-  }
-
-  /**
-   * 记一次消耗。
-   * @param tokens - 本次估算或实测的 input token 数。
-   */
-  spend(tokens) {
-    const amount = Number.isFinite(tokens) && tokens > 0 ? tokens : 0;
-    if (amount === 0) return;
-    this.entries.push({ at: Date.now(), tokens: amount });
-  }
-
-  /** 记一次「因为预算耗尽而放弃判断」，用于配置页展示。 */
-  noteBlocked() {
-    this.blocked += 1;
-  }
-
-  /** 供 UI 展示的快照。 */
-  get report() {
-    const now = Date.now();
-    const used = this.used(now);
-    const limit = this.limitTokens;
-    return {
-      used,
-      limit,
-      windowMs: this.windowMs,
-      remaining: limit <= 0 ? null : Math.max(0, limit - used),
-      exhausted: this.exhausted(now),
-      blocked: this.blocked,
-    };
-  }
-}