OrinVoss/dsh-math-team / presets/paper/skills/math-paper/references/roles-论文手
论文手
Verified根据题目、建模分析和真实代码结果生成完整 Word 数学建模论文,用户显式要求时同时生成 LaTeX 论文。
| File | Kind | Size |
|---|---|---|
| LaTeX格式规范.md | markdown | 4.3 KB |
| SKILL.md | skill md | 10.9 KB |
| 写作规范.md | markdown | 4.2 KB |
| 工作流程.md | markdown | 8.7 KB |
| 章节模板.md | markdown | 1.7 KB |
| 自审框架.md | markdown | 4.2 KB |
| 英文化工作流.md | markdown | 5.2 KB |
| 论文格式规范.md | markdown | 5.2 KB |
论文格式规范.md
View on GitHub> **⚠️ 工具脚本未随附**:本文档引用到的 `tools/*` 路径(如 `tools/latex`、`tools/docx`、`tools/figure/scripts`、`tools/paper_search` 等)来自参考仓库的**工具脚本**,本预设**仅随附方法论文档,未包含这些脚本**。遇到文档中的此类命令时:按正文描述的方法自行实现等价脚本,或由团队在共享工作区另行接入对应工具;**不要假设这些脚本存在于本机**。方法规范本身仍然有效。
# Word 论文格式规范
## 唯一权威来源
论文内容结构与格式必须遵循目标竞赛当届官方规则和官方模板。常用官方入口:
- 全国大学生数学建模竞赛:`http://www.mcm.edu.cn/`
- CUMCM 2026 论文格式规范:`https://www.mcm.edu.cn/upload_cn/node/775/cQMeL0YY905244c8bd4b9af832f1699446d8385e.pdf`
- MCM/ICM:`https://www.comap.com/contests/mcm-icm`
竞赛规则可能更新。生成前必须确认届次和官方文件版本,不能把本 Skill 的默认值当作永久规则。
### CUMCM 篇幅的硬约束与质量目标
- 2026 年官方《全国大学生数学建模竞赛论文格式规范》规定摘要原则上不超过一页、正文不超过 30 页,没有规定最低 15000 字或最低 20 页。
- 为防止论文过短,工具默认用约 15000 字词单位和约 20 页作为 CUMCM 完整度质量目标;它们不是官方最低要求,可由当届规则或用户要求覆盖。
- 页数必须以 DOCX 渲染成 PDF 后的实际页数为准,不能根据字符数猜测。
## 模板驱动生成
推荐流程是“官方参考模板 + `python-docx` 内容构建 + OMML 公式 + 结构校验 + 渲染抽检”。
```python
from pathlib import Path
import sys
skill_root = Path("<SKILL_ROOT>")
sys.path.insert(0, str(skill_root / "tools" / "docx" / "scripts"))
import paper_format as pf
doc = pf.new_document(
contest="cumcm",
template_path=Path("<PROJECT_ROOT>") / "当届官方模板.docx",
preserve_template_content=False,
)
pf.title(doc, "论文题目")
pf.abstract_title(doc)
pf.body(doc, "摘要正文。")
pf.keywords(doc, "关键词一;关键词二")
pf.save_document(doc, Path("<PROJECT_ROOT>"), contest="cumcm")
```
传入模板时,`paper_format.py` 保留模板的样式、分节和页面设置。官方模板含固定摘要页、编号页或占位符时使用 `preserve_template_content=True` 并在原位填充;只借用样式时使用默认值清除示例正文。未提供官方模板时,`cumcm` 和 `mcm-icm` 配置仅提供构建基线,必须再与当届官方规则核对。
## 公式
- 使用 `paper_format.equation()` 或 `equations.py` 写入 Word 原生 OMML。
- 支持常用希腊字母、关系符号、反三角函数、分式、根式、上下标、矩阵与分段表达式,包括 `\nu`、`\mu`、`\approx`、`\arcsin`、`\arccos` 和 `\arctan`;未知命令、未闭合分组和不支持环境会明确失败。
- 复杂公式优先使用 Pandoc 的成熟 LaTeX→OMML 转换,再进行 DOCX 校验。
- 最终公式必须可编辑,不能是截图或纯文本 LaTeX。
## 完整 LaTeX 论文转换
```powershell
python ../../../../tools/docx/scripts/equations.py convert-latex "<PROJECT_ROOT>/完整论文-LaTeX/main.tex" --output "<PROJECT_ROOT>/完整论文.docx" --template "<PROJECT_ROOT>/当届官方模板.docx"
```
该命令需要系统已安装 Pandoc,使用 citeproc 处理 BibTeX 引用,将公式转换为原生 OMML,递归展开项目内的 `\input`/`\include`,并从 LaTeX 项目目录读取相对图片。任何 Pandoc 警告默认阻断 DOCX 发布;只有逐项检查后才能同时使用 `--allow-warning` 和 `--override-reason`。成功转换会生成 `.conversion.json`,用于核对输入、输出、模板哈希、Pandoc 版本和复现命令;交付前运行 `equations.py verify-conversion "<PROJECT_ROOT>/完整论文.docx"` 重新计算全部哈希。自定义宏、浮动体、交叉引用和参考文献样式仍须人工核对;未提供 CSL 时尤其要检查引文样式。输出仍需执行本规范后续的结构校验和渲染抽检。
## 表格与图
- 表格必须可编辑;三线表使用 `three_line_table()`。
- 图来自编程手真实运行结果,可从候选图中选择。
- 每幅图和每个表必须有连续编号与题注,并在正文中至少引用一次;单位和数值必须一致。
## 校验
```powershell
python ../../../../tools/docx/scripts/check_env.py
python ../../../../tools/docx/scripts/self_check.py
python ../../../../tools/docx/scripts/office/validate.py "<PROJECT_ROOT>/完整论文.docx"
```
生成后调用:
```python
issues = pf.validate_paper_structure(doc, contest="cumcm", rendered_pages=实际页数)
```
该检查会报告篇幅、公式/图/表数量、图表编号与正文引用、参考文献双向对应以及页数问题。默认 15000 字词单位、20 页、公式 5 个、图 8 幅、表 3 个均为 CUMCM 完整度质量目标;其他竞赛同样默认至少 8 幅正式图。2026 年 CUMCM 正文 30 页上限属于已经核验的官方硬约束。使用其他届次或竞赛时必须传入相应阈值;降低默认目标必须记录官方条款或用户要求。OOXML 校验通过后仍需渲染抽检,因为 XML 合法不等于版面正确。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |