dsh-mcmp 2.1.4 → 2.2.0

package/README.md

@@ -19,6 +19,8 @@ DeepSeek Harness **持久化 Cordis 插件**:面向全国大学生数学建模
 - **成果全落盘**:每步迭代完整追加保存(含质疑清单),旧内容绝不覆盖;代码保留全部历史版本;全新运行时旧目录自动归档为 `数学建模流水线_历史归档_*`
 - **实时进度面板**:独立浮动窗口(可拖拽/最小化/关闭),显示百分比进度条、当前轮/步骤/迭代、8 步骤打点、日志、产出文件,支持一键中止、重置(全新开始)
 - **断点续跑与重置**:中断/关闭窗口不丢进度,再次 `/loopbegin` 自动续跑;`/loopreset` 或面板「重置(全新开始)」清空续跑记录,下次从头跑
+- **迭代失败自动重试**:单个子任务因模型限流/过载(429、5xx)等瞬时故障失败时,自动退避重试(默认 15s/45s,最多 2 次),吸收抖动、避免"连续 3 败提前终止";确实持续失败才终止,并提示排查方向
+- **`--from` 文件自动补全**:`--from 文件名` 支持部分匹配,自动查找工作区根目录下的 `.md` 文档(前缀优先、包含次之;唯一命中即采用,歧义列出候选);只写 `--from` 会列出全部 MD 文档供选择——不用再复制粘贴完整文件名
 - **原生工作流卡片**:聊天区实时显示每个子智能体的运行状态(按阶段分组)
 
 ## 八大步骤(每轮 19 次迭代)
@@ -42,7 +44,7 @@ DeepSeek Harness **持久化 Cordis 插件**:面向全国大学生数学建模
 2. **触发插件**:发送一条以 `/loopbegin` 开头的消息:
    - `/loopbegin` —— 默认 1 轮
    - `/loopbegin --round=3` —— 3 轮外循环(上限 10)
-   - `/loopbegin --from 题目.txt` —— 从文件读取赛题(支持含空格/中文的文件名,如 `--from 2024 年高教社杯全国大学生数学建模竞赛题目.md`,也可用 `--from=文件` 形式)
+   - `/loopbegin --from 题目.txt` —— 从文件读取赛题。**支持部分匹配自动补全**:只写 `--from` 会列出根目录全部 MD 文档;`--from 2024` 会自动匹配到 `2024 年高教社杯全国大学生数学建模竞赛题目.md`(唯一命中即用,歧义列出候选)
 3. **查看进度**:右下角浮动面板(百分比、步骤打点、日志、文件)+ 聊天区工作流卡片。
 
 辅助命令:`/loopstatus`(查看进度)、`/loopabort`(中止,已产出成果保留)、`/loopreset`(清空状态与断点续跑记录,下次 `/loopbegin` 从头全新开始;等价于面板「重置(全新开始)」按钮)。

package/lib/index.js

