dsh-vibe-math 0.3.7 → 0.3.8

package/README.md

@@ -77,6 +77,14 @@ dsh plugin --profile <你的 profile> add github:ChongCyrus/Vibe-Mathematics
 
 > 修改 preset 文件后需**重启 DSH 进程**再开新会话（preset 的 standing mount 会缓存到进程退出）。
 
+### DSH 版本适配与依赖
+
+- **形态依赖**：两个 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 版本演进，**低于 `package.json` 中 `dsh.minVersion`（实测基线 `0.1.0-rc.5`）的版本未验证**，可能无法挂载。
+- **运行时自检**：安装器（bundle 插件）每次启动时对上述服务与关键 API 做**能力自检**（DSH 不暴露版本号，故按能力而非版本检测）；不满足时打 warning 并提示升级 DSH。preset 挂载失败时先看 DSH 日志里的自检 warning。
+- **升级路径**：DSH 升级后无需重装本包；升级本包用 `dsh plugin update dsh-vibe-math`，重启 DSH 后安装器会自动把 preset 更新到新版本（见上文「安装」说明）。
+
 ---
 
 ## 🧭 两个预设怎么选

package/installer.js

@@ -61,6 +61,35 @@ function writeState(path, state) {
   }
 }
 
+// DSH 适配性自检（能力检测，而非版本号——DSH 不向插件暴露版本）。
+// 检查两个 preset 运行时需要的宿主服务与关键 API 形状是否可用，
+// 缺失时打 warning 提示宿主版本可能过旧 / 缺少对应插件行。
+function checkHostCapabilities(ctx, logger) {
+  const problems = []
+  const checks = [
+    ['subagents', ['startContinuable', 'followup', 'interrupt']],
+    ['agents', ['roots']],
+    ['tools', ['register']],
+    ['commands', ['register']],
+    ['fs', ['resolve', 'stat', 'readText', 'writeText', 'listDir']],
+  ]
+  for (let i = 0; i < checks.length; i++) {
+    const svc = checks[i][0]
+    const methods = checks[i][1]
+    let s
+    try { s = (ctx && ctx.get) ? ctx.get(svc) : undefined } catch (e) { s = undefined }
+    if (s === undefined) { problems.push('宿主缺少服务 ' + svc); continue }
+    for (let j = 0; j < methods.length; j++) {
+      if (typeof s[methods[j]] !== 'function') problems.push(svc + '.' + methods[j] + ' 不可用（宿主版本可能过旧）')
+    }
+  }
+  if (problems.length > 0) {
+    logger?.warn?.('[dsh-vibe-math] 宿主能力自检：' + problems.length + ' 项不满足（' + problems.join('；') + '）。两个 preset 依赖这些宿主服务/API，旧版 DSH 可能无法挂载，建议升级 DSH（本项目实测基线版本 0.1.0-rc.5，见 package.json 的 dsh.minVersion）。')
+  } else {
+    logger?.info?.('[dsh-vibe-math] 宿主能力自检通过：subagents / agents / tools / commands / fs 服务及关键 API 均可用（实测基线 DSH 0.1.0-rc.5）。')
+  }
+}
+
 export function apply(ctx) {
   const logger = ctx && ctx.logger
   try {
@@ -143,6 +172,7 @@ export function apply(ctx) {
     } else if (installed > 0) {
       logger?.info?.('[dsh-vibe-math] restored ' + installed + ' missing preset file(s)')
     }
+    checkHostCapabilities(ctx, logger)
   } catch (err) {
     logger?.warn?.('[dsh-vibe-math] preset install/update failed: %s', String((err && err.message) || err))
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-vibe-math",
   "description": "Multi-agent mathematical problem-solving & verification frameworks for DeepSeek Harness — TWO agent presets in one install: vibe-math-v1 (classic pipeline: brainstorm → solver iteration → multi-verifier debate → Verified) and vibe-math-v2 (new probability-driven architecture: qs.json + Propos knowledge base + explorer→solver→review/debate verdict). Installing this bundle auto-installs both presets into the DSH preset root.",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "type": "module",
   "main": "installer.js",
   "exports": {
@@ -46,6 +46,9 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
-    }
+    },
+    "minVersion": "0.1.0-rc.5",
+    "testedVersion": "0.1.0-rc.5",
+    "compatNote": "依赖宿主提供的 subagents/agents/tools/commands/fs 服务与 @deepseek-ai/dsh-* 插件行；低于 minVersion 的 DSH 未验证，可能无法挂载 preset（安装器启动时会做能力自检并告警）"
   }
 }