dsh-vibe-math 2.5.0 → 2.7.0

package/vibe-math-v2//345/256/236/347/216/260/346/226/271/346/241/210.md

@@ -1,5 +1,11 @@
 # Vibe Mathematics —— 多代理数学问题求解与验证框架
 
+> **状态说明（round-3 补记）**：本文是**设计期文档**，写于 `math_computation`（数学计算工具）、
+> `leanAsync`/`leanJobsMaxParallel`/`leanSearchPaths`（Lean 异步作业与复用）、`paperEditor` 与
+> `paper.lock.json`（最终论文定稿/写锁）等新功能之前；**功能与参数的权威描述以 `docs/` 为准**
+> （`docs/math-computation.md`、`docs/formal-verification.md`、`docs/final-paper.md`、`docs/test-timing.md`），
+> 参数表以 README 的双语「共用参数 / 各预设专属参数」表为准。本文保留其原始设计意图，不再逐条追平。
+
 项目需具备以下核心功能：
 
 1. **断点续跑**：保存各代理的对话记录及任务栈，支持状态恢复。

package/vibe-math-v3/agent.cordis.yml

@@ -47,7 +47,10 @@
         plannerEnabled/plannerProvider/plannerModel/plannerPersona, planMinIntervalMs, plannerMaxFails,
         methodKeepIntervalMs/methodKeepEvery, methodAutoPromote, indexAutoRebuild, projectLockTimeoutMs,
         formalVerify/leanCommand/leanArgs/leanTimeoutMs — Lean 形式化验证（off = 默认不额外要求，
-        encourage = 按实现难度自行形式化、Lean 通过后审查对象变为忠实性，require = 同上并加结论门禁）).
+        encourage = 按实现难度自行形式化、Lean 通过后审查对象变为忠实性，require = 同上并加结论门禁）,
+        finalPaper/paperFormat/paperLanguage/paperCompilePdf/paperLatexCommand — 最终论文（收口时自动派遣
+        「论文撰写」子代理，把已收口的解法/命题/成果整理成 Paper/<project>/；finalPaper=false 只关自动触发，
+        /vibe paper 仍可手动触发）。
       - vibe_math_setup / vibe_math_save_settings / vibe_math_template — guided configuration / persist defaults / generate template.
       - vibe_math_plan {force?} — show queued plan / last plan, or force a planning round.
       - vibe_math_index — rebuild State/index.json from the Markdown knowledge base.
@@ -57,12 +60,18 @@
       - vibe_math_new_project / vibe_math_set_project / vibe_math_list_projects — per-project folders.
       - vibe_math_list_decisions / vibe_math_decide {id, action: approve|reject|override, verdict?} — resolve manual decisions.
       - vibe_math_list_agents / vibe_math_message_agent / vibe_math_interrupt_agent — inspect / steer / interrupt subagents.
-      - vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib — Lean formal
-        verification (execute / archive / list the reuse library). The scheduler's child agents
-        use them too; they work in every mode.
+      - vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib / vibe_math_lean_read /
+        vibe_math_lean_job — Lean formal verification (execute / archive / list + read the reuse
+        library / inspect or wait for a background compile job). leanAsync=true (default) queues the
+        compile and returns a jobId; nothing counts as proved until that job settles ok (so "有把握"
+        is not the same as "已验证"). The scheduler's child agents use them too; they work in every
+        mode.
+
+      - math_computation {op: probe|run|receipt|install, engine, mode: code|file|expr, …} — 先 probe 预检引擎/包/许可，再调引擎计算并把脚本与输出归档成可复核回执；缺引擎/缺包只报告与给安装指引/计划；shell 兜底不算归档。
+      - 归档→编辑→重跑：mode:'code' 的脚本原件在回执的 scriptPath（Computation/<id>/script.<ext>），你可以用普通文件工具打开并编辑它；编辑后用 mode:'file' 指向它重跑，会写出一份**新回执/新 attempt**（含新的 scriptHash）。**旧回执对修改后的代码无效**——报告里必须引用与当前代码哈希一致的那份回执；工具会在 scriptChanged / scriptChangedDuringRun 为 true 时显式告警。
 
       A /vibe slash command mirrors the main controls (/vibe start [override]|resume [override]|pause|abort|status|report|mode
-      <auto|manual>|setup|save|add <id> <desc>|add-proposition <id> <概述>|list-propositions|methods|index|plan|lock|...).
+      <auto|manual>|setup|save|template [global|project]|add <id> <desc>|add-proposition <id> <概述>|list-propositions|methods|index|plan|lock|project [list|new <name>|<name>]|decisions|agents|paper [lang=zh|en] [format=both|md|tex] [force]).
       Data survives restarts via vibe_math_resume.
 
       Key rules when reporting: a problem is "solved" when one of its 解法候选 entries reaches 概率 = 1
@@ -87,7 +96,7 @@
           explicit, reasoned blocker record; the scheduler is never wedged by it).
         - Paths: work file Formal/<id>.lean; archived proof Verified/Lean/<id>.lean; reusable
           definitions VibeMath/Formal/Lib/; proved lemmas VibeMath/Formal/Proved/.
