Yrzsh/paper-workbench · 上手攻略
- 仓库：Yrzsh/paper-workbench
- 链接：https://github.com/Yrzsh/paper-workbench
- 分类：academic-writing
- 作者：Tom
- 更新：2026-09-08
是什么
Paper Workbench 是一个纯 Python 标准库驱动的学术论文全流程流水线引擎，本地运行，零外部依赖（核心仅用 Python 标准库）。它的核心理念是：
AI 干体力活，机器把守验证，关键判断留给人。
工作台覆盖从文献调研 → 定期刊 → 搭框架 → 写作 → 八步审查 → 投稿六大阶段，每一阶段的推进都必须过机器门禁——检查点没有真实证据凭据就推不动，杜绝"勾满检查点、编好引用、换配置刷显著性"的假完成。
v2.0.0 实测：87 条真实参考文献中，核验抓出 5 处年份/期刊级字段偏差——这类错误曾以 verified ✅ 状态漏过人工评审。
⚠️ 存疑：v2.0.0 Release 页的实测记录未经二次核验，数字引用自仓库自述，待读者自行验证。
解决什么问题
纯提示词约束下，AI agent 的假完成率可达 100%——勾满检查点、编引用、刷显著性。Paper Workbench 用以下机制应对：
| 机制 | 说明 |
|---|---|
| 三级证据凭据 | 机验（验证器+哈希）> 人判（作者署名）> 快照（产物哈希） |
| 五档引用核验 | Crossref → OpenAlex → arXiv 三源级联，逐字段比对，裁决分 Exact/Minor/Major/Hallucinated/Pending |
| 统计配置冻结 | statistics-plan.md 配置哈希登记，执行后回改未升版即拦截，封死"换方法挑显著结果" |
| 引用-论断支撑工单 | 摘要/结论区每条带引用的论断生成工单，逐条裁决，unsupported 直接拦截投稿 |
| 防绕过台账 | 所有工具调用落账 data/tool_ledger.jsonl，process_audit 用修改时间比对暴露绕过行为 |
快速安装
方式一：CLI（适合习惯终端的人）
# 1. 确认 Python 版本 ≥ 3.10
python --version
# 2. Clone 或下载解压
git clone https://github.com/Yrzsh/paper-workbench.git
cd paper-workbench
# 3. 跑冒烟测试
python smoke_test.py
# 预期输出：PASS: 135 FAIL: 0
# 4. 初始化项目
python wb.py init "我的论文题目"
# 5. 按 next 指引推进
python wb.py next
方式二：Web 界面（适合想用鼠标的人）
# 双击 web\start-workbench.bat
# 或手动启动：
python web/server.py
# 默认 http://127.0.0.1:8123
方式三：MCP 工具（适合有 Claude Code / Cursor / Qoder 等 MCP 兼容 agent 的人）
python register_mcp.py
# 之后对 AI 说"帮我推进论文"，AI 通过 MCP 工具干活，全程落台账
核心用法
阶段推进命令
# 查看当前状态
python wb.py status
# 推进到下一阶段（必须检查点全勾完才放行）
python wb.py stage journal
# 勾选检查点
python wb.py check research 1
python wb.py check research 2
# 全面体检
python wb.py doctor
# 摘要/总结
python wb.py summary
工具箱（toolbox.py）
python toolbox.py search "关键词" # 文献搜索
python toolbox.py fetch <url> # 抓取文献
python toolbox.py verify-bib # 核验参考文献
python toolbox.py used-refs # 查看已引用文献
python toolbox.py quality-check # 质量检查
python toolbox.py contribution-check # 贡献度检查
python toolbox.py stats-freeze # 冻结统计配置
python toolbox.py stats-check # 检查统计配置漂移
python toolbox.py audit-stats # 审计统计
python toolbox.py originality # 原创性检查
python toolbox.py lang-check # 语言检查
python toolbox.py export # 导出
python toolbox.py chart # 生成图表
python toolbox.py figure # 生成插图
python toolbox.py cn2bib # 中文文献转 BibTeX
支撑工单（support_check.py）
python support_check.py build # 构建引用-论断支撑工单
python support_check.py verify # 验证工单裁决完整性
分批生成流程
generate contract → section/parallel → abstract → assemble
- 契约先行（必须先定义写作契约）
- 段级门禁（每段完成后才能写下一段）
- 摘要后置（防止先射箭后画靶）
- 依赖图分波并行，失败降级单体路径
典型适用场景
- 研究生写学位论文：六级阶段门禁强制推进，贡献确认 → 数据账本 SOURCES.md → 八步审查，环环相扣。
- AI 辅助写论文怕假完成：每次 AI 完成都落证据凭据，人工审查时有据可查。
- 课题组多人协作：项目文件夹结构（
research/journal/framework/data/manuscript/review/submit/）清晰，本地 Git 管理版本。 - 防止统计显著性作弊：统计配置冻结机制让"换方法挑结果"无所遁形。
- 投稿前自查：8 步审查流水线覆盖 Claim 审计 / 引用核验 / 统计审计 / 三视角模拟审稿 / 结构审计 / 润色 / 格式 preflight / 原创性。
坑与注意
⚠️ 引用核验Pending或超时：本机网络访问不到 Crossref/OpenAlex/arXiv 时显示 Pending，不影响其他功能，可稍后重跑。不影响门禁逻辑，Pending 状态的引用不会放行。
⚠️ Python 版本要求：必须 Python ≥ 3.10，安装时务必勾选 Add python.exe to PATH。
⚠️ MCP 注册后需重启 AI 客户端：register_mcp.py 执行后，部分 MCP 客户端需要手动重启才能识别新工具。
⚠️ 桌面版依赖：pywebview 桌面窗口为可选组件，缺失时自动降级为纯 Web 界面，功能不受影响。
⚠️ 数据全程本地：工作台不上传任何内容，所有数据留在本机，适合有数据安全要求的学术场景。
⚠️ semantic 级引用支撑裁决：语义级"引用是否真正支撑论断"当前为工单 + 人工/异源裁决模式，全自动版本在路线图上，介意者请关注后续版本。
⚠️ 冒烟测试版本差异：smoke_test.py 测试覆盖编译、状态机、凭据、门禁异常注入、引用裁决、冻结漂移、工单、Web/MCP 起服，共 135 项；若测试结果不符，务必排查 Python 版本和环境。
与同类对比
| 工具 | 依赖 | 门禁机制 | 引用核验 | 适用场景 |
|---|---|---|---|---|
| Paper Workbench | 纯标准库，零依赖 | 强（证据凭据+配置冻结+防绕过台账） | Crossref/OpenAlex/arXiv 三源级联 | 怕假完成的严肃学术写作 |
| hanlulong/econ-writing-skill | Python + 外部 API | 弱（依赖 LLM 自觉） | 单一来源 | 快速草稿生成 |
| Mimir（1692775560/dsh-Mimir） | TypeScript + 外部服务 | 中（LaTeX 编译检查） | 无明确多源核验 | 科研全周期管理 |
Paper Workbench 的核心差异化在于机器门禁的严肃性：不是用 LLM 写论文，而是用确定性代码守住每一个检查点，把"假完成"的可能性从 100% 压到最低。
一句话推荐结论
如果你正在用 AI 辅助写学术论文，又担心 AI 偷懒或自己被假完成欺骗，Paper Workbench 是目前开源领域门禁最严格的学术写作流水线，纯 Python 标准库核心、零依赖、适合任何有本地 AI 助手的研究者。
写作指引来源：W33–W36 lessons · 高分共性：GitHub 已验 + ⚠️ + 双轨 + fetch + abstract 核实；本篇已做 web_fetch 原始文档获取。