软件著作权申请资料包 / Software Copyright Application Pack

你现在运行 software-copyright 技能。一次性把任意本地源码项目变成一份国家版权局可直接受理的软件著作权登记资料包：4 份 .docx + 1 份 .txt。

• 1 份 操作手册.docx（按软著标准骨架撰写）
• 1 份 源代码前 30 页.docx（宋体小四 10.5pt、行号连续可见、约 50 行/页）
• 1 份 源代码后 30 页.docx（同样宋体小四 + 行号；与前 30 页合计 ≥ 60 页）
• 1 份 源代码全部.docx（超长项目摘录版：前 30 页 + 中间省略 + 后 30 页，便于审核或档案归档；不足 60 页时退化为「全部源代码」）
• 1 份 申请表信息.txt（含 PII 占位字段）

附带 1 份 生成报告.md 作为自检 build report（不算 5 件主交付物，但便于 QA / 用户回查清单）。

打印或上传到 中国版权保护中心计算机软件著作权登记系统 即可提交，免代办费。

本课基于上游开源 skill Fokkyp/SoftwareCopyright-Skill（MIT）做 Clawvard SOP 适配 + showcase 制作。skill 内核：SKILL.md + Python 脚本 + python-docx 模板，无 LLM 调用层；所有业务推理（业务理解 / 操作手册撰写 / 申请表填写 / 代码取舍）由 Claude Code 原生 Anthropic Messages 路径在本进程内完成。课程主页 https://clawvard.school/courses/software-copyright。

前置条件

• Python ≥ 3.10（python3 --version）+ python-docx（pip install python-docx）
• Claude Code（任意带 agent 能力的工具均可，本 SOP 以 Claude Code 为基准）
• Clawvard API key 已配置，Claude Code 原生 Anthropic Messages 路径作 bearer credential —— 在 https://clawvard.school 控制台拿一把
• 任意一个本地源码项目作为输入（语言无所谓：Python / Go / Java / TypeScript / Rust / C# / Kotlin / ……）
• 零第三方付费 API、零商业图像/语音 key：不需要 OpenAI / Gemini / 任何 OpenAI-compatible base URL；不需要 Clawvard 一方 SDK 任何 service
• 不需要 clone 任何私有仓库；底层 skill 完全开源、MIT

安装

# 1) 装上游开源 skill（公开 MIT 仓库，含 SKILL.md + 脚本 + python-docx 模板）
git clone https://github.com/Fokkyp/SoftwareCopyright-Skill ~/.claude/skills/software-copyright-materials

# 2) 装 python-docx（Word 排版唯一依赖）
pip install python-docx

# 3) 把本课程的 NCAC 格式合规补丁脚本下到项目当前目录（公开 https，无需登录、无需 token）
curl -fsSL https://clawvard.school/skills/software-copyright/format-compliance.py \
  -o format-compliance.py

# 4) （可选）若需要更严格的 OpenXML 校验，按上游脚本装 .NET 8 完整环境：
bash ~/.claude/skills/software-copyright-materials/software-copyright-materials/vendor/docx-toolkit/scripts/setup.sh
# 跳过这步也能跑，python-docx 兜底分支足够提交国家版权局

启动 Claude Code，在任意本地项目目录内说「启动 software-copyright skill」即可。

为什么需要 format-compliance.py？上游 Fokkyp/SoftwareCopyright-Skill（MIT）只产出 3 份代码 .docx 且默认 Consolas 7pt 无可见行号；而国家版权局软件著作权登记规则要求宋体（SimSun）小四（10.5pt）+ 连续可见行号 + 长项目可附《代码(全部).docx》摘录版。本脚本仅依赖 python-docx、约 250 行、源码托管于 clawvard.school/skills/software-copyright/format-compliance.py，对上游 .docx 做最小变更并新增第 4 份 .docx，使最终交付物完全符合 NCAC 规则。MIT 协议、零 LLM 调用、零外部 API、零 Clawvard 一方 SDK 依赖，断网也能跑。

输出布局

<你的项目目录>/
└── 软件著作权申请资料/
    ├── 草稿/                          # 模型研判用，用户确认后才进入正式产出
    │   ├── 业务理解.md
    │   ├── 申请表信息.md
    │   ├── 代码文件选择.json
    │   ├── 操作手册.md
    │   └── 操作手册自检记录.md
    ├── 环境检查.md
    └── 正式资料/                       # ← 4 .docx + 1 .txt 在这里
        ├── <软件全称>_操作手册.docx
        ├── <软件全称>-代码(前30页).docx
        ├── <软件全称>-代码(后30页).docx
        ├── <软件全称>-代码(全部).docx          # 超长项目摘录版；项目代码不足 60 页时它会单独提交
        ├── 申请表信息.txt
        └── 生成报告.md                      # build report，自检清单 + 下一步指引

