下载与安装
数模工坊是桌面软件,有 Windows 版和 macOS 版(Apple 芯片)。安装包自带 Python 运行环境和论文排版环境(LaTeX),不需要另外安装 Python。官网下载区会按你的系统选好对应的安装包。第一次打开用邮箱注册登录即可,不需要自己准备模型 API Key。
Windows
- 系统:Windows 10 / 11,64 位。安装包约 350 MB,装好后占用的空间随你的项目增长。
- 安装不需要管理员权限,默认装在当前用户目录下;安装向导里可以换位置,也可以勾选创建桌面快捷方式。
- 下载「数模工坊-Windows-….exe」,双击按向导一路下一步。
- 项目都保存在你电脑上的文件夹里(默认在软件目录下的 workspace,新建项目时也可以自选位置)。卸载软件不会删除你的项目文件夹。
macOS
- 系统:macOS 12.3 及以上,Apple 芯片(M1 及更新)。Intel 芯片的 Mac 暂不支持。安装包约 600 MB。
- 下载「数模工坊-macOS-…dmg」,双击打开,把「数模工坊」拖到「应用程序」文件夹。
- 安装包还没有经过 Apple 公证,第一次打开会提示「已损坏,无法打开」,文件本身没有坏。打开「终端」,执行下面这行(只需一次),再从「应用程序」里打开:
xattr -dr com.apple.quarantine /Applications/数模工坊.app - 项目默认保存在
~/Library/Application Support/数模工坊/workspace,新建项目时也可以自选位置;删除应用不会删除项目。
快速上手
从一道赛题到一篇可提交的论文,按下面四步走。代码、数据、图和论文都保存在本机的项目文件夹里,关掉软件也不会丢。
- 新建项目,填写选题左栏点「+ 新建项目」打开开题向导:选论文类型和参赛类别 → 贴题目、导入题目文件和数据 → 设图表数量与出图风格。
- 生成并审阅建模方案点左栏主按钮「开始」先生成建模方案。在「建模方案」页逐问检查方法、假设和得分要点,方法可以从候选里改选。方案是后面写代码和写论文的依据,值得花几分钟看一遍。
- 一键跑完,或逐题把关再点「开始」,软件按顺序求解每一问、写章、补齐框架并导出 Word。想先看每一问的代码和结果再写章,点「我要逐步控」进入逐题模式。
- 检查成稿,导出提交在「报告」页看全文和成稿检查,处理黄条里的待办,然后点左栏「导出论文」。成品在项目文件夹的 build/ 下。
第一次用,建议先点「我要逐步控」只跑问题一,看过代码、结果图和第 5.1 节的写法,再决定后面是否一键跑完。哪里不满意,直接在右侧 ModLab Agent 里说。

界面一览
| 区域 | 放了什么 |
|---|---|
| 左栏 | 项目(切换项目、新建项目、选题摘要)· 操作(开始 / 继续、我要逐步控、停止)· 产物(导出论文、导出工程包、工程文件)· 左下角账号卡(公告、充值、设置) |
| 左侧图标栏 | 收起左栏后显示:项目、代码编辑器、ModLab Agent(机器人图标)、导出论文(文档箭头)、打包工程包(拉链文件夹);下方是公告、兑换码充值、设置和账号。编辑器和 Agent 打开时高亮,Agent 在跑或有未读消息会有提示。 |
| 中间标签页 | 建模方案 · 逐题模式 · 运行日志 · 代码编辑器 · 报告 · 图表 |
| 右侧 ModLab Agent | 所有页签共用的智能体入口,可收起、可拖宽,可以同时开多个对话窗口 |
| 最右技能库 | 额外加挂的写作技能、我的技能和结果图预设,默认收起,从标签栏右侧的书本图标打开 |
| 快捷键 | Ctrl/⌘ + B 收起左栏,Ctrl/⌘ + L 收起 Agent,Ctrl/⌘ + P 快速打开文件,Ctrl/⌘ + Shift + P 命令面板。macOS 顶部菜单栏里是同一套操作,⌘ + 1–6 切换页签 |
新建项目与开题
开题向导分三步。填得越清楚,方案和代码越贴题;之后随时可以从左栏「编辑选题与素材」回来修改。
① 选择类型
- 论文类型决定写作规范、默认技能和导出模板:数学建模论文、科研论文(复现 / 实现)、SCI 英文复现、课程论文、毕业论文、文献综述、SCI 期刊论文、开题报告。类型跟随项目保存。
- 参赛类别(仅数学建模)决定篇幅和版式:国赛正文约 30 页;华为杯 50 页以上,推导和检验要写透;美赛 MCM/ICM 和亚太赛 APMCM 为英文版式,正文约 22 页。
② 选题与素材
- 题目:直接粘贴,或用「导入题目 / 需求文件」导入 PDF、Word、TXT、图片,多张截图可以一次导入。识别出的文字追加到选题框,图片里的公式会补全成可排版的公式。
- 原始数据:CSV、Excel、TXT、JSON 等,整个文件夹点「选择文件夹」。再上传默认追加,同一路径的文件覆盖。
- 参考文献:科研、综述和期刊类论文建议上传目标文献 PDF,复现和写作会严格对照其方法与公式。
- 数据获取设置是智能体的硬约束,它只用你勾选的来源:上传的或题面附件数据、按需求在 GitHub 找的公开数据(要写清需求)、可复现的模拟数据。
③ 图表约束
- 最低图数、最低表数和公式密度会写进生成要求。每问结果图 2–3 张、上限 4 张,不会为凑数出图。
- 流程图风格、示意图风格和结果图配色在这里选,整篇统一;进入工作台后还能在「图表」页和技能库里调整。
项目名称和写入地址可选,不填就用默认工作目录。项目文件夹可以整个拷走,或用「导出工程包」带到另一台电脑。
一键与逐题
两种推进方式用的是同一套智能体和同一份工程,可以随时切换。
一键全流程(「开始」)
- 每一问都要代码真实跑通、结果和图落盘、证据验收通过,才进入下一问。网络抖动和上游排队会自动等待、重连,不算失败。
- 运行中主按钮显示当前进度(如「问题2 · ①写代码中」),点它可以查看过程。
- 点「停止」随时中断,左栏会出现「从断点继续」和「重新开始」。关掉软件或进程意外退出后,再打开项目会询问是否从断点继续;上次没收尾的题会补完收尾,不会被当成已完成跳过。
- 额度用完或登录失效时,流程会暂停在当前这一问,充值或重新登录后点「继续」接着跑,不会跳过这一问。
逐题模式(「我要逐步控」)

