/softcopyright

name: softcopyright
description: "智能软件著作权申请材料生成工具。自动分析项目源码，生成符合软著申请要求的软件说明书和源代码文档。支持关键词搜索、智能源码分析、格式化输出和PDF导出。"
license: MIT

SoftCopyright - 智能软件著作权申请材料生成工具

概述

当用户需要申请软件著作权时，此 skill 会自动完成以下流程： 1. 读取用户输入，如果是关键词则先搜索相关内容 2. 分析项目源码结构和内容 3. 生成详细的软件说明书（约2000-3000字） 4. 生成符合要求的源代码文档（60页，每页50行） 5. 导出为PDF格式供软著申请使用

支持的触发指令

用户可以通过以下方式触发此 skill：

• "帮我生成软著申请材料" - 处理当前目录项目
• "生成软件说明书" - 仅生成软件说明书
• "生成源代码文档" - 仅生成源代码文档
• 任何关键词 - 首先搜索相关内容，然后询问是否生成软著材料

工作流程

步骤 1: 理解用户意图

首先判断用户输入的类型：

// 检查用户输入类型
if (用户输入包含 "软著" || "著作权") {
  生成类型 = "全部材料"
} else if (用户输入包含 "软件说明书") {
  生成类型 = "说明书"
} else if (用户输入包含 "源代码" || "源码") {
  生成类型 = "源代码文档"
} else if (用户输入是关键词) {
  先搜索相关内容
  询问用户是否生成软著材料
}

步骤 2: 项目路径确认

// 默认使用当前目录
let projectPath = process.cwd()

// 询问用户确认路径
await confirmProjectPath(projectPath)

步骤 3: 使用CLI生成软著材料

推荐使用CLI工具生成软著材料：

# 方式1: 使用关键词触发index.js（交互式）
cd ~/.claude/skills/softcopyright
node scripts/index.js 软著

# 方式2: 使用cli.js直接生成（推荐）
node scripts/cli.js generate --project <项目路径>

# 方式3: 使用快捷命令（最佳体验）
~/.claude/skills/softcopyright/softcopyright-generate --project . --auto-pdf

# 方式4: 技能系统自动调用
用户输入"帮我生成软著" → 自动执行: softcopyright-generate --project . --auto-pdf

该工具会：

• 自动扫描项目源码
• 识别源代码文件类型
• 分析项目结构和技术栈
• 生成HTML格式的软件说明书和源代码文档
• 询问用户是否自动在浏览器中打开并打印为PDF

步骤 4: 生成选项

用户可以选择：

1. **生成全部材料**（软件说明书 + 源代码文档） 2. **仅生成软件说明书** 3. **仅生成源代码文档** 4. **仅查看项目统计**

步骤 5: 输出位置

**默认输出路径**: `<项目目录>/softcopyright-output/`

生成的文件：

• `软件说明书_<项目名>_<时间戳>.html`
• `源代码文档_<项目名>_<时间戳>.html`

步骤 6: 导出PDF

有两种方式将HTML转换为PDF：

**方式1: 自动转换（推荐）**

# 添加--auto-pdf选项
node scripts/cli.js generate --project <项目路径> --auto-pdf

• 自动在浏览器中打开HTML
• 3秒后自动弹出打印对话框
• 选择"保存为PDF"即可

**方式2: 手动转换** 1. 在浏览器中打开生成的HTML文件 2. 按 Cmd+P (macOS) 或 Ctrl+P (Windows/Linux) 3. 在打印设置中：

• 展开"更多设置"
• 勾选"页眉和页脚"
• 选择"保存为PDF"

4. 保存PDF文件

工具脚本使用说明

scanner.js - 源码扫描工具

扫描项目目录并分析结构：

node ~/.claude/skills/softcopyright/scripts/scanner.js <项目路径>

输出项目分析的JSON文件。

doc-generator.js - 软件说明书生成器

生成详细的软件说明书：

node ~/.claude/skills/softcopyright/scripts/doc-generator.js \
  --type manual \
  --input <项目分析JSON> \
  --template <模板文件> \
  --output <输出PDF路径>

