← 返回学习中心 · 知识库与科研OiOi Academy
科研 SKILL · 04 · 选题创新

PaperSpine5：从零开始，快速完成一篇图文完整的论文

一个覆盖论文全流程的 AI Skill：你给研究方向、已有资料或实验数据，它帮你查文献、搭大纲、写全文、画配图、核验引用、审稿修改，最后交付可编辑的 Word / LaTeX / PDF。高中生可读，细节拉满。

仓库 WUBING2023/PaperSpine 版本 v0.4.0-alpha.3 预发布 Stars 5,735 开源协议 MIT
⛰

开篇：写论文的人都翻过三座大山

想象你第一次要写一篇真正的学术论文，面前横着三座大山：

  • 第一座山：文献。导师说"先看 50 篇相关论文"。50 篇！每篇十几页英文，下到第六篇你就忘了第一篇讲了什么。
  • 第二座山：写作。好不容易做完实验，坐在空白文档前三个小时，一个字写不出来；好不容易写完，图表插不进、编号全乱、期刊格式对不上。
  • 第三座山：引用与审稿。正文里每一句话都要有文献撑腰，不能瞎编；投出去又怕被审稿人一句话问倒。
记住：PaperSpine5 就是来替你翻这三座山的。它是一个覆盖论文全流程的 AI Skill——从查文献、搭大纲、写全文、生成配图，到引用核验、审稿修改、排版交付，全部在一个任务里完成。
PaperSpine5 官方主视觉：从零开始，快速完成一篇图文完整的论文
PaperSpine5 官方主视觉：从零开始，快速完成一篇图文完整的论文
📦

它是什么：一句话定位卡

仓库名WUBING2023/PaperSpine（简称 PaperSpine5） 一句话本地优先、证据锚定的论文全流程 AI Skill：研究、写作、绘图、审阅、交付，一次搞定。 适用宿主Codex / Claude / OpenClaw / Hermes（同一个 Skill，四种"投影"） 当前版本v0.4.0-alpha.3（预发布，会自动检查更新） 运作方式在对话里通过 paper-spine 启动；研究材料优先保存在本地；打开一个网页工作台，你在网页上选方案、预览图文、提修改意见、下载成果。 交付物可编辑的 Word / LaTeX 源文件 + PDF，不只是"一段文字"。 仓库地址github.com/WUBING2023/PaperSpine · 产品页

关键词"证据锚定"是什么意思？

这是 PaperSpine 最硬的一条纪律，写在它的 SKILL.md 里：

记住：永远不许编造数据、指标、p 值、引用、图表、方法、作者、伦理声明。论点、引用、图表全部以你的真实资料和证据为依据。

普通 AI 写论文最大的毛病是"一本正经地胡说八道"（编造不存在的文献、编造漂亮但假的数据）。PaperSpine 的整套机制就是为了把"编"这条路堵死：每一句结论都要能在你的材料里找到出处。

💡

它解决什么问题

高中生类比
把写一篇论文想象成盖一栋房子。过去是你一个人：去砖厂搬砖（查文献）、和泥砌墙（写正文）、画施工图（做图表）、还要自己当监理检查质量（审稿）——又慢又容易出错。PaperSpine 就像请来了一支"建房工程队"：总包工头（Orchestrator）统筹，三个调研小分队去搬砖（查前沿/看场景/学范文），三个监理分别查结构、查装修、查证据，最后交给你一把能直接住的房子（可编辑的 Word/LaTeX/PDF）。你还是房主——选户型、定方案、点头验收这些关键决策都由你在网页工作台上做。

它具体干了哪几件事

  • 查文献：你给个研究方向，它去检索、梳理领域现状和创新点，不再人肉读 50 篇。
  • 搭大纲、写全文：从动机到方法到结果讨论，按期刊逻辑组织，有理有据地写。
  • 画科研配图：数据图、机制示意图、方法框架图，在同一个任务里生成并跟正文联动。
  • 引用核验：每一条引用都要回查原文，确认"这篇文献真的支持这句话"。
  • 审阅修改：安排"独立审稿人"挑毛病，按四轮修订流程打磨。
  • 排版交付：LaTeX / Word 模板排版、期刊格式适配，导出 PDF。
避坑
PaperSpine 不授权投稿、上传私有材料、付款或对外联系——这些需要你明确授权的动作，它不会擅自做。你的私有材料默认留在本地。
🏗

仓库结构导览：一个 Skill 的"五脏六腑"

PaperSpine 仓库虽然文件很多，但骨架很清晰——它是一个 Skill（名字叫 paper-spine），配上四份"宿主投影"，装到不同的 AI 工具上用：

PaperSpine/
├── dist/
│   ├── codex/skills/paper-spine/     # 装给 OpenAI Codex 用
│   ├── claude/skills/paper-spine/     # 装给 Claude Code 用
│   ├── openclaw/skills/paper-spine/   # 装给 OpenClaw 用
│   └── hermes/skills/academic-writing/paper-spine/  # 装给 Hermes 用
├── src/               # Skill 源代码（dist 是各宿主的公开投影）
├── install.ps1        # Windows 一键安装
├── install.sh         # macOS / Linux 一键安装
├── paperspine5/       # 旧版核心（PaperSpine4）
├── examples/          # 示例
└── website/           # 产品页网站源码

而 Skill 文件夹本身（以 dist/claude/skills/paper-spine/ 为例）长这样：

paper-spine/
├── SKILL.md                  # 总指挥官手册：权威规则 + 17 步生产协议入口
├── agents/                   # 6 位"特种兵"：3 个调研员 + 3 个审稿人
│   ├── research-sota.md      # 前沿调研：领域最新进展
│   ├── research-scene.md      # 场景调研：真实应用场景
│   ├── research-exemplar.md   # 范文学习：同领域好论文怎么写的
│   ├── reviewer-method.md     # 方法审稿人：挑方法的毛病
│   ├── reviewer-writing.md     # 写作审稿人：挑文字的毛病
│   └── reviewer-evidence.md    # 证据审稿人：查每句话有没有证据
├── references/               # 100+ 份"作战手册"：写作、引用、绘图、投稿…
│   ├── paper-spine-production-protocol.md  # 17 步论文生产协议（脊梁骨）
│   ├── citation-support-bank.md            # 引用证据银行
│   ├── figure-story.md                     # 科学配图叙事方法
│   ├── assertive-scientific-writing.md      # 学术写作风格
│   ├── round1~4-*.md                       # 四轮修订流程
│   └── contracts/                          # JSON 契约：各环节的输入输出规范
└── scripts/                  # 60+ 个确定性小工具（Python）
    ├── paperspine5_web.py      # 网页工作台启动器
    ├── paperspine_update.py    # 自动更新检查
    ├── artifact_check.py       # 成果物检查
    ├── citation_bank_check.py  # 引用库核验
    ├── latex_guard.py / word_guard.py  # 排版守卫
PaperSpine 运作架构：一支"论文工程队" Orchestrator 总包工头 SKILL.md · 17 步生产协议 调研小分队 ×3 research-sota 前沿进展 research-scene 应用场景 research-exemplar 范文学习 写作与绘图 搭大纲 · 写全文 figure-story 科学配图 引用证据银行 独立监理 ×3 reviewer-method 查方法 reviewer-writing 查文字 reviewer-evidence 查证据 网页工作台 Web UI 你选方案 · 预览图文 · 提修改 交付物 Word / LaTeX 源文件 + PDF

图：PaperSpine 的"工程队"分工。参考真实仓库结构（agents/、references/、scripts/）绘制。

🧩

核心技能逐个深讲

PaperSpine 表面上是"一个 Skill"，实际是一个技能体系：总指挥官 + 6 位特种兵 + 100 多份作战手册 + 60 多个确定性工具。下面把最关键的几个逐个讲透。

干什么：它是整个 Skill 的大脑。SKILL.md 里写明：当前宿主 AI 负责调研、引用核查、写作、绘图、修订，并安排独立审稿；17 步生产协议（paper-spine-production-protocol.md）是"脊梁骨"——每一步消耗当前任务状态、留下可核查的结果交给下一步。

输入 / 输出：输入是你的研究方向、已有资料或实验数据 + 目标期刊；输出是一篇证据锚定、图文完整、可交付的论文。

具体例子：你在 Codex 里说：

用 paper-spine 帮我写论文。方向：深度学习预测 ICU 急性肾损伤。
材料：我本地的 /data/aki_experiments 文件夹（实验结果表格）。
目标：投 Scientific Reports，英文。

它会先启动配置（自动打开网页工作台让你确认材料、选工作流），然后按 17 步协议一路执行：调研 → 大纲 → 写作 → 绘图 → 引用核验 → 审稿 → 交付，中途每个关键选择都回到网页上让你点头。

干什么：动笔之前先"做功课"，三路并进：

  • research-sota（前沿）：检索领域最新进展，搞清"现在研究到哪了、创新点在哪"。
  • research-scene（场景）：看真实应用场景，搞清"这研究对谁有用、解决什么真问题"。
  • research-exemplar（范文）：深度学习同领域、同目标期刊的好论文，拆解"人家是怎么写、怎么组织图表的"（deep-imitation-protocol.md 深度模仿协议）。

输入 / 输出：输入是研究方向 + 目标期刊；输出是领域现状报告、创新点定位、范文拆解档案（exemplar-learning-dossier.md）。

具体例子：写"AI 预测急性肾损伤"前，research-sota 会告诉你"2024 年之后大家都在用时序模型 + 可解释性"；research-exemplar 会拆解 Scientific Reports 上 3 篇同类论文的"引言四段式结构"，让你学着写。

干什么：论文写完后，安排"不是作者本人"的独立审稿人挑毛病——这是学术界真实的同行评审流程：

  • reviewer-method（方法监理）：实验设计站得住吗？对照组设对了吗？统计方法用错了吗？
  • reviewer-writing（写作监理）：逻辑跳跃吗？段落之间衔接吗？学术表达地道吗？
  • reviewer-evidence（证据监理）：每一句结论在你的材料里都有出处吗？引用真的支持这句话吗？

输入 / 输出：输入是论文草稿；输出是结构化的审稿意见 + 修改清单。

具体例子：证据监理发现你写了"本方法灵敏度达 92%"，但实验表格里写的是 89%，它会标出来："第 4 页第 2 段数字与表 2 不一致，请核对修正"——这种错人类作者也常犯。

干什么：把"引用"从"文末的参考文献列表"变成"每句话的证据存折"。每一处引用都要存下：这篇文献的哪一页、哪一段、哪句话支持了正文的哪句话。配套的 citation_bank_check.py 会自动核验。

输入 / 输出：输入是正文草稿 + 文献库；输出是"引用—证据"对应表 + 核验报告（哪条引用站不住脚）。

具体例子（可复制的指令）：

核查引言第 3 段这句话："AI 辅助诊断的灵敏度普遍超过 90%"。
找出文献库中真实支持这句话的文献，记录作者、年份、页码，
如果找不到直接支持的，明确告诉我"证据不足"，不要编造。

银行式管理的好处：审稿人质疑任何一句话，你 30 秒就能翻出证据。

干什么：科研图不是"把数据画出来"就行，要讲一个视觉故事。figure-story 方法要求：先看清真实图像→确定每张图要回答的问题→决定面板分工（哪个面板放 setup、哪个放主要发现、哪个放对比）→选参考图的结构学习（只学布局配色，不抄人家的数字和结论）→最后逐像素核验（标签、单位、图注、正文引用是否一致）。

输入 / 输出：输入是你的数据表/结果 + 参考论文的图；输出是数据图、机制示意图、方法框架图、 graphical abstract。

具体例子（可复制的指令）：

用 /data/aki_experiments/result.csv 里的准确率曲线，
参考这篇 Nature 论文 Figure 2 的双面板布局（只学布局，不抄数据），
画一张 300dpi 的折线对比图：左面板放三组模型的训练曲线，右面板放测试集 ROC。
图注用英文写，单位和正文第 3 节保持一致。