- 确认当前方案后进入「逐题模式」页。每问一张题卡,进度依次是写代码、真实运行、验收、写本章,做完的一步打勾。
- 每题的下一步在顶部「总体进度」里点;「逐题求解并验收」按依赖顺序把剩下的题跑完。
- 勾上「代码跑通后自动撰写本章论文」,跑通一问就写这一问的章。
- 审核档位随时可调:Agent 审核要求问题清零才放行,最严也最耗额度;正常审核不放过严重和主要问题;宽松只拦硬伤,最省。
- 要改某一问,点题卡上的「在 ModLab Agent 里改」:打开这一问自己的窗口,说一句怎么改,智能体只改这一问并重跑,跑不通整体还原。
- 题卡显示「等待本轮响应」表示暂未收到新进展,不等于排队或失败;只有收到明确的拥堵信息才显示「上游拥堵」。输出速度按最近的文字估算,等待时隐藏。长时间没有新进展会提示「本轮响应较久」,可以点「唤醒续跑」,它基于已写的文件接着做,不从头再来。
- 重启后题卡或运行日志暂时是空的,点「刷新状态」重新读取;这不会重新求解,也不会中断后台任务。
| 开始(一键) | 我要逐步控 | |
|---|---|---|
| 怎么跑 | 自动跑完所有问题、框架和导出 | 每一步由你点,可以停在任意一步 |
| 适合 | 方案已审过,放着让它跑完 | 想先看每问的代码和结果;只重做某一问 |
| 额度 | 一次跑完整条流程 | 做多少花多少 |
建模方案
「建模方案」页列出每一问的类型、方法、输入输出、核心模型和得分要点。方法可以从候选里改选,假设可以直接编辑,也可以在下方用一句话让模型改写方案。表头右缘可以拖动调整列宽。
ModLab Agent
右侧的 ModLab Agent(机器人图标)是智能体的主入口,所有页签共用。对话记录跟着项目存盘,刷新或重启后接着说。拖动对话栏左侧的分隔线调整宽度,松手后会记住;双击分隔线恢复默认宽度。

