guanghulab/brain/age-os-landing/development-roadmap.md
Guanghu Domestic Migration d1e47f4565
Some checks are pending
自动更新代码和重启 / update-and-restart (push) Waiting to run
CI检查 + 自动部署 / check (push) Waiting to run
CI检查 + 自动部署 / deploy (push) Blocked by required conditions
重启聊天服务 / restart (push) Waiting to run
chore: import sanitized domestic snapshot for REPO-002
Source snapshot: ca48d3ddf926d79aa138306164169baf764bb829
2026-07-17 15:54:41 +08:00

346 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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主线开发