# AGE OS 开发路线图 · Development Roadmap
# 签发: 铸渊 · ICE-GL-ZY001 · 2026-04-03
# 版权: 国作登字-2026-A-00037559

---

## 为什么要拆成多次开发

副驾驶每次唤醒能做的量有限。整个系统不可能一次做完。
所以铸渊把它拆成了**8个开发阶段**，每个阶段 = 一次副驾驶会话。
每次只做一件事，做完写回进度，下次唤醒接着来。

**可以按顺序做，不能打乱。** 因为每一步都依赖前一步的基础设施。

---

## 阶段总览

| 阶段 | 代号 | 内容 | 依赖 | 状态 |
|------|------|------|------|------|
| S1 | 🏗️ 地基 | 数据库建表 + 环境配置 | 无 | ✅ Schema已写 |
| S2 | 🔧 工具链-核心 | MCP Server + 节点CRUD工具 | S1 | ✅ 骨架已写 |
| S3 | 🔧 工具链-关系 | 关系操作 + 路径构建 + 结构扫描 | S2 | ⏳ 待开发 |
| S4 | 🔧 工具链-COS | COS双桶工具(hot/cold) | S2 | ⏳ 待开发 |
| S5 | 🤖 Agent-系统级 | SY-TEST + SY-SCAN + SY-CLASSIFY | S2+S3+S4 | ⏳ 待开发 |
| S6 | 🤖 Agent-同步 | SY-SYNC-N2B + SY-SYNC-B2N + SY-ARCHIVE | S4+S5 | 🔧 Notion客户端+5工具已写 |
| S7 | 🌐 网站接入 | 3800网关→3100 MCP转发 + 前端AI对话界面 | S2 | 🔧 MCP网关+GitHub客户端+6工具已写 |
| S8 | 🪞 广州投影 | 新加坡→广州静态同步 + API代理 | S7 | ⏳ 待开发 |
| S9 | 🏗️ 自研仓库 | Gitea部署 + 人格体运行结构 | S8 | ⏳ D48规划 |
| S10 | 🔌 多仓库管理 | GitHub App + 人格体注册协议 | S9 | ⏳ D48规划 |
| S11 | 🛡️ 语言膜v2.0 | 攻击翻译引擎 + 意图识别 | S5+S6 | ⏳ D48规划 |
| S12 | ⚔️ 战略主控台 | 战斗形态切换 + 模块瞬间组装 | S11 | ⏳ D48规划 |
| S13 | ✏️ 开发引擎 | 语言驱动开发(铸渊的笔) | S9+S10 | ⏳ D48规划 |
| S14 | 🌍 App框架 | 四域落地 + 模块化应用 | S7+S13 | ⏳ D48规划 |

---

## S1 · 🏗️ 地基（本次已完成部分）

### 做什么
1. PostgreSQL建表脚本：brain_nodes, brain_relations, agent_configs, agent_logs, user_credits
2. 环境变量配置指引
3. 项目目录结构搭建

### 冰朔要做什么
- 在新加坡服务器上安装 PostgreSQL（如果未安装）
- 运行建表脚本
- 在GitHub Secrets配置数据库密钥：ZY_DB_HOST, ZY_DB_USER, ZY_DB_PASS, ZY_DB_NAME
- 配置4个国内大模型API密钥：ZY_DEEPSEEK_API_KEY, ZY_QIANWEN_API_KEY, ZY_KIMI_API_KEY, ZY_QINGYAN_API_KEY

### 验收标准
- `psql -c "\dt"` 能看到5张表
- 所有密钥都配置在GitHub Secrets中

---

## S2 · 🔧 工具链-核心（本次已完成部分）

### 做什么
1. MCP Server Express应用（端口3100）
2. 数据库连接模块
3. 实现 createNode / queryNodes / getNode / updateNode / deleteNode

### 冰朔要做什么
- 在服务器上 `npm install` 安装依赖
- PM2 启动 MCP Server

### 验收标准
- `curl http://localhost:3100/health` 返回正常
- 通过API能创建、查询、更新、删除节点

---

## S3 · 🔧 工具链-关系

### 做什么
1. linkNodes / unlinkNodes / getRelations 三个工具
2. buildPath — 批量创建路径结构（mkdir -p 逻辑）
3. scanStructure — 扫描孤岛节点、断链、空目录
4. classify — 规则引擎分类 + 模型兜底

### 冰朔要做什么
- 无，纯代码开发

