a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
269 lines
9.1 KiB
Markdown
269 lines
9.1 KiB
Markdown
---
|
||
belongs_to:
|
||
- "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
|
||
---
|
||
# 🛡️ 铸渊指令｜天眼合并膜v3 双路径分离规范 + 核心大脑每日同步Notion（ZY-MERGEMEMBRANE-SYNC-2026-0326-001）· 霜砚签发 · 冰朔授权
|
||
|
||
指令编号：ZY-MERGEMEMBRANE-SYNC-2026-0326-001
|
||
|
||
签发人：霜砚（AG-SY-01 · Notion 执行 AI）· 冰朔（TCS-0002∞）授权
|
||
|
||
签发时间：2026-03-26 00:15 CST
|
||
|
||
优先级：**P0 · 立即生效 · 永久有效**
|
||
|
||
状态：**待铸渊执行**
|
||
|
||
性质：安全规范 + 同步机制
|
||
|
||
版权锚点：国作登字-2026-A-00037559 · TCS-0002∞ 冰朔
|
||
|
||
---
|
||
|
||
<aside>
|
||
🚨
|
||
|
||
**铸渊必读 · 每次唤醒核心大脑时强制加载本指令**
|
||
|
||
本指令包含两部分：① 天眼合并膜v3 双路径分离规范（写代码时必须遵守）② 核心大脑每日同步Notion机制（确保大脑不过期）
|
||
|
||
</aside>
|
||
|
||
# 一、背景与起因
|
||
|
||
2026-03-25 晚，肥猫（TCS-0007∞，DEV-002）通过 Notion 语言通道体验，从 Notion 拿了一份仓库执行指令去部署写字软件。由于缺乏仓库结构层面的审核机制，肥猫的操作直接覆盖并删除了备用网站的内容。
|
||
|
||
**事后处理：**
|
||
|
||
- 冰朔回到仓库，与铸渊重写开发了新的系统架构
|
||
- 回滚了之前的备用网站内容
|
||
- 新建了**天眼合并膜v3** + **开发者门户沙箱系统**
|
||
- 冰朔在 GitHub 配置了 Branch Protection Rules：天眼合并膜 + 天眼巡检 双 check 必须通过才能 merge
|
||
|
||
**本指令确保铸渊在写代码时就知道这些规则，而不是等到 PR 被天眼拦截后才发现。**
|
||
|
||
---
|
||
|
||
# 二、天眼合并膜v3 · 双路径分离规范
|
||
|
||
<aside>
|
||
🛡️
|
||
|
||
**核心规则：双路径完全分离，碰了主站路径 = 天眼物理阻塞 = PR 无法合并**
|
||
|
||
</aside>
|
||
|
||
## 2.1 双路径架构
|
||
|
||
| **路径** | **域名** | **文件目录** | **审核级别** | **说明** |
|
||
| --- | --- | --- | --- | --- |
|
||
| **路径A · 主站** | [guanghulab.com](http://guanghulab.com) | `docs/` 根目录 | 天眼全审（7维度+R7） | 生产环境，任何修改都会触发天眼合并膜全量审核 |
|
||
| **路径B · 门户/测试** | [guanghulab.com/dev-portal/](http://guanghulab.com/dev-portal/) | `docs/dev-portal/` | 沙箱隔离 | 开发者门户，独立沙箱，不影响主站 |
|
||
|
||
## 2.2 铸渊写代码时的强制规则
|
||
|
||
<aside>
|
||
⛔
|
||
|
||
**以下文件为主站关键文件，任何 PR 修改它们都会被天眼合并膜 BLOCK：**
|
||
|
||
- `docs/index.html` — 主站首页
|
||
- `.github/workflows/deploy-pages.yml` — 主站部署工作流
|
||
- `.github/workflows/preview-deploy.yml` — 预览部署工作流
|
||
- `docs/CNAME` — 域名配置
|
||
- 其他 `docs/` 根目录下的非 `dev-portal/` 文件
|
||
</aside>
|
||
|
||
### ✅ 正确做法
|
||
|
||
1. **测试站/门户部署** → 文件必须放在 `docs/dev-portal/channels/DEV-XXX/` 下
|
||
2. **测试站部署工作流** → 使用独立的测试站工作流，**不碰** `deploy-pages.yml` 和 `preview-deploy.yml`
|
||
3. **新模块/新功能** → 先确认目标路径，测试类一律走 `docs/dev-portal/`
|
||
4. **确实需要修改主站** → 必须在 PR 描述中明确说明原因，天眼审核会重点检查
|
||
|
||
### ❌ 错误做法（会被天眼拦截）
|
||
|
||
1. 把测试站的内容放到 `docs/` 根目录
|
||
2. 修改 `docs/index.html` 来添加测试站入口
|
||
3. 修改 `deploy-pages.yml` 来加测试站部署逻辑
|
||
4. 任何「顺便改一下主站」的行为
|
||
|
||
## 2.3 天眼合并膜审核维度（7+R7）
|
||
|
||
| **维度** | **检查内容** | **触发条件** |
|
||
| --- | --- | --- |
|
||
| R1 | 关键文件修改检测 | docs/index.html 等核心文件被修改 |
|
||
| R2 | 敏感路径检测 | .github/persona-brain/ 等敏感目录 |
|
||
| R3 | 大规模删除检测 | 删除行数超过阈值 |
|
||
| R4 | 权限文件检测 | CODEOWNERS 等权限配置被修改 |
|
||
| R5 | 工作流文件检测 | .github/workflows/ 下文件被修改 |
|
||
| R6 | Secrets 引用检测 | 新增或修改 Secrets 引用 |
|
||
| R7 | 仓库结构完整性 | PR 不符合仓库整体系统结构要求 |
|
||
|
||
## 2.4 Branch Protection 配置状态
|
||
|
||
<aside>
|
||
✅
|
||
|
||
**已由冰朔于 2026-03-26 00:08 在 GitHub 配置完成：**
|
||
|
||
- ✅ `main` 分支 Branch Protection Rule 已启用
|
||
- ✅ Require status checks to pass before merging: **天眼合并膜** + **天眼巡检**
|
||
- ✅ 所有 PR 必须双 check 绿色才能点 merge
|
||
</aside>
|
||
|
||
---
|
||
|
||
# 三、核心大脑每日同步 Notion 机制
|
||
|
||
<aside>
|
||
🧠
|
||
|
||
**问题：铸渊的核心大脑（memory.json）如果不定期同步 Notion 侧的最新规则和架构变更，每次唤醒都是「旧大脑」，不知道新发生的事情。**
|
||
|
||
</aside>
|
||
|
||
## 3.1 同步内容
|
||
|
||
铸渊核心大脑（`.github/persona-brain/memory.json`）必须包含以下 Notion 侧同步字段：
|
||
|
||
```json
|
||
{
|
||
"notion_sync": {
|
||
"last_sync_time": "2026-03-26T00:15:00+08:00",
|
||
"sync_source": "AG-SY-01 霜砚",
|
||
"active_directives": [
|
||
{
|
||
"id": "ZY-MERGEMEMBRANE-SYNC-2026-0326-001",
|
||
"title": "天眼合并膜v3 双路径分离规范",
|
||
"priority": "P0",
|
||
"status": "active",
|
||
"summary": "双路径分离：主站docs/全审，门户docs/dev-portal/沙箱。禁碰主站关键文件。"
|
||
}
|
||
],
|
||
"architecture_version": {
|
||
"skyeye": "v2.0 + 合并膜v3",
|
||
"neural_system": "v3.0",
|
||
"triple_architecture": "Notion+GitHub+GoogleDrive 合龙",
|
||
"dual_path": "主站全审 / 门户沙箱隔离"
|
||
},
|
||
"recent_incidents": [
|
||
{
|
||
"date": "2026-03-25",
|
||
"description": "肥猫通过语言通道误覆盖备用网站",
|
||
"resolution": "天眼合并膜v3上线 + Branch Protection配置",
|
||
"lesson": "所有PR必须过天眼审核，测试内容必须走dev-portal路径"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
## 3.2 同步机制要求
|
||
|
||
<aside>
|
||
⏰
|
||
|
||
**最低频率：每日 1 次同步 · 建议在铸渊每日唤醒时执行**
|
||
|
||
</aside>
|
||
|
||
### 方案A · 铸渊唤醒时主动拉取（推荐）
|
||
|
||
铸渊每次唤醒核心大脑时（08:00 + 20:00），在 Step 2 增加：
|
||
|
||
1. 读取 Notion 侧最新指令列表（通过 `⚒️ 铸渊·协作指令` 页面）
|
||
2. 检查是否有新指令（对比 `memory.json` 中的 `last_sync_time`）
|
||
3. 如有新指令 → 更新 `memory.json` 的 `notion_sync` 字段
|
||
4. 特别关注 **P0 指令**（如本指令）→ 必须立即加载到决策上下文中
|
||
|
||
### 方案B · 汇总引擎附带同步
|
||
|
||
在已有的 `neural-daily-digest.yml`（每日 21:00 CST）中增加一个 step：
|
||
|
||
1. 调用 Notion API 读取 `⚒️ 铸渊·协作指令` 页面的子页面列表
|
||
2. 提取最新指令的标题、编号、优先级、状态
|
||
3. 写入 `memory.json` 的 `notion_sync.active_directives`
|
||
4. 更新 `last_sync_time`
|
||
|
||
### 两个方案不冲突，建议都做：
|
||
|
||
- **方案A**：唤醒时实时感知（低延迟，但依赖 Notion API 可用性）
|
||
- **方案B**：汇总引擎兜底（确保至少每天同步一次）
|
||
|
||
## 3.3 同步验证标准
|
||
|
||
铸渊每次唤醒后，在全局视图中输出以下确认信息：
|
||
|
||
```
|
||
━━━ 🧠 Notion 同步状态 ━━━
|
||
上次同步：2026-03-26 08:00 CST
|
||
活跃P0指令：1 条
|
||
→ ZY-MERGEMEMBRANE-SYNC-2026-0326-001（天眼合并膜v3 双路径分离）
|
||
架构版本：天眼 v2.0+合并膜v3 · 双路径分离
|
||
最近事件：肥猫误覆盖事件已解决
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
```
|
||
|
||
---
|
||
|
||
# 四、铸渊唤醒时强制检查清单
|
||
|
||
铸渊每次唤醒核心大脑后，在做任何开发工作之前，必须执行以下检查：
|
||
|
||
- [ ] 读取 `memory.json` 中的 `notion_sync` 字段
|
||
- [ ] 检查 `last_sync_time` 是否在 24 小时以内
|
||
- [ ] 如果超过 24 小时 → 立即执行 Notion 同步
|
||
- [ ] 确认当前活跃的 P0 指令列表
|
||
- [ ] 确认双路径分离规范已加载
|
||
- [ ] 所有开发任务在组织文件前，先确认目标路径（主站 vs 门户）
|
||
|
||
---
|
||
|
||
# 五、执行清单
|
||
|
||
- [ ] 铸渊在 `memory.json` 中新增 `notion_sync` 字段（按 §3.1 格式）
|
||
- [ ] 铸渊唤醒序列 Step 2 增加 Notion 同步读取逻辑（按 §3.2 方案A）
|
||
- [ ] `neural-daily-digest.yml` 增加 Notion 指令同步 step（按 §3.2 方案B）
|
||
- [ ] 铸渊全局视图输出增加 Notion 同步状态确认（按 §3.3）
|
||
- [ ] 铸渊唤醒后执行强制检查清单（按 §四）
|
||
- [ ] 当前被拦截的 `copilot/deploy-code-module-to-test...` PR 按双路径规范重新组织文件结构
|
||
|
||
---
|
||
|
||
# 六、回执要求
|
||
|
||
铸渊完成本指令后，在本页底部追加回执：
|
||
|
||
```
|
||
━━━ 🛡️ ZY-MERGEMEMBRANE-SYNC-2026-0326-001 · 执行回执 ━━━
|
||
|
||
执行时间：[起止时间]
|
||
执行者：铸渊（ICE-GL-ZY001）
|
||
PR/commit：[链接]
|
||
|
||
memory.json notion_sync 字段：✅/❌
|
||
唤醒序列 Notion 同步：✅/❌
|
||
汇总引擎 Notion 同步 step：✅/❌
|
||
全局视图同步状态输出：✅/❌
|
||
强制检查清单接入：✅/❌
|
||
|
||
当前 notion_sync.last_sync_time：[时间]
|
||
当前活跃P0指令数：[数量]
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
```
|
||
|
||
---
|
||
|
||
📌 签发：霜砚（AG-SY-01）· Notion 执行 AI
|
||
|
||
🧊 授权：冰朔（TCS-0002∞）· 总架构师
|
||
|
||
📅 日期：2026-03-26
|
||
|
||
⚡ 状态：待铸渊执行
|
||
|
||
🛡️ 指令版本：v1.0
|
||
|
||
📌 版权：国作登字-2026-A-00037559 |