dsh-vibe-math 2.0.1 → 2.0.3

package/README.md

@@ -97,7 +97,8 @@ dsh plugin --profile <你的 profile> add github:ChongCyrus/Vibe-Mathematics
 - **形态依赖**：三个 preset 依赖 DSH 的标准 **agent-preset 机制**（`~/.dsh/.agent-presets/<id>/` + preset picker）与 **bundle patch 机制**（`cordis.patch.yml` 注入安装器）。
 - **宿主插件行**：`agent.cordis.yml` 引用宿主提供的 `@deepseek-ai/dsh-*` 插件行（persona、agent-instructions、tool-bash/pwsh、tool-fs/fs-search、tool-jobs、skill-filesystem、tool-skill、tool-goal、plan-mode、compaction、subagent/workflow、ask-user、todo、web 等，约 21 个唯一包名）。宿主缺行会导致 preset 挂载失败（会话启动时报错）。
 - **宿主服务 API**：预设插件消费 `subagents`（startContinuable / followup / interrupt）、`agents`（roots）、`tools`（register）、`commands`（register）、`fs`（resolve/stat/readText/writeText/listDir）、可选 `subprocess` / `sandboxPolicy`。这些 API 形状随 DSH 版本演进；本项目**已充分测试并确认适配 `dsh-v0.1.2-rc.1`**（`package.json` 的 `dsh.testedVersion`；`minVersion` 为 `0.1.2-rc.1`）。**注意：DSH 0.1.2 起 `subagents.startContinuable` 的 `agentOptions` / `toolFilter` 需要宿主 provider 声明对应 capability**（spawn / fork 进程内 provider 均支持，v4 指定常驻模型/路由与工具权限依赖于此）。
-- **运行时自检**：安装器（bundle 插件）每次启动时对上述服务与关键 API 做**能力自检**（DSH 不暴露版本号，故按能力而非版本检测；含 `fs.resolve` 返回形状检测与 subagent `agentOptions`/`toolFilter` capability 检测）；不满足时打 warning 并提示升级 DSH。preset 挂载失败时先看 DSH 日志里的自检 warning。
+- **DSH STORE 兼容声明**：`package.json` 的 `dsh.compatibility.dshReleases` 对每个完整 DSH 版本逐项声明 `compatible` / `incompatible` / `unknown`（当前 `0.1.2-alpha.4`、`0.1.2-alpha.5`、`0.1.2-rc.1` 均标 `compatible`）；`engines.node` 为 `^22.19.0 || >=24.0.0`（与 DSH 0.1.2 相同）。
+- **运行时自检（能力 + 版本双检）**：安装器（bundle 插件）每次启动时：**① 尽力探测 DSH 版本**（读 `@deepseek-ai/dsh/package.json` 或 `DSH_VERSION` 环境变量；DSH 未通过公开 service/context 暴露版本，故为尽力而为，探测不到就跳过）。若探测到且该版本未被 `dshReleases` 声明为 `compatible`，会给出明确"DSH 版本不匹配，请使用 `dsh-v0.1.2-rc.1`（或 `0.1.2-alpha.4/alpha.5`）"提示；**② 再对上述服务与关键 API 做能力自检**（这是真正的挂载门槛，含 `fs.resolve` 返回形状检测与 subagent `agentOptions`/`toolFilter` capability 检测），不满足时打 warning。preset 挂载失败时先看 DSH 日志里的自检 warning。
 - **升级路径**：DSH 升级后无需重装本包；升级本包用 `dsh plugin update dsh-vibe-math`，重启 DSH 后安装器会自动把 preset 更新到新版本（见上文「安装」说明）。
 
 ---

package/installer.js

@@ -24,7 +24,8 @@
 //     are preserved and reported via the logger.
 //   - same version: no-op (idempotent). Missing files are ALWAYS restored.
 //   - force a full refresh at any time: delete the preset dirs and restart DSH.
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, unlinkSync, rmdirSync } from 'node:fs'
+import { createRequire } from 'node:module'
 import { createHash } from 'node:crypto'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
