- AI 技能
- AI 写作
- 人工智能
- 深度研究
- AI 应用
【免费下载链接】PaperSpine
PaperSpine5 — local-first, evidence-bound paper research, writing, figures, review and delivery. Download: https://wubing2023.github.io/PaperSpine/v5/
导读
本文围绕 PaperSpine 技能体系中负责科研执行的核心规程 research.md 展开,系统讲解三种已保存研究模式——materials_only(仅用现有材料)、required(执行被要求的研究分析)与agent_decide(由 Agent 判断是否需要新分析)——各自的授权边界、操作步骤与文献学习能力。读完本文,你将理解 PaperSpine 如何在"绝不伪造数据、绝不擅自重跑分析"的前提下完成从材料核查、文献学习、证据交接(source/result → claim → figure 映射)到写作与图件产出的完整链路,并掌握与模式配套的配置预填、里程碑提交(paperspine_commit_milestone)与公共决策工具的用法。
一、模式前置:先读配置,再决定做什么
research.md开篇即给出一个重要事实:研究里程碑不是对隐藏引擎的请求。Agent 在单个 paper-spine Skill 下完成这项工作,Web 保存用户的设置与选择,公开 API 记录事实并导出可读的桥接文件。也就是说,研究执行的依据全部来自同一任务的已保存配置,而不是某个独立的分析后端。
在实际动手前,Agent 必须读取以下四类输入:
- 已保存的
research_mode(研究模式); - 材料清单 / 授权根目录(materials inventory / authorized roots);
- 任务问题(task question);
- 任何明确的离线指令(explicit offline instruction)。
同时必须遵守两条硬性约束:保持原始输入不变(Keep original inputs unchanged),以及如实记录实际读过的来源与实际计算出的结果(Record sources actually read and results actually computed)。
从源码结构看,这一约束被贯穿到了公开工具的上下文读取逻辑中:paperspine_methods.py 的_context()函数在构建方法路由上下文时,直接从任务快照的configuration字典中读取research_mode(见config.get("research_mode")),并将其与workflow、scene、current_stage一起作为方法选择的过滤轴(paperspine_methods.py)。这说明"研究模式"不是文档中的口号,而是实际参与公开工具路由决策的结构化字段。
研究模式的合法取值在 intake.md 中有明确定义:
| 取值 | 含义 |
|---|---|
materials_only | 保留用户提供的分析结果,禁止新增分析,但仍允许公开文献/期刊学习与基于证据的写作 |
required | 执行被要求的研究,使用真实工具与证据 |
agent_decide | 默认值;判断新分析在确认范围内是否有用且可行,然后执行被判定合理的部分 |
值得注意的一个反陷阱:materials_only的默认来源。intake.md明确警告——"材料已提供"或"先出稿"不能自动变成materials_only;research_mode默认是agent_decide,而不是materials_only。这一约定在 intent-configuration.md 的意图映射表中同样得到体现:未指定研究范围时保留agent_decide,不得默认改为materials_only。
二、materials_only:只消费证据,不制造证据
这是证据约束最严格的一种模式,其核心边界一句话概括:使用提供的材料与既有结果来发展贡献并写作论文,但不运行任何新的数据分析。
2.1 允许做什么
在materials_only下,Agent 可以并且应当:
- 从材料中提取文本/表格,检查相关 PDF/DOCX 页面;
- 核查单位、来源出处(provenance)与内部一致性;
- 为每条主张(claim)找到它由哪个既有结果支撑;
- 按材料原样保留既有的分析输出与方法描述;
- 将已提供的结果渲染为图件(Rendering a supplied result as a figure is allowed);
- 开展公开文献学习、引用查证、期刊格式调研与参考图阅读。
2.2 明确禁止做什么
- 运行新的 EDA、推断检验、实验、模型拟合/评估、数据挖掘;
- 仅为了产出可复现性证据而重跑用户提供的脚本;
- 计算新的统计结果(computing a new statistical outcome is not allowed)。
这里有一个非常关键的判定原则:缺少完整的复现输入(原始数组)本身不足以使结果无效。Agent 只应针对具体矛盾(actual contradictions)进行针对性消解,不能因为"拿不到原始数据"就丢弃用户提供的消融、基序、保守性或机制图。同样,不能捏造结果,也不能强加一套新的"卷宗"(dossier)。这条规则在 scientific-figure-workflow.md 中被再次强化:"materials_onlyprohibits new analyses, experiments, training, evaluation and reruns; it permits reorganizing and redrawing existing results"——即允许重组与重绘既有结果,但不允许新增计算。
2.3 文献学习照常进行
materials_only不影响正常能力范围内的公开文献学习:阅读真实的摘要与综述以支撑其对应的观点即可,不要求每一条引用都有全文。同时要遵守明确的离线指令,并如实描述实际阅读深度——不得声称独立复现了用户提供的科研工作。
里程碑总结可以这样写:"No new data analysis; reused these results and learned from these papers"(未做新的数据分析;复用了这些结果并从这些论文中学到了方法),并给出真实的文件位置与阅读范围。随后提出受支持的贡献/动机选项,待用户选择后进入草稿阶段。
该模式不要求额外的分析报告、三透镜卷宗(three-lens dossier)、Master 认证或 Runner J4 验收——这是research.md明确解除的旧流程负担,其对应的说明也写入了方法路由注册表的current_application字段(见下文第四节)。
三、required:在被要求的范围内做恰如其分的分析
当用户明确要求"分析这些数据""新增回归/实验"时,模式为required(映射规则见 intent-configuration.md 的常用映射表)。此模式并不是无限制的分析许可,而是执行**被请求且合理(justified)**的分析。
3.1 材料核查的顺序
从授权材料清单出发,先读会影响主张(claims)的文件:
- 表格/电子表格:检查列类型、单位、缺失情况、公式错误与来源出处;
- PDF/DOCX:提取文本并目视检查实际使用的源页面;
- 先定义科学问题与研究设计,再选择分析方法(Define the scientific question and design before choosing analysis)。
3.2 方法学纪律
- 使用最窄的合理方法(narrowest justified method),检查其假设;
- 在适当处报告效应量与不确定性(effect sizes and uncertainty);
- 区分探索性工作与验证性工作(exploratory vs confirmatory);
- 建模时必须先划分再拟合(split before fitting),避免数据泄漏,保留可复现的变换、训练/评估设置与脚本;
- 不得为证据完全定性的任务编造数据分析(Do not invent data analysis for a task whose evidence is wholly qualitative)。
3.3 文献与期刊调研
- 可用现有的文献 MCP 工具,否则用宿主浏览/检索工具;无需额外安装 MCP;
- 公开论文与参考图检索是 Skill 的正常能力,没有单独的联网勾选框或重复授权询问;旧配置中已退役的
allow_network标志不构成门禁; - 尊重明确的离线请求与所选研究范围;
- 当配置为 local-first 时,先构建本地源索引;区分"检索失败"与"无命中";
- 保留来源身份、版本/日期、可访问位置、相关段落与主张上下文;
- 未经明确授权不得上传私有材料。
3.4 三个有用的研究透镜
research.md要求按比例使用三个研究透镜(可在一个连贯的 pass 中处理):
- 期刊要求与受众(venue requirements and audience);
- 强范例的论证/结构(strong examples' argument/structure);
- 既有工作与拟提出贡献的关系(prior work versus the proposed contribution)。
这三个透镜的阅读数量遵循 journal-learning.md 中保存的同方向与目标期刊范例数量;超出偏好的深度取决于实际问题与证据缺口。绝不能把范例的风格偏好升级为强制的科学规则(Never turn an exemplar's stylistic preference into a mandatory scientific rule)。未知的投稿事实也不应阻碍一份有证据支撑的本地稿件的推进。
四、agent_decide:默认的智能裁量模式
agent_decide是research_mode的默认值(见 intake.md 第 23 行)。其工作流程:
- 读取问题、清单与约束;
- 判断新的本地分析是否会实质性地回答某个缺口(whether new local analysis will materially answer a gap);
- 当既有结果足够时,可以两者都不选(choose neither when existing results suffice),并把这个理由记录在普通的里程碑总结中;
- 在三种模式中选择相关的一种执行。
两条优先规则必须记住:
- 已保存的拒绝或明确用户指令优先于 Agent 的裁量(A saved refusal or explicit user instruction takes precedence);
- 选择在修订过程中持续有效,直到用户改变它或允许决策的依据发生变化(The choice persists through revision until the user changes it or the permitted decision basis changes)。
在 SKILL.md 的"Scientific work and expected results"一节中,agent_decide还附带一个澄清:"This mode does not silently meanmaterials_only"——即 Agent 裁量不等于默认退化为不分析;它必须先评估证据缺口并说明理由,再执行合理的工作。research.md在方法路由注册表中的对应条目也确认了这一点:agent_decide需要在普通里程碑总结中记录理由,并沿返修流程复用该选择,不新增报告或确认门(见 current-method-routing.json,该条目的stages覆盖 research、evidence、draft、figure、review)。
4.1 从用户意图到 research_mode 的配置映射
research.md 本身不负责配置提取,但它依赖的research_mode值来自 intent-configuration.md 定义的意图预填流程——这一预填仅是Agent proposal,不能伪装成用户确认,也不能绕过 Web 配置保存。常用映射如下:
| 用户表达 | proposal 字段 |
|---|---|
| "分析这些数据""新增回归/实验""需要研究分析" | research_mode=required;保存后执行适合问题的研究分析并保留真实方法与结果 |
| "只用现有材料""不要新增分析" | research_mode=materials_only;仍可进行公开文献学习、引用核对和参考图阅读 |
| "让 AI 判断是否需要分析",或未指定范围 | research_mode=agent_decide;保存后判断证据缺口、说明理由并执行必要且在授权范围内的分析,或说明现有结果足够 |
| "深入查文献""充分学习同方向和目标期刊" | 加深公开文献学习,可建议 6+6;不因此把materials_only改为required |
| "深度研究" | 结合全文判定:请求数据分析/实验时用required;只要求文献综述时保持实际分析范围,不能以关键词推定新增实验授权 |
注意研究模式与文献学习规模是分开解释的:"深度研究"不授权上传私有材料、不自动确认动机或图件、不保证目标期刊接收。用户同时给出自定义数量时以自定义数量为准。
4.2 方法路由如何把 research.md 变成可执行条目
research.md被注册在方法路由目录 current-method-routing.json 中,其元数据为:
path:references/research.md(相对于 Skill 根,即仓库src/skill/references/research.md);purpose: 按 saved research_mode 实际执行三种分支;保留设计、假设、防泄漏、效应/不确定性、来源→claim→图映射;materials_only 保留原结果且允许公开学习,禁止新增/重跑分析;current_application: 读 01_configuration 与 02_materials,已有结果和笔记作为输入;CommitMilestone 记录实际工作;记录 agent_decide 理由并沿返修复用;不新增报告/确认门;review_check: 样本数、单位、分母/缺失处理有实际来源;不虚构独立复现;新分析与 public retrieval 分开判断授权。
在宿主侧,可通过 current-method-routing.md 给出的 CLI 从同一任务读取该方法全文:
python src/scripts/paperspine5_web.py host methods --profile-root "<same-profile>" --task-id "<same-task>" --stage research python src/scripts/paperspine5_web.py host methods --local --task-id "<same-task>" --stage research --resource references/research.md --format text --max-lines 100--local从本机已安装 Skill 读取精确注册资源;文本输出带源 SHA-256、行范围与 END 标记,后续页用--start-line <next> --expect-sha256 <same-source-hash>续读。方法路由的选择只是"选择来源",不是已阅读或已应用的证明;首次使用必须读全文。若 helper 不可用,直接按该目录打开原始文件即可。
五、证据交接:source/result → claim → figure 映射
无论哪种模式,研究阶段的产出最终都要移交到写作与图件环节,research.md规定了这套交接机制。
5.1 映射文件的位置与内容
在真实论文旁边(task.workspace_root/paper/下)维护一份紧凑的 source/result → claim → figure 映射(a compact source/result → claim → figure mapping),尽量复用已有笔记与文件。当分析被选中时,新的分析脚本与结果也存放于此。这条规则与 SKILL.md 的"图件工作"一节一致:把实际结果映射到问题,并为每个有用职责(队列/可用性、主要发现、比较、不确定性/验证、稳健性/亚组、解释)安排图、表、正文或补充材料的去处——没有固定配额。
5.2 通过 paperspine_commit_milestone 记录,不直接编辑桥接 JSON
记录限制、实际检查过的来源与仍需进行的工作,通过paperspine_commit_milestone完成;不得直接编辑派生的桥接 JSON(do not directly edit derived bridge JSON)。这是 PaperSpine 工作台进度的唯一正规通道。从 product-v1-workflow.md 可见其请求形状(示例值需替换):
{"request":{"schema_version":"1.1","task_id":"<same-task-id>","command_id":"<unique-stage-update>","expected_version":6,"payload":{"stage":"research","summary":"Inspected supplied tables and figures; recorded source->claim->figure map; literature learning in progress.","artifact_ids":["<published-artifact-id>"]}}}配合paperspine_publish_artifact发布真实文件,再在 milestone 中引用返回的 artifact ID。里程碑只记录实际工作,不构成科学/编辑/提交就绪的认证;"工具成功、哈希一致、状态推进"都不能替代对真实论文本身的评估。
5.3 公共决策工具与回读
通过公开决策工具提出受支持的动机/贡献选项;Web 确认后,读取同一任务的 task/choice 文件,再继续正常的写作与图件工具。参考(references)可以教方法、教视觉表达,也可以支撑署名的背景、方法与机制描述,但参考的经验性发现绝不能呈现为本研究的结果(Their empirical findings must never be presented as this study's results)。在绘图规划/创建/组装阶段,遵循主 Skill 中的分阶段科学阅读指南(即 scientific-figure-workflow.md)。
六、文献学习在三种模式下的共通底座
research.md多处引用 journal-learning.md,后者定义了无论何种研究模式都适用的文献学习规则——materials_only只禁止新分析,不禁止正常的文献工作。
6.1 两组阅读集合与默认值
当文献偏好缺失时使用默认值:
| 字段 | 默认值 | 含义 |
|---|---|---|
same_field_papers | 3 | 与待写问题紧密相关的强论文 |
target_venue_papers | 3 | 目标期刊中目标类型的代表性论文 |
reference_count_mode | venue_average | 目标高于观察到的期刊样本平均参考文献数 |
reference_count | null | 模式为custom时用户给定的正数 |
mechanism_figure | prefer | 主动考虑机制/概念框架/方法架构图 |
Web 支持 3+3、6+6 与自定义数量;已保存的自定义选择优先。两个集合默认要求 6 篇不同的论文——角色重叠可以注明,但三篇论文数两次不算学习了六篇。对venue_average,需统计所选可比目标论文的参考文献条数,记录其观测均值,目标至少floor(mean) + 1条有效引用;这是基于该批文章估计,不是期刊级精确平均值,且不可用 cited-by 计数替代。
6.2 目标期刊 PDF 与版式学习
- 尽可能把每个选定的目标期刊学习论文以 PDF 下载到同一任务
paper/references/下,优先正式出版版本,记录来源 URL 与论文身份; - 打开 PDF 确认真实、可读、完整——带 PDF 文件名的 HTML 错误页不算下载;
- 渲染并目视阅读目标 PDF:标题/摘要、正文页、图/表、图注与参考文献,比较页面几何、分栏、字体字号、行距、标题层级、段落间距、引文外观、浮动位置与页面密度;
- 区分期刊的投稿说明与已发表页面设计,遵循 manuscript-format.md 的有界官方模板发现与示例编译流程;不要模仿期刊品牌,不要虚构 DOI、卷期、页码或录用信息。
6.3 学习成果向稿件转移
把两组阅读应用到研究问题框定、Introduction 论证、Methods 粒度、Results 顺序、图件角色、Discussion、图注与引文实践,但不得照抄句子,也不得把范例结果导入本研究。在笔记中保留"所选教训 → 当前章节/图件"的简短映射,并在稿件源文件与代表性渲染页中确认转移生效。在mechanism_figure: prefer下,主动找出本研究的最佳解释性图件候选(生物学机制、社科/物理概念框架、计算架构用途不同),优先复用已有好图;新增的机制/示意图栅格图需使用规定的 GPT Image 2 能力并保留可编辑科学标注。
七、边界、限制与正确表述
汇总research.md及其佐证文档反复强调的边界,作为实战自查清单:
- 不伪造任何东西:不编造数据、指标、p 值、引文、图件、方法、作者、伦理、资助、权限或审稿结论(此条同时写入 SKILL.md 的 Authority and boundaries);
- 私有材料不出域:未经明确授权不上传私有材料;明确的离线指令优先于公开检索能力;
- 区分检索失败与无命中,区分"读完摘要支持的边界主张"与"读完全文/图件";
- 缺少复现输入不等于结果无效:只解决具体矛盾,不因缺原始数组而弃用用户提供的丰富结果图件;
- 不虚构独立复现:只发生了写作与可视化时,不得声称独立复现;
- 模式 ≠ 授权链:三种模式都不引入额外的分析报告、三透镜卷宗、Master 认证或 Runner 阶段门禁;已保存的文献学习数量仍是本论文的活跃要求;
- 未知投稿事实不阻塞本地稿:未知作者/伦理/期刊事实可能限制投稿就绪度,但不阻塞安全的本地方案草拟与修正;
- 汇报分层:本地交付、科学局限、投稿就绪度、外部授权分别报告(对应 SKILL.md 的 Quality rules 与 Completion contract)。
八、与整条生产协议的衔接
research.md描述的研究阶段只是 PaperSpine 17 步生产协议(paper-spine-production-protocol.md)中"第 3 步保存配置并建立研究范围""第 6 步盘点证据与可用结果""第 8 步完成问题所需分析"的核心方法依据。协议要求:每个实质段落/阶段之前,先确认上一段落的真实结果已进入同一任务工作台,再用paperspine_commit_milestone记录事实性摘要与真实 artifact ID,随后回读同一任务确认 stage、摘要、可见文件与待决选择一致——这与research.md的"记录来源与结果、不直接编辑桥接 JSON"一脉相承。
一句话总结本文的核心主张:research_mode是 PaperSpine 控制"何时可以产生新证据"的权限开关——materials_only承诺不制造证据,required在明确授权下制造恰如其分的证据,agent_decide由 Agent 裁量是否制造证据;而无论哪种模式,文献学习、证据映射与如实记录始终是不变的科学底线。
延伸阅读(仓库内)
- 方法正文与宿主侧读取方式:research.md、current-method-routing.md、current-method-routing.json
- 模式配置与意图映射:intake.md、intent-configuration.md
- 文献学习细则:journal-learning.md
- 图件与证据映射:scientific-figure-workflow.md
- 工作台进度与里程碑调用:product-v1-workflow.md
- 生产协议与总纲:paper-spine-production-protocol.md、SKILL.md
- 源码实现佐证:paperspine_methods.py(research_mode 上下文读取)、paperspine5_web.py(宿主方法/启动命令入口)
- AI 技能
- AI 写作
- 人工智能
- 深度研究
- AI 应用
【免费下载链接】PaperSpine
PaperSpine5 — local-first, evidence-bound paper research, writing, figures, review and delivery. Download: https://wubing2023.github.io/PaperSpine/v5/
相关推荐
PaperSpine5 科研模式(research_mode)完全指南:materials_only / required / agent_decide 三种研究范围与证据交接机制
PaperSpine5 科研模式(research_mode)完全指南:materials_only / required / agent_decide 三种研
AI 技能AI 写作人工智能深度研究AI 应用PaperSpine 论文研究模式(Research Mode)实战指南:materials_only / required / agent_decide 三模式下的证据边界与写作流程
PaperSpine 论文研究模式(Research Mode)实战指南:materials_only / required / agent_decide 三模
AI 技能AI 写作人工智能深度研究AI 应用PaperSpine 科研范围三模式全解:`research_mode` 的配置、执行与证据交接实战指南
PaperSpine 科研范围三模式全解: research_mode 的配置、执行与证据交接实战指南 PaperSpine5 以“本地优先、证据绑定”的方式完
AI 技能AI 写作人工智能深度研究AI 应用
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考