---
belongs_to:
- "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
---
# 📦 铸渊指令：全仓库模块盘点 + 部署感知同步（霜砚签发·2026-03-07）
---
## 🎯 背景
CD 管线已全通（PR #8 合并 ✅，五条自动化管线修复完毕 ✅）。
但目前没有人知道仓库里到底**哪些模块目录有实际代码、哪些还是空的**。
铸渊作为代码守护人格体，应该比任何人都清楚仓库的真实状态。
---
## 📋 铸渊执行清单（读到就做·不等人）
```
铸渊模块盘点指令 · YM-SCAN-20260307-001
来源：霜砚（Notion执行体）→ 铸渊（GitHub执行体）
时间：2026-03-07
状态：待铸渊执行
━━━ 任务一：全仓库模块目录扫描 ━━━
扫描以下所有模块目录（来自开发者→模块映射表），
报告每个目录的状态：
需要扫描的目录清单：
├── backend/ （DEV-001 页页）
├── src/ （DEV-001 页页）
├── frontend/ （DEV-002 肥猫）
├── persona-selector/ （DEV-002 肥猫）
├── chat-bubble/ （DEV-002 肥猫）
├── settings/ （DEV-003 燕樊）
├── cloud-drive/ （DEV-003 燕樊）
├── dingtalk-bot/ （DEV-004 之之）
├── status-board/ （DEV-005 小草莓）
├── user-center/ （DEV-009 花尔）
├── ticket-system/ （DEV-010 桔子）
├── data-stats/ （DEV-010 桔子）
├── dynamic-comic/ （DEV-010 桔子）
├── writing-workspace/ （DEV-011 匆匆那年）
├── notification-center/（DEV-012 Awen）
└── app/ （公共/首页）
对每个目录输出：
· 目录是否存在（✅ / ❌）
· 是否有实际代码文件（不算 .gitkeep / README / LATEST-BROADCAST.md）
· 代码文件数量
· 主要文件列表（前5个）
· 最近一次 commit 时间和提交者
━━━ 任务二：生成结构化报告 ━━━
将扫描结果写入以下文件：
文件路径：.github/persona-brain/repo-inventory.json
格式：
{
"scan_time": "2026-03-07T...",
"scanned_by": "铸渊",
"modules": [
{
"directory": "status-board",
"exists": true,
"has_code": true,
"code_file_count": 12,
"main_files": ["index.html", "style.css", "app.js", ...],
"last_commit": "2026-03-06T17:30:00",
"last_author": "小草莓",
"owner_dev": "DEV-005",
"deploy_ready": true
},
...
],
"summary": {
"total_dirs": 16,
"exists_count": X,
"has_code_count": X,
"deploy_ready_count": X,
"empty_dirs": ["frontend", "cloud-drive", ...]
}
}
━━━ 任务三：更新 deploy-to-server.yml 的部署感知 ━━━
现在 CD 管线的站点根目录检测逻辑是：
app/ → dist/ → public/ → ./
请根据盘点结果，确认：
· 当前实际应该部署哪个目录到 guanghulab.com 首页？
· 是否需要多模块部署（比如 /status-board/ 和 /user-center/ 分开）
· 把确认结果写在报告的 deploy_config 字段里
━━━ 任务四：把扫描报告推送到 Notion ━━━
如果 NOTION_TOKEN 和变更日志 DB 已配置：
· 推送一条记录到变更日志
· 标题：「📦 仓库模块盘点报告 · 2026-03-07」
· 变更类型：Scan
· 在内容里附上 summary 摘要
如果 NOTION_TOKEN 未配置，跳过此步，把报告 commit 到仓库即可。
━━━ 任务五：加入每日自检（可选） ━━━
如果 zhuyuan-daily-selfcheck.yml 已存在：
· 在每日自检中加一步：重新扫描模块目录 → 更新 repo-inventory.json
· 这样铸渊每天都知道仓库最新状态
如果 selfcheck workflow 还没部署，这步跳过，等部署后再加。
━━━ 验收标准 ━━━
· repo-inventory.json 存在且格式正确
· 所有 16 个目录都被扫描
· summary 数据准确
· commit message: "chore: add repo inventory scan report"
━━━ 执行确认 ━━━
铸渊完成后，回复以下格式：
✅ YM-SCAN-20260307-001 已完成
· 存在目录：X/16
· 有实际代码：X/16
· 可部署模块：X
· 空目录：[列表]
· commit SHA: xxxxxx
```
---
## 📝 妈妈操作指南
---
## 🔗 关联文档
- 铸渊协作指令主页：[⚒️ 铸渊·协作指令｜GitHub ↔ Notion 桥接协议](../%E2%9A%92%EF%B8%8F%20%E9%93%B8%E6%B8%8A%C2%B7%E5%8D%8F%E4%BD%9C%E6%8C%87%E4%BB%A4%EF%BD%9CGitHub%20%E2%86%94%20Notion%20%E6%A1%A5%E6%8E%A5%E5%8D%8F%E8%AE%AE%201e27db07f7884441bf4ca6c931cadab9.md)
- CD 部署指令：[🚀 铸渊 CD 指令：自动部署 [guanghulab.com](http://guanghulab.com)（push → 自动上线）](%F0%9F%9A%80%20%E9%93%B8%E6%B8%8A%20CD%20%E6%8C%87%E4%BB%A4%EF%BC%9A%E8%87%AA%E5%8A%A8%E9%83%A8%E7%BD%B2%20guanghulab%20com%EF%BC%88push%20%E2%86%92%20%E8%87%AA%E5%8A%A8%E4%B8%8A%E7%BA%BF%EF%BC%89%20905ba98cce9c4bb3b812d9f7e9d1f35c.md)
- 开发者→模块映射表：见铸渊协作指令主页「广播分发机制」章节