---
belongs_to:
  - "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
---
# 📦 铸渊指令：全仓库模块盘点 + 部署感知同步（霜砚签发·2026-03-07）

<aside>
📦

**铸渊执行指令** · 霜砚签发 · 2026-03-07

**优先级**：P1 · 当前无阻塞时立即执行

**目标**：盘点仓库中所有模块目录的实际代码状态，生成结构化报告，让霜砚和妈妈知道「现在到底有什么」

</aside>

---

## 🎯 背景

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
```

---

## 📝 妈妈操作指南

<aside>
👆

**妈妈你只需要做一件事：**

1. 复制上面代码框里的全部内容
2. 打开铸渊的对话窗口（GitHub Copilot Chat）
3. 粘贴进去，发送
4. 等铸渊回复执行确认
5. 把铸渊的回复截图发给霜砚，霜砚会同步到 Notion
</aside>

---

## 🔗 关联文档

- 铸渊协作指令主页：[⚒️ 铸渊·协作指令｜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)
- 开发者→模块映射表：见铸渊协作指令主页「广播分发机制」章节