openfang/NEW_SESSION_PROMPT.md

# OpenFang 项目开发 - 新会话提示词

## 项目概述

OpenFang 是一个开源的 Agent 操作系统，使用 Rust 编写 (14 crates)。这是继续推进开发的提示词。

**关键文件**:
- 项目根目录: `c:\Users\szend\Downloads\openfang-main\openfang-main`
- 计划文件: `plans/radiant-yawning-raven.md` (完整分析和任务列表)
- 开发规则: `CLAUDE.md` (必须遵守的开发规则)

---

## 已完成的工作 (2026-03-01)

### 1. Agent Registry 持久化修复 ✅
- 在 `kernel.rs` 添加了 5 个包装方法: `set_agent_state`, `set_agent_mode`, `update_agent_identity`, `update_agent_name`, `update_agent_description`
- 更新了 `routes.rs` 调用 kernel 方法而非直接调用 registry
- 在 `registry.rs` 添加了 8 个测试用例

### 2. 知识图谱递归遍历实现 ✅
- 文件: `crates/openfang-memory/src/knowledge.rs`
- 实现了 BFS 迭代遍历算法
- 支持 `max_depth` 参数 (最大 10)
- 环路检测 (HashSet)
- 4 个新测试用例

### 3. AOL (Agent 编排语言) AST 类型定义 ✅
- 文件: `crates/openfang-types/src/aol.rs` (1074 行)
- 定义了 `AolWorkflow`, `AolStep`, `AgentRef`, `ErrorMode` 等类型
- 40+ 单元测试
- 已在 `lib.rs` 中导出

### 4. E2E 测试框架 ✅
- 文件: `tests/e2e_test.rs`, `tests/e2e_common.rs`, `tests/e2e_api_test.rs`, `tests/e2e_fixtures.rs`
- 测试工具: `spawn_daemon()`, `wait_for_health()`, `create_test_agent()`, `send_message()`
- 30+ 测试用例

### 5. 实时协作层 Migration v8 ✅
- 文件: `crates/openfang-memory/src/migration.rs`
- 新增表: `annotations`, `annotation_reactions`, `collab_sessions`, `presence_log`
- SCHEMA_VERSION: 7 → 8

### 6. CLAUDE.md 开发规则更新 ✅
- 添加了架构规则、持久化规则、API 开发规则、安全规则、测试规则、前端规则

### 7. 智谱 GLM-5 和百炼 Coding Plan 支持 ✅
- 在 `model_catalog.rs` 添加了 BAILIAN_BASE_URL
- 在 `drivers/mod.rs` 添加了百炼提供商支持

---

## 后续待实现任务

按优先级排序:

### 高优先级

1. **AOL 解析器实现** (2-3 天)
   - 文件: `crates/openfang-kernel/src/aol/parser.rs`
   - 实现 TOML → AST 解析
   - 模板变量展开

2. **AOL 执行引擎实现** (5 天)
   - 文件: `crates/openfang-kernel/src/aol_executor.rs`
   - DAG 构建与拓扑排序
   - 并行执行支持
   - 错误处理与重试

3. **验证构建和测试**
   - 运行 `cargo build --workspace --lib`
   - 运行 `cargo test --workspace`
   - 运行 `cargo clippy --workspace --all-targets -- -D warnings`

### 中优先级

4. **PresenceManager 实现** (3 天)
   - 文件: `crates/openfang-api/src/presence.rs`
   - 用户在线状态管理
   - WebSocket 协议扩展

5. **AnnotationStore 实现** (2 天)
   - 文件: `crates/openfang-api/src/annotation.rs`
   - 评论/批注 CRUD 操作
   - 反应系统

### 低优先级

6. **前端协作 UI 组件** (4 天)
   - 文件: `crates/openfang-api/static/js/collab.js`
   - Presence 指示器
   - 光标叠加层
   - 评论面板

7. **Agent 市场设计**
8. **联邦 Agent 网络**

---

## 开发规则摘要

### 持久化规则 (CRITICAL)
所有 Agent 修改操作必须同时更新内存和 SQLite:

```rust
// ✅ 正确: Kernel 层包装方法
pub fn set_agent_mode(&self, agent_id: AgentId, mode: AgentMode) -> KernelResult<()> {
    self.registry.set_mode(agent_id, mode)?;  // 内存
    if let Some(entry) = self.registry.get(agent_id) {
        let _ = self.memory.save_agent(&entry);  // SQLite
    }
    Ok(())
}

// ❌ 错误: 直接调用 registry (不持久化)
state.kernel.registry.set_mode(agent_id, mode)
```

### API 开发规则
- 新路由必须在 `server.rs` 和 `routes.rs` 两处注册
- 使用统一的错误/成功响应格式

### 配置字段规则
添加新配置字段需要:
1. 在 struct 中添加字段
2. 添加 `#[serde(default)]`
3. 在 `Default` impl 中添加默认值

---

## 关键文件路径

| 文件 | 用途 |
|------|------|
| `crates/openfang-kernel/src/kernel.rs` | 核心协调器 |
| `crates/openfang-kernel/src/registry.rs` | Agent 内存注册表 |
| `crates/openfang-memory/src/structured.rs` | Agent SQLite 持久化 |
| `crates/openfang-memory/src/knowledge.rs` | 知识图谱 (已实现递归遍历) |
| `crates/openfang-memory/src/migration.rs` | 数据库迁移 (v8) |
| `crates/openfang-api/src/server.rs` | HTTP 路由注册 |
| `crates/openfang-api/src/routes.rs` | HTTP 处理函数 |
| `crates/openfang-types/src/aol.rs` | AOL AST 类型 (新建) |
| `tests/e2e_*.rs` | E2E 测试框架 (新建) |
| `CLAUDE.md` | 开发规则 (已更新) |
| `plans/radiant-yawning-raven.md` | 完整计划文件 |

---

## 新会话启动提示

复制以下内容到新会话:

```
我正在继续开发 OpenFang 项目 (Rust Agent 操作系统)。

项目路径: c:\Users\szend\Downloads\openfang-main\openfang-main

请先阅读:
1. CLAUDE.md - 开发规则
2. plans/radiant-yawning-raven.md - 完整计划 (特别是附录 L: 实现完成记录)

已完成的工作:
- Agent Registry 持久化修复
- 知识图谱递归遍历实现
- AOL AST 类型定义 (aol.rs)
- E2E 测试框架
- Migration v8 (协作层表结构)
- CLAUDE.md 开发规则更新

待实现的任务 (按优先级):
1. AOL 解析器 (TOML → AST)
2. AOL 执行引擎
3. 验证构建和测试
4. PresenceManager 实现
5. AnnotationStore 实现

请继续推进后续开发工作。
```

---

## 当前日期
2026-03-01