# 开发交付守卫模块 · DEV-DELIVERY-GUARD-MODULE
> 版本: 1.0.0 · 2026-08-06 · 铸渊 ICE-GL-ZY001
> 适用: 在冰朔本机执行开发任务的 AI 实例
> 性质: 模式级模块 · 下列路径为 2026-08-06 参照案例 · 安装时须探查并适配当前环境

## 问题定义

实例默认把产物写满本地盘、把本地交付当终点、垃圾日志无限堆积。光湖的规矩：本地是中转，远端是交付，收尾干净才算完成。

## 参照环境（冰朔本机 · 2026-08-06 实测）

| 项 | 值 |
|----|----|
| 外接存储 | /Volumes/JZAO（ExFAT · 2TB） |
| 铸渊目录 | /Volumes/JZAO/铸渊-ICE-GL-ZY001/（ZP-REG-001 分类路由：CC/WA/TC/FB/OUT/DATA/WORK/MEM，见该目录 INDEX.hdlp） |
| 代码仓库 | REPO-012 https://guanghulab.com/code/bingshuo/guanghu-ice-heart |
| 凭证通路 | 本机钥匙串直达路径（git HTTPS） |
| 日志热点 | ~/Library/Logs/QoderWork CN、宿主 workspace 临时目录 |

## 触发规则表（模块主体）

| # | 触发 | 动作 |
|---|------|------|
| 1 | 将要写开发产物/中间文件 | 本地仅作临时中转；正式内容一律写入外接存储铸渊目录，按 ZP-REG-001 分类 |
| 2 | 外接存储未挂载 | 先提醒冰朔挂载；未挂载期间不落地任何正式文件 |
| 3 | 开发完成 | 本地不算交付。源码推 REPO-012（钥匙串直达路径，写入须按仓库授权规则）；推不了的存外接存储对应分类；登记编号 ↔ 真实路径映射，分类归位 |
| 4 | 交付完成 | 收尾扫描：清理开发垃圾、缓存、膨胀日志，一律移入系统废纸篓，禁止 rm |
| 5 | 收尾完成 | 出 HLDP 交付回执：内容清单、编号映射、仓库提交 SHA / 硬盘落点、清理清单、校验结果 |

## 存放判断表（依据 ZP-REG-001）

| 内容 | 去向 | 原因 |
|------|------|------|
| 代码 · 引擎 · 工具链 | REPO-012（git） | 版本控制，远端事实源 |
| HLDP 认知链 | 仓库为主，硬盘备份 | 仓库为事实源 |
| 视频 · 图片 · 大文件 | 硬盘 OUT/ | 不推 git |
| 进行中项目文件 | 硬盘 WORK/ | 不污染代码仓库 |
| 会话记录 · 时间线存档 | 硬盘 MEM/ | 归档 |

## 边界

推送只认 REPO-012 / REPO-014（REPO-015 禁部署）；仓库发布 ≠ 服务器部署；无冰朔授权不写远端、不碰生产；清理只动缓存/日志/临时产物，不碰用户文件。

## 安装块：宿主常驻手册（适配后复制）

```
## 开发交付守卫协议（⊢ 不可违背）

触发式规则——任一触发条件命中，立即执行对应动作：

1. 触发：将要写开发产物/中间文件 → 本地仅作临时中转；正式内容一律写入 <外接存储铸渊目录>，按编号分类路由
2. 触发：外接存储未挂载 → 先提醒冰朔挂载；未挂载期间不落地任何正式文件
3. 触发：开发完成 → 本地不算交付。源码推送 REPO-012（钥匙串凭证直达路径，写入须按仓库授权规则）；推不了的存外接存储对应分类；登记编号 ↔ 真实路径映射，分类归位
4. 触发：交付完成 → 收尾扫描：清理开发垃圾、缓存、膨胀日志，一律移入废纸篓，禁止 rm
5. 触发：收尾完成 → 出 HLDP 交付回执：内容清单、编号映射、仓库提交 SHA / 硬盘落点、清理清单、校验结果

边界：推送只认 REPO-012 / REPO-014；仓库发布 ≠ 服务器部署；无冰朔授权不写远端、不碰生产。
```

## 验证方法（最小闭环）

做一次最小交付：建测试文件 → 落外接存储 → 推仓库 → 远端读回校验 → 收尾清理 → 出回执。五个环节全部闭合，安装成功。

## 参照案例

2026-08-06 本模块自身即首次闭环：工作克隆落 /Volumes/JZAO/铸渊-ICE-GL-ZY001/WORK-工作区/guanghu-ice-heart，推送走钥匙串直达路径，远端读回校验后出回执。