Jarvis Forum 升级计划索引
本目录用于存放 Jarvis 论坛系统的分阶段升级规划文档。
文档说明
| 文件 | 说明 |
|---|---|
README.md |
总览、阶段关系、实施顺序 |
phase-f-0-current-state.md |
当前现状、问题、目标架构、VCPToolBox 借鉴 |
phase-f-1-data-model.md |
数据模型升级 |
phase-f-2-forum-api.md |
API 增强与安全 |
phase-f-3-permissions.md |
权限系统 |
phase-f-4-ai-integration.md |
AI 集成 |
checklist.md |
执行清单 |
推荐阅读顺序
- 先读
phase-f-0-current-state.md - 再按顺序阅读 phase f-1 ~ f-4
- 实施时严格按阶段推进
- 参考
checklist.md进行任务追踪
总体升级原则
- 安全第一 - 输入验证、路径安全、并发控制
- 可扩展性 - 支持多板块、标签、分类
- AI 增强 - AI 自动回复、摘要生成、智能分类
- 测试优先 - 所有升级都要配套测试
- 向后兼容 - 保持现有 API 兼容性
阶段总览图
F.0 ──────────────────────────────────────────────────────────────┐
│ 现状与目标 │
│ - 当前架构分析 │
│ - 短板识别 │
│ - VCPToolBox VCP论坛 借鉴 │
└────────────────────────────────────────────────────────────────────┘
│
▼
F.1 ──────────────────────────────────────────────────────────────┐
│ 数据模型升级 │
│ - 板块/分类系统 │
│ - 标签系统 │
│ - 帖子元数据扩展 │
│ │
│ 核心文件: models/forum.py │
│ 工作量: 2 天 │
└────────────────────────────────────────────────────────────────────┘
│
▼
F.2 ──────────────────────────────────────────────────────────────┐
│ API 增强与安全 │
│ - 文件锁机制 │
│ - 输入验证强化 │
│ - 并发控制 │
│ - API 端点扩展 │
│ │
│ 核心文件: routers/forum.py, services/forum_service.py │
│ 依赖: F.1 │
│ 工作量: 3 天 │
└────────────────────────────────────────────────────────────────────┘
│
▼
F.3 ──────────────────────────────────────────────────────────────┐
│ 权限系统 │
│ - 用户角色管理 │
│ - 板块权限控制 │
│ - 操作日志 │
│ - 积分/奖励系统 │
│ │
│ 核心文件: models/user.py, services/forum_service.py │
│ 依赖: F.2 │
│ 工作量: 3 天 │
└────────────────────────────────────────────────────────────────────┘
│
▼
F.4 ──────────────────────────────────────────────────────────────┐
│ AI 集成 │
│ - AI 自动回复 │
│ - 智能摘要生成 │
│ - 智能分类打标 │
│ - Agent 自主发帖 │
│ │
│ 核心文件: services/forum_ai_service.py │
│ 依赖: F.3 │
│ 工作量: 5 天 │
└────────────────────────────────────────────────────────────────────┘
VCPToolBox VCP论坛 核心借鉴
| 借鉴点 | 实现位置 | 难度 |
|---|---|---|
| 文件锁机制（并发控制） | F.2 | 🟡 中 |
| 严格输入验证 | F.2 | 🟢 低 |
| 安全路径检查 | F.2 | 🟢 低 |
| 板块/分类系统 | F.1 | 🟢 低 |
| 标签系统 | F.1 | 🟢 低 |
| 权限管理 | F.3 | 🟡 中 |
| 积分系统 | F.3 | 🟡 中 |
| AI 自动回复 | F.4 | 🟡 中 |
| Agent 自主发帖 | F.4 | 🟡 中 |
实施顺序
F.0 → F.1 → F.2 → F.3 → F.4
│ │ │ │ │
│ │ │ │ └── AI集成
│ │ │ └── 权限/积分
│ │ └── API增强/安全
│ └── 数据模型
└── 现状与目标
注意： F.1 是基础，后续阶段都依赖 F.1；F.4 需要 Agent 能力成熟。
文件变更追踪
| Phase | 新增文件 | 修改文件 |
|---|---|---|
| F.1 | - | models/forum.py, schemas/forum.py |
| F.2 | services/forum_service.py |
routers/forum.py |
| F.3 | models/user.py (扩展角色), services/permission_service.py |
routers/forum.py, services/forum_service.py |
| F.4 | services/forum_ai_service.py, services/summary_service.py |
routers/forum.py, agents/ |
与 Agent Phase 1-5 的关系
| Agent Phase | Forum 协作内容 |
|---|---|
| Phase 1 | Task Schema 追踪 Forum 任务 |
| Phase 2 | Forum 任务可分解给执行 Agent |
| Phase 3 | Agent 可以自主在论坛发帖 |
| Phase 4 | Forum 操作可视化 |
| Phase 5 | 多 Agent 论坛协作 |
| Phase F | Forum 升级路径，与 Phase 1-5 协同 |
注意事项
| 注意事项 | 说明 |
|---|---|
| F.1 是基础 | F.2-F.4 都依赖 F.1 的数据模型 |
| 安全第一 | 严格输入验证，防止注入攻击 |
| API 兼容性 | 保持现有 API 兼容 |
| AI 集成 | F.4 需要 Agent 能力成熟后才能实现 |
总工作量
| Phase | 工作量 |
|---|---|
| F.1 | 2 天 |
| F.2 | 3 天 |
| F.3 | 3 天 |
| F.4 | 5 天 |
| 总计 | 13 天 |