对话窗口
- 默认是一个空白的「新对话」,发出第一句话后按内容命名。普通对话都能处理整个项目。
- 右上角「+」新开对话。所有页签都能关闭,关闭不会删除历史;关掉最后一个会回到空白对话。普通对话和打开的历史窗口最多同时 5 个。
- 从题卡点「在 ModLab Agent 里改」打开的是「问题 N」窗口,输入框上方标明「当前针对问题 N」,只改这一问。问题窗口不占 5 个名额,在里面点「+」新建的是普通对话。
- 每个窗口有自己的会话、上下文和模型设置,互不串话。某个窗口在跑时,切到别的窗口照样能看、能问 Ask,正在跑的那一轮不会被打断。
- 时钟图标是历史对话,按「新对话」分段列出。最近那一段回到它自己的窗口接着聊,更早的以只读方式打开,要接着聊就点「+」新开。
三种模式
| 模式 | 做什么 |
|---|---|
| Ask | 问答:解释代码、看图读表、给修改建议,不改文件,任务运行时也能问。PDF 按页渲染成图交给模型,公式以截图为准。 |
| Plan | 只读分析工程,给出可执行的步骤;确认后可以交给 Agent 执行。 |
| Agent | 全工程智能体:读代码、跑脚本、改论文全文,改动直接落盘,每一轮都能整体撤销。 |
三种模式共用设置里选的引擎和输入框下方的模型菜单,区别只在权限:Ask / Plan 在只读环境里运行,不能改文件或执行命令。
Agent 能做什么
| 能力 | 说明 |
|---|---|
| 读写与运行 | 读写工程文件,跑脚本,在代码编辑器下方开标有「Agent」的终端运行命令、读取退出码 |
| 重跑某一问 | 按软件同样的口径重跑题目脚本,记下运行记录、刷新待办 |
| 成稿检查与验收 | 随时自查成稿与提纲;「读取当前工程要求并综合验收成稿」会汇总成稿问题和导出门禁,区分未通过、检查未完成和仍需人工核对的项 |
| 导出预览 | 不排 Word 也能看到页数、各节字数、缺图和导出闸门 |
| 文献与文档 | 检索学术文献(OpenAlex / arXiv / Semantic Scholar / Crossref,DOI 逐条回查),结果进项目文献池,写参考文献时作为来源;把工程里的 PDF、Word 转成可读的文字稿 |
| GitHub | 搜公开仓库、看文件清单、读 README 与数据说明,把数据下载进 data/ 并记下仓库、版本与许可证。只在开题允许 GitHub 数据时才能下载;方案和求解阶段也能用(见设置 →「联网资料」) |
| 配图 | 生成示意图、在原图上修改、批量改、多图融合和撤销 |
| 依赖 | 缺库时按需安装,优先复用已有的兼容环境,见依赖与工程存储 |
| 远程主机 | 检测连接、在允许的目录里上传代码、提交长任务、拉回结果,见远程主机 |
指定要改的对象
- 某一问:题卡上点「在 ModLab Agent 里改」,打开「问题 N」窗口,上下文只含这一问,跑不通整体还原。
- 成稿里的一段:报告页划选一段,点「按描述修改」,这段会挂在输入框上方。可以选「快速改这一段」(直连模型改写,十几秒),或「交给智能体」(核对数字、连带改前后文)。
- 一张图:在报告页点一张图,它同样挂到输入框上方,说清要改哪里即可。
- 代码:编辑器里选中代码后发给 Agent,或按 Ctrl + K 就地改写。
- 附件:拖入、粘贴截图或点回形针,支持图片、PDF、Word、表格和代码文件。
改动、接受与撤销
- 连续的读取、搜索和运行折叠成工具组,出错时自动展开;每轮的回答和执行过程分开显示。
- 轮末的「本轮改动 N 个文件」可以展开看差异、打开文件或撤销本轮。撤销把工程恢复到这一轮开始前,要从最近一轮往回撤。
- 输入框上方的「接受全部」只确认已经落盘的改动、清空待确认列表,报告页同步显示「已接受」;快照有效期内仍可从历史消息撤销。「撤销全部」整体退回。
- 撤销后下一轮会新开智能体会话,带上撤销说明重新读取工程;Ask / Plan 也会知道。快照保留最近 20 次,缺失或恢复失败会明确报错;远程主机上的改动不在撤销范围内。
- 同一时刻只有一轮在改文件。别的窗口正在改时,你在另一个窗口选 Agent 或 Plan 发送会先确认,确认后这一句改按 Ask 回答;同一个窗口接着发,会先问是否停掉上一轮。
长任务与续跑
- 页面被挂起或网络断开(比如合上笔记本盖子)不会取消正在改的这一轮,回来后接着显示进度;点「停止」才会把这一轮整体还原。
- 长任务分段续跑:读到新资料、查到远程任务的新结果都算进展。重复同一个错误、连续没有新进展或本轮时间预算用完时显示「已暂停」,文件和撤销点都保留,排除阻碍后说「继续」即可。一轮最多续 4 段(已有成稿时 8 段),时间预算 45 分钟(已有成稿时 90 分钟)。
- 一轮里生图 / 改图的次数上限默认 4 次,可在设置 →「联网资料」里改;查文献、GitHub 不计次也不扣额度。
- 连续的接口重试合并成一条并更新次数,恢复响应后显示这段一共重试了几次;能查到时附上具体原因。
- 上下文由引擎自己压缩,不会因为聊得多就强制换会话。更换引擎或恢复会话时会带上任务要求、最近的工具证据和待办记录;恢复记录不等于验收通过,较早的细节可能需要重新读取。
智能体引擎与模型
对话框和流程里干活的编码智能体可以换。在「设置 → 智能体引擎」里选,整个对话框(Ask、Plan、Agent)都由选中的引擎接管。论文流程、守卫和校验三家共用,由数模工坊负责。
| 引擎 | 怎么装 | 模型调用从哪来 |
|---|---|---|
| Enborn Code | 随安装包自带,不用另外安装 | 数模工坊网关 |
| Claude CLI | 在设置中点「安装」,或使用本机已安装的版本 | 数模工坊网关(不支持 claude.ai 网页订阅登录) |
| Codex CLI | 在设置中点「安装」,或使用本机已安装的版本 | 数模工坊网关,或 ChatGPT 登录(codex login) |
| 自动 | — | 按对话里选的模型挑引擎 |
- 点「保存」后底栏的引擎图标与模型菜单立即更新,下一轮 Ask、Plan、Agent 都用新设置;已经在跑的任务和历史记录保留原来的引擎。
- 「安装」从 npm 获取官方发行版并校验完整性,安装到数模工坊数据目录,无需 Node.js,不修改系统环境;下载源可选 npmmirror 镜像或 npm 官方源。接入方式选「数模工坊网关」时无需另外登录,也不会读写你自己的
~/.claude、~/.codex。CLI 装在其他位置时,可在「指定可执行文件」中填写路径。 - 所选引擎不可用(未安装、未登录、守卫自检未通过)时会自动回退到 Enborn Code,保存提示和对话中都会注明原因。CLI 已启动、但在模型输出或调用工具之前就报错退出时,本轮同样改由 Enborn Code 重新执行;已经开始工作后才出错的不切换,避免重复修改文件。回退对「自动」和直接选定的引擎都生效。守卫自检失败后,需在设置 → 智能体引擎里选中该引擎,点击「测试连接」并通过守卫测试才恢复使用。
- 模型名称不必是 claude 或 gpt,候选与对话栏一致。两家都有「可切换模型」:点「获取模型列表」后按分组勾选,勾上的模型出现在对话栏的模型菜单里,数量不受别名槽位限制。Claude CLI 设置主模型和推理强度,内部别名及子代理统一跟随本轮所选模型,无需额外配置映射;Codex CLI 设置模型和推理强度。明确选定引擎后,换模型不会换引擎;只有「自动」按模型名称匹配。
- ChatGPT 账号登录:在「智能体引擎 → Codex CLI」设置首次选中的模型和推理强度;未设置模型时选官方列表第一项。模型目录来自当前账号,之后可在对话输入框切换模型和强度,各对话独立保存。登录 ChatGPT 后可点击「查询额度」,查看剩余百分比及重置时间,支持手动刷新;窗口时长以官方返回为准。
- 每轮回复显示这一轮实际使用的引擎和请求模型;由 CLI 自己选模型、还不知道具体名称时不显示猜测值。「按序补链」里软件直接写章的步骤标为「工坊流程」,交给智能体接手时再显示它的引擎。
每个对话的模型、思考与上下文
- 点输入框下方的模型名打开菜单:思考开关、上下文窗口、强度档位和模型列表,菜单只列出模型支持的选项。每个普通对话、问题对话都有自己的一套,重开项目后恢复;改一个窗口不影响别的窗口和软件默认值,改动从这个窗口的下一轮生效。
- 上下文档位是本地的历史与压缩预算,不会扩大上游模型的真实容量。圆环优先显示引擎回报的可用窗口,暂时没有回报时注明按配置估算。
- 每轮消息里的「本轮配置」可以核对请求模型、上下文预算、推理强度的来源和不支持的项。不同引擎的思考开关、预算和输出上限不通用,映射不了的项会明确说明。
- 把上下文切小、或换成窗口更小的模型,而这场对话已经比新窗口大时,会让你选:现在压缩(把记录写成摘要,同一条会话接着用,要等几十秒、花一点额度)、下一轮换新会话(不花额度,带上整理好的前情摘要,细节会少一些)或取消。
- 问它是什么模型时,助手保留数模工坊身份,同时说明本轮配置的引擎和请求模型。「推理信息」来自引擎输出,可能只是摘要,不能用来认证模型身份。
默认模型
设置里的「默认对话模型」用于方案、代码和论文各环节,以及新对话的初始选择;修改它不会覆盖已有对话的选择。
报告与成稿检查
「报告」页显示整合后的成稿 report.md,公式实时渲染。页面顶部的卡片会告诉你成稿还差什么。

