dsh-decision-engine 0.0.0-stage → 0.4.0

package/scripts/migrate-profile.mjs

@@ -0,0 +1,102 @@
+/**
+ * 更名迁移助手：把 profile 里的旧包名换成 dsh-decision-engine。
+ *
+ * 为什么需要这一步：本项目从 `dsh-startlux-decision` 更名为 `dsh-decision-engine`。
+ * profile 的 `package.json` 里有两处按名字引用插件——
+ *
+ *   dsh.profile.bundles[]   决定「加载哪些 bundle」
+ *   dependencies{}          决定「从哪里装」
+ *
+ * 只改其中一处，DSH 就找不到插件（表现为插件从列表里消失，或启动报
+ * 无法解析模块）。包名与依赖 key 必须同时改，且 key 必须与新包名一致。
+ *
+ * 用法：
+ *   node scripts/migrate-profile.mjs           # 预览要改什么（默认，不写文件）
+ *   node scripts/migrate-profile.mjs --write   # 真正写入（会先备份）
+ *
+ * 只处理 `dsh.profile.bundles` 与 `dependencies`/`devDependencies` 里的
+ * `dsh-startlux-decision`，其它字段一概不动。
+ */
+
+import { copyFile, readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+const OLD_NAME = "dsh-startlux-decision";
+const NEW_NAME = "dsh-decision-engine";
+const WRITE = process.argv.includes("--write");
+
+/** 候选 profile 路径：优先 desktop，其次是配置里能找到的其它 profile。 */
+function candidateProfiles() {
+  const base = join(homedir(), ".dsh", "profiles");
+  return ["desktop", "web", "cli"].map((name) => join(base, name, "package.json"));
+}
+
+/** 找到第一个存在的 profile package.json。 */
+async function pickProfile() {
+  for (const path of candidateProfiles()) {
+    if (existsSync(path)) return path;
+  }
+  return undefined;
+}
+
+/**
+ * 计算改动。刻意不解析成 AST：profile 的 package.json 结构固定，
+ * 按文本替换既能保留原有格式与缩进，也不会把注释（JSONC）弄丢。
+ *
+ * @param text - package.json 原文。
+ * @returns `{ next, notes }`；notes 说明改了哪些位置。
+ */
+export function migrateProfileJson(text) {
+  const notes = [];
+  let next = text;
+
+  // 1) bundles 数组里的一项
+  const bundleLine = new RegExp(`^(\\s*)"${OLD_NAME}"(,?)$`, "m");
+  if (bundleLine.test(next)) {
+    next = next.replace(bundleLine, `$1"${NEW_NAME}"$2`);
+    notes.push(`dsh.profile.bundles: "${OLD_NAME}" → "${NEW_NAME}"`);
+  }
+
+  // 2) 依赖键（值不变：仍指向同一份本地目录或同一版本）
+  const depLine = new RegExp(`^(\\s*)"${OLD_NAME}"(\\s*:\\s*)"([^"]*)"(,?)$`, "m");
+  if (depLine.test(next)) {
+    next = next.replace(depLine, `$1"${NEW_NAME}"$2"$3"$4`);
+    notes.push(`dependencies: "${OLD_NAME}" → "${NEW_NAME}"`);
+  }
+
+  if (notes.length === 0) {
+    notes.push(`没有找到 "${OLD_NAME}"，profile 可能已经迁移过`);
+  }
+  return { next, notes };
+}
+
+const profilePath = await pickProfile();
+if (profilePath === undefined) {
+  console.error(`未找到 profile 的 package.json（找过：${candidateProfiles().join(", ")}）`);
+  process.exit(2);
+}
+
+const before = await readFile(profilePath, "utf8");
+const { next, notes } = migrateProfileJson(before);
+
+console.log(`profile: ${profilePath}`);
+for (const note of notes) console.log(`  - ${note}`);
+
+if (next === before) {
+  console.log("\n无需改动。");
+  process.exit(0);
+}
+
+if (!WRITE) {
+  console.log("\n以上为预览。确认无误后加 --write 真正写入（会先备份 .bak）。");
+  process.exit(0);
+}
+
+const backup = `${profilePath}.bak-${new Date().toISOString().replace(/[:.]/g, "-")}`;
+await copyFile(profilePath, backup);
+await writeFile(profilePath, next, "utf8");
+console.log(`\n已写入。原文件备份在：${backup}`);
+console.log("接着执行：cd " + join(profilePath, "..") + " && pnpm install");
+console.log("然后重启 DSH。配置（startlux.yml）不需要重填，插件会自动读取旧数据目录。");

package/startlux.example.yml

@@ -0,0 +1,218 @@
+# dsh-decision-engine 配置模板
+#
+# 用法：复制到数据目录，按需修改。
+#   mkdir -p ~/.dsh/dsh-decision-engine
+#   cp startlux.example.yml ~/.dsh/dsh-decision-engine/startlux.yml
+#
+# 文件名刻意仍叫 startlux.yml：老版本就叫这个名字，改名会让已保存的配置
+# （含 API key 与决策点开关）失效。插件会自动读取以下位置，取第一个存在的：
+#   ~/.dsh/dsh-decision-engine/startlux.yml        （首选位置）
+#   ~/.dsh/dsh-startlux-decision/startlux.yml      （上一代；首次启动会自动拷到新目录）
+#   ~/.dsh/plugins/dsh-startlux-decision/startlux.yml
+#   ~/.dsh/plugins/dsh-startlux-guard/startlux.yml
+#
+# 数据目录（插件自动读取）：
+#   <上述目录>/startlux.yml        配置
+#   <上述目录>/telemetry.jsonl     决策记录
+#
+# 改完立即生效：每次工具调用 / 每一步前都会检查 mtime，无需重启 DSH。
+
+# 总开关：true 才开始工作（默认 false，不会擅自介入你的会话）
+enabled: false
+
+# shadow  = 只记录判断结果，绝不拦截（建议先用它观察一段时间）
+# enforce = 真正执行各决策点的处置
+#
+# 注意：这一项现在只是「工具授权」这一个决策点的历史开关。
+# 新写法是给每个决策点单独指定模式，见下面的 pointXxx。
+# pointAuthorize 留 auto 时，就沿用这里的 mode（shadow→observe、enforce→enforce）。
+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，老配置行为完全不变。
+provider: bamboonode
+
+# ---- bamboonode 预设的地址覆盖 ----------------------------------------------
+# 只在 provider=bamboonode 时生效。老版本唯一的地址字段，继续支持，因此
+# 已有的自建 bamboonode 兼容地址不会因为升级被改回官方。
+# 接受多种写法（等价）：
+#   https://api.bamboonode.dev/v1
+#   https://api.bamboonode.dev/v1/decisions
+#   api.bamboonode.dev/v1          （会补 https://）
+# 末尾斜杠会被规范化，不会拼出 //decisions 或 /v1/v1/decisions。
+baseUrl: https://api.bamboonode.dev/v1
+
+# ---- 模型（按 provider 分开存，切换时互不覆盖）------------------------------
+# bamboonode 的模型。留空 = 自动（由服务端选当前默认决策模型），
+# 这样服务商将来换模型名时，本配置不会失效。
+model:
+
+# system one 的模型。留空 = 服务端默认（jev-latest）。
+# 与上面的 model 分开：否则切到 system one 会把 bamboonode 的模型名发过去，
+# 得到 400 model not served。
+systemoneModel: ""
+
+# ---- custom 预设（provider=custom 时才生效）--------------------------------
+# base URL 必填，且必须是 http/https 地址；不带 scheme 会被拒绝（内置预设
+# 允许省略 scheme，custom 不允许——自定义地址必须显式，避免猜错协议）。
+# customBaseUrl: https://api.example.com/v1
+#
+# 端点风格：
+#   auto       地址已带 /decisions 或 /systemone 就原样用，否则按 decisions 拼
+#   decisions  POST <base>/decisions
+#   systemone  POST <base>/systemone
+customEndpointStyle: auto
+#
+# custom 自己的模型（留空 = 服务端默认）。与内置预设的 model 分开存，
+# 这样在两者之间来回切换不会互相覆盖。
+customModel: ""
+# custom 的 key；留空则读 customApiKeyEnv（环境变量或 .credentials.yaml 的 refs）
+customApiKey: ""
+customApiKeyEnv: ""
+# 附加请求头，格式 `名称: 值`，多项用分号分隔。
+# authorization / content-type / host 由插件固定，写了也会被忽略。
+customHeaders: ""
+
+# ============================================================================
+# 密钥
+# ============================================================================
+# 每个 provider 有**自己的** key 名，各自保存各自的 key：
+#
+#   system one -> TYPESAFE_API_KEY
+#   bamboonode -> BAMBOO_API_KEY
+#   custom     -> customApiKeyEnv（没填时用 DECISION_ENGINE_CUSTOM_KEY）
+#
+# 三者互不覆盖，可以同时配好；切换 provider 不会串用别人的 key。
+
+# 密钥存到哪里：
+#   credentials = ~/.dsh/.credentials.yaml 的 refs 段（默认，与其他服务统一托管）
+#   config      = 本文件（自包含，便于随目录备份；注意这里是明文）
+keyStorage: credentials
+
+# 变量名可以覆盖（留空即用上面的默认名）：
+# systemoneApiKeyEnv: ""
+# bamboonodeApiKeyEnv: ""
+# customApiKeyEnv: ""
+
+# 直接写明文 key 也可以（各 provider 一格，互不影响）。
+# 若 keyStorage=credentials，在设置界面粘贴的 key 会写进 .credentials.yaml，
+# 不会落到这里；只有 keyStorage=config 时下面这些字段才会被写入。
+# systemoneApiKey: ""
+# bamboonodeApiKey: ""
+# customApiKey: ""
+
+# 历史字段：老版本的单一 key 槽位，仅对 bamboonode 生效（保留兼容，不建议再用）。
+apiKey: ""
+apiKeyEnv: BAMBOO_API_KEY
+
+# .credentials.yaml 里的形态就是 refs 段：
+#   refs:
+#     BAMBOO_API_KEY: sk-你的key
+#     TYPESAFE_API_KEY: sk-另一个key
+
+# 超时预算（毫秒）。超时自动降级放行，连续失败进入冷却。
+timeoutMs: 8000
+
+# never = 不思考，最省 token（默认）；auto = 仅在不确定时思考
+thinkMode: never
+
+# ============================================================================
+# 决策模型参与点
+# ============================================================================
+# 三态：off 不参与 / observe 只记录不干预 / enforce 真正生效。
+# 九个点全部已实装。新点默认 off —— 升级不会改变现有行为。
+#
+# 建议：先 observe 跑一段时间，对着 telemetry.jsonl 确认与人工判断一致，
+# 再逐点切 enforce。热路径的点（route / delegate / cotTranslate）尤其如此。
+
+# ---- 1. 工具授权：每次工具调用前判断能否放行 -------------------------------
+# 替代 auto-review——后者把完整会话历史发给主模型，每次调用都跑一遍。
+pointAuthorize: auto
+
+# ---- 2. 模型路由：机械步骤下沉到便宜模型 -----------------------------------
+# 热路径。三道闸控量：每轮最多 routeMaxStepsPerTurn 步、路由未变不问、
+# 新用户输入后的步骤不问。
+# 必须同时配好 routeCheapProvider + routeCheapModel 才会真的换模型；
+# 两者留空时即便打开此点也只会记录「本该换」。
+pointRoute: off
+routeCheapProvider: ""
+routeCheapModel: ""
+# routeMaxStepsPerTurn: 3
+# routeMaxScore: 0.4        # 能力需求归一化后超过此值就保留强模型
+# routeMechanicalFloor: 0.6 # 「机械步骤」的最低置信
+# routeRiskFloor: 0.3       # 风险达线一律保留强模型
+
+# ---- 3. 子任务分派：接着做 / 开 subagent / 组 agent team -------------------
+# 热路径。只在每轮第一步且带新用户输入时判断（分派只在这一刻可能改变）。
+# 生效时注入一条提示，不替模型决定——工具选择仍归模型。
+pointDelegate: off
+# delegateConfidenceFloor: 0.5  # 三选项均分 0.33，实测需 ≥0.5 才算有倾向
+# delegateBlockingFloor: 0.6    # 被本地事实阻塞时继续内联
+# delegateParallelFloor: 0.5    # 组队还需真并行才有意义
+
+# ---- 4. 上下文压缩：摘要 vs 只丢陈旧工具结果 -------------------------------
+# 非热路径。只在实测 token 达触发线（compactThresholdRatio × 窗口）才问。
+# 生效方式：先跑宿主的确定性工具结果裁剪；compaction-basic 随后重新测压，
+# 低于阈值就跳过摘要——这才是真正省下的那一次调用。
+pointCompact: off
+# compactContextWindow: 0     # 0 = 用 compactTriggerTokens 绝对阈值
+# compactThresholdRatio: 0.7  # 提前于 compaction-basic 的 0.8 介入
+# compactTriggerTokens: 100000
+# compactToolResultChars: 8192
+# compactDistilledFloor: 0.6  # 结论已落地 → 允许只裁剪
+# compactVerbatinFloor: 0.6   # 仍需逐字原文 → 一律摘要（安全否决优先）
+
+# ---- 5. 轮次延续：再来一轮有没有增量价值 -----------------------------------
+# 非热路径。生效方式是用 agent.steer() 续一轮，每轮最多 turnStopMaxSteers 次。
+pointTurnStop: off
+# turnStopMaxSteers: 1
+# turnStopClosedFloor: 0.6
+# turnStopUnfinishedFloor: 0.6
+# turnStopValueFloor: 0.35    # 只作弱确认；主判据是 unfinished
+
+# ---- 6. 检索必要性：这条信息是不是已经知道 ---------------------------------
+# 非热路径。只对检索类工具生效，其余工具零开销。
+pointRetrieval: off
+# retrievalTools: [web_search, web_fetch, research, multi_search, advanced_search]
+# retrievalCoveredFloor: 0.5     # 上下文已覆盖该事实
+# retrievalWouldAddCeiling: 0.8  # 且再搜基本没有新信息
+
+# ---- 7. 技能选择：该装哪个技能 ---------------------------------------------
+# 非热路径。只对 skill 工具、且候选 ≥2 时判断。
+# 生效时拦下不匹配的加载并指路，避免「装错再换」付两遍正文 token。
+pointSkillPick: off
+# skillPickCandidates: 8      # 送给模型挑选的候选上限（只带名称+描述）
+# skillPickConfidenceFloor: 0.5
+
+# ---- 8. 思维链翻译门槛：这条内容真的需要翻译吗 -----------------------------
+# 热路径（每条消息）。本地先做免费预筛（去代码块/URL 后判断有无正文），
+# 预筛不过的直接跳过，不发请求。生效时判为「不需要」则返回原文。
+pointCotTranslate: off
+# cotProseFloor: 0.5
+# cotSameLanguageFloor: 0.8
+
+# ============================================================================
+# 自身开销护栏
+# ============================================================================
+# 决策模型自己也烧 token（实测约 1.9k/次，p50 约 0.5s）。
+# 这是每小时上限，超出后所有决策点自动退回启发式并放行——
+# 省钱的东西不能反过来变成主要消耗方。0 表示不限制。
+budgetTokens: 400000
+budgetWindowMs: 3600000
+
+# ---- 以下为可选调优项 ----
+# cacheSize: 256            # 缓存条数上限
+# cacheTtlMs: 600000        # 裁决存活时间
+# recentMessages: 4         # 带给模型的上下文条数
+# guardReadOnlyTools: [read, grep, glob, todo_write]
+# guardDenyConfidence: 0.85
+# guardIrreversibleCeiling: 0.2