dsh-decision-engine 0.6.1 → 0.7.0

package/README.md

@@ -104,14 +104,14 @@ Windows 允许点开头的目录。真正与平台相关的是分隔符与家目
 - 选 `custom` 时展开四个字段：`Base URL`（必填）、`端点风格`、`附加请求头`、`密钥变量名`
 - 一个 `测试端点` 按钮（回显 provider、实际 POST 的完整地址、HTTP 码、请求 id 与响应体）
 - **决策模型参与点**列表：每个决策点一行，右侧是 `关闭 / 观察 / 生效` 三态
-- `自身 token 预算` 输入框，以及实时的缓存命中率与每个点的 token / 延迟统计
+- 实时的缓存命中率与每个点的 token / 延迟统计
 
 **改完即保存，没有「保存」按钮**：开关 / 下拉 / 分段控件点一下就落盘；文本框
-（地址、请求头、预算）停手约 0.7 秒或失焦后落盘；API Key 只在**失焦或回车**
+（地址、请求头）停手约 0.7 秒或失焦后落盘；API Key 只在**失焦或回车**
 时落盘（避免把打字途中的半截 key 写进凭据文件）。底部状态行实时显示
 `待保存… / 保存中… / 已保存 / 未保存：原因`，失败时附「重试」。落盘即写入
 `config.yml`，**不需要重启**：监听器常驻注册，provider 与模式在每次调用时现读；
-预算与缓存参数同样是取值函数而非启动期快照。
+缓存参数同样是取值函数而非启动期快照。
 
 一个例外：选 `custom` 但 `Base URL` 还没填或不合法时，配置改动会**整体延后**
 （状态行给出原因），地址补全后自动落盘；此时决策点改动不受影响，照常保存。
@@ -131,16 +131,26 @@ content-type: application/json
 响应只需含 `answers`（`model` / `usage` 可选）。因此 provider 只决定三件事：
 **往哪发、用谁的 key、默认哪个模型**。
 
-### 三个选项
+### 五个选项
 
 | provider | 默认地址 | 端点 | 密钥名 | 默认模型 |
 |---|---|---|---|---|
 | `system one` | `https://api.typesafe.ai/v1` | `/v1/systemone` | `TYPESAFE_API_KEY` | 服务端默认（`jev-latest`） |
 | `bamboonode` | `https://api.bamboonode.dev/v1` | `/v1/decisions` | `BAMBOO_API_KEY` | 服务端默认（`startlux-decision-27b-autothink`） |
+| `siliconflow`（硅基流动，国内站） | `https://api.siliconflow.cn/v1` | `/v1/systemone` | `SILICONFLOW_API_KEY` | `Kev-4B`（可改 `SemIf`） |
+| `siliconflow-intl`（Silicon Flow，国际站） | `https://api.siliconflow.com/v1` | `/v1/systemone` | `SILICONFLOW_INTL_API_KEY` | `Kev-4B`（可改 `SemIf`） |
 | `custom` | 用户填写（必填） | 按 `端点风格` 拼 | `customApiKeyEnv`（缺省 `DECISION_ENGINE_CUSTOM_KEY`） | `customModel` |
 