成稿检查
- 点「检查成稿」是看这篇稿读者拿到满不满意,不是看能不能导出。分三类:硬问题(缺图、公式印成源码、同一章出现多次,稿是残的,建议先改)、查不到来源的数(评委问起来说不清从哪来,建议核对;题目里本来有的数写上来源即可)、提示(不改变对错,但读起来不像正式论文;点那颗计数会弹出每一条)。
- 有问题时点「让智能体处理」,清单和处理原则会填进 ModLab Agent,你确认后再发。
- 每轮改完,卡片上显示「上一轮改了 N 个文件」,可以「看成稿改动」或「撤销这一轮」。在对话里点过「接受全部」后,卡片显示「已接受」并收起撤销按钮。
综合验收
可以让 Agent「读取当前工程要求并综合验收成稿」。它会查询技能规范,汇总成稿问题与导出门禁,区分未通过、检查未完成和仍需人工核对的项。验收记录保存在 results/_agent_review.json,改动后需要重新检查。自动检查通过不代表学术论证或排版已经全部合格。
黄条待办与按序补链
- 代码、数据或结果变了,依赖它们的章节和摘要就会过期。报告页用黄条列出待办,顺序是:先重跑,再重写章,最后重写框架节。
- 点「按序补链」按这个顺序自动做完;某一步没做成会交给智能体接手一次,过程都在 ModLab Agent 里。
- 黄条说某一章「还写着失效的旧数」,但那些数其实没错(比如是参数)时,点「我确认无误」即可,不必重写。
直接在成稿上改
- 成稿可以在编辑器里直接改,也可以划一段交给 ModLab Agent 改。改动会自动写回对应的章节文件,两边保持一致。
- 编辑器保存时,如果磁盘上的文件已经被流程更新过,会让你选「载入磁盘版本」或「保留我的版本」,不会悄悄覆盖。
图表
「图表」页集中展示 figures/ 下的全部图片和 results/ 下的数据表。图分两类,改法不同。
| 类别 | 怎么来的 | 怎么改 |
|---|---|---|
| 结果图 | 求解脚本用 matplotlib 画出,数字来自真实结果 | 「编辑重绘」按描述改绘图代码再重跑;版式统一用「全部按预设重绘」 |
| 示意图 | 流程图、技术路线图、机理图等,由生图模型绘制 | 「编辑重绘」在原图上改或重画;「换个风格」只换版式、不改内容 |
结果图预设
- 技能库面板里的「结果图预设」管字体、字号、刻度、边框、网格和整篇配色,保存到项目的 plot_prefs.json。
- 改完点「全部按预设重绘」,所有出图脚本按新版式重跑,不调模型、不花额度。
- 同一个量在整篇论文里用同一种颜色,跨图自动统一。
图片编辑与重绘