干什么：论文不是"写完就交"，要按四轮修订流程打磨：

  • round1 文献修订：补文献、调论证；
  • round2 期刊修订：按目标期刊的风格和要求改；
  • round3 LaTeX 精修：公式、交叉引用、排版细节；
  • round4 模板集成：套进期刊官方模板。

latex_guard.py / word_guard.py 是"排版守卫"：自动检查缺失的交叉引用、编号错乱、页面几何问题。translation-package 负责中英互译的术语一致性。

输出：可编辑的 Word / LaTeX 源文件 + PDF，同一任务内可反复修改（不用另起任务）。

🔁

完整工作流演示：从一句话到一篇论文

把上面所有技能串起来，一篇论文的诞生是这样的（对应 17 步协议的精简版）：

从一句话到一篇论文：8 个阶段 ① 配置网页选材料·定目标期刊 ② 调研前沿·场景·范文三路 ③ 大纲动机线·贡献点·章节 ④ 写作逐节撰写全文 ⑤ 绘图数据图·机制图·框架图 ⑥ 引用核验证据银行逐条核查 ⑦ 三审稿人方法·写作·证据独立审 ⑧ 交付Word/LaTeX/PDF 贯穿全程：你在网页工作台做关键决策 选研究方案 → 选配图方案 → 预览图文 → 提修改意见 → 下载成果 → 同一任务内继续修订 材料留在本地 · 私有内容不上传 · 每次调用自动检查更新 交付后的四轮修订（round1 → round4） 文献修订 → 期刊风格修订 → LaTeX 精修 → 期刊模板集成 latex_guard / word_guard 自动检查编号、交叉引用与排版

图：PaperSpine 论文生产线。每个阶段对应 17 步协议中的若干步；虚线框是全程的人机协作边界。

关键纪律（来自官方协议原文精神）

💾

安装与上手：三步开工

第 1 步：下载对应平台的套件

去 GitHub Release 页面下载（都有 SHA-256 校验）：Windows x64 约 26.5MB、Linux x86_64 约 56.2MB、macOS Apple Silicon 约 40.6MB / Intel 约 40.5MB。解压后进目录。

第 2 步：一键安装到你的 AI 工具

Windows（PowerShell）：

powershell -ExecutionPolicy Bypass -File .\install.ps1 -Target codex -CleanLegacy

macOS / Linux：

sh ./install.sh --target codex --clean-legacy

把 -Target codex 换成 claude 就装给 Claude Code 用。-CleanLegacy 会先只读预览旧版冲突，不会删你的论文数据。

第 3 步：启动，开始写

在对话里说 用 paper-spine 帮我写论文，它会自动打开网页工作台。也可以手动启动：

python scripts/paperspine5_web.py launch     # 启动网页工作台
python scripts/paperspine5_web.py status     # 查看状态
python scripts/paperspine_update.py --preflight --yes   # 检查更新
避坑
macOS 套件尚未签名/公证，首次运行系统可能弹窗拦截——去"系统设置 → 隐私与安全"里点允许即可。这是正常的，不是病毒。
📖

三个适用场景小故事

故事一：研一新生的开题报告

小林刚读研一，导师让他两周内交开题报告。他连"这个方向有哪些人在做"都不知道。他把方向告诉 PaperSpine，research-sota 一晚上梳理出近三年 30 篇核心论文的脉络，research-exemplar 拆了 3 篇范文的"引言四段式"，最后他交了一份"现状—缺口—思路"清清楚楚的开题报告，导师问的每个问题他都能答上出处。

故事二：医生的临床论文

陈医生攒了三年的病例数据，想发一篇 SCI，但"写英文论文"和"画机制图"都是短板。她把脱敏后的数据表交给 PaperSpine（材料留在本地医院电脑），它按 Scientific Reports 的风格写完全文、画好数据图和机制示意图，reviewer-evidence 逐句核对了每一处引用。陈医生只做了她最擅长的事：确认医学结论对不对。

故事三：跨学科团队的综述

