2026-05-25-12-48-00 更新代码汇总格式且docx不入库

2026-05-25 12:34:56 +08:00
parent a08bf908c9
commit 27e0ec626e
11 changed files with 487 additions and 0 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -14,6 +14,9 @@ Docker部署/**/exports/
 Docker部署/**/locked-results/
 项目数据/锁定结果/

+# Local deliverables not pushed to Gitea
+3. 代码汇总.docx
+
 # Local env
 .env
 .env.*
--- a/工程分析/实现方案-2026-05-25-12-30-27.md
+++ b/工程分析/实现方案-2026-05-25-12-30-27.md
@@ -0,0 +1,59 @@
+# 实现方案-2026-05-25-12-30-27
+
+## 实现方案文档路径
+
+`工程分析/实现方案-2026-05-25-12-30-27.md`
+
+## 修改目标
+
+将 `3. 代码汇总.docx` 整理为约 10000 行真实、连续、无省略占位的项目源码汇总文档，避免出现以 `...` 表示删减的软著材料风险。
+
+## 涉及路径
+
+- `3. 代码汇总.docx`
+- `WebSite/server.ts`
+- `WebSite/src/components/ReverseWorkspace.tsx`
+- `WebSite/src/components/ProjectLibrary.tsx`
+- `工程分析/需求分析-2026-05-25-12-30-27.md`
+- `工程分析/实现方案-2026-05-25-12-30-27.md`
+- `工程分析/测试方案-2026-05-25-12-30-27.md`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+1. 读取既有工程分析、整体分析和经验记录，确认项目约束。
+2. 统计可选源码文件行数，优先选择完整文件而非局部摘录。
+3. 使用 `python-docx` 读取并重写 docx 正文，保留为 `.docx` 格式。
+4. 正文中写入标题、整理说明、文件清单和完整源码内容；每个源码文件从第一行到最后一行连续写入。
+5. 对生成后的 docx 做结构可读性检查、行数检查和省略占位检查。
+6. 执行构建、重新启动 `tmux` 服务并验证 `/api/health` 和首页。
+7. 追加经验记录，并对本次相关文档和 docx 做 Git 备份 commit。
+
+## 执行步骤
+
+1. 确认 `工程分析/经验记录.md` 在执行修改前已再次阅读。
+2. 选定完整源码文件组合，控制总行数约 10000 行。
+3. 生成 docx：使用等宽字体、小字号、紧凑段落，每行保留行号和原始源码文本。
+4. 检查 docx 中是否存在以独立 `...` 表示的省略占位；若源码语法中存在合法 `...`，评估是否需要改选文件或在材料说明中避免误判。
+5. 运行 `npm run build`。
+6. 使用 `tmux` 会话 `revoxelseg-dicom` 运行 `npm run serve -- --host 0.0.0.0 --port 4000`。
+7. 使用 `curl` 验证本地 API 与页面。
+8. 追加经验记录并提交备份 commit。
+
+## 兼容性与回滚方案
+
+- 若 docx 生成异常，可从 Git 工作区或修改前备份文件恢复。
+- 若选定文件中合法 `...` 过多导致材料观感不佳，可改为选择不含该字符或更少使用扩展运算符的完整源码文件组合。
+- 本次不修改项目运行源码；构建和部署异常按既有服务回滚方式恢复上一版服务。
+
+## 预计文件变更
+
+- 更新：`3. 代码汇总.docx`
+- 更新：`工程分析/经验记录.md`
+- 新增：本次需求分析、实现方案、测试方案三件套
+
+## 提交与部署策略
+
+- Git commit message 包含 `2026-05-25-12-30-27` 和“整理软著代码汇总文档”。
+- 只暂存本次相关文件，避免提交无关未跟踪或运行态文件。
+- 构建成功后重启本地 4000 服务，并验证健康检查和首页响应。
--- a/工程分析/实现方案-2026-05-25-12-45-33.md
+++ b/工程分析/实现方案-2026-05-25-12-45-33.md
@@ -0,0 +1,55 @@
+# 实现方案-2026-05-25-12-45-33
+
+## 实现方案文档路径
+
+`工程分析/实现方案-2026-05-25-12-45-33.md`
+
+## 修改目标
+
+从未推送的本地 commit 中移除 `3. 代码汇总.docx`，保留本地文件，并阻止后续误提交该 docx。
+
+## 涉及路径
+
+- `3. 代码汇总.docx`
+- `.gitignore`
+- `工程分析/需求分析-2026-05-25-12-45-33.md`
+- `工程分析/实现方案-2026-05-25-12-45-33.md`
+- `工程分析/测试方案-2026-05-25-12-45-33.md`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+1. 确认上一次 commit 尚未推送，当前分支仅本地领先远程。
+2. 使用 `git rm --cached` 从索引中移除 `3. 代码汇总.docx`，不删除工作区文件。
+3. 在 `.gitignore` 中加入 `3. 代码汇总.docx`，降低后续误提交风险。
+4. 使用 `git commit --amend` 修正未推送的上一个本地 commit，使其不包含 docx。
+5. 本次不执行 `git push`。
+6. 验证 `git status` 中 docx 不再显示为待提交文件，且 `git ls-files` 不包含 docx。
+
+## 执行步骤
+
+1. 执行前再次阅读 `工程分析/经验记录.md`。
+2. 检查 `git status --short --branch` 和 `git log -1`。
+3. 取消跟踪 `3. 代码汇总.docx`，保留本地文件。
+4. 更新 `.gitignore`。
+5. 追加经验记录。
+6. 暂存 `.gitignore`、工程分析文档和经验记录，修正上一个本地 commit。
+7. 不推送远程。
+
+## 兼容性与回滚方案
+
+- 若需要恢复 docx 入库，可删除 `.gitignore` 对应规则后手动 `git add`。
+- 若 amend 后发现提交范围异常，可通过 `git reflog` 找回 amend 前的 commit。
+- 本次不修改业务源码，部署服务无需因本次 Git 治理变化重启。
+
+## 预计文件变更
+
+- 新增：本次需求分析、实现方案、测试方案。
+- 更新：`.gitignore`、`工程分析/经验记录.md`。
+- Git 历史：上一个未推送 commit 被 amend，不再包含 `3. 代码汇总.docx`。
+
+## 提交与部署策略
+
+- 本次遵循用户指令，不推送 Gitea。
+- 备份 commit 仅保留工程分析文档和忽略规则，不包含 `3. 代码汇总.docx`。
+- 因不修改运行代码，本次仅做状态验证；如服务仍在运行，可验证 4000 服务健康。
--- a/工程分析/实现方案-2026-05-25-12-48-00.md
+++ b/工程分析/实现方案-2026-05-25-12-48-00.md
@@ -0,0 +1,53 @@
+# 实现方案-2026-05-25-12-48-00
+
+## 实现方案文档路径
+
+`工程分析/实现方案-2026-05-25-12-48-00.md`
+
+## 修改目标
+
+重写本地 `3. 代码汇总.docx`，移除源码行号前缀和 `文件：XXX` 标题，仅保留连续源码文本。
+
+## 涉及路径
+
+- `3. 代码汇总.docx`
+- `WebSite/server.ts`
+- `WebSite/src/components/ReverseWorkspace.tsx`
+- `WebSite/src/components/ProjectLibrary.tsx`
+- `工程分析/需求分析-2026-05-25-12-48-00.md`
+- `工程分析/实现方案-2026-05-25-12-48-00.md`
+- `工程分析/测试方案-2026-05-25-12-48-00.md`
+- `工程分析/经验记录.md`
+
+## 技术路线
+
+1. 再次确认执行前已阅读 `工程分析/经验记录.md`。
+2. 使用 `python-docx` 重新生成 `3. 代码汇总.docx`。
+3. 读取三个完整源码文件，按原始行内容写入 docx，不添加行号。
+4. 文件之间只添加空行，不写 `文件：XXX` 标题。
+5. 校验 docx 可读取、无 `文件：` 文案、无行号前缀、源码行数仍为 10835。
+
+## 执行步骤
+
+1. 写入本次三件套。
+2. 重新生成 docx。
+3. 使用 `python-docx` 读取段落文本并检查。
+4. 使用 `unzip -t` 检查 docx 包结构。
+5. 追加经验记录。
+6. 只提交工程分析文档和经验记录，不提交、不推送 `3. 代码汇总.docx`。
+
+## 兼容性与回滚方案
+
+- 如新格式不符合要求，可用同一脚本重新生成带标题或带其他格式的版本。
+- `3. 代码汇总.docx` 未入库，Git 回滚不影响本地交付文件；必要时可从源码重新生成。
+
+## 预计文件变更
+
+- 本地修改：`3. 代码汇总.docx`。
+- Git 文档变更：新增本次三件套，更新 `工程分析/经验记录.md`。
+
+## 提交与部署策略
+
+- 本次不提交、不推送 `3. 代码汇总.docx`。
+- 可将本次工程分析文档 amend 到尚未推送的本地备份 commit。
+- 不修改业务源码，不需要重新构建；用健康检查确认现有服务即可。
--- a/工程分析/测试方案-2026-05-25-12-30-27.md
+++ b/工程分析/测试方案-2026-05-25-12-30-27.md
@@ -0,0 +1,47 @@
+# 测试方案-2026-05-25-12-30-27
+
+## 测试方案文档路径
+
+`工程分析/测试方案-2026-05-25-12-30-27.md`
+
+## 静态检查
+
+- 检查 `3. 代码汇总.docx` 可被 `python-docx` 打开。
+- 统计写入源码行数，确认约 10000 行。
+- 检查文档中不存在独立 `...` 段落或明显的省略占位。
+- 检查每个收录文件从第 1 行到末行连续写入，不存在人为跳行。
+
+## 构建检查
+
+- 在 `WebSite/` 执行 `npm run build`。
+- 本次不修改源码，构建用于确认当前项目仍可正常打包。
+
+## 关键业务场景验证
+
+- 验证更新后的 docx 包含标题、整理说明、文件清单和完整源码正文。
+- 验证收录源码来自项目真实文件，且文件边界明确。
+- 验证未将 `node_modules`、`dist`、医学影像数据或运行态导出内容写入 docx。
+
+## 医学影像数据相关边界验证
+
+- 本次不读取、不修改、不提交 `Head_CT_DICOM/`、`Head_CT_ReConstruct/` 原始医学数据。
+- 本次不修改 DICOM/STL 解析、融合、导出算法，仅验证部署服务仍可启动。
+
+## 部署验证
+
+- 构建完成后沿用或重建 `tmux` 会话 `revoxelseg-dicom`。
+- 启动命令：`npm run serve -- --host 0.0.0.0 --port 4000`。
+- 验证 `http://127.0.0.1:4000/api/health` 返回成功。
+- 验证 `http://127.0.0.1:4000/` 返回页面 HTML。
+
+## Git/Gitea 备份验证
+
+- 使用 `git status --short` 确认暂存范围只包含本次相关文件。
+- 提交消息包含 `2026-05-25-12-30-27` 和简要描述。
+- 提交后记录 commit 哈希。
+
+## 风险与回归关注点
+
+- docx 修改为二进制变化，需重点确认文档可打开和源码行数正确。
+- 若服务端口 4000 已被占用，需要确认占用来源，优先使用既有 `tmux` 会话重启。
+- 当前 `3. 代码汇总.docx` 原本未被 Git 跟踪，提交时需明确纳入备份。
--- a/工程分析/测试方案-2026-05-25-12-45-33.md
+++ b/工程分析/测试方案-2026-05-25-12-45-33.md
@@ -0,0 +1,43 @@
+# 测试方案-2026-05-25-12-45-33
+
+## 测试方案文档路径
+
+`工程分析/测试方案-2026-05-25-12-45-33.md`
+
+## 静态检查
+
+- `git ls-files -- '3. 代码汇总.docx'` 应无输出。
+- `git status --short --ignored` 应显示 `3. 代码汇总.docx` 为忽略文件或至少不在待提交列表中。
+- `git show --name-only HEAD` 不应包含 `3. 代码汇总.docx`。
+
+## 构建检查
+
+- 本次不修改业务源码，可不重复完整构建。
+- 若需要确认服务状态，使用健康检查验证当前部署仍可访问。
+
+## 关键业务场景验证
+
+- 本地 `3. 代码汇总.docx` 文件仍存在。
+- Git 备份 commit 中不包含该 docx。
+- 不执行 `git push`，避免远程收到 docx。
+
+## 医学影像数据相关边界验证
+
+- 本次不触碰 DICOM/STL 医学数据目录。
+- 不提交运行态导出和数据文件。
+
+## 部署验证
+
+- 本次不修改服务代码，不需要重新部署。
+- 验证现有 `http://127.0.0.1:4000/api/health` 仍返回成功即可。
+
+## Git/Gitea 备份验证
+
+- 本地 commit message 包含 `2026-05-25-12-45-33` 或在修正后的提交历史中保留对应说明。
+- 不推送 Gitea。
+- 分支仍可能领先远程，但领先 commit 不包含 `3. 代码汇总.docx`。
+
+## 风险与回归关注点
+
+- amend 会改变未推送 commit 哈希；由于前一 commit 未推送，此风险可控。
+- 必须确认 docx 没有被删除，只是未被 Git 跟踪。
--- a/工程分析/测试方案-2026-05-25-12-48-00.md
+++ b/工程分析/测试方案-2026-05-25-12-48-00.md
@@ -0,0 +1,42 @@
+# 测试方案-2026-05-25-12-48-00
+
+## 测试方案文档路径
+
+`工程分析/测试方案-2026-05-25-12-48-00.md`
+
+## 静态检查
+
+- `python-docx` 能打开 `3. 代码汇总.docx`。
+- 文档中不包含以 `文件：` 开头的段落。
+- 文档源码正文不包含形如 `   1  ` 的行号前缀。
+- 源码正文行数为 10835 行。
+- 独立省略占位 `...` 数量为 0。
+
+## 构建检查
+
+- 本次不修改业务源码，可不重复执行 `npm run build`。
+
+## 关键业务场景验证
+
+- 打开 docx 后看到的是源码本身，不显示文件标题和行号编号。
+- 代码仍来自完整连续源码文件，不是人工摘录。
+
+## 医学影像数据相关边界验证
+
+- 不读取、不修改、不提交 DICOM/STL 医学数据。
+
+## 部署验证
+
+- 本次不修改服务代码，不重新部署。
+- 验证当前 `http://127.0.0.1:4000/api/health` 仍为 200。
+
+## Git/Gitea 备份验证
+
+- `3. 代码汇总.docx` 保持被 `.gitignore` 忽略。
+- `git show --name-only HEAD` 不包含 `3. 代码汇总.docx`。
+- 不执行 `git push`。
+
+## 风险与回归关注点
+
+- 去掉文件标题后不要误删源码首行。
+- 去掉行号后要保持空行、缩进和源码文本本身。
--- a/工程分析/经验记录.md
+++ b/工程分析/经验记录.md
@@ -1905,3 +1905,57 @@ C. 解决问题方案
 D. 后续如何避免问题

 部署验证不能只看 API 健康检查，还要同时验证首页 HTML，因为 Vite host 检查、静态资源路径和反代规则可能只影响页面入口。只要继续用 Vite middleware 方式提供公网访问，就要把公网域名写入 `allowedHosts`；如果后续改为 `NODE_ENV=production` 纯静态部署，也需要单独验证静态资源和 API 是否都通过同一反代链路。