- 默认结合原图当初的提示词和正文语境来改,不是随意重画;关掉「结合原图依据」才只按本次描述出图。
- 结果先进草稿区,由你决定替换原图、存为新图还是插进章节。替换前会留底,可以「撤回」或「撤销上次修改」。
- 「新建配图」可以上传一张参考图来学风格:只学排布、配色和流程逻辑,不抄内容。
示意图的规矩
一张示意图最多 7 个模块(顶会架构版式 9 个)、3 个分组、2 条公式;图上文字用短名词,中文标签不超过 6 个字。流程图里不放缩略小图,要给证据就单独出一张结果图在正文里引用。
导出与提交
导出即整合:把当前各章、框架各节和结果图收成一份成稿,再排成你勾选的格式。
导出论文
- 左栏「导出论文」打开导出窗:填论文标题;在「封面与版式」里填队号、学校、指导教师,选竞赛模板(国赛 / 华为杯 / 美赛 / 亚太赛)和表格样式(默认三线表)。
- 格式可以多选:Word(.docx,竞赛提交的主格式)、PDF(LaTeX 排版)、LaTeX 源码(可上传 Overleaf)、Markdown、工程 zip。
- 整合方式默认「确定性整合」,快且少乱码;「AI 整合 + 评审返修」更精细,但更慢。
- 成品在项目文件夹的 build/ 下,导出后点「打开所在文件夹」直接定位。
什么情况会拦住导出
- 还有任务在写盘:等它结束或先停止,避免导出半截稿。
- 黄条待办没清零、框架节没写齐、正文引用的图不在:导出窗会说明原因。可以先补齐,也可以选「直接导出」按当前稿出,缺的图会在回执里点名。
AI 工具使用声明
- 导出窗里的「附 AI 工具使用声明」勾上就附声明、生成 AI 使用文档,不勾就都不生成,不分赛事。默认勾上,记住你上次的选择,一键流程最后的导出也照这个选择。对 Word、PDF、LaTeX 生效,成稿 report.md 不改。
- 中文模板:参考文献之前加一节「AI工具使用声明」,措辞按国赛规定的固定句式,不占章节号;同时生成《AI工具使用详情》草稿(results/AI工具使用详情.md 和 build/AI工具使用详情.docx),其中的提示方式和人工核验情况须由你们补齐,再另存为 PDF 放进支撑材料。
- 英文模板(美赛、亚太、英文学术):参考文献之后加一节「Report on Use of AI」,列出所用模型和用途;每次提问的原话和模型的完整输出要由你们照实填进留好的位置。美赛只交论文本身,这些内容就写在论文里。
- 想改声明的写法,就在 report.md 里自己写一节同名标题,勾选导出时用你写的那一节。具体要求以当年赛事官方规定为准。
工程包
「导出工程包」把代码、数据、图表、章节、成稿、流程进度和依赖版本清单整包打成 zip。在另一台电脑的「选择或新建项目」里导入就能接着改,没跑完的一键流程也能从断点继续。换机后缺额外依赖时,见依赖与工程存储。
数模写作规范
数模工坊按竞赛评审的要求写论文。下面这些规矩由技能规范和系统检查一起把关,了解它们能少走弯路。
论文骨架
- 摘要:每问一段(方法 + 真实数字),「综上」收尾,附关键词
- 问题重述与问题分析
- 模型假设与符号说明
- 模型的建立与求解:每问一节(5.1、5.2…),末尾写「问题N小结」
- 模型检验与灵敏度分析
- 模型评价、改进与推广
- 参考文献(可核实);AI 工具使用声明(导出时勾选)
每问一节的写法:问题分析与建模思路 → 模型建立(要有推导)→ 求解与算法 → 结果与分析(含基准对照)→ 检验 → 小结。启发式算法的结果称「近优解」,不写「全局最优」。
数字必须有来源
- 每问的脚本 src/problemN.py 必须真实跑通,结果写进 results/,图存进 figures/。论文里的数字要能在结果文件里找到。
- 结果更新后,正文里还写着的旧数会被标成「失效旧数」;题面、数据和结果里都找不到的数会列为「查不到来源的数」。
- 数据只用开题时允许的来源;GitHub 公开数据会记下仓库、版本和许可证。
图表与公式
- 每张图都要在正文引用并给出结论;灵敏度分析要有真实的图和文字结论。
- 结果图整篇统一预设和配色,表格默认三线表。
- 公式用 LaTeX 写,导出时转成 Word 公式;转不了的公式会在成稿检查里提示。
技能库与我的技能
- 论文类型的默认技能(数模主干,以及工程、数据与证据、推导、得分点、灵敏度、写作一致性、摘要等分支)始终生效,各阶段按需取用。技能库(标签栏右侧的书本图标,点开从右侧滑出)里勾选的会在此基础上额外加上,不会替换默认技能。
- 技能库右上角可以「新建我的技能」或导入一份 SKILL.md。它的硬约束每次都会注入,排在默认技能后面,超过 2800 字不能保存。自己的技能智能体能读,不能改。
代码编辑器与终端
项目就是磁盘上的一个文件夹。「代码编辑器」页是内置 IDE:左侧资源管理器、中间编辑区、下方终端,右侧照常是 ModLab Agent。

