- AI 技能
- AI 写作
- 人工智能
- 深度研究
- AI 应用
【免费下载链接】PaperSpine
PaperSpine5 — local-first, evidence-bound paper research, writing, figures, review and delivery. Download: https://wubing2023.github.io/PaperSpine/v5/
本文聚焦 PaperSpine5 重写工作流中的核心质量关卡——Logic Transfer Audit。它解决的是一个非常具体的问题:当一份手稿被"重写"后,如何证明这次改写真正从优秀范文(exemplar papers)中习得了论证逻辑,而不只是改了措辞、长度或 LaTeX 排版。读完本文,你将掌握 Logic Transfer Audit 的输入/输出契约、六步审计程序、七锚点测试(Seven-Anchor Test)、缺陷标签体系(如
metric-dump、claim-leap),以及它如何与revision_audit.py等脚本形成"逻辑审计 + 文本相似度审计"的双重校验闭环,可用于指导自己的论文重写与质量验收。
一、为什么需要"逻辑转移审计":重写的验收标准
在 PaperSpine 的编排器中,rewrite阶段的定义是"从已确认的 motivation、研究产出和一份紧凑的、证据感知的写作计划出发,对手稿进行实质性重写"(见 rewrite.md)。但"实质性"如何度量?仅仅对比修改前后的文本相似度,无法区分"深层重写"与"浅层润色"。
logic-transfer-audit.md 正是为此而设的参考文档:当一次重写必须证明它从强论文中学到了东西、并确实改变了手稿的论证逻辑(argument logic),而不仅是措辞、长度或 LaTeX 格式时,就使用本参考。
其判据是四个必须能被回答的问题:
- 原稿本来想做什么?
- 目标期刊/范文教会了我们什么逻辑?
- 改后稿现在使用的是哪种逻辑?
- 具体是哪些段落、章节开头、结果框定(result framings)和讨论收尾(discussion closures)因为这次学习而发生了变化?
如果这四个问题无法回答,则改写不完整(the rewrite is not complete)。这一定义直接写入了 audit.md 的硬性检查项第 8 条:"Logic transfer from original draft or materials",且logic_transfer_audit.md被列为审计阶段的 Required Outputs 之一;在 orchestrator-branch-map.md 中,"Logic-transfer or evidence-integrity blocker"也被明确路由回 research/planning/drafting 阶段修复。
二、审计的输入契约:一份完整的证据链
Logic Transfer Audit 不是凭空执行的,它依赖以下输入工件(均来自同一任务的既有产出):
source_map.md—— 数据、结论、图、引用的来源映射;target_journal_research.md—— 当明确了目标期刊时提供;paper_diagnosis.md—— 对原稿的论证诊断;original_logic_map.md—— 原稿的逐段逻辑映射;exemplar_learning_dossier.md—— 范文学习档案(见 exemplar-learning-dossier.md),其中规定了每篇范文的七步阅读程序:抽象五步 move 识别、Introduction 逐段修辞职责映射、各主要章节首尾句提取、Methods 中设计必要性解释的标注、Results 中setup -> metric/figure -> comparison -> interpretation -> transition序列标注、Discussion 段落职责映射、可复用句法骨架(sentence skeletons)提取;paragraph_function_templates.md—— 段落功能模板(范文模式到本稿写作逻辑的转换载体);result_narrative_templates.md—— Results 重写时使用的叙事模板,其中包含"Anti-Metric-Dump Rules"(弱模式/失败原因/替代模式三列表);style_profile.md—— 风格画像(见 style-learning-workflow.md);motivation_thread_model.md—— 动机主线模型(见 motivation-thread-writing.md),内含 one-sentence red thread、Problem-Solution Arc 表、Introduction-to-Discussion Closure Map 等;section_blueprints.md—— 章节蓝图;rewrite_matrix.md—— 改写矩阵(见 rewrite-matrix.md);- 原稿(original manuscript);
- 改后稿(revised manuscript)。
这些输入印证了审计的定位:它处于重写工作流末端,消费的是整个"研究 → 学习 → 规划 → 改写"链条的产物,因此它的结论具有可追溯性——任何"某段逻辑变了"的断言都能回指到具体的模板行、档案行或矩阵行。
三、输出契约:logic_transfer_audit.md的标准结构
审计结果必须保存为paper_rewriting_output/logic_transfer_audit.md,其标准 Markdown 骨架如下(在改写矩阵工作流中同样被引用,见 rewrite-matrix.md 的 Step 7):
# Logic Transfer Audit ## Executive Verdict - Logic transfer verdict: - Strongest transferred pattern: - Weakest section: - Sections requiring another rewrite: ## Whole-Paper Argument Lineage | Anchor | Original Manuscript | Revised Manuscript | Improvement Type | Pass/Fail | |---|---|---|---|---| | Abstract motivation | | | | | | Introduction opening problem | | | | | | Introduction gap sentence | | | | | | Final Introduction promise | | | | | | Methods rationale sentence | | | | | | First Results headline | | | | | | Discussion first answer sentence | | | | | | Discussion closing implication | | | | | ## Section Logic Comparison | Section | Original Logic | Learned Target Logic | Revised Logic | Evidence of Transfer | Verdict | |---|---|---|---|---|---| | Abstract | | | | | | | Introduction | | | | | | | Methods | | | | | | | Results | | | | | | | Discussion | | | | | | ## Paragraph Function Transfer | Section | Paragraph Slot | Original Function | Target Function Template | Revised Function | Transfer Quality | |---|---:|---|---|---|---| ## Results Narrative Transfer | Result Subsection | Introduction Promise Tested | Evidence Used | Interpretation Added | Transition/Implication | Verdict | |---|---|---|---|---|---| ## Shallow Patch Check | Warning Sign | Observed? | Evidence | Required Fix | |---|---|---|---| | Same paragraph order with sentence-level polish | | | | | Mostly append-only revision | | | | | New claims without evidence bank support | | | | | Results still metric-dump style | | | | | Discussion repeats Results without resolving motivation | | | | | LaTeX formatting work displaced writing logic | | | |值得注意的结构设计:
- Whole-Paper Argument Lineage(全篇论证谱系)的 8 个锚点覆盖了 Abstract → Introduction → Methods → Results → Discussion 的关键叙事节点,构成一条"动机—问题—差距—承诺—设计—证据—答案—意义"的完整链;
- Paragraph Function Transfer(段落功能转移)要求逐段给出"原功能 / 目标模板 / 新功能 / 转移质量",把审计下沉到段落粒度;
- Shallow Patch Check(浅层修补检查)的 6 个警示信号直接对应文本相似度工具会捕捉到的浅改模式,见下文第六节。
四、六步审计程序:从提取原逻辑到决定是否重写
步骤 1:提取原逻辑(Extract the Original Logic)
使用original_logic_map.md,不要依赖记忆。对每个主要章节识别:
- 该章节当前回答的读者问题;
- 段落 move 序列;
- 章节在逻辑上的起止点;
- 使用的证据;
- 未能解释清楚的内容。
同时精确标注常见缺陷,这套标签体系贯穿整个审计,是"把模糊批评变成可定位缺陷"的关键:
| Defect | 含义 |
|---|---|
background-stack | 文献/背景被罗列,但没有收窄到必要性 |
gap-vague | gap 存在但不可操作、不可检验 |
method-recipe | Methods 罗列组件但未解释设计需要 |
metric-dump | Results 报告数字却不解释它们检验了什么 promise |
claim-leap | 解释超出了证据支撑范围 |
discussion-repeat | Discussion 复述 Results 而非消解 motivation |
latex-driven | 修订聚焦排版而非论证 |
步骤 2:陈述习得的目标逻辑(State the Learned Target Logic)
使用范文档案(dossier)和模板,为每个章节命名习得的模式:
- Abstract:motivation → gap → method → key evidence → significance;
- Introduction:field problem → bottleneck → prior progress → unresolved gap → design response → evidence preview;
- Methods:design need → implementation choice → rationale → evaluation;
- Results:question/promise → evidence → comparison → interpretation → transition;
- Discussion:answer → mechanism/significance → relation to prior work → limitations → field implication。
如果目标期刊使用不同的模式,则采用期刊特有模式,并引用支持该模式的工件(artifact)。
步骤 3:把改后逻辑与两条基线对比(Compare Against Both Baselines)
对每个主要章节比较三样东西:原逻辑、习得的目标逻辑、改后逻辑。改后章节只有当它遵循习得的目标逻辑、同时保留了用户真实的证据时才算通过。
明确不得给分的几种"伪改写":
- 仅替换同义词;
- 在未改动的段落后加一句解释;
- 添加与 Results 无关的泛化 motivation;
- 原段落角色在被诊断为薄弱后仍原样保留原有顺序。
步骤 4:运行七锚点测试(Seven-Anchor Test)
从原稿和改后稿中提取这 7 个精确锚点:
- Abstract motivation 句;
- Introduction 首个 problem 句;
- 主要 gap 句;
- Introduction 末尾的 contribution 或 roadmap 句;
- Methods 首个 rationale 句;
- Results 首个 headline finding;
- Discussion 首个 answer 句。
改后稿的 7 个锚点应形成一条连贯的 problem-solution-evidence-resolution 弧。如果弧断裂,应先在打磨语言之前修订对应的 section blueprint。这一思想与 motivation-thread-writing.md 中"Introduction 末段成为 Results 将证明的 promise,Discussion 首段回答该 promise"的设计一致,也与 round1-literature-revision.md Phase 4 的"Problem–Solution arc 审计"(Introduction 末句 → Discussion 首句 → Discussion 末句成弧)相互印证。
步骤 5:审计 Results 子章节(Audit Results Subsections)
对每个 Results 子章节,要求五个 move 各回答一个问题:
| Move | Question |
|---|---|
| Setup | 正在检验哪个 Introduction promise 或设计主张? |
| Evidence | 哪个图/表/数字支持该主张? |
| Comparison | 什么基线、条件或消融使证据可解释? |
| Interpretation | 读者应当在数字之外得出什么结论? |
| Transition | 为什么下一个子章节在逻辑上自然承接? |
若某子章节只报告性能,则标记为metric-dump,并从result_narrative_templates.md重写——该模板文件本身定义了 benchmark / ablation / generalization / interpretability / biological analysis 五类结果子章节的叙事行,并配有 Anti-Metric-Dump Rules。
步骤 6:决定是否需要再次重写(Decide Whether Another Rewrite Is Required)
满足以下任一条件即需要再次重写:
- Abstract 或 Introduction 缺少清晰的 motivation-gap-response 链;
- Results 无法映射到 Introduction 的 promises;
- Discussion 缺少对论文中心问题的直接回答;
- 被诊断为逻辑薄弱的章节在修订后仍包含相同的未解决论证缺陷(注意:单纯的"段落功能未变"不足以构成重写理由——如果原内容本身有效则无需重写);
revision_audit.md报告本应重建的章节存在高比例近似相同段落;- Logic Transfer Audit 对 Introduction、Results 或 Discussion 判定为"部分转移(partially transferred)"。
五、与改写矩阵的协同:审计不是孤立关卡
Logic Transfer Audit 是改写矩阵工作流(见 rewrite-matrix.md)的 Step 7,位于整条链路的末尾,其上游是:
- Step 1Build the Red Thread:由
confirmed_contribution.md与confirmed_motivation.md推导出 one-sentence red thread; - Step 2Section Role Map:给出各章节的当前角色、贡献任务、motivation 对齐、主要缺陷与动作;
- Step 3Paragraph Rows:按 move 标签(Abstract 的 background/problem/method/key result/significance,Introduction 的 territory/prior work/gap/problem statement/contribution/roadmap 等)生成逐段矩阵行;
- Step 4Row-by-Row Rewrite:每个操作取
REWRITE、SPLIT、MERGE、DELETE、MOVE、ADD或KEEP之一;Step 4.5 还定义了"闭卷重写"(Closed-Book Rewrite)——从事实和蓝图重写而非在原文上打补丁,当用户抱怨"之前只加了句子、太浅"时强制使用; - Step 5/6 的 Section Audit 与七句谱系测试(seven-sentence lineage test);
- Step 7 产出本审计;
- Step 8Shallow-Edit Audit运行
revision_audit.py脚本(见下文)。
"如果审计说某个被诊断为薄弱的章节基本保留了原逻辑,就从蓝图重建该章节"——这一规则使审计成为改写闭环的强制出口。
六、脚本级印证:revision_audit.py的相似度护栏
逻辑转移审计是定性的论证审查,而文本相似度审计是定量的浅改探测,二者互补。PaperSpine 提供了 revision_audit.py,在 rewrite-matrix.md Step 8 与 audit.md 的检查清单中均被要求运行:
python scripts/revision_audit.py <original> <revised> --markdown > paper_rewriting_output/revision_audit.md从源码看,该脚本(src/scripts/revision_audit.py)的核心机制:
- 按扩展名分别用
normalize_tex/normalize_markdown归一化.tex/.md文件,再按段落切分; - 用
similarity_canon对每个改后段落与原稿所有段落做最佳匹配,得到相似度分数; - 输出四个关键比率:
near_identical_ratio(相似度 ≥--unchanged-threshold,默认 0.82)、mostly_new_ratio(相似度 <--new-threshold,默认 0.25)、likely_deleted_ratio,以及两个聚合判定:addition_heavy(mostly_new_ratio > 0.35 且 deleted_ratio < 0.15)与shallow_warning(near_identical_ratio > 0.35); - 进程退出码:存在浅改警告(
shallow_warning)时返回 1,否则返回 0; - 支持
--json与--markdown两种输出;Markdown 报告包含最高/最低相似度改后段落的前 20 行对比表。
该脚本在 tests/test_scripts.py 的test_revision_audit_reports_similarity用例中验证(用tests/fixtures/mini_paper.tex与mini_paper_revised.tex运行,断言输出包含# Revision Audit与Near-identical revised paragraphs)。与 Logic Transfer Audit 的 Shallow Patch Check 表一一呼应:near_identical_ratio过高对应"Same paragraph order with sentence-level polish",addition_heavy对应"Mostly append-only revision"。解读规则在 rewrite-matrix.md 中有明确定义:高未变比是诊断信号;弱章节高相似度意味着应从蓝图重建。
七、报告标准:具体、可定位、可被挑战
Logic Transfer Audit 的 Reporting Standard 要求具体且具体到位置。鼓励的写法:
Introduction P4 changed from a general limitation list to a three-part modelling gap that later maps to BiGRU, CDF loss, and PhyloP.禁止的写法:
The Introduction is improved and more logical.审计的终极验收标准是:它必须让用户能够质疑"这次改写是否真的从范文中学到了东西"(The audit should make it possible for the user to challenge whether the rewrite really learned from the exemplar papers)。换言之,审计报告不是给改写"盖章",而是把改写的证据链摊开在桌面上:每一条"逻辑变了"的断言,都应有对应的段落位置、目标模板、证据来源与转移质量评级。
八、落地建议:在你的重写流程中使用本审计
结合 PaperSpine 的完整链路(见 orchestrator-branch-map.md 与 audit.md),一套可复用的实践顺序是:
- 前置工件齐备:确保
original_logic_map.md、exemplar_learning_dossier.md、paragraph_function_templates.md、result_narrative_templates.md、motivation_thread_model.md、section_blueprints.md、rewrite_matrix.md已存在,否则审计缺少可比对的基线; - 改写:按 rewrite-matrix.md 逐行改写,操作符优先
REWRITE/SPLIT/MERGE/MOVE,警惕连续KEEP/ADD; - 量化浅改探测:运行
python scripts/revision_audit.py <original> <revised> --markdown,先排除"文本没变"的嫌疑; - 逻辑转移审计:填写
paper_rewriting_output/logic_transfer_audit.md全部表格,跑完六步程序; - 按判定行动:若出现第六节列出的任一"需再次重写"条件,先改 section blueprint 再重写该章节,随后重新渲染、重新审查受影响输出(见 audit.md 的"修复后重跑受影响检查、再做一次完整最终审计"要求)。
需要说明的适用前提:本审计是 PaperSpine 重写工作流(rewrite_existing)内部的质量关卡,其结论质量取决于前置工件的真实性与用户证据的完整性;审计表格本身是"工作记录格式",在 PaperSpine 的现行宿主工作流中,真正的判据是论证是否真的被学习与修复,而非表格是否填满(见 exemplar-learning-dossier.md 对"learning is demonstrated by justified writing choices, not a sequence of new files"的强调)。
延伸阅读(仓库内):rewrite.md(改写阶段总纲)、rewrite-matrix.md(改写矩阵七步工作流)、exemplar-learning-dossier.md(范文学习档案与模板)、motivation-thread-writing.md(动机主线与表面映射)、style-learning-workflow.md(风格画像)、audit.md(审计阶段完整脚本清单)、revision_audit.py(浅改相似度探测实现)。
- AI 技能
- AI 写作
- 人工智能
- 深度研究
- AI 应用
【免费下载链接】PaperSpine
PaperSpine5 — local-first, evidence-bound paper research, writing, figures, review and delivery. Download: https://wubing2023.github.io/PaperSpine/v5/
相关推荐
PaperSpine 逻辑迁移审计(Logic Transfer Audit):用证据证明论文重写真正改变了论证逻辑
PaperSpine 逻辑迁移审计(Logic Transfer Audit):用证据证明论文重写真正改变了论证逻辑 重写一篇论文时,如何证明自己"学到了强论文
AI 技能AI 写作人工智能深度研究AI 应用PaperSpine 逻辑迁移审计(Logic Transfer Audit):验证论文重写真正迁移了论证逻辑,而非浅层润色
PaperSpine 逻辑迁移审计(Logic Transfer Audit):验证论文重写真正迁移了论证逻辑,而非浅层润色 导读 本文讲解 PaperSpin
AI 技能AI 写作人工智能深度研究AI 应用PaperSpine 范例学习档案(Exemplar Learning Dossier):从优秀论文提取可迁移写作逻辑的完整方法论
PaperSpine 范例学习档案(Exemplar Learning Dossier):从优秀论文提取可迁移写作逻辑的完整方法论 导读 本文讲解 PaperS
AI 技能AI 写作人工智能深度研究AI 应用
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考