PaperSpine 3.x升级到4.0完整攻略：如何用--clean-legacy彻底清理旧版worker残留

PaperSpine 3.x升级到4.0完整攻略如何用--clean-legacy彻底清理旧版worker残留【免费下载链接】PaperSpinePaperSpine5 — local-first, evidence-bound paper research, writing, figures, review and delivery. Download: https://wubing2023.github.io/PaperSpine/v5/项目地址: https://gitcode.com/gh_mirrors/pa/PaperSpinePaperSpine5是一款本地优先、证据绑定的 AI 论文全流程工具查文献、搭大纲、写全文、生成科研配图最终交付可编辑的 Word/LaTeX 与 PDF。从 3.x 升级到 4.0 只需一条带--clean-legacy参数的安装命令——它会把旧版遗留的 worker Skill 目录只归档、零删除且全程可恢复。本文带你 5 分钟完成升级、清理与验证。 升级前 30 秒4.0 到底改了什么3.x 时代PaperSpine 在宿主Codex / Claude Code的 skills 目录里散落了16 个旧 worker Skillpaper-spine-ui、paper-spine-intake、paper-spine-research、paper-spine-citation……每个负责一个阶段。4.0 做了架构收敛所有 worker 被合并进唯一的paper-spine编排 Skill各阶段逻辑改为读取references/*.md阶段手册playbook并内置了 Web 工作区。历史 worker Skill 的说明见 suite-map.mdHistorical worker skills (paper-spine-ui,paper-spine-intake, etc.) were removed in architecture convergence Stage 2b.但如果你直接从 3.x 升级旧 worker 目录仍留在 skills 目录里可能与新 Skill互相抢占触发——这正是--clean-legacy要解决的问题。升级后的 PaperSpine 5 工作区长这样从工作配置、论文主稿、科研图件到交付成果四个阶段在同一条流水线里推进在同一个任务里它还能生成完整的科研配图例如下面的多面板方法示意图输入→融合→层级→任务头的完整逻辑 最快上手一条命令完成安装升级克隆仓库并进入目录git clone https://gitcode.com/gh_mirrors/pa/PaperSpine cd PaperSpinemacOS / Linux--target按需选codex、claude-code或bothsh ./install.sh --target codex --clean-legacyWindows x64powershell -ExecutionPolicy Bypass -File .\install.ps1 -Target codex -CleanLegacy完整参数说明见 INSTALL.md。安装器会自动检测 OS 与 CPU、下载匹配的平台套件、校验字节数与 SHA-256、安装 Skill 并要求首次启动自检。安装完成后请重启宿主让新 Skill 生效。只想检查、不做任何变更加一个参数即可sh ./install.sh --check-only离线环境可以用本地 manifest 套件包校验安装详见 INSTALL.md 的离线安装小节。 原理拆解--clean-legacy 先预览、后归档、零删除很多人担心清理删数据其实--clean-legacy的核心承诺是不删除任何论文任务数据、宿主设置或未知文件夹。它由 skill_discovery_migration.py 驱动流程分三步只读预览preview扫描 Codex/Claude 的 skills 目录列出所有与旧版重名的冲突目录此时零写入按需迁移migrate只有预览结果中item_count大于 0 时才执行归档安装脚本 install.sh 中的判断逻辑把旧目录移出自动发现路径签发回执receipt每次迁移生成一份哈希绑定的 JSON 回执存放在~/.paperspine5/legacy-migrations/receipts/凭回执可随时原样恢复。如果迁移提交后安装中途失败sync_local_installs.py 还会自动触发恢复把归档目录放回原位——你最多收到一条警告而不是一个半迁移的残缺状态。 会被清理的旧目录全名单--clean-legacy只动已知的旧版名称白名单硬编码在 skill_discovery_migration.py类型目录名旧版主 SkillPaperSpine、PaperSpineV2、paperspine5-workspace、paperFig旧版 workerpaper-spine-ui、paper-spine-intake、paper-spine-research、paper-spine-citation、paper-spine-rewrite、paper-spine-build、paper-spine-latex、paper-spine-audit、paper-spine-translate、paper-spine-humanize、paper-spine-update备份/更新残留.paperspine5-update-backups命名模式paper-spine.pre-*、paper-spine.backup-*不在此名单里的目录一律不碰放心执行。✅ 升级后验证三步确认万无一失第一步确认 Skill 就绪。重新运行一次安装命令不加任何参数若提示up to date且skills_ready: true说明单 Skill 已正确绑定套件INSTALL.md 说明了交易式更新与数据保留机制。第二步核对版本与任务数据。当前 Skill 版本号为 4.0.1见 paperspine_version.json默认 profile 位于~/.paperspine5/profiles/defaultmacOS/Linux或%USERPROFILE%\.paperspine5\profiles\defaultWindows——升级前后任务数据路径不变可直接继续未完成的论文。第三步可选跑一遍验收。仓库自带端到端验收脚本 v4_acceptance.py会真实执行全部守卫脚本并生成TEST_REPORT.md回归测试覆盖清理逻辑的边界情况见 test_suite_hardening.py。万一发现旧目录归档有误用回执恢复即可skill_discovery_migration.py 的restore子命令python skill_discovery_migration.py restore \ --receipt ~/.paperspine5/legacy-migrations/receipts/operation_id.json \ --operation-id restore-1至此PaperSpine 已从 3.x 平滑升级到 4.0单一编排 Skill、完整 Web 工作区、干净的 skills 目录而你的任务数据与论文进度分毫未损。更详细的发布细节可查阅 RELEASE-NOTES-v0.4.0-alpha.3.md。【免费下载链接】PaperSpinePaperSpine5 — local-first, evidence-bound paper research, writing, figures, review and delivery. Download: https://wubing2023.github.io/PaperSpine/v5/项目地址: https://gitcode.com/gh_mirrors/pa/PaperSpine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考