项目里的文件
| 位置 | 内容 | 能否手改 |
|---|---|---|
| src/ | 每问的求解脚本和公共模块 | 可以 |
| data/ | 上传的原始数据 | 可以 |
| chapters/、sections/ | 各问章节和框架各节(摘要、结论等) | 可以 |
| report.md | 整合后的成稿,改动会写回章节文件 | 可以 |
| results/、figures/ | 脚本运行产出的结果和图 | 不可以,改代码后重跑 |
| build/ | 导出的 Word、PDF 等成品 | 不需要 |
- 运行产物和系统文件在编辑器里显示「🔒 只读」,并写明该去哪里改。结果和图必须由代码跑出来,手改会让论文里的数字失去来源。表格(xlsx、csv)和 PDF 是只读预览。
- 资源管理器顶部的新建、刷新和折叠按钮,在鼠标移入文件列表或焦点在里面时显示,离开后隐藏。
- Markdown 文件可以用标签栏右上角的「在侧边打开预览」同时看源码和排版结果,再点一次收起;只读的转写稿也能分栏。
保存并运行
- 打开 src/ 下的 .py 文件,点工具条的「▶ 保存并运行」:先保存再运行,输出实时显示在下方面板,运行中可以停止。
- 本题的求解脚本(src/problemN.py)和流程里一样处理:记进这一问的运行记录、重建账本、刷新待办,报告页的「代码改过还没重跑」随之消掉。跑通了但还缺结果文件或结果图时,面板会说明运行记录没算通过。共享模块、探测脚本等其它 .py 照常运行,但不记哪一问的运行记录。
- 依赖栏在工具条下方:这个脚本是哪一类、引用了哪些共享模块和题脚本、又被谁引用、运行记录还算不算数。改了共享模块,可以在这里把引用它的脚本逐个重跑。
- 跑挂了,面板底部有一行摘要和出口:「跳到出错行」;缺第三方库时「安装 xxx」;「交给 AI 修」把报错填进 ModLab Agent 的输入框,你看过再发送。脚本引用的名字已经不存在(多半是改名了)时,会直接说明原因并列出相近的名字。
- 脚本或它引用的文件之后被智能体、流程改过,旧报错就过时了,摘要行会换成「重新运行」。
终端
- Ctrl + ` 打开或收起终端,可以开多个;「在终端运行」把当前文件交给终端执行。终端用的是软件自带的 Python 和项目的依赖环境。
- 在 Agent 对话里说「在编辑器终端运行这段代码」,智能体会新开一个标有「Agent」的终端,你在下方能看到真实输出;也可以让它读取退出码、停止命令或关闭终端。各项目的终端分开,智能体不会接管你手动开的终端;Ask / Plan 模式不执行命令。
快捷键
| 按键(macOS 用 ⌘ 代替 Ctrl) | 功能 |
|---|---|
| Ctrl + S | 保存当前文件 |
| Ctrl + P | 快速打开文件 |
| Ctrl + Shift + P | 命令面板 |
| Ctrl + Shift + F | 在整个项目里搜索 |
| Ctrl + K | 对选中的代码下达修改指令,先看改动再接受 |
| Ctrl + / | 注释 / 取消注释 |
| Ctrl + F | 文件内查找 |
| Ctrl + ` | 打开 / 收起终端(macOS 上也是 Ctrl) |
| Ctrl + B / Ctrl + L | 收起左栏 / 收起 ModLab Agent |
| Enter | 对话框发送(Shift + Enter 换行) |
| Esc | 关闭打开的下拉菜单 |
依赖与工程存储
软件自带常用的科学计算库。脚本还要别的 Python 包时,由软件统一下载和管理,不装进共享的运行环境,也不塞进工程文件夹。
怎么装
- 编辑器运行报
No module named …时点摘要行的「安装 xxx」;智能体在 Agent 模式下也会按需安装。项目里有同名模块、或名字像题脚本时不会去装:这种报错说的是路径或名字写错了。 - 已有兼容的共享环境就直接复用,不调用 pip、不重复下载;缺少时才下载安装到暂存目录,成功后再启用,失败保留原环境。不同版本并存,互不覆盖。
- 装完后已经打开的终端和智能体下次启动 Python 就能用上,不用重启软件。
工程存储与依赖
- 工程文件栏的「工程存储与依赖」分别显示独立依赖、本项目使用的共享依赖和过程日志的占用;共享占用不是每个项目各存一份。可以记录依赖版本、按清单联网恢复依赖、清理超限日志。
- 每份过程日志超过 8 MB 后自动保留最近约 4 MB 并留下裁剪标记;手动清理也只处理超限日志。代码、数据、结果、论文和撤销快照不受影响,较早的过程回放会丢失。
- 工程包只带依赖的版本清单,不带安装好的包。换机后缺依赖,在这里点「按清单恢复」(需要联网);用软件运行脚本时清单没满足也会先自动准备。
- 旧工程里的 .dependencies 继续可用、随工程包导出,不会被自动迁走或删除。
远程主机
实验要跑很久、或要用服务器上的显卡时,可以让 Agent 在你自己的服务器上跑,跑完把结果拉回项目。
- 设置 →「远程主机」添加 SSH 主机。第一次连接要核对主机指纹,指纹变了会拒绝连接,需要你重新确认。口令和私钥只存在本机的凭据仓里。
- 默认只读,只能查看。填一个远端工作目录、再打开「允许写入」,Agent 才能在这个目录里上传代码、提交长时间任务;不填目录就打不开写入。
- 可以直接让 Agent「检测已配置的远程主机」:它先列出主机、检测连接和权限,再按允许的范围执行。连接成功、命令被拒绝、远端程序不存在会分别说明;Agent 不能自行确认新指纹或修改主机权限。
- 跑完后让 Agent 把 results/、figures/ 拉回来,结果才进论文和运行记录。远端的改动撤销不了。
账号、套餐与用量
左下角账号卡显示会员档位和剩余额度,点「设置」管理账号、模型和用量。
套餐与钱包
- 会员套餐显示剩余百分比和到期日;钱包是另外的余额。两者都在设置里显示。
- 充值:左下角「充值」或设置 →「兑换码充值」。额度用完时,运行中的流程停在当前这一问,充值后点「继续」。
用量明细
- 设置 →「用量明细」按时间列出每一次调用:模型、推理强度、扣费类型、token 和扣费金额。
- 扣费类型:订阅从会员套餐额度扣,钱包从余额扣。
- Token 拆成输入、输出、缓存读(↓)和缓存写(↑)。
- ChatGPT 套餐按轮记录模型、强度和执行结果,不扣数模工坊余额。用量来自客户端,拿不到时显示「未提供」;离线记录联网后补传。
注册与登录
- 账号在软件里注册和登录。用邮箱注册时先点「发送验证码」,填邮箱收到的验证码后再创建账号;忘记密码可以在登录框里用邮箱验证码找回。
- 账号开了两步验证时,密码通过后会多出一个验证码框,填动态验证码即可;填错了可以重填,验证过期会退回到输密码这一步。
- 同一账号在别处登录会让本机登录失效。运行中的流程会暂停并弹出登录框,重新登录后接着跑。
- 登录凭据只保存在本机:Windows 上用系统加密,Mac 上存在只有你的账户能读的文件里。
外观
设置 →「外观」调整应用主题与壁纸;设置会保存,重启后还在。编辑器默认跟随应用配色。
- 主题:深色、浅色或跟随系统;强调色有六种。
- 壁纸:几款内置插画,也可以上传自己的图片。建议 2560 × 1440 像素(16:9 横图),重要主体放中央;壁纸会居中铺满窗口,边缘可能裁切。支持 PNG / JPG / WebP,最大 25 MB,会去掉照片里的拍摄地点等信息。开了壁纸,弹窗和下拉菜单会一起换成毛玻璃;选「默认」就是不开壁纸。
- 「遮罩」控制壁纸明暗(浅色主题下为提亮),「模糊」柔化图片,「面板不透明度」越低壁纸越明显。默认遮罩 16%、面板不透明度 50%;可读性保护会在图片偏亮或偏暗时按需加深面板,保证小字看得清。
更新与旧版迁移
软件更新
- 启动时会自动检查,也可以在设置里点「检查更新」。有新版本时顶部出现横幅,点「立即下载更新」,按钮上显示下载进度;下完变成「安装并重启」。
- 安装包是官方签名的:软件会重新核对清单签名和安装包摘要,对不上就不会启动安装程序。核对没通过、或不在桌面窗口里时,会打开官网下载页,下载后手动安装即可。
- 安装会关闭数模工坊。有任务在跑时会先提示,任务可以在重新打开后点「继续」接着做;项目和账号都保存在本机,更新不会动它们。
- Mac 版暂不能在软件里一键安装:点横幅上的按钮下载新版 dmg,退出数模工坊,把新版拖进「应用程序」替换,再执行一次上面「下载与安装」里的
xattr命令。
从旧版(1.4.x)搬过来
- 1.4.9 起是全新基座,与旧版并行安装、互不覆盖,旧版的项目和设置原样保留。
- 安装向导会发现旧版,问你要不要把旧版的项目复制过来、要不要卸载旧版本体(旧版正在运行时只提示,不会强行卸载)。卸载旧版不会删除项目。
- 第一次启动、本机还没登录时,会沿用旧版保存的登录状态(先向服务器确认票据有效),不必重新输入密码。
换电脑
在旧电脑点「导出工程包」,到新电脑的「选择或新建项目」里导入,就能接着做,没跑完的一键流程也能从断点继续。项目文件夹本身也可以直接拷走再打开。
常见问题
运行中
题卡很久没有动静怎么办?
Agent 显示「已暂停」是怎么回事?
代码跑不通怎么办?
关掉软件,流程会丢吗?
在代码编辑器里运行脚本,提示 No module named …?
对话与引擎
想同时聊两件事怎么办?
能换成 Claude CLI 或 Codex CLI 吗?
「接受全部」和「撤销全部」有什么区别?
额度与账号
余额或套餐用完了会怎样?
为什么突然弹出登录框?
成稿与导出
导出时提示还有待办没完成?
导出的 Word 在哪里?
成稿检查说某个数「查不到来源」,一定是错的吗?
图表数量不够怎么办?
文件与项目
为什么有些文件不能编辑?
切换论文类型会影响已有项目吗?
改坏了能撤销吗?
项目和数据会发给谁?
联系我们
没找到答案,或者遇到了软件的问题,来官方 QQ 交流群问:
反馈问题时请带上:软件版本(设置里可看)、做到哪一步、报错原文或截图。软件里「帮助 → 反馈问题」可以生成诊断包(日志与现场)直接发给我们;过程日志也可以在题卡的「事件日志 / CLI 原始日志」里找到。