Fokkyp / SoftwareCopyright-Skill

# Software Copyright Materials Skill
这是一个用于生成中文软件著作权申请资料的通用 Skill 仓库，适用于支持本地 Skill 目录机制的 coding agent 软件。
项目地址：https://github.com/Fokkyp/SoftwareCopyright-Skill
真正的 Skill 位于：
 [code] 
安装时不要把仓库根目录当作普通单个 skill 复制。只需将 `software-copyright-materials/` 这个实际 skill 目录放置到你的 coding agent 软件要求的 skill 目录下，即可加载使用。
## 功能概览
> **本项目完全免费。请不要相信任何使用本项目包装出来的付费服务。**
软件著作权申请本身不神秘，真正麻烦的是整理材料：申请表字段要写对，操作手册要像样，代码材料要按规则截取，软件名称、版本号、页数还要保持一致。很多开发者最后会把这件事交给付费代办或资料整理服务，花钱买的往往也只是这些文档整理工作。
这个 skill 的目标很直接：让开发者不用再为整理软著材料额外付费，也不用把项目代码和产品细节交给外部商家来回沟通。把真实项目交给支持该 skill 的代码助手，它会按流程引导你确认关键信息，并在本地生成一整套可检查、可修改、可提交前再导出的软著申请资料。
- **自己生成整套资料**：从项目分析、业务理解、申请表信息、操作手册到代码材料，一套流程跑完，不再依赖外部代办整理文档。
- **从真实源码抽取代码**：代码材料只来自开发者已有项目，禁止 AI 编造源码，适合对材料真实性敏感的开发者。
- **自动处理前 30 页 / 后 30 页规则**：源码足够时按常见鉴别材料要求生成前 30 页和后 30 页；不足 60 页时按规则生成全部代码材料。
- **操作手册不套模板**：先理解项目业务、页面和功能，再写面向审核员的操作说明，避免只有空泛功能列表。
- **申请表字段集中整理**：软件名称、版本号、著作权人、开发环境、运行环境、源程序量、功能说明等字段统一生成到 `申请表信息.txt`，官网填报时可以对照复制。
- **关键节点都让你确认**：业务口径、申请表字段、代码选择、截图方式、最终 Markdown 草稿都会停下来让开发者确认，减少材料写偏的风险。
- **Word/TXT 一键输出**：确认后生成操作手册 DOCX、代码材料 DOCX 和申请表 TXT，文件统一放在 `软件著作权申请资料/正式资料/`。
- **本地生成，资料可控**：默认在当前项目目录生成材料，代码、文档和草稿都留在本地，方便开发者自行审阅、修改和归档。
- **提供完整 demo**：仓库内提供 `生成demo/软件著作权申请资料/`，可以直接点击查看生成后的草稿、正式资料和填报辅助文件。
## 演示截图
| 生成流程 | 生成流程 |
|---------|---------|
| | |
| | |
| | |
## 目录结构
 [code] 
## 下载并安装
先获取本仓库。会用 Git 的用户执行：
 [code] 
不会用 Git 的用户可以在 GitHub 页面点击 `Code` -> `Download ZIP`，解压后进入仓库目录。目录中应能看到实际 skill 目录：
 [code] 
按照你的 coding agent 软件文档，找到它要求的 skill 目录，然后复制实际 skill 目录即可：
 [code] 
如果你的 coding agent 支持项目级 skill，也可以把 `software-copyright-materials/` 放到该项目要求的本地 skill 目录中：
 [code] 
复制完成后，按你的 coding agent 软件要求重启会话、刷新 skill 列表或重新加载配置。
## 运行要求和环境校验
### 必需环境
- **支持 Skill 的 coding agent 软件**：能够从本地 skill 目录加载 `software-copyright-materials/`。
- **Python 3.10+**：用于项目分析、草稿生成、代码抽取、门禁和 OfficeCLI 命令编排。可以使用 coding agent 自带的 Python 运行时，无需另外安装 `python-docx`。
- **全局安装的 OfficeCLI 1.0.151**：正式 Word 统一由 OfficeCLI 生成、校验和预览。仓库不复制 OfficeCLI 二进制，也不再使用 LibreOffice、Pandoc、内置 DOCX skill、.NET 工具包或项目内便携版兜底。
- 生成完成后会继续通过 OfficeCLI 统一 DOCX 主题字体为宋体和 Times New Roman，并重新读取主题校验，避免 WPS 因默认的等线、Calibri、Calibri Light 提示缺失字体。
- **可读取的项目源码**：代码材料必须从真实项目中抽取，所以需要在代码助手中打开或指定你的项目目录。
Windows PowerShell 使用 OfficeCLI 官方全局安装命令：
 [code] 
macOS / Linux 使用官方安装命令：
 [code] 
安装脚本会把 OfficeCLI 放入全局命令目录并更新 PATH。安装后重新启动 coding agent，让新进程读取更新后的 PATH，然后确认固定版本：
 [code] 
当前 skill 固定验证 OfficeCLI v1.0.151。运行时只使用 PATH 中的全局 `officecli`，不使用 `OFFICECLI_PATH`、`--officecli` 或项目内 `工具/officecli.exe`。生成脚本会禁用 OfficeCLI 自动更新，以避免同一份材料因工具版本漂移产生不同结果。
### 可选能力
- **Microsoft Word（Windows）**：代码段落连续写入 DOCX，由 Word 像普通文档一样根据页面空间自动换页；OfficeCLI 可调用 Word 取得最终真实页数。没有 Word 时仍可生成、做 OpenXML 校验和 OfficeCLI HTML 预览，但提交前必须在 Word 或 WPS 中人工复核分页。本项目统一使用 OfficeCLI。
- **Node.js 18+、npm 和 `@playwright/cli@0.1.20`**：仅在选择 Playwright CLI 自动截图时需要。用户确认后可执行 `npm install -g @playwright/cli@0.1.20`；不会写入被分析项目的 `package.json`。
- **Chrome**：Playwright CLI 自动截图优先使用本机已安装的 Chrome。只有 Chrome 不可用且用户同意时，才安装额外浏览器运行时。
- **用户自行截图**：不使用自动截图时，可以把 PNG/JPG/JPEG/WebP 图片放到 `软件著作权申请资料/用户截图/