a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
166 lines
5.5 KiB
Markdown
166 lines
5.5 KiB
Markdown
---
|
||
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)
|
||
- 开发者→模块映射表：见铸渊协作指令主页「广播分发机制」章节 |