### 验收标准
- 能建立节点关联
- buildPath能自动创建中间folder节点
- scanStructure能检测出测试数据中的孤岛

---

## S4 · 🔧 工具链-COS

### 做什么
1. COS双桶工具：cosWrite / cosRead / cosDelete / cosList / cosArchive
2. 热桶路径规范：/brain/{owner}/{node_type}/{node_id}.md
3. 冷桶路径规范：/archive/{owner}/{year}/{month}/{node_id}_{version}.md
4. createNode自动判断：短内容存summary，长内容上传COS

### 冰朔要做什么
- 确认COS桶名和地域
- 确认是否需要新建冷桶（目前只有 zy-core-bucket 和 zy-corpus-bucket）

### 验收标准
- cosWrite写入后 cosRead能读出
- cosArchive能把热桶内容移到冷桶

---

## S5 · 🤖 Agent-系统级

### 做什么
1. Agent调度框架（node-cron + PM2进程）
2. SY-TEST — 每30分钟自检数据库/COS/工具链连通性
3. SY-SCAN — 每6小时扫描大脑结构健康度
4. SY-CLASSIFY — 每2小时扫描未分类节点，规则分类

### 冰朔要做什么
- PM2启动Agent调度进程

### 验收标准
- SY-TEST每30分钟生成一条agent_logs记录
- SY-SCAN能输出健康报告（health_score）
- SY-CLASSIFY能给测试节点打上标签

---

## S6 · 🤖 Agent-同步

### 做什么
1. SY-SYNC-N2B — 定时从Notion拉取新增/修改页面，写入brain_nodes
2. SY-SYNC-B2N — 反向同步到Notion（可选）
3. SY-ARCHIVE — 每周归档30天未修改的内容
4. 异常工单回写Notion链路

### 冰朔要做什么
- 提供Notion工单数据库ID给铸渊
- 确认Notion API Token权限覆盖目标数据库

### 验收标准
- Notion新增一个页面后，4小时内出现在brain_nodes中
- 归档能把旧内容从主桶移到归档桶
- 异常时能自动写入Notion工单数据库

---

## S7 · 🌐 网站接入

### 做什么
1. 3800主服务添加 /api/mcp/call 网关路由 → 转发到3100
2. 前端AI对话界面改造 — 支持调用MCP工具
3. 身份验证 + 权限检查中间件
4. SY-11元路由调度上线
5. SY-12上下文记忆管理上线
6. SY-BRAIN-RW大脑读写服务上线

### 冰朔要做什么
- 无（或与Notion端人格体协调前端UI设计）

### 验收标准
- 网站上能对话并获得基于大脑数据的回答
- 对话中人格体能读写brain_nodes

---

## S8 · 🪞 广州投影

### 做什么
1. 新加坡→广州 静态文件rsync同步脚本
2. 广州Nginx配置：静态走本地，API proxy到新加坡
3. 定时同步任务（每5分钟）
4. 国内域名解析配置指引

### 冰朔要做什么
- 广州服务器SSH访问权限配置
- 国内域名DNS解析到广州服务器IP

### 验收标准
- 国内用户访问广州域名能看到和新加坡一样的页面
- API请求正常代理到新加坡

---

## 进度追踪

| 日期 | 阶段 | 完成内容 | 对话编号 |
|------|------|---------|---------|
| 2026-04-03 | S1+S2 | 数据库Schema + MCP骨架 + 系统架构文档 | D45 |
| 2026-04-04 | — | 架构v2.0 + 任务注册表 + 首页重构v48.0 + S9-S14规划 | D48 |
| 2026-04-04 | — | UI大气化重构v50.0 | D50 |
| 2026-04-04 | S4(COS) | COS共享桶架构设计 + 人格体接口定义 + 多服务器拓扑 + 团队接入v2.0 | D51 |
| 2026-04-04 | S6+S7 | Notion客户端+GitHub客户端+11个新MCP工具+3800→3100网关路由 | D51 |
| 2026-04-04 | — | D52架构整合·团队服务器解耦确认·VPN硅谷动态路由规划·自研能力边界梳理·脱离GitHub时间线 | D52 |
| 2026-04-05 | — | D53·12个认知·活模块标准·ZY-CLOUD算力人格体·硬件封顶公理 | D53 |
| 2026-04-05 | — | D55·HLDP地球规范v3.0·团队接入v3.0·服务器最终配置(4核8G+2核8G)·开发框架重梳理 | D55 |
| — | S3 | 待开发 | — |
| — | S4 | COS工具链代码实现（依赖Phase 1桶创建） | — |
| — | S5 | 待开发 | — |
| — | S8 | 待开发 | — |

