听写助手对话记录 31 — ref 清理与归档排除范围优化¶
编号：DLG-31 日期：2026-08-05 智能体：听写（DT） 主题：清理归档中的 ref 目录，优化归档排除范围策略 关联文档：ARC、PJM §4.4、DLG-30
一、用户需求¶
用户在清理归档递归目录后，进一步要求：
1. 清理归档中的 ref/ 目录（外部参考资料不应纳入归档）
2. 归档策略中把 ref/ 作为无需归档的排除部分
二、工作过程¶
2.1 现状检查¶
| 检查项 | 结果 |
|---|---|
| V1.0 批次 | 已在 DLG-30 中删除（用户确认"取消键"未影响删除结果） |
| V1.1 批次中的 ref/ | 存在，21 个文件，约 60MB |
| 项目根目录 ref/ | 存在（正常参考资料库，21 个文件） |
2.2 ref 排除理由¶
| 排除理由 | 说明 |
|---|---|
| 非项目产出物 | ref/ 是外部获取的参考资料（市场调研、品牌 VI 等），非项目自身产出 |
| 可重新获取 | 外部资料可随时从外部来源重新获取，归档无意义 |
| 体积较大 | 21 文件约 60MB，纳入归档增加存储负担 |
| 聚焦产出物 | 归档应聚焦项目自身产出物，排除外部资料是行业惯例 |
2.3 清理操作¶
删除 V1.1 批次中的 ref/ 目录：
Remove-Item "d:\AC\TF\hk2026\docs\归档\20260805_V1.1_筹备期前期\ref" -Force -Recurse
结果：V1.1 批次现仅含 agents.md、docs/、PPT 产出物、归档清单.md。
2.4 归档策略优化¶
在 ARC README 新增 §3.5 归档排除范围，明确以下内容不纳入归档：
| 排除项 | 路径 | 排除理由 |
|---|---|---|
| 归档目录自身 | docs/归档/ |
避免递归自我复制 |
| 外部参考资料 | ref/ |
非项目产出物，可重新获取 |
| 临时文件 | *.tmp、*.log |
运行时产物 |
| Git 元数据 | .git/ |
由 Git 仓库管理 |
| IDE 配置 | .vscode/ 等 |
开发环境配置 |
同时更新全量/增量归档命令，增加 ref 排除；校验脚本新增 ref 排除检查。
2.5 文档更新¶
| 文档 | 版本变更 | 更新内容 |
|---|---|---|
| ARC README | V1.2 → V1.3 | 归档原则新增「聚焦产出物」；新增 §3.5 归档排除范围；全量/增量命令排除 ref；校验脚本新增排除检查；目录结构移除 ref |
| PJM §4.4 | V1.4 → V1.5 | §4.4.6 全量归档命令移除 ref 复制；新增归档排除范围说明；校验脚本新增 ref 排除 |
| V1.1 归档清单 | — | §四 移除 ref 行，合计 64→43；§六 完整性移除 ref 提及；新增 ref 移除说明 |
三、产出物清单¶
| 产出物 | 路径 | 说明 |
|---|---|---|
| 清理后的 V1.1 归档 | docs/归档/20260805_V1.1_筹备期前期/ |
移除 ref/，现仅含项目产出物 |
| ARC README V1.3 | docs/归档/README.md |
新增归档排除范围策略 |
| PJM V1.5 | docs/项目管理.md |
§4.4.6 归档命令与排除范围更新 |
| V1.1 归档清单（修正） | docs/归档/20260805_V1.1_筹备期前期/归档清单.md |
移除 ref，合计 43 文件 |
| DLG-31 工作日志 | 本文件 | ref 清理与策略优化记录 |
四、关键决策¶
- ref/ 全面排除归档：外部参考资料不纳入任何类型的归档（全量/增量/指定部分）
- 归档排除范围制度化：将 ref/、临时文件、.git/、IDE 配置统一列入 §3.5 排除范围，而非临时处理
- 校验脚本双重检查：归档后同时检查递归（docs/归档）和排除（ref/），形成完整防护
本记录由听写（DT）于 2026-08-05 生成。