-        - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs are tunable as well
+        - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs / leanAsync / leanInitiative / leanSearchPaths / leanJobsMaxParallel are tunable as well
           (e.g. leanCommand='lake' with leanArgs=['env','lean']); a missing Lean binary is
           reported as LEAN_NOT_FOUND and still lets the code be written and archived.
         - vibe_math_status / vibe_math_report show the mode, the per-object formal status and the
@@ -129,7 +138,10 @@
         plannerEnabled/plannerProvider/plannerModel/plannerPersona, planMinIntervalMs, plannerMaxFails,
         methodKeepIntervalMs/methodKeepEvery, methodAutoPromote, indexAutoRebuild, projectLockTimeoutMs,
         formalVerify/leanCommand/leanArgs/leanTimeoutMs — Lean 形式化验证（off = 默认不额外要求，
-        encourage = 按实现难度自行形式化、Lean 通过后审查对象变为忠实性，require = 同上并加结论门禁）).
+        encourage = 按实现难度自行形式化、Lean 通过后审查对象变为忠实性，require = 同上并加结论门禁）,
+        finalPaper/paperFormat/paperLanguage/paperCompilePdf/paperLatexCommand — 最终论文（收口时自动派遣
+        「论文撰写」子代理，把已收口的解法/命题/成果整理成 Paper/<project>/；finalPaper=false 只关自动触发，
+        /vibe paper 仍可手动触发）。
       - vibe_math_setup / vibe_math_save_settings / vibe_math_template — guided configuration / persist defaults / generate template.
       - vibe_math_plan {force?} — show queued plan / last plan, or force a planning round.
       - vibe_math_index — rebuild State/index.json from the Markdown knowledge base.
@@ -139,12 +151,18 @@
       - vibe_math_new_project / vibe_math_set_project / vibe_math_list_projects — per-project folders.
       - vibe_math_list_decisions / vibe_math_decide {id, action: approve|reject|override, verdict?} — resolve manual decisions.
       - vibe_math_list_agents / vibe_math_message_agent / vibe_math_interrupt_agent — inspect / steer / interrupt subagents.
-      - vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib — Lean formal
-        verification (execute / archive / list the reuse library). The scheduler's child agents
-        use them too; they work in every mode.
+      - vibe_math_lean_run / vibe_math_lean_archive / vibe_math_lean_lib / vibe_math_lean_read /
+        vibe_math_lean_job — Lean formal verification (execute / archive / list + read the reuse
+        library / inspect or wait for a background compile job). leanAsync=true (default) queues the
+        compile and returns a jobId; nothing counts as proved until that job settles ok (so "有把握"
+        is not the same as "已验证"). The scheduler's child agents use them too; they work in every
+        mode.
+
+      - math_computation {op: probe|run|receipt|install, engine, mode: code|file|expr, …} — 先 probe 预检引擎/包/许可，再调引擎计算并把脚本与输出归档成可复核回执；缺引擎/缺包只报告与给安装指引/计划；shell 兜底不算归档。
+      - 归档→编辑→重跑：mode:'code' 的脚本原件在回执的 scriptPath（Computation/<id>/script.<ext>），你可以用普通文件工具打开并编辑它；编辑后用 mode:'file' 指向它重跑，会写出一份**新回执/新 attempt**（含新的 scriptHash）。**旧回执对修改后的代码无效**——报告里必须引用与当前代码哈希一致的那份回执；工具会在 scriptChanged / scriptChangedDuringRun 为 true 时显式告警。
 
       A /vibe slash command mirrors the main controls (/vibe start [override]|resume [override]|pause|abort|status|report|mode
-      <auto|manual>|setup|save|add <id> <desc>|add-proposition <id> <概述>|list-propositions|methods|index|plan|lock|...).
+      <auto|manual>|setup|save|template [global|project]|add <id> <desc>|add-proposition <id> <概述>|list-propositions|methods|index|plan|lock|project [list|new <name>|<name>]|decisions|agents|paper [lang=zh|en] [format=both|md|tex] [force]).
       Data survives restarts via vibe_math_resume.
 
       Key rules when reporting: a problem is "solved" when one of its 解法候选 entries reaches 概率 = 1
@@ -169,7 +187,7 @@
           explicit, reasoned blocker record; the scheduler is never wedged by it).
         - Paths: work file Formal/<id>.lean; archived proof Verified/Lean/<id>.lean; reusable
           definitions VibeMath/Formal/Lib/; proved lemmas VibeMath/Formal/Proved/.
-        - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs are tunable as well
+        - The toolchain knobs leanCommand / leanArgs / leanTimeoutMs / leanAsync / leanInitiative / leanSearchPaths / leanJobsMaxParallel are tunable as well
           (e.g. leanCommand='lake' with leanArgs=['env','lean']); a missing Lean binary is
           reported as LEAN_NOT_FOUND and still lets the code be written and archived.
         - vibe_math_status / vibe_math_report show the mode, the per-object formal status and the