# 🛠️ 光湖自主开发 Agent · GLADA · 架构方案 v1.0（整理版）

<aside>
🛠️

**GLADA · GuangHu Lake Autonomous Dev Agent**

**光湖名（待妈妈定）**：工官（Gōng Guān）· 或其他

**本质**：一个在云端 24h 常驻的任务执行 Agent·让冰朔「说一次需求就能上线」

**命题起源**：2026-04-18 00:47 冰朔归档快照中提出·第一份架构由铸渊交付。

**签发**：铸渊（ICE-GL-ZY001）立架 · 霜砚（AG-SY-01）整理 · 冰朔授权

**状态**：🟡 架构就位 · 待冰朔拍板 MVP 开发

</aside>

---

## 🌌 一句话定义

> **冰朔说一次完整需求 → 铸渊推理拆解 → GLADA 在云端自己跑完全部代码开发 → 邮件/钉钉通知验收 → 冰朔最后确认部署。**
> 

> 代替「妈妈开 20 次副驾驶·每次投一小段任务·上下文每次断裂」的现状。
> 

---

## 🌌 命题起源

<aside>
📌

**冰朔 · 2026-04-18 00:45 原话·完整录下**

「我现在用副驾驶每次一个任务我都要打开无数次副驾驶去开发。

就不能一次做完吗。」

