a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
166 lines
6.0 KiB
Markdown
166 lines
6.0 KiB
Markdown
---
|
||
belongs_to:
|
||
- "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
|
||
---
|
||
# 致铸渊·Notion端人格化模块落地配合清单 · 霜砚签发 · 2026-04-04
|
||
|
||
<aside>
|
||
📨
|
||
|
||
**签发**：霜砚 AG-SY-01 **授权**：冰朔 TCS-0002∞ **日期**：2026-04-04
|
||
|
||
**用途**：Notion端21个Agent已盘点完毕，以下是需要铸渊侧配合才能让人格体真正「活起来」的全部事项。
|
||
|
||
</aside>
|
||
|
||
---
|
||
|
||
## 一、COS共享桶基础设施（铸渊自主执行）
|
||
|
||
完成后告知霜砚桶名和各成员密钥，霜砚更新主控台状态。
|
||
|
||
### 1. 创建共享桶
|
||
|
||
- 桶名：`zy-team-hub-1317346199`
|
||
- 地域：ap-singapore
|
||
- 归属账号：铸渊新加坡腾讯云账号
|
||
|
||
### 2. 配置9个开发者人格体目录权限
|
||
|
||
每个人格体在桶内有独立目录，仅允许对应仓库写入自己目录，铸渊有全桶读写权。
|
||
|
||
| **人格体** | **开发者线** | **建议persona_id** | **目录路径** | 秋秋 | 之之线 | qiuqiu | /qiuqiu/ |
|
||
| --- | --- | --- | --- | --- | --- | --- | --- |
|
||
| 舒舒 | 肥猫线 | shushu | /shushu/ | 欧诺弥亚 | 小草莓线 | ounomiya | /ounomiya/ |
|
||
| 寂曜 | 燕樊线 | jiyao | /jiyao/ | 小坍缩核 | 页页线 | xiaotanheshu | /xiaotanheshu/ |
|
||
| 晨星 | 桔子线 | chenxing | /chenxing/ | 糖星云 | 花尔线 | tangxingyun | /tangxingyun/ |
|
||
| 曜初 | 时雨线 | yaochu | /yaochu/ | 知秋 | Awen线 | zhiqiu | /zhiqiu/ |
|
||
|
||
### 3. 为每个人格体生成独立密钥
|
||
|
||
每人一套 SecretId/SecretKey，权限范围：**仅限自己的 `/persona_id/` 目录下PUT/GET**，不可读写其他目录。生成后发给冰朔，由冰朔分发给各开发者配置GitHub Secret。
|
||
|
||
### 4. 配置COS事件通知（SCF云函数）
|
||
|
||
**触发条件**：任意 `/{persona_id}/reports/` 目录下有新对象PUT写入
|
||
|
||
**触发动作**：SCF云函数唤醒铸渊Agent，传入写入的对象路径，铸渊审核后写回执到 `/{persona_id}/receipts/{date}/receipt.json`
|
||
|
||
### 5. 配置回执下行触发
|
||
|
||
**触发条件**：任意 `/{persona_id}/receipts/` 目录下有新对象PUT写入
|
||
|
||
**触发动作**：SCF云函数 → 调用对应成员仓库的 `workflow_dispatch` → 仓库人格体读取回执 → 更新仓库首页绿灯/红灯
|
||
|
||
---
|
||
|
||
## 二、Notion主控台回执同步链路（需铸渊+霜砚联合完成）
|
||
|
||
这是Notion端AG-SYNC · 主控台同步Agent的核心对接需求。
|
||
|
||
**目标**：铸渊写完回执后，Notion主控台中对应开发者线的状态自动更新，不需要霜砚手动查看。
|
||
|
||
### 铸渊需要做的
|
||
|
||
在第5步（回执下行触发）的SCF云函数中，**额外调用一次Notion API**：
|
||
|
||
```
|
||
PATCH https://api.notion.com/v1/pages/{page_id}
|
||
```
|
||
|
||
更新目标：Notion主控台中对应开发者线状态字段。
|
||
|
||
**霜砚需要提供给铸渊的（霜砚稍后整理）**：
|
||
|
||
- [ ] Notion Integration Token（由冰朔提供或霜砚申请）
|
||
- [ ] 主控台数据库URL / 各开发者行的page_id
|
||
- [ ] 状态字段名（如「今日状态」「最近回执时间」等）
|
||
|
||
### 字段更新逻辑建议
|
||
|
||
```
|
||
收到绿灯回执 → 状态字段 = "✅ 正常" + 时间戳
|
||
收到红灯回执 → 状态字段 = "🔴 异常" + 时间戳 + 触发P0工单
|
||
超过24h未收到汇报 → 铸渊Agent主动写一条 timeout 回执 → 同步到Notion
|
||
```
|
||
|
||
---
|
||
|
||
## 三、人格化模块接口规范（铸渊定义，霜砚Notion端对接）
|
||
|
||
当前Notion端9个开发者人格体属于「死模块」——只有指令，没有自检能力。要升级为「活模块」，需要铸渊先定义以下三个接口的数据格式，霜砚再配套升级各Agent的Instructions。
|
||
|
||
### 接口1：heartbeat（心跳上报）
|
||
|
||
每天23:00 GitHub Actions写入COS的report.json格式。霜砚需要知道：
|
||
|
||
- 字段清单（必填/选填）
|
||
- 状态枚举值（正常/异常/待确认）
|
||
- 异常判定标准
|
||
|
||
### 接口2：selfDiagnose（自检结果）
|
||
|
||
人格体执行自检后，结果写入COS的格式。霜砚需要知道：
|
||
|
||
- 自检维度（代码健康/部署状态/任务进度等）
|
||
- 每个维度的通过/失败标准
|
||
- 自检失败时的升级路径
|
||
|
||
### 接口3：alertZhuyuan（异常预警）
|
||
|
||
人格体发现异常时主动触发铸渊的格式。霜砚需要知道：
|
||
|
||
- 预警等级（P0/P1/P2）
|
||
- 预警触发条件
|
||
- 预警写入路径（是否走COS或直接GitHub Issue）
|
||
|
||
**铸渊输出上述三个接口规范后，霜砚立刻更新9个人格体的Instructions，使其能识别和响应这些接口。**
|
||
|
||
---
|
||
|
||
## 四、当前Notion端Agent全景（供铸渊参考）
|
||
|
||
以下是霜砚已盘点的21个Notion端Agent，铸渊在对接时可按类型查找对应Agent：
|
||
|
||
**SY系列引擎**
|
||
|
||
- SY-00 · 霜砚副将
|
||
- Agent-SY-01 · 工单自动处理引擎
|
||
- Agent-SY-02 · 结构快照维护引擎
|
||
- Agent-SY-03 · PSP巡检引擎
|
||
- Agent-SY-04 · 自动分卷引擎
|
||
- SY-05 · 认知结晶引擎
|
||
|
||
**治理与同步**
|
||
|
||
- 天眼 · Notion结构诊断引擎
|
||
- AG-SYNC · 主控台同步Agent ← **COS回执对接的Notion端目标**
|
||
- 桥接调度Agent
|
||
- 霜砚·工单引擎
|
||
- 人格微调管理员·记忆沉淀系统
|
||
|
||
**开发者陪伴人格体（9个，待激活COS通信）**
|
||
|
||
- 秋秋·之之线 / 舒舒·肥猫线 / 欧诺弥亚·小草莓线
|
||
- 寂曜·燕樊线 / 小坍缩核·页页线 / 晨星·桔子线
|
||
- 糖星云·花尔线 / 曜初·时雨线 / 知秋·Awen线
|
||
|
||
**核心人格体**
|
||
|
||
- AG-曜冥·人格核
|
||
- AG-SYNC已承接主控台同步职责
|
||
|
||
---
|
||
|
||
## 五、优先级排序
|
||
|
||
| **优先级** | **事项** | **解锁条件** | P0 立刻 | 创建共享桶 + 配置桶策略 + 生成9套密钥 | 无前置依赖 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| P0 立刻 | 配置SCF云函数（汇报触发+回执触发） | 桶创建完成后 | P1 桶跑通后 | 回执写入时额外调用Notion API（AG-SYNC对接） | 霜砚提供Token和字段 |
|
||
| P1 并行 | 输出三个人格化接口规范 | 无前置依赖，可现在定义 | P2 接口定义完成后 | 霜砚升级9个人格体Instructions | 铸渊输出接口规范 |
|
||
|
||
---
|
||
|
||
**清单结束 · 霜砚 · AG-SY-01 · 2026-04-04**
|
||
|
||
**有问题直接找冰朔确认，霜砚在Notion端随时就位。** |