从研究问题到可核验论文：一套支持任意步骤直达、证据分级和质量闭环的学术论文工作流。
From research question to verifiable paper: start from any Step, keep evidence visible, and close every quality gate.
more-paper-workflow 不把论文简化成“一键生成文本”。它把定题、大纲、检索、PDF、Zotero、写作、科研图表、论文流程图、引用审计和保守润色连成一条可追溯链路。
它面向的是“能继续写、能审、能投稿”的论文项目：先把研究问题、证据来源、章节任务和图表意图落成可核验工件，再进入写作、绘图和润色。Step 7 既能保留论文原图，也能基于可信数据生成科研图表，并内置原生论文流程图/架构图引擎，输出语义 SVG、PNG 预览、布局检查和证据哈希；刊发模式默认支持纯黑白、无底纹和字号门控。
已有 DOI、PDF、Zotero 文库或草稿？你可以直接进入对应 Step，不必机械重跑前序流程；但证据边界、Checkpoint 和 Completion Gate 不会被跳过。
| 项目 | 主要用途 |
|---|---|
| more-paper-workflow（当前项目） | 论文定题、文献检索、证据组织、写作、科研图表、论文流程图与引用审计 |
| more-sci-figure | 科研图表数据提取、人工复核、论文级重绘与交付验证 |
| more-comic-digitizer | 儿童手绘漫画数字化、审核、共创与电子出版 |
| more-news-briefing | 新闻与行业信息收集、去重、排序、核验和简报生成 |
More 系列是并列的独立 skill 目录，不是一条强绑定流水线。more-paper-workflow 独立拥有论文项目的 Step 1-8、证据门和完成标准；其他项目只作为选型参考或外部已验收产物来源，不会被自动调用。
English readers: start with the English summary and copy-ready prompts.
more 系列 · 快速开始 · 八步工作流 · 安装 · English · 完整流程图 · 最小样例
Why it matters: useful academic writing keeps research questions, evidence, claims and deliverables connected.
论文真正困难的地方，通常不是“写出一段话”，而是下面几个问题：
- 检索结果能否对应研究问题和章节证据需求？
- 引用是否来自真实、匹配且读到足够深度的文献？
- 草稿、图表和修订是否达到可以交付的状态？
本工作流默认采用：先发散、后收敛、候选池先保留。每一步都明确输入边界、候选池、输出工件和失败回退：先把主题、假设、路线和反例放进候选池，再把当前轮收敛成一个执行包。
Three practical differences
| 能力 / Capability | 常见 AI 写作方式 / Typical AI writing | more-paper-workflow |
|---|---|---|
| 工作范围 / Scope | 从主题直接生成正文 | 从定题到终验的现有 8 步工作流 |
| 证据使用 / Evidence | 容易混用标题、摘要和全文 | 明确区分候选、元数据、摘要和全文证据 |
| 任务状态 / Status | 生成结束即视为完成 | 区分草稿、风险、失败、待人工和可交付状态 |
| 进入方式 / Entry | 从头执行固定流程 | 依据现有材料 direct-entry |
| 高风险动作 / Risk | 容易静默继续 | 登录、外部写入和弱证据使用前明确确认 |
Eight Steps · Direct Entry · Evidence-Grounded
| 阶段 / Phase | Step | 解决的问题 / Purpose | 主要产物 / Outputs |
|---|---|---|---|
| 研究设计 / Research design | 1 · 研究主题 / Topic | 研究什么、边界在哪里、如何证伪 | 研究主题.md |
| 研究设计 / Research design | 2 · 大纲关键词 / Outline | 章节如何承接 RQ 和证据需求 | 大纲关键词.md、section_blueprints.json |
| 研究设计 / Research design | 3 · 检索方案 / Search plan | 如何形成可执行、可复核的查询 | 检索方案.json、compiled_queries.json |
| 证据获取 / Evidence acquisition | 4 · 检索评分 / Search & score | 如何检索、核验、去重、评分与分层 | workflow_search_results.json、step4-dashboard/ |
| 证据获取 / Evidence acquisition | 5 · PDF 下载 / PDF routing | 如何路由、校验、记录失败并恢复 | download_manifest.json、PDF 附件池 |
| 证据管理 / Evidence management | 6 · Zotero 对齐 / Zotero alignment | 如何对齐集合、条目、BibTeX 和 PDF | Zotero 映射、附件索引、capability_index.json |
| 证据化生产 / Evidence-based production | 7 · 写作与审计 / Write & audit | 如何先锁定论证和证据，再写作与绘图 | writing_blueprints.json、草稿、引用审计报告 |
| 终稿验证 / Final validation | 8 · 保守润色 / Conservative revision | 如何诊断、局部修订并验证含义未漂移 | 润色稿、revision_ledger.json/md |
完整的功能流程图、详细操作图、入口选择图和质量闭环图见 docs/public-workflow-flowcharts.md。
Quick start: give the repository URL to a supported Skill runtime, then copy a prompt. English prompts are available in the English summary.
把仓库地址交给支持 Skill 的 Codex、Claude Code、Hermes 或 OpenClaw：
https://github.com/bingyunjiang/more-paper-workflow
安装或加载后，从下面三条提示词中选择一条。
适合只有研究方向、题目尚未收敛的情况。
使用 more-paper-workflow，从 Step 1 开始。
我的研究方向是：[方向]。
请先诊断研究阶段，帮我收敛研究问题、范围、评价指标和可证伪条件；到 CP-TOPIC 时停下来让我确认。
样例：examples/first-run/step1-topic-sample.md
适合已有 DOI、标题、URL、BibTeX 或参考文献列表的情况。
使用 more-paper-workflow，直接进入 Step 5，不重跑前序步骤。
下面是 DOI / 标题 / URL / BibTeX：[材料]。
请先生成下载 manifest 和 dry-run 摘要；只有确实需要机构登录时才触发 CP-DOWNLOAD-LOGIN。
样例：examples/first-run/step5-download-summary.md
适合已有 Zotero、PDF、笔记或章节草稿的情况。
使用 more-paper-workflow，直接进入 Step 7。
目标体裁：[期刊论文 / 学位论文 / 综述]；目标章节：[章节名]；已有材料：[Zotero / PDF / 笔记 / 草稿]。
请先建立最小证据映射和 argument plan，再开始写作；摘要级证据不得支撑具体参数或强机理结论。
样例：examples/first-run/step7-writing-sample.md
更多可复制样例见 examples/first-run/README.md。
仓库自带可复制的演示项目：examples/demo/step8-ai-trace-demo/。
python3 scripts/run_step8_ai_trace.py --project-root examples/demo/step8-ai-trace-demo它会生成 .skill-state/ai_trace_diagnostics.json、diagnostic_summary.md、revision_ledger.json/md 和润色质量报告。
Start from the Step your current materials support. Direct entry is a fast path, not a quality bypass.
入口由“你想完成什么”决定，而不是由文件扩展名决定：
| 你已经有什么 / Available material | 推荐入口 / Recommended entry |
|---|---|
| 研究方向 / Research direction | Step 1 · 定题 / Topic |
| 查询式或已有文献表 / Queries or literature list | Step 4 · 检索与评分 / Search & score |
| DOI、标题、URL、BibTeX | Step 5 · 下载 / PDF routing |
| Zotero 文库或 PDF 文件夹 / Zotero library or PDF folder | Step 6 · 文库整理 / Library alignment |
| 证据包或章节草稿 / Evidence pack or draft | Step 7 · 写作与审计 / Write & audit |
| 待润色稿件 / Manuscript to revise | Step 8 · 保守修订 / Conservative revision |
入口收敛不影响对话式工作流从 Step 1-8 直接进入。Artifact Passport 的材料识别与 readiness 路由只覆盖 Step 4-8；它生成的 artifact_passport.json 是 direct-entry artifact graph 和 runtime 状态源之一，不替代正式产物。
Quality gates keep fast execution from weakening evidence standards.
metadata_only只能说明元数据存在。abstract_only只能支持摘要明确表达的背景性判断。- 参数、实验数值、强机理结论和因果判断优先要求全文核验。
- RAG 仅作为候选定位加速层，不得替代原文确认。
- Checkpoint 是当前 Step 的输入与风险确认，不是线性流程锁。
- Completion Gate 检查主产物、状态、风险和下一步输入。
- Failure Triage 先定位失败层，再做最小补救。
- HANDOFF 记录 confirmed inputs、primary outputs、open risks 和 recommended next step。
- Step 7 按大纲对应的 Zotero 子集合逐节读取证据，不扫整个文库。
full-document / review-only / abstract-only / chapter-only / continue-existing / revision-only是公开写作模式。continue-existing、chapter-only和revision-only都允许直达，但不能跳过证据确认。- 图表证据子链区分原图插入、可信数据新图、原生论文流程图/架构图和 source-locked 重绘/数字化；原生语义图同时交付 SVG、PNG、布局检查与证据哈希，并提供纯黑白、无底纹、通栏字号受检的刊发模式；曲线数字化固定经过
candidates → observations → formal data.csv → VisualSpec。 - 公式写作通过
equation_guard.py阻断公式缺失、T(omega)/F_{i+1}/X_in纯文本退化和 LaTeX/矩阵源码残留，并在 DOCX 导出后回读 Word 原生公式对象。 - 用户仍保留自己的写作策略和表达风格。
Step 8 先做 AI 味确定性检查和载体清洁度检查，再把问题分为：可直接修订、需作者决定、当前依据不足。它不会把语言优化变成观点漂移，也不承诺通过任何 AIGC 检测。
You receive reusable project artifacts, not just chat responses.
这套工作流交付的是可继续使用的项目工件，而不只是聊天回答：
- 研究主题、大纲、检索方案和章节证据需求
- 检索结果主 JSON、文献表、BibTeX、报告和
step4-dashboard/ - PDF 下载清单、尝试日志、失败分类和附件池
- Zotero 集合方案、条目映射、PDF 索引和能力索引
- 证据矩阵、
writing_blueprints、论证计划、章节或全文草稿 - 科研图表、原生论文流程图、图形复现包和引用审计报告
- 润色稿、质量报告和修订台账
展示样例：examples/showcase/README.md
Install by sharing the repository URL with a supported Skill runtime.
将下面的仓库地址发送给支持 Skill 的运行时，让它读取 SKILL.md 并完成安装或加载：
https://github.com/bingyunjiang/more-paper-workflow
加载成功后，直接复制快速开始中的任意提示词。能正确识别 Step、输入边界和预期产物，即说明路由已生效。
完整安装必须保留仓库根目录，而不是只复制单个 SKILL.md 或
skills/more-paper-workflow/ 子目录。可在仓库根目录执行完整性检查：
python scripts/validate_skill_package.py --root .参与开发或执行完整发布验收时，先安装 requirements-dev.txt（已包含严格科研绘图依赖）；只有按需单独运行科研绘图时，才直接安装 requirements-figures.txt。
检查通过时，Step 7 的精确入口为 agents/step_7_entry.md，完整写作合同为
agents/step_7_writing.md；不存在 agents/step_7.md。其他步骤同样以
manifest.yaml 的 step_routes 和根目录 SKILL.md 列出的精确文件名为准。
Markdown 和 YAML 文件均应以 UTF-8 保存。PowerShell 中文显示异常时，可显式读取：
Get-Content -Encoding UTF8 .\SKILL.md
Get-Content -Encoding UTF8 .\README.mdStep 6 支持 local / cloud / skip。只读扫描、查重和 plan-only 不触发外部写入；真正修改 Zotero 前必须确认 CP-ZOTERO-WRITE。
Boundaries: no invented evidence, silent external writes or quality-gate bypasses.
- 不承诺一键生成可信论文。
- 不把候选、摘要或未链接证据冒充全文证据。
- 不在未确认时执行机构登录、Zotero 写入或高风险引用动作。
- 不因已有快速入口就跳过当前 Step 的质量门。
- 不保证任何付费、订阅或受限内容一定可以获取。
- 不把 README 当运行时真相；执行边界以
SKILL.md、manifest.yaml和其中列出的精确agents/文件为准。
- 核心运行时（最小安装）：
python3 -m pip install -r requirements.txt。仅保证工作流基础入口与文献表能力。 - 完整开发环境：
python3 -m pip install -r requirements-dev.txt。该清单包含核心与科研图形依赖，并用于本地测试。 - 严格科研图形：
python3 -m pip install -r requirements-figures.txt；用于 VisualSpec/原生流程图、复现与字体质量门。 - 平台限定的离线 Zotero 缓存：先按
scripts/packages/manifest.lock.json的bundle.target_platform与bundle.target_python选择匹配解释器，再执行离线解析/验收：python3 scripts/check_offline_packages.py --strict --resolve。该缓存不是跨平台通用包，目标平台不匹配时验收应失败。
release_acceptance.py 会记录 commit、commit tree、工作树状态、运行平台、Python、依赖清单 SHA-256 及离线 manifest 目标。普通运行允许在 dirty 工作树中得到 diagnostic_pass，但此时 release_eligible=false；正式发布使用 --require-clean，只有当前可识别的 clean HEAD 才能得到 release pass。环境预检按 --capability core|quick_figure|chinese_diagram|strict_reproduction|docx_export|publisher_download 检查，不相关能力互不阻塞。
Detailed documentation and runtime contracts
| 主题 | 文档 |
|---|---|
| 工作流架构与产物链 | docs/workflow-architecture.md |
| 选择正确入口 | references/entry-guide.md |
| Step 交接 | references/step-handoff-contract.md |
| 完成声明门槛 | references/completion-gates.md |
| 失败分流 | references/failure-triage.md |
| 科研图形复现 | references/scientific-figure-reproduction.md |
| 引用审计 | commands/citation-audit.md |
| 完整版本历史 | CHANGELOG.md |
more-paper-workflow is an evidence-driven academic workflow covering topic clarification, outlining, search planning, literature screening, PDF routing, Zotero alignment, evidence-based writing, scientific figures, citation audit and conservative revision.
Its defining rule is simple: start from the Step your current materials support, but never bypass evidence boundaries or quality gates.
Use more-paper-workflow and start from Step 1. Diagnose my research stage, clarify the research question, scope, evaluation criteria and falsifiability conditions, then stop at CP-TOPIC for confirmation.
Use more-paper-workflow and go directly to Step 5. Build a download manifest and dry-run summary from these DOI / title / URL / BibTeX records. Trigger CP-DOWNLOAD-LOGIN only when institutional login is actually required.
Use more-paper-workflow and go directly to Step 7. My target genre is [genre], target section is [section], and available evidence is [Zotero / PDF / notes / draft]. Build the evidence map and argument plan before drafting.
See the first-run examples, workflow diagrams and runtime contract for details.
当前版本：v1.0.28-20260814。
- 引用审计改为按 claim 出现位置逐处检查，同一文献的重复引用不再去重；统一识别常见 DOI 形式，中文/跨语言低词面重叠只进入人工复核，不自动判“不支撑”。
- Step 5 dry-run 会写出计划态
download_manifest.json和preflight_summary.json，但不获取下载锁、不探测或启动 CDP、不创建登录 checkpoint，也不记录虚假下载 attempt。 - quick 图表公开类型与真实 renderer 共用单一 dispatch；未实现类型不再出现在
--list-types，--test不再用 grouped bar 冒充成功。 - ZIP 构建排除
.venv、venv、env、.test-*、site-packages与本地缓存。 - release acceptance 区分诊断通过与正式发布资格；能力范围环境检查保证 CJK、严格复现、DOCX 或下载依赖只阻塞对应分支。
- Step 1–8 direct-entry、Step 7 既有 mode/operation/target state 以及 Step 8 quick/audited 边界保持不变；未新增全局质量档或强制 JSON execution card。
- 保留轻量主合同，同时恢复 Direct-entry、Checkpoint、执行卡、章节证据、机理、图文和分层完成门。
manifest.step7.yaml接回材料/机械、电力能源、目标期刊、机理分析、写作质量、修稿和图表支持合同。- Step 7 测试改为验证主合同边界、manifest 可达性、reference 内容和运行时行为，不再绑定旧的 7.1–7.17 文件布局。
- Zotero key 检测改为映射命中或明确 key 语境；普通八位大写单词不再误报。
- 摘要结果审计支持结构化 writing blueprint 和更完整的定量表达。
- 新增开发依赖清单并清理离线包重复版本；发布门要求全量测试、包校验、release acceptance 与 offline strict 同时通过。
- 升级提醒现在读取当前 upstream 的远程
SKILL.md版本；同版本提交不误报，自动升级仅允许干净工作区安全快进。 - 离线发布门新增
pip --ignore-installed --no-index --only-binary=:all:解析；0.5.0是可复现离线基线，安装器接受并保留更高兼容版本。
- 新增
figure_backend=diagram，支持流程图、系统/Agent 架构图、数据流图、时序图、状态图、时间线、对比矩阵、ER 图和用例图。 - 统一生成可编辑语义 SVG、Pillow PNG、布局检查、可选审阅覆盖层及 SHA-256 证据记录；公式标签支持 text/math runs，不明确的公式会阻断完成并请求作者确认。
style=minimal固化为纯黑白、无底纹的刊发模式；字号随画布宽度缩放，并按 170–180 mm 通栏图检查节点文字不低于 7 pt。- Step 7 校验器对重叠、裁切、越界、边穿节点、外部资源、非黑白刊发图和陈旧哈希 fail-closed；发布基线包含根目录/ZIP 包校验。
- 移除仓库内真实
.codex/config.toml，新增无凭据的config/codex-config.example.toml；Zotero API key、library id 和本机可执行路径必须通过本地环境或 secret 管理。 - 包构建和校验新增本机状态与敏感信息拦截，防止
.codex/、.codegraph/、.skill-state/、.claude/、测试临时产物、明文 Zotero 凭据或作者本机路径进入发布包。 - 新增统一中文字体发现逻辑，PNG/Matplotlib/Pillow 渲染覆盖 Windows 微软雅黑、宋体、黑体，Linux 思源黑体、Noto Sans CJK、文泉驿，以及 macOS PingFang/STHeiti。
- Step 7 写作合同改为轻量入口加按需 references：证据 intake、正文合同、引用审计、图表工作流、预审和完成验收分文件加载，
manifest.step7.yaml只保留最小always_load。 release_acceptance.json已同步为v1.0.26-20260804，官方样例semantic_strict_pass；本次复验 21 项 focused tests、根目录/临时 ZIP 包校验和 release acceptance 均通过。
完整记录见 CHANGELOG.md。
作者： Dr. Jiang Bingyun（江博士）
微信： Bingyunjiang
邮箱： bingyunjiang@qq.com
本项目以 CC BY-NC-SA 4.0 许可发布。详见 LICENSE。