@@ -75,8 +76,42 @@ function writeState(path, state) {
 
 // DSH 适配性自检（能力检测，而非版本号——DSH 不向插件暴露版本）。
 // 检查 preset 运行时需要的宿主服务与关键 API 形状是否可用，缺失时打 warning。
+// Best-effort DSH host-version detection. DSH does NOT expose its version through a documented
+// service/context property or a guaranteed env var, so we probe in order: an explicit env var
+// (future-proofing), then the installed @deepseek-ai/dsh package.json. This is layout-dependent
+// (works for a typical global install where @deepseek-ai/dsh is a sibling of this plugin); when it
+// cannot resolve, the capability self-check below is still the authoritative gate.
+const __require = createRequire(import.meta.url)
+function detectDshVersion() {
+  try { const v = process.env.DSH_VERSION; if (v && String(v).trim()) return String(v).trim() } catch (e) {}
+  try {
+    const p = __require.resolve('@deepseek-ai/dsh/package.json')
+    const v = (JSON.parse(readFileSync(p, 'utf8')).version || '').trim()
+    if (v) return v
+  } catch (e) { /* host package not resolvable from here — rely on capability check */ }
+  return undefined
+}
+
 async function checkHostCapabilities(ctx, logger) {
   const problems = []
+  // 1) DSH version compatibility (best-effort, only when the version is detectable).
+  //    Declared under package.json dsh.compatibility.dshReleases (per the DSH STORE contract):
+  //    each full DSH release maps to 'compatible' | 'incompatible' | 'unknown'. A version that is
+  //    absent or 'unknown' is a soft warning; 'incompatible' is a hard "please use X" message.
+  let dshRel = {}
+  try { const m = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), 'package.json'), 'utf8')); dshRel = (m.dsh && m.dsh.compatibility && m.dsh.compatibility.dshReleases) || {} } catch (e) {}
+  const supported = Object.keys(dshRel).sort()
+  const dshVersion = detectDshVersion()
+  if (dshVersion) {
+    const status = dshRel[dshVersion]
+    if (status === 'incompatible') {
+      problems.push('当前 DSH 版本 v' + dshVersion + ' 被本包声明为 incompatible；请使用 ' + supported.join(' / ') + '。')
+    } else if (status === undefined || status === 'unknown') {
+      problems.push('当前 DSH 版本 v' + dshVersion + ' 尚未被本包声明为兼容（dshReleases 仅声明 ' + supported.join(' / ') + '）；建议使用 ' + supported.join(' / ') + '，或将该版本在 dshReleases 中标注后再自行验证。')
+    }
+  }
+  // 2) capability self-check (the authoritative mounting gate; also covers hosts whose version
+  //    could not be read). subagents / agents / tools / commands / fs shapes + v4 capabilities.
   const checks = [
     ['subagents', ['startContinuable', 'followup', 'interrupt']],
     ['agents', ['roots']],
@@ -120,9 +155,9 @@ async function checkHostCapabilities(ctx, logger) {
     }
   } catch (e) { /* 探测失败不致命 */ }
   if (problems.length > 0) {
-    logger?.warn?.('[dsh-vibe-math] 宿主能力自检：' + problems.length + ' 项不满足（' + problems.join('；') + '）。v2/v3/v4 预设依赖这些宿主服务/API，旧版 DSH 可能无法挂载，建议升级 DSH（本项目已充分测试并确认适配 dsh-v0.1.2-rc.1，见 package.json 的 dsh.minVersion/testedVersion）。')
+    logger?.warn?.('[dsh-vibe-math] 宿主自检：' + problems.length + ' 项不满足（' + problems.join('；') + '）。v2/v3/v4 预设依赖这些宿主服务/API，旧版或未经声明兼容的 DSH 可能无法挂载' + (dshVersion ? '（当前检测到 DSH v' + dshVersion + '，本包适配 ' + (supported.length ? supported.join(' / ') : '(未声明)') + '）' : '') + '。')
   } else {
-    logger?.info?.('[dsh-vibe-math] 宿主能力自检通过：subagents / agents / tools / commands / fs 服务及关键 API 均可用（已确认适配 DSH 0.1.2-rc.1）。')
+    logger?.info?.('[dsh-vibe-math] 宿主自检通过：subagents / agents / tools / commands / fs 服务及关键 API 均可用' + (dshVersion ? '（当前 DSH v' + dshVersion + '，本包已声明兼容 ' + supported.join(' / ') + '）' : '') + '。')
   }
 }
 
@@ -195,8 +230,42 @@ export async function apply(ctx) {
       }
     }
 
+    // Clean up preset dirs that this bundle NO LONGER manages (e.g. vibe-math-v1 after it was
+    // removed at v2.0.0). The copy loop only adds/updates PRESETS; it never deletes a preset that
+    // was dropped, so an old removed preset would linger in the picker forever. Here we remove the
+    // files this installer previously recorded as package-owned under a prefix that is no longer in
+    // PRESETS, then drop the dir if it became empty. User-owned files (provenance 'user') are kept.
+    const currentPrefixes = new Set(PRESETS.map(p => p.src + '/'))
+    let removedFiles = 0
+    let removedDirs = []
+    const stale = new Map() // prefix -> [keys]
+    for (const key of Object.keys(prevFiles)) {
+      const slash = key.indexOf('/')
+      if (slash === -1) continue
+      const prefix = key.slice(0, slash + 1)
+      if (currentPrefixes.has(prefix)) continue
+      if (!stale.has(prefix)) stale.set(prefix, [])
+      stale.get(prefix).push(key)
+    }
+    for (const [prefix, keys] of stale) {
+      let dirEmpty = true
+      for (const key of keys) {
+        const rec = (prevFiles[key] && typeof prevFiles[key] === 'object') ? prevFiles[key] : { provenance: 'package' }
+        if (rec.provenance === 'user') { dirEmpty = false; continue }   // 用户文件 → 保留
+        const f = join(presetRoot, key)
+        if (existsSync(f)) { try { unlinkSync(f); removedFiles += 1 } catch (e) {} }
+        if (existsSync(f)) dirEmpty = false
+      }
+      const dir = join(presetRoot, prefix.slice(0, -1))
+      if (dirEmpty && existsSync(dir)) { try { rmdirSync(dir); removedDirs.push(dir) } catch (e) {} }
+    }
+
     writeState(stateFile, { version: pkgVersion, files: nextFiles, updatedAt: Date.now() })
 
+    if (removedFiles > 0 || removedDirs.length > 0) {
+      logger?.info?.('[dsh-vibe-math] preset cleanup: removed ' + removedFiles + ' file(s) from ' + removedDirs.length + ' stale preset dir(s) (' + removedDirs.map(d => d.split(/[\\/]/).pop()).join(', ') + ') that are no longer shipped.')
+    }
+
     if (isUpgrade) {
       logger?.info?.('[dsh-vibe-math] preset auto-update: version ' + (state.version || '(none)') + ' → ' + pkgVersion +
         ' — 新增 ' + installed + ' 个文件，更新 ' + updated + ' 个文件' +

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "dsh-vibe-math",
   "description": "Multi-agent mathematical problem-solving & verification frameworks for DeepSeek Harness — THREE agent presets in one install: vibe-math-v2 (probability-driven: qs.json + Propos knowledge base + explorer→solver→review/debate verdict), vibe-math-v3 (THIRD-generation, recommended: paper-style Markdown knowledge base with Problems/Progress/Propos/Methods/Verified + planner-agent scheduling that decides the next N actions + universal theory/method invention library + agents write their own Markdown directly via a per-file write lock), and vibe-math-v4 (FOURTH-generation: persistent self-organizing resident subagents that message & meet to decide all tasks, verify only by unanimous consensus, /compact at a context threshold, and stop only when all agree the problem is solved). Installing this bundle auto-installs all three presets (v1 was removed at v2.0.0).",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "type": "module",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
   "main": "installer.js",
   "exports": {
     ".": "./installer.js",
@@ -54,6 +57,13 @@
     },
     "minVersion": "0.1.2-rc.1",
     "testedVersion": "0.1.2-rc.1",
-    "compatNote": "依赖宿主提供的 subagents/agents/tools/commands/fs 服务与 @deepseek-ai/dsh-* 插件行。本项目已充分测试并确认适配 dsh-v0.1.2-rc.1（v2/v3/v4；v1 已于 v2.0.0 移除）。注意：DSH 0.1.2 起 subagents.startContinuable 的 agentOptions/toolFilter 需要宿主 provider 声明对应 capability（spawn/fork 进程内 provider 均支持），安装器启动时会做能力自检并在旧版宿主上告警。"
+    "compatNote": "依赖宿主提供的 subagents/agents/tools/commands/fs 服务与 @deepseek-ai/dsh-* 插件行。本项目已充分测试并确认适配 dsh-v0.1.2-rc.1（v2/v3/v4；v1 已于 v2.0.0 移除）。注意：DSH 0.1.2 起 subagents.startContinuable 的 agentOptions/toolFilter 需要宿主 provider 声明对应 capability（spawn/fork 进程内 provider 均支持），安装器启动时会做能力自检并在旧版宿主上告警。",
+    "compatibility": {
+      "dshReleases": {
+        "0.1.2-alpha.4": "compatible",
+        "0.1.2-alpha.5": "compatible",
+        "0.1.2-rc.1": "compatible"
+      }
+    }
   }
 }