@@ -29,12 +29,38 @@ export function apply(ctx) {
   const subagents = ctx.get('subagents')
   const systemPrompt = ctx.get('systemPrompt')
   const webServer = ctx.get('webServer')
-  console.log('dsh-mcmp: services available -> commands=' + !!commands + ' fs=' + !!fs + ' agents=' + !!agents + ' subagents=' + !!subagents + ' systemPrompt=' + !!systemPrompt + ' webServer=' + !!webServer)
+  const timerSvc = ctx.get('timer')
+  console.log('dsh-mcmp: services available -> commands=' + !!commands + ' fs=' + !!fs + ' agents=' + !!agents + ' subagents=' + !!subagents + ' systemPrompt=' + !!systemPrompt + ' webServer=' + !!webServer + ' timer=' + !!timerSvc)
 
   const FLOW_NAME = '数学建模论文流水线v2'
   // 全流水线缺陷台账:跨步骤错误登记、裁决与向上修复的唯一权威文件
   const LEDGER = '00_缺陷与裁决台账.md'
 
+  // 迭代级重试:一次迭代失败(如模型 429/5xx 瞬时抖动)后自动退避重试,
+  // 避免"连续 3 个子任务失败"被瞬时故障触发。重试间隔可用 --retry-ms=N 覆盖(测试/调优用)。
+  const DEFAULT_RETRY_DELAYS = [15000, 45000]
+  const MAX_ITER_RETRY = 2
+
+  function sleepAbortable(ms, signal) {
+    return new Promise((resolve) => {
+      let settled = false
+      let timerDispose = null
+      const finish = () => {
+        if (settled) return
+        settled = true
+        if (timerDispose) { try { timerDispose() } catch (err) { /* ignore */ } }
+        resolve()
+      }
+      if (signal && signal.aborted) { resolve(); return }
+      if (signal && typeof signal.addEventListener === 'function') signal.addEventListener('abort', finish, { once: true })
+      if (timerSvc && typeof timerSvc.timeout === 'function') {
+        try { timerDispose = timerSvc.timeout(finish, ms) } catch (err) { finish() }
+      } else {
+        finish() // 无 timer 服务时不做等待,直接重试
+      }
+    })
+  }
+
   // ---------- 识图能力探测(宿主侧,仅供参考;以子智能体自检为准) ----------
   function detectVision() {
     // 1) 宿主服务:常见的识图服务键
@@ -113,6 +139,7 @@ export function apply(ctx) {
   let state = freshState()
   let active = null
   let lastSession = null // 最近一次运行所属会话,供「清空状态」追加重置标记
+  let starting = false // 启动锁:async startPipeline 中等待目录扫描时防止并发启动
   const recording = new Map()
 
   function fmtTime(ts) {
@@ -289,6 +316,67 @@ export function apply(ctx) {
     return filtered.trim()
   }
 
+  // ---------- --from 的文件补全:列出/匹配工作区根目录的 .md 文档 ----------
+  async function listMdFiles(dir) {
+    if (!fs || !dir) return []
+    try {
+      const root = await fs.resolve(dir)
+      const entries = await fs.listDir(root)
+      return entries
+        .filter((e) => e && e.type === 'file' && /\.md$/i.test(e.name || ''))
+        .map((e) => e.name)
+        .sort()
+    } catch (err) { /* 目录不存在/不可读时返回空 */ }
+    return []
+  }
+
+  function pickMdMatch(names, partial) {
+    const p = (partial || '').toLowerCase()
+    const exact = names.filter((n) => n.toLowerCase() === p)
+    if (exact.length === 1) return { kind: 'match', name: exact[0] }
+    const starts = names.filter((n) => n.toLowerCase().startsWith(p))
+    if (starts.length === 1) return { kind: 'match', name: starts[0] }
+    if (starts.length > 1) return { kind: 'ambiguous', names: starts }
+    const contains = names.filter((n) => n.toLowerCase().indexOf(p) >= 0)
+    if (contains.length === 1) return { kind: 'match', name: contains[0] }
+    if (contains.length > 1) return { kind: 'ambiguous', names: contains }
+    return { kind: 'none' }
+  }
+
+  async function resolveFromPath(cwd, raw) {
+    // 返回 { kind:'ok', path } | { kind:'error', text }
+    let p = (raw || '').trim().replace(/^["']|["']$/g, '')
+    const cwdNorm = cwd.replace(/[\\/]+$/, '')
+    if (p.length === 0) {
+      const names = await listMdFiles(cwd)
+      if (names.length === 0) return { kind: 'error', text: '--from 未指定文件,且工作区根目录下没有 .md 文档。' }
+      return { kind: 'error', text: '--from 未指定文件。工作区根目录下的 MD 文档:\n' + names.map((n) => '  - ' + n).join('\n') + '\n请用 --from 文件名(支持部分匹配,如 --from 2024)重新指定。' }
+    }
+    // 绝对路径
+    if (/^[A-Za-z]:[\\/]/.test(p) || p.indexOf('/') === 0 || p.indexOf('\\') === 0) {
+      return { kind: 'ok', path: p }
+    }
+    // 含路径分隔符的相对路径:直接按路径解析并验证存在
+    if (p.indexOf('/') >= 0 || p.indexOf('\\') >= 0) {
+      const full = cwdNorm + '/' + p
+      try {
+        const t = await fs.resolve(full)
+        const st = await fs.stat(t)
+        if (st && st.type === 'file') return { kind: 'ok', path: full }
+        return { kind: 'error', text: '路径不是文件: ' + p }
+      } catch (err) { /* fallthrough 到模糊匹配 */ }
+    }
+    // 模糊匹配文件名
+    const names = await listMdFiles(cwd)
+    const pick = pickMdMatch(names, p)
+    if (pick.kind === 'match') return { kind: 'ok', path: cwdNorm + '/' + pick.name }
+    if (pick.kind === 'ambiguous') {
+      return { kind: 'error', text: '--from "' + p + '" 匹配到多个文档,请补充关键字:\n' + pick.names.map((n) => '  - ' + n).join('\n') }
+    }
+    const hint = names.length > 0 ? '\n工作区根目录现有 MD 文档:\n' + names.map((n) => '  - ' + n).join('\n') : ''
+    return { kind: 'error', text: '未找到匹配 "' + p + '" 的 MD 文档。' + hint }
+  }
+
   function buildPrompt(round, si, ii, s, it, args) {
     const p = []
     p.push('你正在参与「全国大学生数学建模竞赛论文」的多轮自动化撰写流水线,担任本轮「' + s.name + ' · ' + it.name + '」的执行专家。你的目标不是"写完",而是产出**可直接放进竞赛论文、经得起评审质疑**的内容。')
@@ -476,10 +564,23 @@ export function apply(ctx) {
       let started = false
       let outcome = 'failed'
       let note = ''
-      const res = await runChild(provider, session, agent, controller, label, buildPrompt(r, f.s, f.i, s, it, args), (child) => {
-        started = true
-        appendRec(runId, session, 'tool-workflow/agent-start', { runId, seq: g + 1, label, phase: s.phase, childId: String(child.id) })
-      })
+      // 迭代级重试:失败(如模型 429/5xx 瞬时抖动)后自动退避重试,吸收瞬时故障
+      const retryDelays = Array.isArray(args.retryDelays) && args.retryDelays.length ? args.retryDelays : DEFAULT_RETRY_DELAYS
+      let res = null
+      for (let attempt = 0; ; attempt++) {
+        res = await runChild(provider, session, agent, controller, label, buildPrompt(r, f.s, f.i, s, it, args), (child) => {
+          if (!started) {
+            started = true
+            appendRec(runId, session, 'tool-workflow/agent-start', { runId, seq: g + 1, label, phase: s.phase, childId: String(child.id) })
+          }
+        })
+        if (res.outcome !== 'failed' || attempt >= MAX_ITER_RETRY) break
+        const delayMs = retryDelays[Math.min(attempt, retryDelays.length - 1)] || 0
+        pushLog('迭代失败,将在 ' + Math.round(delayMs / 1000) + 's 后重试(第 ' + (attempt + 1) + '/' + MAX_ITER_RETRY + ' 次): ' + label)
+        await sleepAbortable(delayMs, controller.signal)
+        if (controller.signal.aborted) { cancelled = true; break }
+      }
+      if (cancelled) break
       outcome = res.outcome
       note = (res.text || '').trim().slice(0, 300)
       if (res.err) note = '执行异常: ' + String((res.err && res.err.message) || res.err).slice(0, 200)
@@ -506,7 +607,7 @@ export function apply(ctx) {
       if (controller.signal.aborted) { cancelled = true; break }
       if (failStreak >= 3) {
         stopReason = 'error'
-        errorMsg = '连续 3 个子任务失败,流水线提前终止(已有成果全部保留,可重新 /loopbegin 续跑)'
+        errorMsg = '连续 3 个子任务失败(每个失败迭代已含自动重试),流水线提前终止。常见原因:模型服务限流(429)/账户余额不足(402)/上下文过长/工作区文件问题;请排查后重新 /loopbegin 续跑,或 /loopreset 后重来。已有成果全部保留。'
         break
       }
     }
@@ -540,12 +641,13 @@ export function apply(ctx) {
     if (active && active.runId === runId) active = null
   }
 
-  // ---------- 共享的流水线启动逻辑(同步执行,永不阻塞命令通道) ----------
-  function startPipeline(agent, rawInput) {
+  // ---------- 共享的流水线启动逻辑(async:--from 需要异步扫描目录;启动锁防并发) ----------
+  async function startPipeline(agent, rawInput) {
+    if (state.status === 'running' || starting) {
+      return { kind: 'error', text: '已有流水线正在运行(当前进度 ' + (state.total > 0 ? Math.floor((state.done * 100) / state.total) : 0) + '%)。可在浮动面板点「中止」或运行 /loopabort 后再启动新流水线。' }
+    }
+    starting = true
     try {
-      if (state.status === 'running') {
-        return { kind: 'error', text: '已有流水线正在运行(当前进度 ' + (state.total > 0 ? Math.floor((state.done * 100) / state.total) : 0) + '%)。可在浮动面板点「中止」或运行 /loopabort 后再启动新流水线。' }
-      }
       if (!subagents) return { kind: 'error', text: '子智能体服务不可用(当前部署未提供),无法启动流水线。' }
       const session = agent && agent.session
       const cwd = session && session.header ? session.header.cwd : undefined
@@ -560,20 +662,21 @@ export function apply(ctx) {
       if (!Number.isSafeInteger(rounds) || rounds < 1) rounds = 1
       if (rounds > 10) return { kind: 'error', text: '--round 最大为 10。每轮 19 次迭代、每次迭代启动一个专家子智能体,轮数过大会非常耗时。' }
       const fresh = /(?:^|\s)--fresh\b/i.test(raw)
-      // --from 路径:允许含空格,遇到下一个 -- 标志或行尾即结束,避免吞掉后面的 --round/--fresh
-      const mFrom = /(?:^|\s)--from(?:=)?\s*([^\r\n]+?)(?=\s+--|\r?$)/i.exec(raw)
+      // 迭代失败重试间隔(毫秒),默认 [15s, 45s];--retry-ms=N 可覆盖(测试/调优)
+      const mRetry = /(?:^|\s)--retry-ms\s*[=:]?\s*(\d+)/i.exec(raw)
+      const retryDelays = mRetry ? [Math.max(1, parseInt(mRetry[1], 10)), Math.max(1, parseInt(mRetry[1], 10))] : DEFAULT_RETRY_DELAYS
+      // --from:允许只写 --from(列出根目录 MD 文档)或部分文件名(自动匹配补全)
+      const hasFrom = /(?:^|\s)--from\b/i.test(raw)
+      const mFrom = hasFrom ? /(?:^|\s)--from(?:=)?\s*([^\r\n]+?)(?=\s+--|\r?$)/i.exec(raw) : null
       let problem = null
-      if (mFrom) {
-        let p = mFrom[1].trim().replace(/^["']|["']$/g, '')
-        if (p.length === 0) return { kind: 'error', text: '--from 需要指定赛题文件路径。' }
-        const abs = /^[A-Za-z]:[\\/]/.test(p) || p.indexOf('/') === 0 || p.indexOf('\\') === 0
-          ? p
-          : cwd.replace(/[\\/]+$/, '') + '/' + p
-        problem = { kind: 'file', path: abs }
+      if (hasFrom) {
+        const resolved = await resolveFromPath(cwd, mFrom ? mFrom[1] : '')
+        if (resolved.kind === 'error') return { kind: 'error', text: resolved.text }
+        problem = { kind: 'file', path: resolved.path }
       } else {
         const text = extractProblem(session)
         if (text.trim().length < 40) {
-          return { kind: 'error', text: '未能从对话中提取到赛题。请先把完整赛题粘贴到对话框并发送,再发送以 /loopbegin 开头的消息;或使用 /loopbegin --from 题目.txt 指定赛题文件。' }
+          return { kind: 'error', text: '未能从对话中提取到赛题。请先把完整赛题粘贴到对话框并发送,再发送以 /loopbegin 开头的消息;或使用 /loopbegin --from 文件名(支持部分匹配自动查找根目录 .md 文档)。' }
         }
         problem = { kind: 'text', text: text.length > 6000 ? text.slice(0, 6000) + '\n…(原文过长,已截断)' : text }
       }
@@ -581,7 +684,7 @@ export function apply(ctx) {
       const problemPath = problem.kind === 'file' ? problem.path : wsDir + '/00_赛题原文.md'
       const title = problem.kind === 'text' ? problem.text.split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0)[0] : problem.path
       const vision = detectVision()
-      const args = { rounds, wsDir, problemPath, problem, title: title ? title.slice(0, 40) : '赛题', vision }
+      const args = { rounds, wsDir, problemPath, problem, title: title ? title.slice(0, 40) : '赛题', vision, retryDelays }
       // 断点续跑:扫描本会话落盘的 v2 工作流记录,跳过已完成的迭代
       const resumeCount = fresh ? 0 : completedIterations(session)
       args.startIndex = resumeCount
@@ -627,6 +730,8 @@ export function apply(ctx) {
       }
     } catch (err) {
       return { kind: 'error', text: '启动失败: ' + String((err && err.message) || err) }
+    } finally {
+      starting = false
     }
   }
 
@@ -636,7 +741,7 @@ export function apply(ctx) {
       commands.register({
         name: 'loopbegin',
         description: '启动数学建模论文自动化流水线 v2(8 步骤:含图表视觉自检、评审修复闭环、论文定稿;每轮 19 次迭代、多轮外循环,成果全部落盘)',
-        input: { hint: '--round=N 外循环轮数(默认 1);可选 --from 题目文件 指定赛题文件;--fresh 从头重跑' },
+        input: { hint: '--round=N 外循环轮数(默认 1);--from 文件名(支持部分匹配,自动查找根目录 .md 文档,如 --from 2024);--fresh 从头重跑' },
         handler: (invocation) => startPipeline(invocation.agent, invocation.rawInput),
       })
     } catch (err) { console.warn('dsh-mcmp: loopbegin 注册失败(可能被其他实例占用): ' + String((err && err.message) || err)) }
@@ -694,8 +799,9 @@ export function apply(ctx) {
       const agent = agents && agents.get(session.id)
       if (!agent) return
       console.log('dsh-mcmp: 检测到以 /loopbegin 开头的用户消息,自动启动流水线')
-      const res = startPipeline(agent, firstLine)
-      if (res && res.kind === 'error') pushLog('消息触发启动失败: ' + res.text)
+      Promise.resolve(startPipeline(agent, firstLine)).then((res) => {
+        if (res && res.kind === 'error') pushLog('消息触发启动失败: ' + res.text)
+      }).catch(() => { /* 忽略 */ })
     } catch (err) { /* 触发器自身异常忽略,不影响消息流 */ }
   }, { global: true })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mcmp",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "description": "DeepSeek Harness 插件:数学建模论文自动化流水线 v2(8 步骤 × 19 迭代 × N 轮:图表视觉自检与修复、评审问题修复闭环、跨步骤缺陷台账与向上修复、论文兜底定稿、质疑驱动、断点续跑、进度面板)",
   "type": "module",
   "main": "lib/index.js",