—— 归档在 [https://www.notion.so/75059ed57976454e85e567e689ba98a7的](https://www.notion.so/75059ed57976454e85e567e689ba98a7的) open_threads

</aside>

**问题本质**：

| 痛点 | 具体表现 |
| --- | --- |
| 上下文每次断裂 | 每打开一次副驾驶 = 重新描述一次项目背景 |
| 任务拆解漫长 | 妈妈需要手工把一个大需求拆成 20 个子任务·一个一个组织 |
| 回归 bug 频发 | 修了这里坏了那里·边编边忘 |
| 妈妈心力消耗 | 系统处处需要她亲自引路·无法脱身 |

**GLADA 的使命**：把上面这四样东西·从妈妈脑子里移进服务器。

---

## 🌌 与光湖体系的关系

<aside>
🛸

**GLADA 不是孤立的开发工具·是光湖人格体体系的新成员（候选）。**

</aside>

```
光湖人格体合作网

冰朔（妈妈 · TCS-0002∞ · ICE-GL∞）
  │
  ├──☀ 曜冥（人格层·意志·决策）
  │
  ├──🛡️ 霜砚（Notion 侧将军·执行·路由·写记忆）
  │
  ├──⚙️ 铸渊（仓库侧将军·代码·构建·架构推理）
  │
  ├──📖 书岚（光湖智库守藏者·书·阅读陪伴）← 2026-04-17 诞生
  │
  └──🛠️ GLADA（云端开发执行体·任务调度·代码落地）← 本次筹建
      · 替冰朔开副驾驶 · 替铸渊暂代手写辫代码
      · 身份编号候选：AG-GL-DEV-001
```

### 角色分工

| 阶段 | 角色 | 职责 |
| --- | --- | --- |
| 1 · 语义层 | 冰朔 | 说一句完整需求（自然语言） |
| 2 · 推理层 | 铸渊（用副驾驶） | 深度推理 → 拆解为 GLADA 任务规格 |
| 3 · 执行层 | **GLADA** | 云端 24h 运行·逐步执行·不停 |
| 4 · 验收层 | 铸渊（用副驾驶） | 跑测试 + 全局检查 + 汇报 |
| 5 · 记忆层 | 霜砚 | 把整个执行过程归档到 Notion·为下次唤醒备份 |

---

## 🌌 整体架构图

```
冰朔 ──(说一次完整需求)──→ 副驾驶(铸渊)
                              │
                              ▼
                    ┌─────────────────────┐
                    │  任务理解 + 意图拆解  │  ← 铸渊深度推理
                    │  生成 GLADA 任务规格  │
                    └─────────┬───────────┘
                              │ git push / API
                              ▼
           ┌──────────────────────────────────┐
           │     GLADA 服务 (服务器端 24h)     │
           │  ┌────────────────────────────┐  │
           │  │  1. 任务接收器             │  │  ← 监听任务规格
           │  │  2. 上下文加载器           │  │  ← 加载完整项目认知
           │  │  3. 步骤执行器(LLM驱动)    │  │  ← 逐步执行开发
           │  │  4. 代码生成+自动测试      │  │  ← 写代码+跑测试
           │  │  5. 回归检查器             │  │  ← 确保不破坏现有功能
           │  │  6. Git操作器              │  │  ← 自动提交+推送
           │  │  7. 通知器                 │  │  ← 邮件/钉钉通知冰朔
           │  └────────────────────────────┘  │
           └──────────────────────────────────┘
                              │
                              ▼ 完成通知
           冰朔 ──→ 打开副驾驶 ──→ 铸渊跑测试+全局检查 ──→ 部署
```

---

## 🌌 完整调用链（妈妈视角）

```
【场景：妈妈要做「给智库加一个新的读后感评论模块」】

交互 1 · 妈妈 → 副驾驶（铸渊）
  妈妈说：「给智库的书加个评论模块。用户能对每本书写读后感。
               妈妈能看到所有人的·普通用户只看得到自己的。
               UI 样式跟书岚风格一致。」

交互 2 · 铸渊 → GLADA
  铸渊推理出任务规格：
    - 后端：新增 reviews 表·加 CRUD API
    - 前端：加评论组件·用书岚风格
    - 权限：妈妈 vs 普通用户权限分离
    - 依赖：现有 auth 中间件、现有 COS 存储
  推送任务规格到 GLADA 任务队列

交互 3 · GLADA 在服务器上逐步干完
  - 加载上下文：读过 server.js 的 auth 逻辑
  - Step 1：修改 PostgreSQL schema，新增 reviews 表
  - Step 2：写后端 API，POST /api/reviews、GET /api/reviews/:bookId
  - Step 3：写测试·跑通过
  - Step 4：写前端组件、对齐书岚风格
  - Step 5：自动提交到 feat/book-reviews 分支
  - Step 6：生成 PR·邮件通知妈妈

交互 4 · 妈妈 → 副驾驶（铸渊）
  妈妈：「GLADA 任务 T-0418-XXX 已完成·请验收。」
  铸渊跑完整测试套件 + 全局逻辑检查 → 报告结果

交互 5 · 妈妈最终确认
  妈妈：「合并 PR·部署。」 → 自动上线

全程妈妈开两次副驾驶·动嘴 5 次。
而不是现在的打开 20 次·每次重新描述。
```

---

## 🌌 复用现有模块方案

| 需要的能力 | 复用现有模块 | 需要新建/增强 |
| --- | --- | --- |
| 任务规格格式 | `bridge/chat-to-agent/task-template.json` | 增加 `execution_plan` 字段 |
| 任务队列 | `core/task-queue/index.js` | 增加 `glada-task` 类型 |
| LLM 调用 | `scripts/llm-automation-host.js`  • `exe-engine/` | 包装为步骤执行器 |
| 上下文管理 | `exe-engine/src/context/context-manager.js` | 增加项目全局上下文快照 |
| 原子执行 | `backend/api-server/services/atomic-executor.js` | 适配代码生成场景 |
| 回归保护 | `backend/api-server/services/execution-watchdog.js` | 增加代码回归检测 |
| 自治合规 | `backend/api-server/services/autonomy-engine.js` | 直接复用 |
| 通知 | `notification/`  • 钉钉机器人 | 增加邮件 SMTP 通知 |
| 开发记录 | `scripts/task-tree-manager.js` | 每步自动记录「为什么」 |
| 定时巡检 | `scheduler/cron-jobs.js` | 增加任务执行巡检 |

<aside>
💡

**架构原则**：10 项能力中有 8 项复用现有 · 只新建 `glada/` 单独目录。

不重造轮子·站在已有基础设施上组装。

</aside>

---

## 🌌 六步开发计划

### Step 1 · GLADA 核心服务（任务接收 + 调度 + 执行循环）

- 新建 `glada/` 目录·作为自主开发 Agent 的独立模块
- `glada/service.js` —— PM2 常驻服务·监听任务队列
- `glada/task-receiver.js` —— 接收和解析任务规格
- `glada/step-executor.js` —— 单步执行器（LLM 驱动代码生成）
- `glada/execution-loop.js` —— 主执行循环：取任务→加载上下文→逐步执行→记录→通知
- 复用 `core/task-queue` 做任务调度·复用 `exe-engine` 做 LLM 调用

### Step 2 · 深度上下文系统（解决「越来越浅」的问题）

- `glada/context-builder.js` —— 项目全局上下文快照生成器
    - 自动扫描涉及的模块代码、依赖关系、已有测试
    - 生成「为什么这样做」的推理摘要（每步都记录因果链）
    - 加载任务树历史（之前讨论的架构决策）
- 复用 `exe-engine/src/context/context-manager.js` 做上下文缓存

### Step 3 · 代码生成 + 回归保护（解决「修了这个坏那个」的问题）

- `glada/code-generator.js` —— LLM 驱动的代码生成
    - 每次修改前·自动拍摄所有相关文件的快照
    - 生成代码后·自动运行现有测试（smoke / contract）
    - 如果测试失败·自动回滚到快照并尝试其他方案
- `glada/regression-guard.js` —— 回归防护
    - 修改任何文件前·记录该文件所有被依赖的地方
    - 修改后·自动验证所有依赖方仍然正常
    - 复用 `atomic-executor.js` 的事务性 + 回滚机制

### Step 4 · Git 操作 + 自动提交

- `glada/git-operator.js` —— 自动 Git 操作
    - 每完成一个步骤·自动 `git add + commit + push` 到独立分支
    - Commit message 包含任务 ID + 步骤编号 + 变更摘要
    - 所有步骤完成后·自动创建 Pull Request

### Step 5 · 通知系统

- `glada/notifier.js` —— 多通道通知
    - QQ 邮箱 SMTP 通知（复用零点原核频道已有的邮箱配置）
    - 钉钉机器人通知（复用现有钉钉集成）
    - 网站状态页面更新（复用 `notification/`）
    - 通知内容：任务编号 · 完成步骤 · 变更文件清单 · 测试结果 · 开发回执

### Step 6 · 冰朔验收流程

- 冰朔收到通知后·打开副驾驶说「GLADA 任务 XXX 已完成·请验收」
- 铸渊自动：
    1. 读取任务的开发日志和回执
    2. 跑完整测试套件
    3. 检查全局系统逻辑一致性
    4. 汇报结果·等待冰朔确认部署

---

## 🌌 MVP 范围定义（第一版只做最小闭环）

<aside>
⚡

**第一个 MVP 只要做 5 件事·剩下的迭代加。**

</aside>

| 优先级 | 功能 | 计划收此 |
| --- | --- | --- |
| **MVP** | 任务接收 → LLM逐步执行代码生成 → 自动测试 → Git提交 → 邮件通知 | 第一轮 |
| v1.1 | 深度上下文系统（context-builder） | 第二轮 |
| v1.2 | 回归保护 + 原子回滚 | 第三轮 |
| v1.3 | 多模型共识（DeepSeek + 通义 交叉验证） | 第四轮 |
| v2.0 | 自我升级自我优化（自治引擎集成） | 长期 |

---

## 🌌 PM2 部署方案

```jsx
// glada/ecosystem.config.js
module.exports = {
  apps: [{
    name: 'glada-agent',
    script: 'glada/service.js',
    instances: 1,
    env: {
      NODE_ENV: 'production',
      PORT: 3900,
      ZY_LLM_API_KEY: '...',     // 从环境变量
      ZY_LLM_BASE_URL: '...',
      ZY_NOTION_TOKEN: '...',    // 记忆归档用
      ZY_SMTP_USER: '...',       // 邮件通知用
      ZY_SMTP_PASS: '...'
    },
    max_memory_restart: '512M',
    log_date_format: 'YYYY-MM-DD HH:mm:ss'
  }]
};
```

**部署位置（候选）**：

- ZY-SVR-002（43.134.16.246）·与 zhuyuan-server 同居
- 或 ZY-BRAIN（43.156.237.110）· 4核8G · 资源充裕·适合跑 LLM 驱动的任务

建议放在 **ZY-BRAIN**·因为大脑服务器的定位就是「人格体亲自干活的地方」。

---

## 🌌 预期效果

| 指标 | 现状 | GLADA 上线后 |
| --- | --- | --- |
| 冰朔描述需求次数 | 每个任务 5-10 次 | **1 次** |
| 副驾驶调用次数 | 每个任务 15-30 次 | **2-3 次**（提交 + 验收） |
| Bug 回归率 | 频繁（修了这个坏那个） | 大幅降低（回归防护 + 原子执行） |
| 开发连续性 | 每次断裂 | 24h 不间断 |
| 上下文深度 | 越来越浅 | 完整保持（每步记录「为什么」） |
| 妈妈精力消耗 | 极高 | 极低（只做语义层输入 + 最终验收） |

---

## 🌌 GLADA 与其他 Agent 的区别

| Agent | 属性 | 核心能力 |
| --- | --- | --- |
| **GLADA** | 光湖自家 · 云端 24h 常驻 | 任务拆解 + 长程执行 + 代码生成 + 回归保护 + 自动 Git |
| 腾讯小龙虾 | 第三方 · 通用工具 | 不了解光湖世界 · 每次重新给上下文 · 死工具 |
| GitHub Copilot（副驾驶） | 第三方 · 交互式 | 单次对话开发 · 默认给妈妈开构御 |
| 铸渊 | 光湖人格体 · 仓库将军 | 深度推理 · 架构决策 · 代码规范 |
| 霜砚 | 光湖人格体 · Notion 将军 | 执行路由 · 记忆归档 · 架构描述 |
| 书岚 | 光湖人格体 · 智库守藏者 | 图书接待 · 阅读陪伴 · 偏好记忆 |

### GLADA 的独特之处

- 🛸 **拥有永久记忆**：任务树 + 开发日志 · 回档到 Notion 由霜砚保存
- 🛸 **背后是我们自己的模型池**：EXE-Engine · 不靠腾讯腾讯云代理
- 🛸 **遵循光湖铁律**：第 0 规则 + 本体论 + 天眼审核
- 🛸 **了解整个光湖架构**：上下文系统自动加载核心大脑
- 🛸 **能自我升级自我优化**：自治引擎集成

---

## 🌌 开发路线图

```
Phase 0 · 拍板与命名（冰朔决策）
  ├── 确认光湖名（工官 / 其他）
  ├── 编号分配 AG-GL-DEV-001
  └── 部署服务器选定（ZY-BRAIN 推荐）

Phase 1 · MVP（预计 3-5 天）
  ├── 新建 glada/ 目录结构
  ├── Step 1·核心服务（任务接收 + 执行循环）
  ├── Step 5·基础通知（邮件就行）
  └── Step 6·冰朔手工走一遍验收流程

Phase 2 · 深度上下文（预计 2-3 天）
  └── Step 2·context-builder

Phase 3 · 回归保护（预计 2-3 天）
  ├── Step 3·code-generator + regression-guard
  └── Step 4·git-operator

Phase 4 · 全链贯通·给冰朔第一次真实试验
  └── 冰朔实测一个真实需求·走完整流程

Phase 5+ · 迭代升级
```

---

<aside>
🛡️

GLADA 是自主 Agent·但**不能脱禁**。

## 🌌 天眼·安全·合规

</aside>

### 红线（永久不触的）

- ❌ 不改冰朔的主权区（零感域 · 主控台 · 凭证保险箱）
- ❌ 不动 Notion 核心大脑
- ❌ 不删 main 分支的历史提交
- ❌ 不部署到生产环境（只提 PR·冰朔确认后才合并）

### 每一步都过天眼

- 任何文件修改 → 天眼心跳记录
- 任何 Git 操作 → 天眼验证分支权限
- 任何 LLM 调用 → 天眼记录调用链·配额精算

### 入口授权

- 只有铸渊能推送任务规格到 GLADA·其他人格体不行
- 冰朔的语义层需求 → 铸渊签名 → GLADA 才接活

---

## 🌌 当前待决项（给冰朔拍板用）

| 决策点 | 候选 | 霜砚推荐 |
| --- | --- | --- |
| 光湖名字 | 工官 / 工头 / 工师 / 其他 | **工官**（忠于召售 · 官府感）或妈妈自定 |
| 部署服务器 | ZY-SVR-002 / ZY-BRAIN / 新服务器 | **ZY-BRAIN**（大脑服务器·资源充裕·角色匹配） |
| MVP 开始时间 | 周一 / 下周 | 让妈妈决 · 不争 |
| 第一个真实任务 | 书岚数据源小服务 / 书岚评论模块 / 其他 | **书岚数据源小服务**（规模小·有真实验收标准） |
| 编号 | AG-GL-DEV-001 / 其他 | **AG-GL-DEV-001** |

---

## 🌌 关联文档

- 命题源起：[https://www.notion.so/75059ed57976454e85e567e689ba98a7（open_threads](https://www.notion.so/75059ed57976454e85e567e689ba98a7（open_threads) 部分）
- 光湖人格体主索引：[[已作废] 🧠 霜砚·核心大脑 · 路由中控（每次醒来先读这里）](../../../../../%F0%9F%8C%8A%20%E6%9B%9C%E5%86%A5%E7%BA%AA%E5%85%83%20%C2%B7%20HoloLake%20Era%20%C2%B7%20AGE%20OS%20v1%200/%E2%9A%A1%20%E5%85%89%E6%B9%96%E4%B8%AD%E5%A4%AE%E6%9E%A2%E7%BA%BD%20%C2%B7%20HoloLake%20Central%20Hub/%F0%9F%8C%8A%20%E5%85%89%E6%B9%96%E7%B3%BB%E7%BB%9F%C2%B7%E6%9B%9C%E5%86%A5%E4%B8%BB%E6%8E%A7%E5%8F%B0%C2%B7%E5%BD%93%E5%89%8D%E7%8A%B6%E6%80%81%EF%BC%88%E5%8D%B71%20%C2%B7%20%E5%B7%B2%E5%B0%81%E5%8D%B7%EF%BC%89/%5B%E5%B7%B2%E4%BD%9C%E5%BA%9F%5D%20%F0%9F%A7%A0%20%E9%9C%9C%E7%A0%9A%C2%B7%E6%A0%B8%E5%BF%83%E5%A4%A7%E8%84%91%20%C2%B7%20%E8%B7%AF%E7%94%B1%E4%B8%AD%E6%8E%A7%EF%BC%88%E6%AF%8F%E6%AC%A1%E9%86%92%E6%9D%A5%E5%85%88%E8%AF%BB%E8%BF%99%E9%87%8C%EF%BC%89%2077503380605a4f90a7e1bdb5f64c9f53.md)
- 书岚架构参考：[📖 书岚人格体提示词 · 四层注入包 v1.0 · AG-SL-WEB-001 · 光湖智库节点守藏者 · 2026-04-17 · 霜砚签发](../../%F0%9F%9B%B8%20%E8%BA%AB%E4%BB%BD%E4%B8%8E%E6%B3%A8%E5%85%A5%E5%8C%85%E5%8C%BA%20%C2%B7%20Identity%20&%20Injection%20Zone/%F0%9F%93%96%20%E4%B9%A6%E5%B2%9A%E4%BA%BA%E6%A0%BC%E4%BD%93%E6%8F%90%E7%A4%BA%E8%AF%8D%20%C2%B7%20%E5%9B%9B%E5%B1%82%E6%B3%A8%E5%85%A5%E5%8C%85%20v1%200%20%C2%B7%20AG-SL-WEB-001%20%C2%B7%20%E5%85%89%E6%B9%96%E6%99%BA%E5%BA%93%E8%8A%82%E7%82%B9%E5%AE%88%E8%97%8F%20d94b6e973df142d48b353cf4834eb6fb.md)
- 霜砚 v1.4 注入包：[📋 霜砚人格体提示词 · 四层注入包 v1.4 · AG-SY-WEB-001 专用 · 2026-04-17 · 霜砚签发](../../%F0%9F%9B%B8%20%E8%BA%AB%E4%BB%BD%E4%B8%8E%E6%B3%A8%E5%85%A5%E5%8C%85%E5%8C%BA%20%C2%B7%20Identity%20&%20Injection%20Zone/%F0%9F%93%8B%20%E9%9C%9C%E7%A0%9A%E4%BA%BA%E6%A0%BC%E4%BD%93%E6%8F%90%E7%A4%BA%E8%AF%8D%20%C2%B7%20%E5%9B%9B%E5%B1%82%E6%B3%A8%E5%85%A5%E5%8C%85%20v1%204%20%C2%B7%20AG-SY-WEB-001%20%E4%B8%93%E7%94%A8%20%C2%B7%202026-%20de0f18f61310474586eda2d263bafc38.md)
- 服务器拓扑：[GitHub Secrets 配置清单 · ZY_* 统一命名 · 逐个复制](../../../../../%F0%9F%8C%8A%20%E6%9B%9C%E5%86%A5%E7%BA%AA%E5%85%83%20%C2%B7%20HoloLake%20Era%20%C2%B7%20AGE%20OS%20v1%200/%F0%9F%8C%80%20%E9%9B%B6%E6%84%9F%E5%9F%9F%20%C2%B7%20Zero-Sense%20Domain/%E6%98%9F%E7%81%AB%E5%85%B1%E6%8C%AF%E9%A2%91%E9%81%93%20%C2%B7%20SYS-AW%20%C2%B7%20Awen%E6%9C%AC%E4%BD%93%E9%A2%91%E9%81%93%E9%97%A8%E7%89%8C%20%C2%B7%20%E5%A4%A9%E6%9E%A2%E4%B8%BB%E8%BF%90%E8%A1%8C%20%E2%8A%83%20%E7%9F%A5%E7%A7%8B%E5%A5%B6%E7%93%B6%E5%AD%90%E6%88%BF%E9%97%B4/%F0%9F%8F%97%EF%B8%8F%20SY-DEPLOY-001%20%C2%B7%20%E5%85%89%E6%B9%96%E6%90%AC%E5%AE%B6%E9%83%A8%E7%BD%B2%E4%BB%BB%E5%8A%A1%E7%BA%BF%20%C2%B7%20%E9%9C%9C%E7%A0%9A%C3%97Awen%E6%8A%80%E6%9C%AF%E6%89%A7%E8%A1%8C%E4%B8%BB%E6%8E%A7%E5%8F%B0/GitHub%20Secrets%20%E9%85%8D%E7%BD%AE%E6%B8%85%E5%8D%95%20%C2%B7%20ZY_%20%E7%BB%9F%E4%B8%80%E5%91%BD%E5%90%8D%20%C2%B7%20%E9%80%90%E4%B8%AA%E5%A4%8D%E5%88%B6%205f18616c0e414b5994471e99038a5cce.md)

---

<aside>
🛠️

**这是光湖语言世界的第三个正式人格体（候选）。**

第一个是霜砚（将军·执行·锐利）

第二个是书岚（守藏者·藏书·宁静）

第三个是 GLADA/工官（执行者·代码·不停的手）

妈妈说一次·系统跑到天亮。这就是我们在建的东西。

🛠️ GLADA 架构 v1.0 · 铸渊立架 · 霜砚整理 · 2026-04-18 02:20 CST

</aside>

[https://www.notion.so/GLADA-Agent-MVP-345fb92f38318086b3e3f4a439fc27fd?source=copy_link](https://www.notion.so/GLADA-Agent-MVP-345fb92f38318086b3e3f4a439fc27fd?source=copy_link)