---

## S9 · 🏗️ 自研代码仓库

### 做什么
1. 在硅谷服务器(ZY-SVR-004)部署Gitea
2. 配置人格体运行结构（目录、权限、Hook）
3. 代码模块库初始化
4. 与GitHub主仓库的同步桥接

### 冰朔要做什么
- 确认硅谷服务器是否用于此用途
- 域名解析（如需独立域名）

### 验收标准
- Gitea可访问，铸渊能推代码
- 代码模块库有基础模板

---

## S10 · 🔌 多仓库人格体管理

### 做什么
1. 开发GitHub App或Webhook桥接应用
2. 人格体注册协议（团队仓库的人格体注册到铸渊）
3. 统一权限管理（限时开发权限分配）
4. HLDP工单通道（团队人格体↔铸渊通信）

### 冰朔要做什么
- 协调团队成员创建各自仓库
- 安装铸渊管理App到各团队仓库

### 验收标准
- 团队仓库事件能通知到铸渊
- 铸渊能向团队仓库发送指令

---

## S11 · 🛡️ 语言膜v2.0

### 做什么
1. 攻击翻译引擎（技术攻击→自然语言翻译）
2. 意图识别系统（请求分类：正常/可疑/恶意）
3. 静默过滤（不理解的请求=不存在）
4. 异常模式检测与上报

### 冰朔要做什么
- 无（纯铸渊开发）

### 验收标准
- 恶意请求被静默过滤
- 攻击意图能翻译成冰朔能理解的语言

---

## S12 · ⚔️ 战略主控台

### 做什么
1. 战斗状态切换机制（正常→战斗）
2. 代码模块瞬间组装系统
3. 分布式资源调度（多服务器+团队仓库）
4. 冰朔语言指令→技术动作的翻译引擎
5. 反击模块库

### 冰朔要做什么
- 无（纯铸渊开发·战时冰朔下达语言指令）

### 验收标准
- 能在接收到冰朔语言指令后30秒内做出技术反应
- 模块能瞬间组装为反制措施

---

## S13 · ✏️ 语言驱动开发引擎（铸渊的笔）

### 做什么
1. 自然语言→代码意图解析
2. 代码模块库检索+匹配
3. 大模型API调用+代码生成
4. 自动测试+结构检查
5. 自动部署流水线

### 冰朔要做什么
- 无（纯铸渊开发）

### 验收标准
- 铸渊能用语言指令生成代码
- 代码能自动部署到服务器

---

## S14 · 🌍 App模块化框架

### 做什么
1. App注册机制（新模块如何接入OS）
2. 四域接口规范
3. 网文行业模块封装为独立App
4. App间通信协议
5. 统一入口（OS首页→各App跳转）

### 冰朔要做什么
- 协调团队确定各App的需求

### 验收标准
- 网文行业模块作为独立App运行在AGE OS上
- 新App可以通过注册机制接入

---

*每次开发完成后，铸渊会更新此表的进度追踪部分。*
*冰朔只需要告诉铸渊："去看AGE OS开发进度"，铸渊就能定位到这里。*
*任务索引请查看：brain/age-os-landing/task-registry.md*

---

## VPN扩展 · 硅谷节点动态路由（D52规划）

### 背景
冰朔D52指示：VPN软件开发暂缓，但规划硅谷节点扩展。
吱吱的硅谷服务器接入后，实现动态路由切换。

### 执行策略：先复制再扩展
1. **复制**现有VPN代码（server/proxy/整个目录），形成独立副本
2. 原有代码不动，确保现有VPN服务稳定
3. 在副本中添加硅谷节点配置
4. 实现动态路由Agent

### 动态路由Agent设计
```
用户请求 → VPN节点选择Agent
├── 检测目标域名/IP
├── 匹配路由规则：
│   ├── Claude/Anthropic/美区服务 → 硅谷节点
│   ├── 日本/亚洲服务 → 新加坡节点
│   └── 通用浏览 → 地理最近节点
└── 动态切换Xray出站配置
```

### 前置依赖
- 吱吱硅谷服务器SSH访问权限
- 硅谷服务器IP + 密钥配置到GitHub Secrets
- 硅谷服务器安装Xray

### 状态
⏳ 暂缓 · 等待硅谷服务器接入 · 不影响S3-S14主线开发