+
+## 2026-05-25-12-30-27 软著代码汇总应选完整连续源码文件
+
+A. 具体问题
+
+用户要求整理 `3. 代码汇总.docx`，原文档不能继续保留用三点字符表示删减的代码摘录；软著材料需要无省略、连续、逻辑完整的源程序内容，约 10000 行即可，不需要放入项目全部代码。
+
+B. 产生问题原因
+
+软著源程序材料关注的是完整连续的代码页。若为了节省篇幅在函数体、类定义或模块中间放置省略占位，即使整体看起来像代码汇总，也会被判断为摘录而不是完整源程序。项目中的 TypeScript/JavaScript 真实源码也可能包含扩展运算符等合法三点语法，需要和删减占位区分检查。
+
+C. 解决问题方案
+
+本次直接重写 `3. 代码汇总.docx`，选择 `WebSite/server.ts`、`WebSite/src/components/ReverseWorkspace.tsx`、`WebSite/src/components/ProjectLibrary.tsx` 三个完整源码文件，合计 10835 行，从每个文件第 1 行连续写入到末行。生成后用 `python-docx` 重新打开文档，逐行比对三个文件内容，确认连续匹配；同时检查独立省略占位数量为 0，并用 `unzip -t` 确认 docx 包结构正常。
+
+D. 后续如何避免问题
+
+后续整理软著代码材料时，优先选择若干完整源码文件或连续页码区间，不要在函数体、类型定义、类定义和模块内部人工删减。校验时既要统计收录行数和文件连续性，也要专门检查独立省略占位；若源码语言自身有合法三点语法，应在材料说明或审核沟通中明确其不是省略占位。
+
+## 2026-05-25-12-45-33 本地交付 docx 不应进入 Gitea 备份提交
+
+A. 具体问题
+
+用户明确要求不要将 `3. 代码汇总.docx` 做 Gitea commit，也不要推送该文件。此前本地 commit 尚未推送成功，但已经把 docx 纳入了本地待推送历史。
+
+B. 产生问题原因
+
+工作流默认要求对本次文档做 Git/Gitea 备份提交，而 `3. 代码汇总.docx` 是给用户本地交付的软著材料，不一定适合进入代码仓库。若只是不再推送而不修正未推送 commit，后续认证恢复后执行 `git push` 仍可能把该 docx 传到远程。
+
+C. 解决问题方案
+
+在远程推送失败且 commit 尚未进入 Gitea 的前提下，使用取消索引跟踪和 amend 的方式修正最后一个本地 commit：保留工作区里的 `3. 代码汇总.docx`，但从 Git 历史中移除。同步在 `.gitignore` 加入该文件名，避免后续 `git add .` 再次误提交。
+
+D. 后续如何避免问题
+
+后续交付软著、合同、截图、压缩包等本地材料前，应先确认是否允许入库；如果用户要求不要提交或推送，应加入 `.gitignore` 或只保留在工作区。对已经生成但未推送的误提交，应优先修正未推送 commit，避免把敏感或本地交付材料带到 Gitea。
+
+## 2026-05-25-12-48-00 代码汇总格式应避免额外行号和文件标题
+
+A. 具体问题
+
+用户要求 `3. 代码汇总.docx` 不需要每行最前方的行号编号，也不需要 `文件：XXX` 形式的文件标题。
+
+B. 产生问题原因
+
+上一版为了便于人工核对源码连续性，在 docx 中给每行增加了行号，并给每个完整源码文件增加了文件标题。该格式虽然便于审阅，但不符合用户希望直接呈现纯源码内容的材料样式。
+
+C. 解决问题方案
+
+重新生成本地 `3. 代码汇总.docx`，保留此前三个完整源码文件的连续内容，但写入段落时不再添加行号前缀，也不再插入 `文件：XXX` 标题。文件之间仅保留空行分隔。生成后用 `python-docx` 校验正文与源码逐行一致，`文件：` 文案数量为 0，行号前缀匹配数量为 0。
+
+D. 后续如何避免问题
+
+整理软著代码汇总时，先确认用户要的是“带核对信息的审阅版”还是“纯源码版”。若目标是提交材料，默认减少额外说明、文件标题和行号，只保留源码文本；用于内部核对的行号应放在临时检查结果里，不直接写入最终 docx。
--- a/工程分析/需求分析-2026-05-25-12-30-27.md
+++ b/工程分析/需求分析-2026-05-25-12-30-27.md
@@ -0,0 +1,47 @@
+# 需求分析-2026-05-25-12-30-27
+
+## 开始时间
+
+2026-05-25-12-30-27
+
+## 原始需求摘要
+
+用户要求修改 `3. 代码汇总.docx`：不需要收录所有代码，选取约 10000 行左右即可；文档中的代码不能出现大量 `...` 省略占位，必须整理为无省略、连续、逻辑完整的源程序内容，函数体和类定义不能被 `...` 截断。
+
+## 业务目标
+
+生成符合软著源程序材料要求的代码汇总文档，使用项目真实源码的完整连续内容替换原有删减摘录，降低因省略号占位导致材料不合规的风险。
+
+## 输入与输出
+
+- 输入：现有 `3. 代码汇总.docx`、项目源码、既有工程分析文档。
+- 输出：更新后的 `3. 代码汇总.docx`，本次需求分析、实现方案、测试方案，以及追加后的经验记录和备份 commit。
+
+## 影响范围
+
+- 主要影响 `3. 代码汇总.docx` 文档内容。
+- 新增 `工程分析/需求分析-2026-05-25-12-30-27.md`、`工程分析/实现方案-2026-05-25-12-30-27.md`、`工程分析/测试方案-2026-05-25-12-30-27.md`。
+- 完成后追加 `工程分析/经验记录.md`。
+- 不修改 WebSite 业务源码。
+
+## 关键约束
+
+- 必须先遵守 `工程分析/代码编纂工作流.md`。
+- 本次时间戳统一使用 `2026-05-25-12-30-27`。
+- 选取约 10000 行真实源码，且不使用 `...` 作为省略占位。
+- 尽量选完整文件，保证函数体、类型定义和模块逻辑连续完整。
+- Git 提交只包含本次相关文档和明确修改文件，避免混入医学数据、运行态导出或无关改动。
+- 修改完成后需执行构建、重新部署并验证服务。
+
+## 风险点
+
+- docx 是二进制文档，修改后需要确认能被 Word/LibreOffice 正常解析。
+- TypeScript/React 源码本身可能存在合法的扩展运算符 `...`，需要区分“省略占位”和真实代码语法；若最终材料希望完全不出现三个点字符，应优先选取或转换不含该字符的代码来源。
+- 文档行数过多会增大 docx 体积，但约 10000 行仍在可接受范围。
+- 当前 `3. 代码汇总.docx` 在 Git 状态中为未跟踪文件，备份 commit 时需明确纳入。
+
+## 待确认问题或默认假设
+
+- 默认保留原文件名 `3. 代码汇总.docx`，直接覆盖其正文内容。
+- 默认将“约 10000 行”理解为可在 9000 至 11000 行附近浮动，优先保证完整文件和无省略占位。
+- 默认不额外改动项目功能源码。
--- a/工程分析/需求分析-2026-05-25-12-45-33.md
+++ b/工程分析/需求分析-2026-05-25-12-45-33.md
@@ -0,0 +1,42 @@
+# 需求分析-2026-05-25-12-45-33
+
+## 开始时间
+
+2026-05-25-12-45-33
+
+## 原始需求摘要
+
+用户明确要求不要将 `3. 代码汇总.docx` 做 Gitea commit，也不要推送该文件。
+
+## 业务目标
+
+保证已生成的 `3. 代码汇总.docx` 保留在本地工作区供用户使用，但不再包含在本地备份 commit 中，也不会被推送到 Gitea 远程仓库。
+
+## 输入与输出
+
+- 输入：用户最新指令、当前 Git 历史和工作区状态。
+- 输出：移除上一次本地 commit 中的 `3. 代码汇总.docx`；必要时加入忽略规则防止误提交；保留本地 docx 文件。
+
+## 影响范围
+
+- Git 历史：上一次尚未推送的本地 commit 需要修正。
+- 工作区：`3. 代码汇总.docx` 应保留为本地文件，不进入暂存区。
+- 工程分析：新增本次三件套并追加经验记录。
+
+## 关键约束
+
+- 用户明确要求不提交、不推送 `3. 代码汇总.docx`。
+- 远程推送此前已失败，当前只需确保后续不把该 docx 推送出去。
+- 不删除用户需要的本地 docx 文件。
+- 不混入医学数据、运行态文件或无关改动。
+
+## 风险点
+
+- 如果只在新提交中删除 docx，远程将来仍可能收到历史提交中的 docx；因此需要修正未推送的上一个本地 commit。
+- 若不加入忽略规则，后续 `git add .` 可能再次误加该 docx。
+- 修改 Git 历史只应作用于当前未推送且由本轮生成的最后一个 commit。
+
+## 待确认问题或默认假设
+
+- 默认用户说的“不要 Gitea commit 和推送”包含不要把该 docx 保存在本地待推送 commit 历史中。
+- 默认允许修正尚未推送的最后一个本地 commit，以彻底移除该 docx。
--- a/工程分析/需求分析-2026-05-25-12-48-00.md
+++ b/工程分析/需求分析-2026-05-25-12-48-00.md
@@ -0,0 +1,42 @@
+# 需求分析-2026-05-25-12-48-00
+
+## 开始时间
+
+2026-05-25-12-48-00
+
+## 原始需求摘要
+
+用户要求修改本地 `3. 代码汇总.docx`，去掉代码行最前方的行号编号，例如 `   1  `，并去掉 `文件：XXX` 这类文件标题。
+
+## 业务目标
+
+让软著代码汇总文档正文更接近纯源码展示，不出现额外行号前缀和文件路径标题，同时继续保持代码内容真实、连续、无省略占位。
+
+## 输入与输出
+
+- 输入：当前本地 `3. 代码汇总.docx`、项目源码文件。
+- 输出：更新后的本地 `3. 代码汇总.docx`，其中源码行不带行号，不包含 `文件：XXX` 标题。
+
+## 影响范围
+
+- 仅修改本地忽略文件 `3. 代码汇总.docx`。
+- 新增本次工程分析三件套，追加 `工程分析/经验记录.md`。
+- 不修改业务源码。
+
+## 关键约束
+
+- `3. 代码汇总.docx` 已按用户要求加入 `.gitignore`，本次仍不得提交或推送该 docx。
+- 继续使用完整连续源码内容，不使用 `...` 作为省略占位。
+- 保持约 10000 行左右源码内容。
+- 不触碰医学数据和运行态导出。
+
+## 风险点
+
+- 去掉文件标题后，多个源码文件之间缺少文字边界；默认用空行分隔，避免出现 `文件：XXX`。
+- 去掉行号后需要重新校验文档内容与源码逐行一致。
+- docx 是二进制本地交付文件，应确认生成后可正常打开。
+
+## 待确认问题或默认假设
+
+- 默认允许保留文档标题 `代码汇总`，但不保留 `文件：XXX` 或源码行号。
+- 默认继续使用此前选定的三个完整源码文件。