前言¶
写论文时常见一种局面：本地同时留着 v3-final、v3-final-改、送审版 等文件名，隔两周已记不清某一版改了什么、哪一版还能当作底稿。Git 能管文本差异，但学术论文往往还叠着审查意见、决策理由和质量判断，单靠 commit 信息很难还原「这一版为什么比上一版更好」。
下面介绍 SkillHub 上的社区 Skill 论文版本管理器（坐标 @user_8d26dabd/paper-version-manager，当前发布版本 2.0.10）。它把版本血缘、质量量化、变更日志和安全回退写成一套可执行流程，由 Agent 在对话里按 SKILL.md 与 references/ 细则落地；不需要 API Key（requires_api_key=false），且声明为离线工具，依赖 read / write 访问本地文件。
这是什么¶
论文版本管理器面向学术论文写作中的多版本演进管理：追踪版本之间的继承与分支、用加权维度给各版打分、从相邻审查结果生成结构化 CHANGELOG，并通过「安全底本」与决策日志保证修改可审计、可回退。
- 来源：SkillHub 社区（
community），发布者user_8d26dabd；SkillHub 页面标注作者为刘楠，包内 README 署名人类 Nan。 - 分类：
dev-programming。 - 平台数据（SkillHub 已抓取资料，2026-10-21）：评分 100000，下载 1382，安装 0。
与「审稿」「投稿」类 Skill 的分工在包内写得很清楚：要审稿走 paper-review-methodology，要投稿走 submission-helper；本 Skill 专注版本演进、评分、日志与回退，不替代审校或投稿流程。
核心功能¶
以下能力均来自官方 SKILL.md 与 references/ 文档，Agent 按场景路由执行。
-
版本血缘可视化
用 Mermaid 等形式描述版本树，标注继承、分支、合并及关键节点（如架构重构、P0 清零、送审就绪等）。细则见references/version-tree.md。 -
四维加权评分
从内容完整性、逻辑完整性、逻辑闭环、AI 检测评估四个维度量化单版质量，并支持趋势对比。公式与权重在references/scoring-system.md中定义，例如：
综合得分 = 内容完整性 × 0.30 + 逻辑完整性 × 0.25 + 逻辑闭环 × 0.25 + AI检测评估 × 0.20
文档还给出送审就绪线（≥85）、修改完成线（≥75）等阈值说明；README 提到可用 Python matplotlib 生成雷达图与趋势图（需本地具备相应环境）。
-
变更日志自动生成
基于相邻两版审查报告做差异提取，按新增/修改/删除/修复分类，并用 P0–P3 标注严重级别，产出 CHANGELOG。流程见references/changelog-workflow.md。 -
安全底本管理
在并行修改或冲突场景下，优先保护「数据诚信度」最高的底本，使回退有明确锚点。方法见references/safe-baseline.md。 -
决策日志与审计
记录关键写作决策，并在后续版本中核查落实状态。模板与审计步骤见references/decision-log.md。
质量红线（官方明确）：不直接改写论文正文与审查报告本身，只做版本管理；每个版本需有唯一标识与修改时间；初始化阶段应设定安全底本。
学术伦理边界：禁止为掩盖抄袭、数据造假等不端行为而删除或篡改版本历史，禁止伪造修改痕迹以规避查重；关键不可逆操作须用户确认并保留审计记录。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装，或把安装提示发给当前 Agent。
1. 检查 SkillHub CLI¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档 执行官方脚本（完整安装或 --cli-only）。
2. 安装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端会加载的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install paper-version-manager --namespace user_8d26dabd --dir <你的 skills 目录>
搜索确认坐标与版本：
skillhub search paper-version-manager
常见路径（摘自 SkillHub 安装文档，按你实际客户端选择其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
3. 通过对话让 Agent 安装¶
SkillHub 页面提供的提示等价于：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_8d26dabd/paper-version-manager`。
安装完成后，在支持 Skill 的客户端中重启或刷新技能列表，使 SKILL.md 被加载。触发词包括「论文版本」「版本对比」「变更日志」「安全底本」等中英文关键词（见包内 frontmatter 与正文）。
典型用法¶
官方在 SKILL.md 中给出最小闭环，适合第一次接入：
- 初始化版本：确定基线稿（如 V1.0），建立不可篡改的安全底本快照。
- 记录变更：每次修改后登记修改点、决策理由与评分变化到决策日志。
- 生成产物：按四维评分量化质量，输出 CHANGELOG 与版本血缘树。
- 深挖细则：结构对比、退化检测等再查阅对应
references/*.md。
对话示例（包内原文）：用户说「请帮我管理论文 V1.2 到 V1.3 的修改」→ Agent 应输出版本树、修改记录、决策说明。更细的 CHANGELOG 流程需要你有上一版与当前版的审查报告（或等价差异输入），否则只能先建基线并提示后续按版归档。
README 中还列出几条可复现的提问方式，例如「给 v2.0 版本打个分」「生成本次修改的变更日志」「审计决策在当前版本的落实情况」，分别对应 scoring-system.md、changelog-workflow.md、decision-log.md。
适用场景与注意¶
适合谁
- 同一课题多轮大修、并行分支（如导师版 / 自用版）需要一张「版本地图」的作者。
- 已有审查报告或修改清单，希望自动生成按 P0–P3 分级的 CHANGELOG。
- 需要在投稿前固定「送审快照」，并保留决策与评分曲线以便复盘。
限制与注意
- 输入完整性决定输出质量：缺少历史稿、审查报告或时间线时，Skill 会降级为「建初版基线 + 提示后续存版」（见包内 eval 说明）。
- 与 Git 职责不同：通用仓库版本管理仍适合 Git；本 Skill 强调论文场景下的血缘、评分、底本与审计，二者可并存但配置与习惯应区分。
- 不联网：不会自动访问外部服务；图表脚本若使用 matplotlib，需本地自行安装依赖。
- 伦理与确认：覆盖、删除版本历史等操作需人类确认；不得用于掩盖不端或伪造演进。
- 邻接能力：深度审稿、排版引文、查重降重等由套件内其他 Skill 或外部工具承担，本 Skill 多在上下游完成后做归档与对比。
结尾¶
论文版本管理器把「第几版、改了什么、质量是否变好、能否回到可信底本」从文件名猜测变成结构化产出。若你需要在 Agent 里接入，可从 SkillHub 安装 @user_8d26dabd/paper-version-manager（v2.0.10），官方入口：
- API 坐标页：https://api.skillhub.cn/user_8d26dabd/paper-version-manager
- SkillHub 展示页：https://www.skillhub.cn/skills/user_8d26dabd/paper-version-manager
