Aampidy/dsh-mcmp
DeepSeek Harness 持久化 Cordis 插件:面向全国大学生数学建模竞赛论文撰写的全自动流水线。 粘贴赛题 → 发送一条以 /loopbegin 开头的消息 → 插件按 8 大步骤、每步多次迭代自动完成论文撰写, 全程由专家子智能体「先质疑、再迭代」驱动,成果全部落盘保存,右下角浮动面板实时显示进度百分比。 无论流水线正常完成、出错还是被中止,最终都会生成一版完整、干净的 Markdown 论文(论文定稿.md)。
catalog 简介 / catalog descriptioncatalog description：Deepseek-Harness数学建模竞赛论文全自动撰写流水线插件。Deepseek-Harness fully automatic pipeline plugin for writing mathematical modeling competition papers.
安装Install
dsh plugin --profile web add github:Aampidy/dsh-mcmp把 Aampidy/dsh-mcmp 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-mcmp · 数学建模论文自动化流水线(v2)
DeepSeek Harness 持久化 Cordis 插件:面向全国大学生数学建模竞赛论文撰写的全自动流水线。
粘贴赛题 → 发送一条以 /loopbegin 开头的消息 → 插件按 8 大步骤、每步多次迭代自动完成论文撰写,
全程由专家子智能体「先质疑、再迭代」驱动,成果全部落盘保存,右下角浮动面板实时显示进度百分比。
无论流水线正常完成、出错还是被中止,最终都会生成一版完整、干净的 Markdown 论文(论文定稿.md)。
功能特性
- 消息触发:输入文本以
/loopbegin开头即自动运行(兼容斜杠命令路径) - 8 大步骤 × 多迭代:每轮 19 次迭代,外循环轮数可配置(
--round=N,默认 1 轮) - 质疑驱动:每个子智能体必须先对上一版成果提出 ≥3 条质疑,再开始本轮工作
- 图表视觉自检与修复:S5 步骤自动探测识图插件——检测到识图服务/工具(如 vision_describe、read_image)即自动调用逐张检查定稿图;没有识图能力则让子智能体编写脚本做文本包围盒重叠/越界/乱码分析,发现问题必须修复并复检(A 级问题清零),而不是只写报告
- 评审问题修复闭环:S7 合并"合规检查 + 评审",建立《问题跟踪表》,每个 A/B 级问题必须在论文/图表/代码中实际修复并经复核验证,禁止"只写问题不修复"
- 跨步骤缺陷回传(台账机制):后续步骤发现前序步骤的错误时,必须登记
00_缺陷与裁决台账.md并直接修复出错文件(标注修正来源),下游以台账最新裁决为最高权威——错误在源头修掉,不打下游补丁 - 论文兜底定稿:S8 组装完整、可直接提交的
论文定稿.md;即使流水线提前出错或中止,也会追加一次兜底定稿 - 成果全落盘:每步迭代完整追加保存(含质疑清单),旧内容绝不覆盖;代码保留全部历史版本;全新运行时旧目录自动归档为
数学建模流水线_历史归档_* - 实时进度面板:独立浮动窗口(可拖拽/最小化/关闭),显示百分比进度条、当前轮/步骤/迭代、8 步骤打点、日志、产出文件,支持一键中止、重置(全新开始)
- 断点续跑与重置:中断/关闭窗口不丢进度,再次
/loopbegin自动续跑;/loopreset或面板「重置(全新开始)」清空续跑记录,下次从头跑 - 原生工作流卡片:聊天区实时显示每个子智能体的运行状态(按阶段分组)
八大步骤(每轮 19 次迭代)
| 步骤 | 内容 | 迭代次数 |
|---|---|---|
| S1 | 赛题分析与建模方案 | 2 次(赛题精读与拆解→建模方案定稿) |
| S2 | 模型建立与求解 | 3 次(模型建立→模型求解→模型验证设计) |
| S3 | 编程实现与数值验证 | 3 次(核心代码→调试与数值验证→封装与自测) |
| S4 | 图表与流程图生成 | 3 次(基础图表与结构图→美化统一→精选定稿) |
| S5 | 图表视觉自检与修复 | 2 次(视觉自检与问题清单→修复与复检) |
| S6 | 论文撰写 | 2 次(初稿→润色终稿) |
| S7 | 评审与修复落实 | 3 次(合规检查与评审→修复落实→修复复核) |
| S8 | 论文定稿与提交包 | 1 次(必产出完整 论文定稿.md) |
跨步骤纠错机制:每一步骤开工前必须先读
00_缺陷与裁决台账.md(由 S1 创建)。发现前序步骤的错误时:①登记台账(编号/证据/修复方案)→ ②直接编辑修复出错文件并标注「第R轮·Sx修正:D#编号」→ ③同步所有下游引用。任何文件与台账最新裁决冲突时,以台账为准。S8 终检台账,未闭环项列入「遗留缺陷清单」。
使用方法
- 发送赛题:把数学建模竞赛题目完整粘贴到对话框并发送;
- 触发插件:发送一条以
/loopbegin开头的消息:/loopbegin—— 默认 1 轮/loopbegin --round=3—— 3 轮外循环(上限 10)/loopbegin --from 题目.txt—— 从文件读取赛题(支持含空格/中文的文件名,如--from 2024 年高教社杯全国大学生数学建模竞赛题目.md,也可用--from=文件形式)/loopbegin --model glm-vision/glm-4.7-Flash—— 可选显式覆盖(也可用--provider 提供商 --model 模型分拆形式)。默认不需要此参数:流水线子任务的模型强制跟随你在对话右下角选择的模型(每次启动时读取当前选择);若无法读取(未安装默认模型服务),兜底使用deepseek-official/deepseek-v4-flash(high 推理由 deepseek 提供商默认提供)
- 查看进度:右下角浮动面板(百分比、步骤打点、日志、文件)+ 聊天区工作流卡片。
辅助命令:/loopstatus(查看进度)、/loopabort(中止,已产出成果保留)、/loopreset(清空状态与断点续跑记录,下次 /loopbegin 从头全新开始;等价于面板「重置(全新开始)」按钮)。
触发规则
| 消息内容 | 是否触发 |
|---|---|
/loopbegin --round=3(开头) |
✅ |
/loopbegin(前导空格) |
✅ |
题目正文… /loopbegin(不在开头) |
❌ |
/loopstatus、/loopabort、/loopreset |
辅助命令,不触发 |
安装方式
插件包已发布到 npm(dsh-mcmp),并声明了
dsh.bundle补丁:安装后自动注册配置行,无需任何手动步骤。
安装(唯一方式)
# 一条命令完成:安装包 + 自动注册(通过 bundle 机制)
pnpm dsh plugin --profile web add dsh-mcmp
# 等价调用形式:
# dsh plugin --profile web add dsh-mcmp
# npx @deepseek-ai/dsh plugin --profile web add dsh-mcmp
# 然后重启:
# 重启 pnpm dsh web → 刷新网页
# 验证:浏览器访问 /mcmp-api/state,返回 JSON 即成功
升级:
pnpm dsh plugin --profile web update dsh-mcmp
卸载:
pnpm dsh plugin --profile web remove dsh-mcmp
输出目录(工作区 数学建模流水线/)
数学建模流水线/
├── 00_赛题原文.md # 启动时自动保存的赛题
├── 00_缺陷与裁决台账.md # ★ 跨步骤缺陷台账:错误登记、裁决、向上修复的唯一权威
├── 01_赛题分析.md ~ 08_论文定稿.md # 八大步骤完整成果(逐迭代追加,含质疑清单/问题跟踪表)
├── 论文定稿.md # ★ 最终交付:完整、干净的 Markdown 论文(无论成败都会生成)
├── 代码/ # 全部验证与求解代码(_vN 后缀保留历史版本,绝不删除)
│ └── results/ # 权威结构化结果(CSV/JSON + 结果索引)
├── 图表/ # 全部图表(定稿/ 为论文插图,归档/ 为冗余图)
└── 数学建模流水线_历史归档_*/ # 全新运行时,上一次运行成果自动归档(改名,不删除)
架构
插件按职责拆分为三个模块:程序入口(lib/index.js)、论文写作主循环(lib/pipeline.js)、显示界面(lib/client.js)。
用户消息(/loopbegin 开头)
│ session/event 全局监听(或 commands 斜杠命令)
▼
程序入口模块(lib/index.js)
├─ 输入框内检测:斜杠命令注册 + 消息触发监听 + systemPrompt 模型侧提示
├─ 模型选择:父对话当前选择 / --model 显式覆盖 / 兜底 DeepSeek V4 Flash
├─ 题目检测:提取赛题(对话文本或 --from 文件)
├─ 识图能力探测(宿主服务/工具注册表扫描;S5 子智能体再自检,以自检为准)
└─ 启动解析与校验(--round/--fresh/--model/--from)→ 委托主循环模块启动
▼
论文写作主循环模块(lib/pipeline.js,createPipeline 实例)
├─ 断点续跑:扫描会话日志中 tool-workflow/* v2 记录,跳过已完成迭代
├─ 编排器:按 8 步骤 × 19 迭代 × N 轮逐个启动专家子智能体(subagents.spawn)
│ 子智能体:读必读文件 → 质疑先行(质疑驱动)→ 完成任务 → 追加落盘 → 返回总结
├─ 兜底定稿:若 S8 未完成(出错/中止),追加一次子智能体组装完整 论文定稿.md
├─ 向会话追加 tool-workflow/* 事件 → 聊天区原生工作流卡片
└─ 运行状态/进度快照/中止/重置:供入口命令与面板 API 调用
▼
显示界面模块(lib/client.js,标准 __ModuleLoader__ bundle)
├─ shell.overlay 浮动面板,每 1.2s fetch('/mcmp-api/state') 轮询
└─ 进度条/步骤打点/日志/文件/中止按钮(拖拽仅绑定标题文字)
(面板 API 路由 /mcmp-api/{state,abort,reset} 由程序入口模块注册并转发)
文件说明
仓库根目录即插件包本体(发布到 npm 的内容 =
lib/+cordis.patch.yml+package.json;tests/不随包发布)。
| 文件 | 内容 |
|---|---|
package.json |
插件包清单:dsh.bundle 补丁声明、dsh.client 声明、exports 入口(. → Host,./client → 面板 bundle) |
cordis.patch.yml |
bundle 补丁:安装时自动注册插件行(insert: mcmp),无需手动编辑配置 |
lib/index.js |
程序入口模块:输入框内检测(斜杠命令注册、消息触发监听、systemPrompt 模型侧提示)、模型选择(父对话当前选择 / --model 覆盖 / 兜底)、题目检测(对话文本提取 / --from 本地文件)、识图能力探测、启动参数解析与校验、/mcmp-api 面板路由注册 |
lib/pipeline.js |
论文写作主循环模块:8 步骤元数据与提示词构造(含质疑驱动)、子智能体调度、主循环编排(断点续跑、失败熔断、中止处理、兜底定稿)、运行状态与进度快照、中止/重置 |
lib/client.js |
显示界面模块:浮动进度面板(标准 __ModuleLoader__ bundle,fetch 轮询、显示与交互) |
tests/smoke.mjs |
冒烟测试:伪造 Cordis ctx 驱动插件,验证启动/触发/断点续跑(含多轮)/中止/兜底/--from/识图探测等路径,node tests/smoke.mjs(不随 npm 包发布) |
License
MIT
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…