Codeup 仓库生成软著源码材料协作经验

把 Codeup 源码拉取、业务选码、Word 成稿和提交前自查固化为标准流程。

已沉淀为 Codex Skill

适用场景

当软著申请需要从真实代码仓库中筛选源码材料时，用户只需提供项目名、Codeup 仓库地址、分支、软件名称和排除范围，即可按统一流程生成可提交的源码鉴别材料。

项目：400
仓库：https://codeup.aliyun.com/60069db88deaa14d9e02b875/zhct/device/restaurant/billedBygram/ZhctWeightingTableOrange
分支：master
软件名称：膳识智能台营养结算系统V1.0
要求：后端 Java 30 页，前端 XML 30 页，去空行去注释，避开登录、权限、工具类、框架基础代码

标准流程

  1. 权限确认：优先使用 HTTPS + Codeup 个人访问令牌；仓库成员至少具备只读权限。
  2. 仓库拉取：将网页地址转换为 .git 地址，拉取到 zhctprompt/work_android/ 下的项目目录。
  3. 功能映射：根据软件名称、操作手册和用户排除范围，确定核心业务模块。
  4. 源码选码：优先选业务流程、设备控制、数据核验、识别绑定、上传同步、异常处理等相关代码。
  5. 材料生成：统一去空行、去注释，按后端 30 页、前端 30 页、每页 50 行生成 Word。
  6. 提交前自查：记录选用文件、页数、总行数、空行数、疑似注释行数和排除范围。
  7. 渲染验收：用 LibreOffice 渲染 Word，抽看第 1 页、分界页和末页，确认无空白、错页、截断和重叠。

选码原则

优先选择能体现本软件独立功能的核心业务源码，包括业务页面控制、硬件交互、业务接口、数据处理、记录上传和异常提示。避开登录注册、权限分配、通用工具、框架基础、测试代码、构建产物、图片资源和公开模板代码。

权限经验

如果 SSH 或 HTTPS 返回“找不到代码库”或 403，通常不是命令写法问题，而是当前账号没有仓库权限或认证信息未传入。最简单的做法是将当前 Codeup 用户加入仓库成员，并在个人设置中创建“代码读取”个人访问令牌。

令牌只能用于 Password，不能写入文档、代码或提交记录。如果用户误把令牌发到聊天中，完成必要操作后应提醒用户删除并重新生成令牌。

已封装 Skill

本流程已封装为本地 Codex skill：

/Users/hedy/.codex/skills/codeup-ruanzhu-source-material

后续可以直接发送仓库链接和软件名称，也可以明确写：使用 codeup-ruanzhu-source-material，根据这个 Codeup 仓库生成软著源码材料。

协作价值

该流程把临时性取码工作转为可复用机制，减少每次重复确认权限、格式、页数和自查口径的成本；同时通过选码规则和渲染验收降低重复代码、模板化、空行注释残留和格式不合规风险。