2026-05-19-00-28-03 移除本地配音工具备份

工程分析/实现方案-2026-05-19-00-28-03.md

@@ -0,0 +1,23 @@
+# 实现方案
+
+开始时间：2026-05-19-00-28-03
+
+## Git 跟踪处理
+
+- 保持 `Tools_scripts_XunFei-Ubuntu/` 与 `配音生成工作流-Ubuntu-Agent.md` 的删除状态。
+- 提交删除记录，使 Gitea 最新 `main` 不再包含这些本地配音工具。
+
+## 忽略规则
+
+- `.gitignore` 增加：
+  - `Tools_scripts_XunFei-Ubuntu/`
+  - `配音生成工作流-Ubuntu-Agent.md`
+- `.dockerignore` 增加：
+  - `Tools_scripts_XunFei-Ubuntu`
+  - `配音生成工作流-Ubuntu-Agent.md`
+
+## 校验
+
+- 使用 `git check-ignore` 验证三个路径都被忽略。
+- 使用 `git status --short` 确认待提交内容只包含删除、忽略规则与工程分析文档。
+- 推送到 Gitea 后重新部署并检查健康接口。

工程分析/测试方案-2026-05-19-00-28-03.md

@@ -0,0 +1,34 @@
+# 测试方案
+
+开始时间：2026-05-19-00-28-03
+
+## 忽略校验
+
+- `git check-ignore -v 待配音视频/任意文件`
+- `git check-ignore -v Tools_scripts_XunFei-Ubuntu/任意文件`
+- `git check-ignore -v 配音生成工作流-Ubuntu-Agent.md`
+
+执行结果：
+
+- `待配音视频/` 命中 `.gitignore` 第 13 行规则。
+- `Tools_scripts_XunFei-Ubuntu/` 命中 `.gitignore` 第 14 行规则。
+- `配音生成工作流-Ubuntu-Agent.md` 命中 `.gitignore` 第 15 行规则。
+- `.dockerignore` 也已加入这三个不需要进入构建上下文的路径。
+
+## Git 校验
+
+- `git diff --check`
+- `git status --short`
+- `git ls-files Tools_scripts_XunFei-Ubuntu 配音生成工作流-Ubuntu-Agent.md 待配音视频`
+
+执行结果：
+
+- `git diff --check` 通过。
+- `待配音视频/` 没有被 Git 跟踪。
+- `Tools_scripts_XunFei-Ubuntu/` 与 `配音生成工作流-Ubuntu-Agent.md` 曾在上一轮被纳入 Git，本次保持删除状态并提交删除，让 Gitea 最新 `main` 不再包含它们。
+
+## 部署校验
+
+- `docker compose -f docker_compose_huijutec.yaml up -d --build`
+- `curl -fsS http://127.0.0.1:10004/api/health`
+- `curl -fsS https://isiseg.huijutec.cn/api/health`

工程分析/经验记录.md

@@ -271,3 +271,15 @@ B. 产生问题原因：ffmpeg concat demuxer 要求输入流参数一致，多
 C. 解决问题方案：`build_final_video_ubuntu.py` 在合并音频目录时先把每段音频统一转为 48kHz 双声道 PCM WAV，再拼接并与视频合成，最终输出 H.264/AAC MP4。
 
 D. 后续如何避免问题：多段音频拼接前先标准化采样率、声道和编码；最终成片统一使用 H.264/AAC/yuv420p/faststart。
+
+## 2026-05-19-00-28-03 配音工具不纳入 Gitea 备份
+
+### 1. 临时配音工具误纳入源码备份
+
+A. 具体问题：Ubuntu 版配音工具和工作流文档属于本地辅助材料，用户明确说明它们和 `待配音视频` 一样不需要 Gitea 备份。
+
+B. 产生问题原因：上一轮把“新建工具”理解为需要随仓库保存，未先确认这些本地配音工具是否属于源码交付范围。
+
+C. 解决问题方案：从 Git 跟踪中移除 `Tools_scripts_XunFei-Ubuntu/` 与 `配音生成工作流-Ubuntu-Agent.md`，并将它们加入 `.gitignore` 与 `.dockerignore`；`待配音视频/` 继续保持忽略。
+
+D. 后续如何避免问题：凡是视频、配音、录屏、临时工具和本地工作流材料，默认先按“不进入源码仓库”处理；只有用户明确要求备份时再纳入 Gitea。

工程分析/需求分析-2026-05-19-00-28-03.md

@@ -0,0 +1,25 @@
+# 需求分析
+
+开始时间：2026-05-19-00-28-03
+
+## 用户需求
+
+用户明确说明：刚创建的 Ubuntu 配音工具与工作流文档，以及 `待配音视频`，都不需要备份到 Gitea。
+
+## 需处理对象
+
+- `Tools_scripts_XunFei-Ubuntu/`
+- `配音生成工作流-Ubuntu-Agent.md`
+- `待配音视频/`
+
+## 目标
+
+- 从 Git 跟踪中移除 Ubuntu 配音工具目录和 Ubuntu 工作流文档。
+- 将上述路径加入 `.gitignore`，避免后续误提交。
+- 将上述路径加入 `.dockerignore`，避免 Docker 构建上下文夹带配音工具和视频素材。
+- 保留工程分析文档用于记录本次处理过程。
+
+## 注意
+
+- `待配音视频/` 已在上一轮加入 `.gitignore` 和 `.dockerignore`，本次继续保留。
+- 当前工作区中 Ubuntu 配音工具目录和 Ubuntu 工作流文档已经处于删除状态，本次不恢复文件，直接确认从 Gitea 最新版本移除。