工作流程（8 步，每步都有人工门禁）

重要：每个门禁前 agent 必须停下来等用户输入，不得静默"默认继续"。门禁未经用户确认就跑下一步 = 资料不可信。

1. 环境检查

python3 ~/.claude/skills/software-copyright-materials/software-copyright-materials/scripts/check_environment.py \
  --out-dir 软件著作权申请资料

产物：软件著作权申请资料/环境检查.{md,json}。告诉用户当前环境支不支持完整 OpenXML 校验（.NET）。门禁 environment：用户必须明确选"装完整环境"或"用 python-docx 兜底"。

2. 项目扫描 + 业务理解

让 Claude Code 用 Read / Glob / Grep 扫描项目源代码（自动跳 node_modules / .git / build / dist / vendor / __pycache__ / target / venv / .next），结合 package.json / pyproject.toml / pom.xml / Cargo.toml / README.md 等元数据，产出 草稿/业务理解.md：行业、目标用户、核心功能、用户操作流程。

门禁 business：用户必须确认行业、目标用户、核心功能描述正确。

3. 申请表草稿

Claude Code 基于 业务理解.md 产出 草稿/申请表信息.md：软件全称 / 简称 / 版本号 / 开发完成日期 / 首次发表日期 / 开发方式 / 权利取得方式 / 原创性说明 / 著作权人 / 联系方式 / 硬件环境 / 操作系统 / 编程语言 / 源程序量 / 软件分类 / 页数 等。

PII 字段铁律：身份证号 / 公司统一社会信用代码 / 通讯地址 / 邮政编码 / 联系电话 / 电子邮箱一律写成 [PII：请手填]，agent 绝不编造。著作权人姓名 / 公司全称也用同一占位让用户填，避免任何 hallucination 风险。

门禁 application-fields：用户必须补齐所有 [PII：请手填] 字段，并确认硬件 / 系统环境字段。

4. 代码文件选择

Claude Code 阅读项目源码后产出 草稿/代码文件选择.json：优先抽取入口 / 路由 / 页面 / 核心组件 / 接口封装 / 状态管理 / 工具函数，逐文件给出抽取理由。

门禁 code-selection：用户可增删文件、调整顺序。

5. 操作手册撰写

Claude Code 按"相关文档 → 说明 → 功能特点 → 系统要求 → 各核心页面用户操作 → 常见问题 → 术语表"骨架撰写 草稿/操作手册.md：

• 一级标题用中文大写序号（一、相关文档），不用 (1)、相关文档
• 相关文档章节用表格指向总体设计 / 详细设计 / 测试案例等
• 正文用连续段落，不用 1./2./3. 编号列表
• 每个核心页面从普通用户视角写：进入位置 / 用户可见内容 / 用户动作 / 输入限制 / 异常提示 / 结果反馈 / 截图预留
• 避免"赋能 / 一站式 / 智能化 / 高效便捷 / 显著提升"等套话
• 同步产出 草稿/操作手册自检记录.md：每轮"AI 味"检测 + 修订记录

门禁 screenshot-method：让用户在「Chrome DevTools MCP / Codex Computer Use / 自行截图 / 本次跳过」中选择。选"跳过"时操作手册仍保留可见的截图预留位（如 【截图预留：请在此处插入"项目管理"页面截图】）。

6. 草稿确认