source-exporter.js - 源代码文档生成器

生成符合软著要求的源代码文档：

node ~/.claude/skills/softcopyright/scripts/source-exporter.js \
  --input <源码目录> \
  --output <输出PDF路径> \
  --pages 60 \
  --lines-per-page 50

使用示例

示例 1: 完整软著材料生成

**用户**: "帮我生成软著申请材料"

**Claude 执行流程**:

1. 确认项目路径：当前目录 2. 运行源码扫描工具 3. 分析项目结构和技术栈 4. 生成软件说明书 5. 生成源代码文档 6. 导出PDF文件 7. 向用户展示生成结果

示例 2: 关键词搜索后生成

**用户**: "React电商系统"

**Claude 执行流程**:

1. 搜索"React电商系统"相关信息 2. 展示搜索结果 3. 询问："是否需要为React电商系统生成软著申请材料？" 4. 用户确认后执行完整生成流程

示例 3: 仅生成软件说明书

**用户**: "帮我生成软件说明书"

**Claude 执行流程**:

1. 扫描项目源码 2. 分析项目功能 3. 生成软件说明书 4. 导出PDF文件

输出文件规范

软件说明书PDF

• 文件名：`软件说明书_项目名称_YYYYMMDD.pdf`
• 字数要求：2000-3000字
• 包含所有必需章节
• 专业排版和格式

源代码文档PDF

• 文件名：`源代码文档_项目名称_YYYYMMDD.pdf`
• 页数要求：60页（或处理全部代码）
• 每页行数：不少于50行
• 无注释和无版权信息
• 代码连续性保证

软件著作权申请要求

源代码文档要求

1. **页数要求**：通常需要20-60页 2. **格式要求**：每页不超过50行代码 3. **注释要求**：需要移除所有注释，只保留纯代码 4. **页眉页脚**：需要包含软件名称和版本号 5. **代码连续性**：需要保证代码的连续性和完整性

软件说明书要求

1. **内容详实**：约2000-3000字 2. **结构完整**：包含所有必需章节 3. **重点突出**：突出软件的独创性 4. **专业描述**：使用专业的技术描述

技术栈

• **Node.js**: 主要运行环境
• **PDFKit**: PDF文档生成
• **glob**: 文件模式匹配
• **commander**: CLI参数解析
• **chalk**: 终端颜色输出
• **inquirer**: 交互式命令行界面

依赖安装

使用 nvm 管理 Node.js 版本：

# 确保使用合适的 Node 版本
nvm use 18

# 安装依赖
cd ~/.claude/skills/softcopyright
npm install

最佳实践

1. **项目分析准确**: 确保正确识别项目类型和技术栈 2. **内容详实专业**: 生成专业的技术描述和功能说明 3. **格式规范合规**: 严格按照软著申请要求格式化 4. **用户交互友好**: 提供清晰的进度提示和确认流程 5. **文档完整性**: 确保生成材料的完整性和准确性

安全注意事项

1. **源码安全**: 不修改原始源码，只读取和分析 2. **隐私保护**: 不上传源码到外部服务 3. **本地处理**: 所有处理都在本地完成 4. **用户确认**: 重要操作前需要用户确认

故障排除

扫描失败

# 检查项目路径
ls -la <项目路径>

# 检查权限
chmod -R 755 <项目路径>

PDF生成失败

# 检查依赖安装
cd ~/.claude/skills/softcopyright
npm list

# 重新安装依赖
npm install

内存不足

对于大型项目，可以： 1. 排除不必要的目录（node_modules, .git等） 2. 分批处理源码文件 3. 增加Node.js内存限制

开发和扩展

要添加新的文件类型支持，编辑 `scripts/scanner.js`：

const SUPPORTED_EXTENSIONS = {
  '.rs': {
    'single_line': '//',
    'multi_line': ['/*', '*/'],
    'language': 'rust'
  },
  '.go': {
    'single_line': '//',
    'multi_line': ['/*', '*/'],
    'language': 'go'
  }
}

---

**版本**: 1.0.0 **作者**: peterfei **许可**: MIT