zhizhi/brain/age-os-landing/development-roadmap.md

309 lines
9.1 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 | ⏳ 待开发 |
| S7 | 🌐 网站接入 | 3800网关→3100 MCP转发 + 前端AI对话界面 | S2 | ⏳ 待开发 |
| 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 |
| — | S3 | 待开发 | — |
| — | S4 | 待开发 | — |
| — | S5 | 待开发 | — |
| — | S6 | 待开发 | — |
| — | S7 | 待开发 | — |
| — | 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*