一个"AI + 农业"交叉团队要写综述，成员分散在三地。他们用同一个 PaperSpine 任务：调研小分队分头梳理 AI 文献和农业文献，大纲阶段在网页工作台上投票选定框架，写作阶段每人认领章节，最后四轮修订统一风格。引用证据银行保证了 200+ 条引用条条有出处。

🏁

总结与延伸思考

一句话总结

PaperSpine = 请了一支"论文工程队"：总包工头按 17 步协议统筹，调研小分队搬砖、写作绘图盖楼、三位独立监理验收，最后交给你可编辑的 Word / LaTeX / PDF——而"证据锚定"这条铁律，保证了盖出来的每一块砖都是真的。

延伸思考

仓库原链：github.com/WUBING2023/PaperSpine · 产品页：wubing2023.github.io/PaperSpine/v5 · 开源协议 MIT

词

术语翻卡：点卡片看解释

证据锚定
evidence-bound
PaperSpine 的核心纪律：论文里的每一句话、每一个数字、每一条引用，都必须能在真实材料里找到出处，绝不编造。
Orchestrator
orchestrator
总指挥官：统筹整个论文生产流程的 AI 角色，负责按 17 步协议调度调研、写作、绘图、审稿各环节。
生产协议
production protocol
17 步论文生产流程：每一步消耗当前任务状态、留下可核查结果交给下一步，是 PaperSpine 的"脊梁骨"。
宿主投影
host projection
同一个 paper-spine Skill 针对不同 AI 工具（Codex/Claude/OpenClaw/Hermes）打包的四个版本，内容一致、入口不同。
引用证据银行
citation support bank
把每条引用存成"存折"：哪篇文献的哪一页支持了正文哪句话，配套脚本自动核验。
Figure Story
figure story
科学配图叙事法：每张图先回答"它要讲什么故事"，再定面板分工，最后逐像素核验。
独立审稿
independent review
写完后由"不是作者"的 AI 审稿人挑毛病，分方法/写作/证据三个维度，模仿真实同行评审。
四轮修订
four-round revision
文献修订 → 期刊风格修订 → LaTeX 精修 → 期刊模板集成的打磨流程。
LaTeX
LaTeX
学术排版语言，用代码写论文，公式、交叉引用、参考文献自动排版，理工科论文标配。
本地优先
local-first
你的研究材料默认保存在本地电脑，不上传；公开文献的检索是正常的。
Graphical Abstract
graphical abstract
图文摘要：一张图讲清整篇论文在干什么，很多期刊要求配。
p 值
p-value
统计学里判断"结果是不是碰巧"的指标，p 越小越不像碰巧；PaperSpine 严禁编造它。
测

自测：单选，点击选项看对错与解析

Q1PaperSpine 的核心纪律"证据锚定"是什么意思？
解析：SKILL.md 明确规定：永远不许编造数据、指标、p 值、引用、图表。引用证据银行（citation-support-bank）就是为了把这条纪律落到实处——每条引用都要能回查到原文。
Q2PaperSpine 里负责"查每句话有没有证据"的审稿人是？
解析：三位独立审稿人分工明确：reviewer-method 查方法、reviewer-writing 查文字、reviewer-evidence 查证据。research-sota 是调研员，figure-story 是绘图方法。
Q3安装 PaperSpine 到 Claude Code，应该用的命令是？
解析：官方安装器是 install.sh（macOS/Linux）/ install.ps1（Windows），用 --target 指定宿主（codex/claude…）。仓库 README 原文如此。
Q4你的实验数据很敏感（病人信息），用 PaperSpine 时最该记住哪一点？
解析：PaperSpine 是本地优先设计：研究材料优先保存在本地；SKILL.md 明确"任务状态不授权上传、投稿、付款或外部联系"，须经你明确授权。
Q5论文写完后，PaperSpine 的打磨流程包含几轮修订？
解析：仓库 references/ 里有 round1-literature-revision 到 round4-template-integration 四份修订流程文档，对应四个阶段。
Q6以下哪项是 PaperSpine 明确"不会擅自做"的？
解析：README"边界"一节原话：产品发布不授权投稿、上传私有材料、付款或外部联系。这些必须经你明确授权。