跳到正文
CCopyright.软件资料与软著工具

版本记录

软著代码版本管理记录怎么导出?Git、GitHub、Gitee 整理指南

CCopyright 编辑团队内容核对:非官方指南

版本管理记录应来自项目已有的版本系统。先确定要说明的仓库和提交范围,再导出历史,避免把多个项目、多个分支或整理后的描述混成无法追溯的一份表。

整理 Git 版本记录
提交历史说明仓库中记录的变化,不会自动证明权属或全部研发活动。整理时保留原始字段,不倒填日期、拆造提交或虚构历史。

先固定仓库、分支与版本范围

记录仓库名称、选定分支或版本标签,以及导出时的提交号。多个仓库可以分别导出,并在说明中解释它们属于同一软件的哪些模块。

默认 git log 只列当前分支可达的提交,不等于仓库的全部历史;浅克隆也可能缺少早期提交。工具只整理你提供的数据,不会自动从远端补齐。

Git 提交记录的可复现导出方式

以下命令生成 UTF-8 制表符分隔文本,不修改仓库。字段顺序为提交号、作者时间、提交者时间、作者和提交说明。导出后请先检查是否包含不宜外发的信息。

  • 作者时间和提交者时间不是同一个字段,应分别保留。
  • 工具接受该格式的 TSV;文件编码应为 UTF-8。
  • Windows 终端若默认导出其他编码,请明确选择 UTF-8 后再导入。
git log --reverse --date=iso-strict --format='%H%x09%aI%x09%cI%x09%an%x09%s' > commits.tsv

GitHub、Gitee、GitLab 和 SVN 怎么选择资料

GitHub、Gitee 和 GitLab 托管的 Git 仓库都可以从实际本地克隆导出上述历史。网页中的提交链接、发布页和 PR/MR 可作为补充来源。

SVN 项目应保留实际 revision、作者、时间与日志,可使用其自身导出功能。当前网页工具的自动解析仅支持本页 Git TSV 格式,不能将 SVN 输出改写成伪造的 Git 提交号。

版本记录里应解释什么

保留完整提交号、日期时区、作者和原始说明,再补充软件版本或范围说明。若提交信息不清楚,应另外写说明,不覆盖原始标题。

合并、回退或修复也是开发过程的一部分。不要为了显示“只成功不失败”而将它们改写成其他事项;提交附件范围需要说明筛选方式。

只有一个源码包,没有版本历史怎么办

源码快照可以支持目录和当前文件哈希的整理,但无法反推出此前的提交时间、作者和迭代过程。

可以整理现有版本备份、交付记录、需求和测试资料,注明各自来源与缺失情况。是否满足补正要求,应就具体通知向办理机构确认。

常见问题

代码托管在私有仓库,必须公开仓库吗?

不要仅为了整理材料就公开私有仓库。可导出通知要求范围内的记录并做适当脱敏;具体提交方式仍需核对通知。

需要凑够多少次提交?

本轮未核实到统一的最低提交次数要求。真实记录的对应关系比数量更重要,不能通过拆分或补造历史来满足想象中的门槛。

版本记录可以证明代码没有使用 AI 吗?

不能仅靠提交历史得出这一结论。应按真实使用情况填写声明,并根据通知补充能够核对的资料。

依据与资料来源

继续核对其他材料