-**每个 provider 有各自的 key 名，各自保存各自的 key。** 三者互不覆盖，
-可以同时配好三套凭据；切换 provider 不会串用别人的 key。
+> 硅基流动两个站点的接入文档：
+> [国内站 api-docs.siliconflow.cn](https://api-docs.siliconflow.cn/docs/api/systemone-post) ·
+> [国际站 docs.siliconflow.com](https://docs.siliconflow.com/en/api-reference/systemone/create-systemone)
+
+**开箱即用**：`siliconflow` / `siliconflow-intl` 只需要粘一个 API key——地址、
+路径（`/systemone`）、默认模型（`Kev-4B`）都已预置。两个站点是**两套账号**，
+key 互不通用，所以各占一格。
+
+**每个 provider 有各自的 key 名，各自保存各自的 key。** 五者互不覆盖，
+可以同时配好五套凭据；切换 provider 不会串用别人的 key。
 
 不写 `provider` 时等于 `bamboonode`，**老配置行为完全不变**。
 
@@ -150,8 +160,20 @@ content-type: application/json
 |---|---|---|
 | `bamboonode` | `model` | 与历史一致（留空即服务端默认） |
 | `system one` | `systemoneModel` | 留空 = 服务端默认（`jev-latest`） |
+| `siliconflow` | `siliconflowModel` | 留空 = 预设默认 `Kev-4B` |
+| `siliconflow-intl` | `siliconflowIntlModel` | 留空 = 预设默认 `Kev-4B` |
 | `custom` | `customModel` | 留空 = 服务端默认 |
 
+> ⚠️ 两个 SiliconFlow 端点把 `model` 列为**必填**（实测省略或空串都回
+> `400 {"code":20013,"message":"Model field is required."}`），所以它们的
+> 「留空」不是「让服务端挑」，而是用预设默认 `Kev-4B`；想换模型填 `SemIf`。
+> 官方目前只支持这两个决策模型，界面上的模型下拉也只列这两个——
+> `/v1/models` 会返回 98 个模型，但 chat 模型打到 `/systemone` 会
+> `400 Model does not exist.`，列出来就是「选了就失败」。
+>
+> 模型名**大小写不敏感**：`kev-4b` / `Kev-4b` / `Kev-4B` 实测都 200，
+> 配置里三种写法等价。
+
 ### custom：填写方式与限制
 
 在设置界面选 `custom` 后需要填：
@@ -213,7 +235,8 @@ content-type: application/json
 - 保存后再次打开配置页按服务端返回的状态回显（不缓存、不推断），custom 的字段
   除密钥明文外全部回显。
 - 密钥优先级：该 provider 的显式 key（`systemoneApiKey` / `bamboonodeApiKey` /
-  `customApiKey`）> 密钥存储位置上对应的键 > 环境变量。
+  `siliconflowApiKey` / `siliconflowIntlApiKey` / `customApiKey`）>
+  密钥存储位置上对应的键 > 环境变量。
 - 旧的单一 `apiKey` 字段只对 `bamboonode` 生效（历史兼容）。
 
 ### 密钥保存位置
@@ -231,7 +254,7 @@ content-type: application/json
 写入 `credentials` 的行为约束：
 
 - **只改 `refs:` 段**，`records:`（DSH 的授权记录，含嵌套结构）与注释逐字保留；
-- 键名就是该 provider 自己的名字，所以三套 key 能同时存在、互不覆盖；
+- 键名就是该 provider 自己的名字，所以五套 key 能同时存在、互不覆盖；
 - 传空值等于**删除**该键（清空即撤销，不留空壳行）；
 - 文件权限固定 `600`；
 - 写入失败会整体报错，不会出现"配置说存了、实际没存"。
@@ -314,11 +337,9 @@ content-type: application/json
 决策点（注册表里标了 `hotPath`，配置页显示「热路径」角标）都带明确的触发闸，
 不能无条件调用。
 
-同时有两道护栏兜底：
-
-- **自身预算**（`budgetTokens`，默认每小时 40 万）：超限后所有决策点自动退回
-  启发式并放行。省钱的东西不能反过来成为主要消耗方。
-- **双层缓存**：见下节。
+护栏是**双层缓存**（见下节）：命中缓存就不发请求，把热路径上的重复调用挡掉。
+本插件不设每小时的 token 预算——一次决策约 1.9k token，命中缓存后几乎为零，
+不值得用「超限即停止判断」的方式省，那会让守卫在最需要它的时刻失效。
 
 ## 模型选择
 
@@ -348,12 +369,18 @@ chat 模型，拿去打 `/v1/decisions` 会 400 `model ... is not served by this
 模型）。因此这两种 provider 改为「有类型就按类型过滤，没类型就全收」，下拉里也
 仍可手填。
 
+对 `siliconflow` / `siliconflow-intl`：它们的 `/v1/models` 返回 **98 个**模型、
+**没有一条**带 `supported_endpoint_types`，而决策端点只认 `Kev-4B` / `SemIf`
+（chat 模型打过去是 400 `Model does not exist.`）。类型过滤拿不到任何线索，
+全收又等于「96 个选了就失败的选项」，因此按预设里的 `knownModels` 白名单筛，
+下拉里只列这两个。
+
 ## 超时与自动回退
 
 每次请求都带**硬超时**（默认 8000ms），超时不是错误，而是降级放行：
 
 ```
-AbortSignal.timeout(budget) → 超时 → degrade("timeout") → 钩子 next() 放行
+AbortSignal.timeout(timeoutMs) → 超时 → degrade("timeout") → 钩子 next() 放行
 ```
 
 三层保护，保证守卫永远不会拖住工具执行：
@@ -388,7 +415,7 @@ AbortSignal.timeout(budget) → 超时 → degrade("timeout") → 钩子 next()
 | 命中失败冷却 | `cooldown` |
 | 端点 4xx / 5xx | `http-404` / `http-500` 等（附 `endpoint`、`body`） |
 | 网络不可达 | `network-error` |
-| 超时 | `timeout`（附 `budgetMs`） |
+| 超时 | `timeout`（附 `timeoutMs`） |
 | 返回非 JSON / 非对象 | `invalid-json` / `invalid-response` |
 | 缺 `answers` 字段 | `missing-answers` |
 | provider 配置不可用（如 custom 的 base URL 非法） | `invalid-base-url`（附 `provider` 与原因） |
@@ -426,7 +453,7 @@ AbortSignal.timeout(budget) → 超时 → degrade("timeout") → 钩子 next()
 - **只读工具直接放行**：`read`/`grep`/`glob`/`todo_write` 等不发请求。
 - **state 截断**：`args` 走头尾摘要，`recent` 只带最近 4 条、每条 240 字符。
 - **失败冷却**：连续 3 次失败进入 60s 冷却，避免对着故障端点烧钱。
-- **自身预算**：`budgetTokens` 限制决策模型每小时的花费，超限自动退回启发式。
+- **双层缓存**：精确命中与同类复用都不发请求，热路径上的重复判断几乎零成本。
 - **默认只观察**：新决策点先跑 `observe`，确认与人工判断一致后再切 `enforce`。
 
 ## 验证链路

package/config.example.yml

@@ -36,14 +36,20 @@ mode: shadow
 # ============================================================================
 # 服务提供方（provider）
 # ============================================================================
-# 三选一：
-#   bamboonode  内置。StartLux 官方端点 POST /v1/decisions，本插件的原有默认值。
-#   systemone   内置。任意 System One 协议服务 POST /v1/systemone，
-#               默认指向 TypeSafe（https://api.typesafe.ai/v1）。
-#   custom      自己填 base URL，接任何 system-one 风格服务
-#               （自建 llama.cpp / vLLM、企业网关、第三方中转）。
+# 五选一：
+#   bamboonode        内置。StartLux 官方端点 POST /v1/decisions，本插件的原有默认值。
+#   systemone         内置。任意 System One 协议服务 POST /v1/systemone，
+#                     默认指向 TypeSafe（https://api.typesafe.ai/v1）。
+#   siliconflow       内置。硅基流动（国内站）https://api.siliconflow.cn/v1/systemone
+#   siliconflow-intl  内置。Silicon Flow 国际站 https://api.siliconflow.com/v1/systemone
+#                     （与国内站是两套账号，key 互不通用）
+#   custom            自己填 base URL，接任何 system-one 风格服务
+#                     （自建 llama.cpp / vLLM、企业网关、第三方中转）。
 #
 # 不写这一项 = bamboonode，老配置行为完全不变。
+#
+# siliconflow / siliconflow-intl 是「开箱即用」的：地址、路径、默认模型都已
+# 预置，只要粘一个 API key 就能跑（详见下方「密钥」一节）。
 provider: bamboonode
 
 # ---- bamboonode 预设的地址覆盖 ----------------------------------------------
@@ -66,6 +72,16 @@ model:
 # 得到 400 model not served。
 systemoneModel: ""
 
+# 硅基流动 / Silicon Flow 的模型。**留空 = 用预设默认 Kev-4B**——
+# 这两个端点把 model 列为必填（实测省略或空串都回 400
+# "Model field is required."），所以这里的「留空」不是「让服务端挑」，
+# 而是用预设默认。想换模型就填 SemIf（官方目前只支持这两个决策模型）。
+#
+# 你写的 kev-4b 与 Kev-4B 是同一个模型：实测该端点对大小写不敏感
+#（三种写法都 200），/v1/models 里的规范写法是 Kev-4B。
+siliconflowModel: ""
+siliconflowIntlModel: ""
+
 # ---- custom 预设（provider=custom 时才生效）--------------------------------
 # base URL 必填，且必须是 http/https 地址；不带 scheme 会被拒绝（内置预设
 # 允许省略 scheme，custom 不允许——自定义地址必须显式，避免猜错协议）。
@@ -99,11 +115,15 @@ customHeaders: ""
 # ============================================================================
 # 每个 provider 有**自己的** key 名，各自保存各自的 key：
 #
-#   system one -> TYPESAFE_API_KEY
-#   bamboonode -> BAMBOO_API_KEY
-#   custom     -> customApiKeyEnv（没填时用 DECISION_ENGINE_CUSTOM_KEY）
+#   system one          -> TYPESAFE_API_KEY
+#   bamboonode          -> BAMBOO_API_KEY
+#   硅基流动（国内站）   -> SILICONFLOW_API_KEY
+#   Silicon Flow 国际站 -> SILICONFLOW_INTL_API_KEY
+#   custom              -> customApiKeyEnv（没填时用 DECISION_ENGINE_CUSTOM_KEY）
 #
-# 三者互不覆盖，可以同时配好；切换 provider 不会串用别人的 key。
+# 五者互不覆盖，可以同时配好；切换 provider 不会串用别人的 key。
+# 两个 SiliconFlow 站点是**两套账号**，key 不通用，因此各占一格——
+# 共用一格的话，切过去就会拿错 key 得到 401，而用户看不出是拿错了还是失效了。
 
 # 密钥存到哪里：
 #   credentials = ~/.dsh/.credentials.yaml 的 refs 段（默认，与其他服务统一托管）
@@ -113,6 +133,8 @@ keyStorage: credentials
 # 变量名可以覆盖（留空即用上面的默认名）：
 # systemoneApiKeyEnv: ""
 # bamboonodeApiKeyEnv: ""
+# siliconflowApiKeyEnv: ""
+# siliconflowIntlApiKeyEnv: ""
 # customApiKeyEnv: ""
 
 # 直接写明文 key 也可以（各 provider 一格，互不影响）。
@@ -120,12 +142,16 @@ keyStorage: credentials
 # 不会落到这里；只有 keyStorage=config 时下面这些字段才会被写入。
 # systemoneApiKey: ""
 # bamboonodeApiKey: ""
+# siliconflowApiKey: ""
+# siliconflowIntlApiKey: ""
 # customApiKey: ""
 
 # .credentials.yaml 里的形态就是 refs 段：
 #   refs:
 #     BAMBOO_API_KEY: sk-你的key
 #     TYPESAFE_API_KEY: sk-另一个key
+#     SILICONFLOW_API_KEY: sk-国内站的key
+#     SILICONFLOW_INTL_API_KEY: sk-国际站的key
 
 # 超时预算（毫秒）。超时自动降级放行，连续失败进入冷却。
 timeoutMs: 8000
@@ -215,11 +241,8 @@ pointCotTranslate: off
 # ============================================================================
 # 自身开销护栏
 # ============================================================================
-# 决策模型自己也烧 token（实测约 1.9k/次，p50 约 0.5s）。
-# 这是每小时上限，超出后所有决策点自动退回启发式并放行——
-# 省钱的东西不能反过来变成主要消耗方。0 表示不限制。
-budgetTokens: 400000
-budgetWindowMs: 3600000
+# 决策模型自己也烧 token（实测约 1.9k/次，p50 约 0.5s），靠双层缓存挡住重复调用：
+# 命中缓存就不发请求。本插件不限制每小时的总用量，因此没有预算字段。
 
 # ---- 以下为可选调优项 ----
 # cacheSize: 256            # 缓存条数上限

package/lib/adapters/tools.js

@@ -174,7 +174,7 @@ async function loadSkillCandidates(ctx, exec, cfg) {
   } catch {
     return [];
   }
-  // 决策模型每次只有很小的一段 state；候选超过上限就截断，宁可少挑不可超预算。
+  // 决策模型每次只有很小的一段 state；候选超过上限就截断，宁可少挑不可超长。
   const limit = Math.max(2, cfg.skillPickCandidates ?? 8);
   return summaries.slice(0, limit).map((summary) => ({
     name: String(summary.name ?? ""),