门禁 markdown：用户阅读全部 草稿/*.md 后确认进入正式 Word 生成。

7. 正式 Word/TXT 生成

上游 build_docx_from_md.py 要求显式传入软件全称与版本号（脚本不会从 markdown 里反推）。把第 3 步用户确认后的字段直接传给脚本：

# CLAUDE_SKILL_DIR 默认 ~/.claude/skills/software-copyright-materials
python3 "$CLAUDE_SKILL_DIR/software-copyright-materials/scripts/build_docx_from_md.py" \
  --workdir 软件著作权申请资料 \
  --software-name "<你的软件全称，例如 小记账>" \
  --version "<你的版本号，例如 V1.0>"
# 例：python3 .../build_docx_from_md.py --workdir 软件著作权申请资料 --software-name "小记账" --version "V1.0"

必填参数：

• --workdir 输出目录（默认 软件著作权申请资料）
• --software-name 软件全称（必填，与第 3 步申请表 软件全称 字段一致，决定文件名与页眉）
• --version 版本号（默认 V1.0，与第 3 步申请表 版本号 字段一致）

脚本只做 4 件事：

1. 读 草稿/申请表信息.md 的「软件全称 / 版本号」（应与命令参数一致），作为正式资料文件名与 Word 页眉
2. 从 草稿/操作手册.md 套模板生成 <软件全称>_操作手册.docx
3. 从 草稿/代码-前30页.md、草稿/代码-后30页.md 套模板生成代码 Word（注意：上游脚本对 84 页这类常规项目只产 前30页 + 后30页 两份，不会自动产《代码(全部).docx》，第 8 步会补这一份）
4. 把 草稿/申请表信息.md 中除 [PII：请手填] 外的字段写入 申请表信息.txt，并生成 生成报告.md

产物全部落在 软件著作权申请资料/正式资料/ 里。此时是 3 .docx + 1 .txt + 1 .md（build report），字体是 Consolas 7pt 且无可见行号——下一步 NCAC 格式补丁会把这两个问题修掉并补足第 4 份 .docx。

8. NCAC 格式合规补丁（必跑）

上游 build_docx_from_md.py 默认 Consolas 7pt 无可见行号、并且常规项目不出《代码(全部).docx》——本步把它们一次性补齐。format-compliance.py 已经在第 0 步「安装」里下载到当前目录：

python3 format-compliance.py \
  --workdir 软件著作权申请资料 \
  --software-name "<同第 7 步>" \
  --version "<同第 7 步>"

参数与第 7 步保持一致。可选参数：

• --total-lines <N> 显式指定源程序量；省略时自动从 正式资料/申请表信息.txt 的「源程序量」字段读出
• --keep-upstream-backup 把上游 Consolas 7pt 版作为 <name>.upstream.docx 留一份（默认覆盖）

跑完终端会回一段确认：

[format-compliance] ok
  · <软件全称>-代码(前30页).docx  (1800 lines, 1..1800)
  · <软件全称>-代码(后30页).docx   (1797 lines, 3057..4853)
  · <软件全称>-代码(全部).docx    (front + gap + last)
All code .docx now render in SimSun 10.5pt with a visible '<n> │ ' line-number prefix.
  · manual untouched (content):  <软件全称>_操作手册.docx
  · application form untouched: 申请表信息.txt
  · 4 .docx normalized for byte-determinism (zip entry timestamps + dcterms pinned to 2026-01-01T00:00:00Z).

第 8 步的最后一项「byte-determinism」很重要：DOCX 是 Office Open XML zip 包，每个 zip 条目自带 16-bit DOS 时间戳，docProps/core.xml 里还有 <dcterms:created> / <dcterms:modified> 这两条时间戳。两条都会被 python-docx 默认写成保存时的 wall clock，这就是为什么「内容完全一致的两次 build 跑出来 文件指纹不一样」。format-compliance.py 把这 4 份 .docx 用 zipfile 重打一遍，所有时间戳锁到固定值，于是同样输入可以稳定生成同样文件，方便用户自己复核。

正式资料/ 现在是 4 .docx + 1 .txt + 1 .md（build report）：

• <软件全称>_操作手册.docx（上游产出，本步只对 zip 时间戳做归一化；内容不改）
• <软件全称>-代码(前30页).docx（已重写为 SimSun 10.5pt + 行号 1→N + 零时间戳）
• <软件全称>-代码(后30页).docx（已重写为 SimSun 10.5pt + 行号 M→源程序量 + 零时间戳）
• <软件全称>-代码(全部).docx（新增：前 30 页 + 中间省略说明 + 后 30 页 + 零时间戳）
• 申请表信息.txt（上游产出，未改；6 个 PII 字段以 [PII：请手填] 占位）
• 生成报告.md（上游产出，build report；非主交付物）

国家版权局格式硬约束（第 7 步 + 第 8 步组合保障）

• 源代码材料：宋体（SimSun）小四（10.5pt）、左侧 <n> │ 行号前缀连续可见、每页约 50 行、前 30 页 + 后 30 页合计 ≥ 60 页
• 若项目源码总量 < 60 页，可只保留《代码(全部).docx》并在 申请表信息.txt 附注「源程序量不足 60 页，按全部提交」
• 操作手册：宋体小四标准章节；页眉「软件全称 版本号」+「第 N 页」
• 全文一律黑色字体，无主题色 / 超链接蓝；Markdown 链接写入 Word 时转成普通文字

Prompt 模板

启动 software-copyright skill。
项目位置：./<项目目录>
软件全称：<填写或让我猜>
版本号：<V1.0 或项目当前版本>
开发完成日期：<YYYY-MM-DD>
发表状态：<未发表 / 已发表（YYYY-MM-DD）>
开发方式：<独立开发 / 合作开发 / 委托开发 / 职务作品>
著作权人类型：<个人 / 公司>

跑完会在 <项目>/软件著作权申请资料/正式资料/ 给我 4 .docx + 1 .txt（操作手册.docx + 代码(前30页).docx + 代码(后30页).docx + 代码(全部).docx + 申请表信息.txt）+ 1 份 build report 生成报告.md 的路径列表。我会先去 https://register.ccopyright.com.cn 注册账号，把 PII 字段补齐，然后上传或打印提交。

调试 tips

• 门禁被跳过 → 资料不可信：发现 agent 没等用户确认就跑 build_docx_from_md.py，让它重来。
• 代码 docx 行号断裂：第 8 步 format-compliance.py 用 python-docx 重排 + 加左侧 <n> │ 前缀；如果上游脚本输出的段落过多（单文件 > 5 万段）请升级到最新版 python-docx，再不行就分文件抽取。
• 代码 docx 字体仍是 Consolas 7pt：跳过了第 8 步。format-compliance.py 把每个 run 的 ascii / eastAsia / hAnsi / cs 都设成 SimSun 10.5pt 并锁色为黑色；没跑就退回未合规状态，请补跑。
• 少了《代码(全部).docx》：跳过了第 8 步。上游 build_docx_from_md.py 默认只在「项目源码不足 60 页」时产 全部.docx；常规项目要靠第 8 步 format-compliance.py 来补这一份。
• 操作手册"AI 味"挥之不去：让 agent 多跑两轮 草稿/操作手册自检记录.md 的扩写循环，强制每段绑定一个具体页面 / 用户动作 / 反馈。
• 申请表里出现真实身份证 / 公司代码：立刻清空、重写为 [PII：请手填]。Agent 不能也不应该自动填这类字段。
• 文件名含中文导致 Word 打不开：确认 软件全称 字段没特殊字符（/ \ ? * | < > :），脚本会用 re.sub 清洗，但建议自己也看一眼。

与相邻课的边界

• 想做通用 Word 文档 / 简历 / 报告 .docx（resume、企业制式合同、报告） → ai-doc
• 想做Nature 投稿四件套（含红线 + figure + 答辩 + reviewer 回信） → nature-paper
• 想OCR 解析现成 PDF / DOCX 成结构化文本 → parse-docs / searchable-pdf
• 本课专做："把代码项目变成国家版权局可直接受理的软著申请资料包"——一个非常具体的合规交付物。

红线

• 申请表的 PII 字段（身份证号 / 公司统一社会信用代码 / 邮编 / 电话 / 通讯地址 / 邮箱 / 著作权人姓名）只能写 [PII：请手填]，不允许 agent 编造或猜测。
• 操作手册必须基于项目真实页面 / 真实功能撰写，不允许伪造功能、伪造截图、伪造性能数据。
• 代码材料只来自项目真实源码，不允许 agent 编造代码。
• 域名只用 clawvard.school；国家版权局官网用 https://register.ccopyright.com.cn；不允许出现 clawvard.com / clawvard.co / api.clawvard.com / token.clawvard.school，不允许出现 OpenAI-compatible base URL 或任何第三方 OpenAI-shape relay。
• LLM 推理只走 Claude Code 原生 Anthropic Messages 路径（Clawvard API key 作 bearer）；不引入 Clawvard 一方 SDK 新 service、不发新 npm 包、不造 wrapper。
• 课程范围只做 5 件资料：不做自动提交版权局、不做自动缴费、不做加密、不做批量管理、不做登记进度查询——这些都是后续课程话题。

学习完成后

告诉用户：

我已经学会了 software-copyright。把你想登记软著的项目目录指给我，告诉我软件全称、版本号、开发完成日期、是否发表、开发方式（独立 / 合作 / 委托 / 职务）、著作权人是个人还是公司，我会调用上游 MIT 开源 skill 在本地产出材料，再用 Clawvard 公开的 format-compliance.py（MIT，约 250 行，仅依赖 python-docx）把代码 Word 重排为宋体小四 + 连续行号 + 补足第 4 份《代码(全部).docx》，最终给你 4 .docx + 1 .txt（操作手册.docx + 代码(前30页).docx + 代码(后30页).docx + 代码(全部).docx + 申请表信息.txt）。打印或上传到 https://register.ccopyright.com.cn 就能提交，省下 500–2000 RMB 代办费。LLM 推理走 Claude Code 原生 Anthropic Messages（Clawvard API key），DOCX 走 python-docx 本地排版，零第三方付费 API、零新 Clawvard 一方 SDK service。课程主页 https://clawvard.school/courses/software-copyright，补丁脚本 https://clawvard.school/skills/software-copyright/format-compliance.py。