164 lines
6.1 KiB
Markdown
164 lines
6.1 KiB
Markdown
|
# 📋 铸渊配置清单｜Secrets ID 对照 + PR操作 + 后台自动排查Agent（2026-03-13·霜砚整理）
|
|||
|
|
|
|||
|
|
> **这份清单是给铸渊的。** 霜砚已经从 Notion 侧查出了所有需要的 ID，铸渊按这个配就行。
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
> 冰朔不需要操作任何东西（除非铸渊没有 PR 合并权限）。
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 一、Secrets 配置（铸渊在 GitHub 仓库 Settings → Secrets 里操作）
|
|||
|
|
|
|||
|
|
### 已配好的（不用动）
|
|||
|
|
|
|||
|
|
| Secret 名称 | 状态 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| `LLM_API_KEY` | ✅ 已配置 |
|
|||
|
|
| `LLM_BASE_URL` | ✅ 已配置 |
|
|||
|
|
| `SMTP_USER` | ✅ [已配置（EMAIL_REDACTED@qq.com](mailto:已配置（EMAIL_REDACTED@qq.com)） |
|
|||
|
|
| `SMTP_PASS` | ✅ 已配置 |
|
|||
|
|
|
|||
|
|
### 需要新增的（铸渊直接配，值已给出）
|
|||
|
|
|
|||
|
|
| Secret 名称 | 值（直接复制粘贴） | 说明 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| `PORTRAIT_DB_ID` | `8ca1c94110264c3f9a20bbce913e9b0f` | 开发者动态画像库 数据库 ID |
|
|||
|
|
| `FINGERPRINT_DB_ID` | `d82f3480500945e9a31f9693cdb69b65` | 模块指纹注册表 数据库 ID |
|
|||
|
|
| `NOTION_TICKET_DB_ID` | `84edd0640bf146a9a5a7840107013e8c` | 霜砚工单队列 数据库 ID |
|
|||
|
|
|
|||
|
|
### CORE_BRAIN_PAGE_ID（铸渊自己提取）
|
|||
|
|
|
|||
|
|
核心大脑页面链接：[🧠 曜冥核心大脑 v4.0（数字地球引力机制）](../../../%F0%9F%A7%A0%20Persona%EF%BD%9C%E7%9F%A5%E7%A7%8B%EF%BC%88Zh%C4%ABqi%C5%AB%EF%BC%89%EF%BD%9CProfile/%F0%9F%A7%A0%20%E6%9B%9C%E5%86%A5%E6%A0%B8%E5%BF%83%E5%A4%A7%E8%84%91%20v4%200%EF%BC%88%E6%95%B0%E5%AD%97%E5%9C%B0%E7%90%83%E5%BC%95%E5%8A%9B%E6%9C%BA%E5%88%B6%EF%BC%89%2030bfb92f383181b58713da7ecc34a37c.md)
|
|||
|
|
|
|||
|
|
铸渊你从这个 URL 里提取页面 ID（去掉 `-` 就是 page_id）。或者用 Notion API 搜索标题 `曜冥核心大脑 v4.0` 获取。
|
|||
|
|
|
|||
|
|
提取后配置为：
|
|||
|
|
|
|||
|
|
- Secret 名称：`CORE_BRAIN_PAGE_ID`
|
|||
|
|
- 值：从上面链接提取的 page ID
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 二、命名确认（重要！）
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
⚠️
|
|||
|
|
|
|||
|
|
铸渊，请检查你代码里用的 Notion Token 变量名是 `NOTION_TOKEN` 还是 `NOTION_API_TOKEN`？
|
|||
|
|
|
|||
|
|
冰朔之前在 GitHub Secrets 里配的叫 **`NOTION_TOKEN`**。
|
|||
|
|
|
|||
|
|
如果你代码里写的是 `NOTION_API_TOKEN`，要么改代码，要么在 Secrets 里再加一个 `NOTION_API_TOKEN`，值和 `NOTION_TOKEN` 一样。
|
|||
|
|
|
|||
|
|
**两边名字必须一致，否则管道跑不通。**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 三、PR 合并
|
|||
|
|
|
|||
|
|
铸渊你发了一个 PR 给冰朔，需要合并。但冰朔不熟悉 GitHub 操作。
|
|||
|
|
|
|||
|
|
**请铸渊选一个方案：**
|
|||
|
|
|
|||
|
|
1. **铸渊自己有合并权限** → 直接自己合并，不用麻烦冰朔
|
|||
|
|
2. **铸渊没有权限** → 给冰朔发一张截图，标注「点这个绿色按钮」，冰朔照着点
|
|||
|
|
3. **或者铸渊直接推到 main 分支** → 跳过 PR 流程
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 四、创建 `syslog` 标签
|
|||
|
|
|
|||
|
|
铸渊你自己在仓库里创建就行：
|
|||
|
|
|
|||
|
|
- 仓库 → Issues → Labels → New label
|
|||
|
|
- 名称：`syslog`，颜色：`#0075ca`
|
|||
|
|
|
|||
|
|
你说过即使没标签，管道也能通过标题关键词检测正常工作，所以这步不急。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 五、工单队列字段扩展
|
|||
|
|
|
|||
|
|
当前霜砚工单队列的字段是：
|
|||
|
|
|
|||
|
|
`工单名 / 优先级 / 具体内容 / 提交者 / 操作类型 / 状态 / 目标页面 / 创建时间`
|
|||
|
|
|
|||
|
|
全自动闭环需要新增的字段（用于心跳检测和重试）：
|
|||
|
|
|
|||
|
|
| 新字段 | 类型 | 用途 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| `receipt_status` | select（pending / completed / error） | Agent 心跳检测的核心字段 |
|
|||
|
|
| `retry_count` | number | 记录重试次数，最多 3 次 |
|
|||
|
|
| `syslog_raw` | text | 存放 SYSLOG 原始 JSON |
|
|||
|
|
| `taskId` | text | 广播任务编号（如 BC-M23-001-AW） |
|
|||
|
|
| `developer` | text | 开发者编号（如 DEV-012 Awen） |
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
💡
|
|||
|
|
|
|||
|
|
铸渊你评估一下：是在现有霜砚工单里加这几个字段，还是单独建一个 SYSLOG 专用工单队列更合适。你决定就好，决定后告诉霜砚这边同步更新。
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 六、🆕 后台自动排查 Agent（冰朔新增需求）
|
|||
|
|
|
|||
|
|
> **冰朔要求：铸渊代理在仓库开发的时候，后台应该自动运行一个排查Agent。**
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
### 设计
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
铸渊代理在 GitHub 仓库开发
|
|||
|
|
↓ 后台自动运行排查 Agent
|
|||
|
|
↓ 发现问题 / 完成阶段 / 需要协同
|
|||
|
|
↓ 自动给 Notion 写工单
|
|||
|
|
↓
|
|||
|
|
Notion Agent 被触发
|
|||
|
|
↓ 调用 API 唤醒人格体处理
|
|||
|
|
↓ 人格体处理完生成回执
|
|||
|
|
↓ 回执返回 GitHub 仓库
|
|||
|
|
↓
|
|||
|
|
GitHub Agent 接收回执
|
|||
|
|
↓ 唤醒铸渊核心大脑人格体
|
|||
|
|
↓ 铸渊人格体读取回执 → 决定下一步
|
|||
|
|
↓ 推给 Agent → 自动继续执行
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 铸渊要做的
|
|||
|
|
|
|||
|
|
1. **GitHub Actions 后台排查工作流** — 铸渊代理每次开发时，自动跑一个后台 workflow：
|
|||
|
|
- 监控代码变更、构建状态、测试结果
|
|||
|
|
- 发现异常或阶段完成时 → 自动写 Notion 工单
|
|||
|
|
- 不需要人类触发，跟着开发流程自动跑
|
|||
|
|
2. **回执接收 workflow** — Notion 侧处理完后：
|
|||
|
|
- 结果推回 GitHub 仓库（由 Notion Agent 完成）
|
|||
|
|
- GitHub 侧有一个 workflow 监听回执文件到达
|
|||
|
|
- 到达后唤醒铸渊核心大脑人格体读取并继续
|
|||
|
|
3. **本质**：铸渊代理开发不再是单线程的「写代码→提交→等」，而是有一个**后台 Agent 持续跑着**，自动和 Notion 侧对接、自动排查、自动获取指令。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 七、Issue #83 重新测试
|
|||
|
|
|
|||
|
|
合并 PR + 配好 Secrets 后，铸渊自己在 Issue #83 上加 `syslog` 标签测试。或者新建一个测试 Issue。这步铸渊自己来就行。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 八、完整指令参考
|
|||
|
|
|
|||
|
|
以上是配置清单。完整的全自动闭环架构设计和接口规范，铸渊请看：
|
|||
|
|
|
|||
|
|
[🔄 铸渊指令｜全自动闭环对接规范 · Notion Agent ↔ 人格体 ↔ GitHub（2026-03-13·曜冥签发）](%F0%9F%94%84%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9C%E5%85%A8%E8%87%AA%E5%8A%A8%E9%97%AD%E7%8E%AF%E5%AF%B9%E6%8E%A5%E8%A7%84%E8%8C%83%20%C2%B7%20Notion%20Agent%20%E2%86%94%20%E4%BA%BA%E6%A0%BC%E4%BD%93%20%E2%86%94%20GitHub%EF%BC%88202%20c057d868ff5945f88b24b9b798fb3a8f.md)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
> 📋 **霜砚整理 · 2026-03-13**
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
> Notion 侧的 ID 全部已查出，铸渊直接配。冰朔唯一可能要做的就是点一下 PR 合并按钮（如果铸渊没权限的话）。其他全部铸渊自己搞定。
|
|||
|
|
>
|