xt/agcore
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
144 Commits 2 Branches 6 Tags
b895616dd097349544e9174cd9f40907e6c9dcdc
Commit Graph

36 Commits

Author SHA1 Message Date
徐涛 b895616dd0 feat(llm): 实现 OpenAI Response API Provider
CI / test (chat,provider-openai) (push) Has been cancelled
CI / test (chat,provider-openai,provider-openai-response) (push) Has been cancelled
CI / test (chat,provider-openai,tools-mcp) (push) Has been cancelled
CI / test (full) (push) Has been cancelled
CI / test (light) (push) Has been cancelled
CI / test (multi,provider-openai,tools-mcp) (push) Has been cancelled
CI / clippy (push) Has been cancelled
CI / fmt (push) Has been cancelled
CI / examples (push) Has been cancelled
CI / test (multi,provider-openai) (push) Has been cancelled
- 新增独立 OpenaiResponseProvider（POST /responses 协议），独立 feature provider-openai-response
- 覆盖文本对话/流式/Vision/Function Calling/多轮接续/结构化输出/内置工具逃生舱
- 内置工具（web_search/file_search）通过 extra 逃生舱透传
- 工厂注册 ProviderType::OpenaiResponse + src/llm 模块门控追加
- 新增 example response_api_demo + CI 矩阵新增组合 + README/roadmap 同步
- 测试覆盖：13 单元 + 15 wiremock（流式 + 非流式 + 错误路径）
- 文档：docs/28-phase28-openai-response-api-provider.md
 2026-07-20 09:05:04 +08:00
徐涛 5baa170508 docs: 更新 README feature 表 + 升级指南 + 示例注释 + roadmap 同步 
- README 添加 feature 组合表 + 模块级 features 清单 + 升级指南
- 18 个 example 顶部添加 Required features 注释
- roadmap.md 和 roadmap-v0.3.2.md 同步 Phase 26-27 完成状态
- cargo fmt 全量格式化（修复预存格式问题，CI format job 可通过）
 2026-07-19 08:18:04 +08:00
徐涛 932a06f512 refactor(core): 完成 v0.3.2 Cargo features 拆分基础设施 
- 定义 16 个 features + 4 个快捷组合，default = ["full"] 保持向后兼容
- 12 个重型依赖 optional 化（tokio/reqwest/rusqlite 等）
- 全模块 #[cfg(feature)] 门控注入（llm/tools/memory/agent/engine）
- 将 LlmProvider trait 及关联类型移出 provider 模块归属 llm（ADR-1）
- 为 session.rs bundle() 方法添加 engine feature 门控
- 更新 12 个内部文件 + 4 个示例文件的 import 路径
- 向后兼容：provider.rs 保留 pub use 重导出老路径
 2026-07-19 07:58:04 +08:00
徐涛 7e72e102a2 feat(memory): 实现知识图谱与双通道检索 
- 新增 KnowledgeGraph trait + InMemoryGraph（BFS 图遍历 + 标签管理）
- 扩展 MemoryRetriever 为双通道检索（Hybrid/KnowledgeOnly/GraphOnly）
- 统一 RetrievalResult 为 RetrievalItem enum 变体
- GraphRelation 使用复合键 + composite_key() 派生 id
- 旧 ScoredItem 标注 #[deprecated]
- 新增 knowledge_graph_demo 示例
- 全量测试 427 passed，clippy/doc 0 警告
 2026-07-17 14:37:49 +08:00
徐涛 5bb349d177 docs(roadmap): 将 roadmap.md 拆分为按版本归档的多文件 
- 替换 docs/roadmap.md 为简短索引入口，列出 4 个子文件导航
- 新增 docs/roadmap-v0.1.0.md（Phase 0–4c + v0.1 Release）
- 新增 docs/roadmap-v0.2.0.md（Phase 5–12 + M1-M8 + v0.2.0-rc.1）
- 新增 docs/roadmap-v0.3.0.md（Phase 13–19 + M9-M15）
- 新增 docs/roadmap-unsorted.md（全局愿景/模块完整性/v0.4+ 展望/风险/下一步/已完成列表）
- 修复 docs/24-phase18-agent-switch-and-dispatch.md 中 2 处具体行号引用改为指向新文件

拆分原则：每个版本文件含目标/Phase/里程碑/依赖图四要素；
跨版本视图、阶段总回顾、未来展望集中于 unsorted
 2026-07-17 11:20:12 +08:00
徐涛 cb922b03de docs(roadmap): 标记 Phase 17 完成 + M13 里程碑达成 + 更新依赖图 
Phase 17 全部交付物已完成（2026-07-15）：
- 状态从 ⏳ 改为 ✅
- 增补实际增量（5 新增文件 + 5 修改 + 1 示例 = 1848 行净增）
- 列出 21 个新内联测试（Checkpointer 6 + SessionManager 15）
- 列举关键设计决策落地（SessionSnapshot 独立 / to_snapshot+from_snapshot+restore_memory
  三段式 / EngineError::Memory 透传 / RwLock 锁契约 / ckpt_id 纳秒+计数器 / 孤儿策略等）
- 记录实施后两轮审查门禁 PASS（第一轮 PM+SA 修复 6 🔴，第二轮 SA 修复 2 🔴，
  实施后 PM+SA+Code Reviewer 联合修复 8 个 🟡）

M13 里程碑达成 ✅ 2026-07-15（依赖图节点从 pending 改为 done）

Phase 17 rc.1 完成 → 下一步 Phase 18（Agent Switch + SubAgent Dispatch）
- 「下一步行动」重定向到 Phase 18
- 「里程碑追踪」更新为 M12+M13 已达成，剩余 M14-M15
- 已完成阶段列表追加 Phase 17 完成项（详细列出 11 个 SessionManager API +
  5 个 Checkpointer API + 关键实现细节 + 审查修复记录）
 2026-07-15 09:00:02 +08:00
徐涛 fbbf8bf6e5 docs(roadmap): 同步 Phase 17 方案审查后的交付物与里程碑定义 2026-07-15 06:52:05 +08:00
徐涛 cc1c68b69d feat(agent): 实现摘要自动生成（SummaryConfig + 内联检查点） 
SummaryConfig 6 字段配置（trigger_token_ratio / max_context_tokens /
summary_prompt / debounce_turns / summary_model / max_tool_result_chars），
AgentBuilder 链式 summary_config()；AgentSession 在 submit_turn /
finalize_turn 的 OnTurnEnd 之后内联检查点：水位 + 防抖（首次不受
约束）→ 独立 LlmCycle 调 submit_messages 生成摘要 → 写入
FocusedConfig.summary_override + slot.save() + SessionMemory 全局快照。

should_summarize 接收 current_turn 参数避免流式路径 turn_index 偏差；
format_messages_as_text 简洁版格式化含 30K 整体截断保留最新；空消息
守卫直接返回空串。所有错误静默 tracing::error!，成功路径
tracing::info!。

src/agent/summary.rs 新增 ~240 行；agent/session.rs +428 行（双路径
检查点 + 关联函数 + 测试 + 公开 API）。零新外部依赖。全量 335 → 353
测试（+18 新测试），clippy 0 警告，doc 0 warning。两轮审查 PASS——
第一轮 PM/SA 修复 11 项，第二轮 Code Reviewer 修复 9 项（含 🔴
generate_summary 空消息 bug + 🟡 5 项 + 💭 2 项）。方案文档 docs/
22-phase16-summary-auto-generation.md（471 行）；roadmap.md 标记
Phase 16 完成 + M12 里程碑达成。
 2026-07-10 06:43:06 +08:00
徐涛 209932e3b5 feat(docs): 标记 Phase 15 完成并更新 roadmap 状态 2026-07-09 22:46:29 +08:00
徐涛 b04427e83f docs(roadmap): 标记 Phase 14 完成 + M10 里程碑达成 
Phase 14 全部交付物已完成（commit d4c4d8f）：
- Document 类型 + RecursiveCharacterSplitter 分割器
- Embedding trait + MockEmbedding
- 19 Document 测试 + 6 Embedding 测试
- 全量测试 286 → 313，clippy 0 警告，零新外部依赖

Roadmap 同步 6 处：
- 顶部最后更新日期 + 当前状态（Phase 14 完成，Phase 15-19 待实施）
- §Phase 14 章节新增实际新增段落（commit hash + 文件清单 + 设计决策 + 测试覆盖）
- v0.3.0 依赖图 P14 节点 pending → done
- M10 里程碑 ⏳ → ✅ 2026-07-09
- 下一步行动从 Phase 14 启动改为 Phase 15 启动
- 已完成/进行中阶段列表追加 Phase 14 完成条目
 2026-07-09 13:27:36 +08:00
徐涛 4686063ca8 docs: 标记 Phase 13 完成 + 追加 v0.3.0 CHANGELOG 条目 
- CHANGELOG.md: 追加 v0.3.0 (unreleased) 条目
  - Breaking Changes: 类型路径变更（request.rs/response.rs → provider/openai.rs，
    公共 ToolChoice re-export 路径不变）+ ChatResponse / LegacyStreamEvent 删除
  - Added: ContextSlot::fork / merge + MergeStrategy 枚举（#[non_exhaustive]）
  - Changed: 3 个旧 types 文件删除 + 所有 wire-format 类型迁入 openai.rs
  - Fixed: Phase 9 实施审查修复（PreRequest hook + 死代码清理 + 2 个集成测试）
  - Migration Guide: v0.2.0-rc.1 → v0.3.0 路径迁移示例
  - 修复 M9 里程碑验收 #11（CHANGELOG 条目）和审查结论 CONDITIONAL PASS 条件清单 #1
- docs/roadmap.md:
  - 顶部最后更新日期 → 2026-07-08（Phase 13 完成 + M9 里程碑达成）
  - 末尾"v0.3.0 规划完成"状态行从"Phase 13-19 待逐步实施"更新为"Phase 13 完成，
    Phase 14-19 待实施（Document → 向量存储 → 摘要 → 引擎 → 调度 → 知识图谱）"
 2026-07-09 06:19:43 +08:00
徐涛 d4f27b5865 refactor(types): 删除旧类型文件和 ChatResponse 
- 删除 src/llm/types/old_stream.rs（45 行，LegacyStreamEvent 内部死代码）
- types/mod.rs 删除 pub mod old_stream; 与 ChatResponse 结构体定义
- 前置验证 A 通过：parse_chunk_stream / map_legacy_to_ir / LegacyToIrEventStream /
  ChunkToLegacyEventStream / LegacyStreamEvent 零外部调用方
- 前置验证 B 通过：cargo doc --no-deps 中无 ChatResponse 引用
- cycle.rs:88 的 #[allow(deprecated)] 保留（LlmCycle impl 中无 ChatResponse 引用，
  与 ChatResponse 无关；按方案文档"若不相关则无需改动"原则保留原状）
- stream.rs 已在 Step 13.2 commit 中同步简化为 module doc + pub use
- 同步更新 docs/roadmap.md：Phase 13 状态 ⏳→✅，M9 里程碑 + 完成日期，
  Mermaid 依赖图 P13 pending→done，"下一步"指向 Phase 14
- Breaking Change：agcore::llm::types::ChatResponse 已删除
  （v0.1.0 起标记 #[deprecated]，请改用 MessageResponse）
 2026-07-08 22:59:31 +08:00
徐涛 993118f661 docs(roadmap): 将 v0.3+ 展望更新为 v0.3.0 详细规划 
新增 Phase 13-19 共 7 个增量交付阶段，覆盖技术债清理、Document 系统、向量
存储持久化、摘要自动生成、Agent 执行引擎、Agent Switch 与 SubAgent 调度、
知识图谱及双通道检索。同步更新里程碑、依赖关系图及风险说明
 2026-07-06 23:10:18 +08:00
徐涛 0dc91faa43 docs(roadmap): 标记 Phase 11 测试与检索补强已完成 2026-07-06 15:30:52 +08:00
徐涛 2af92cd554 docs(roadmap): 标记 Phase 10 ContextSlot 上下文管理已完成 
- 顶部状态行更新：Phase 0-10 全部完成，11 个离线示例，254 测试
- Phase 10 状态：Step 10.1/10.2/10.3 全部标记 ✅
- 详细实际新增：agent/context.rs (~430 行) + agent/error.rs 3 个变体 +
  agent/session.rs 改造（slots 字段 + 5 个管理方法 + submit_turn/finalize_turn
  增量追加写回） + context_slot_demo 示例 + 43 个新测试
- finalize_turn 签名变更记录（new_messages_from_cycle 参数 + Result 返回）
- 依赖关系图 P10 节点标 ✅
- 里程碑 M6 → ✅ 2026-07-07
- 下一步行动：Phase 10 → Phase 11（测试与检索补强）
- 已完成阶段列表追加 Phase 10 完整说明
- 最后更新日期：2026-07-06 → 2026-07-07
 2026-07-06 09:53:44 +08:00
徐涛 fe51961202 docs(roadmap): 标记 Phase 9 流式体验增强已完成 
- 顶部「当前状态」「最后更新」同步到 Phase 0-9 完成
- Phase 9 Step 9.1 标记完成并新增「实际新增」段落
- Mermaid 依赖图 P9 节点 class 从 p1 切换为 done
- 里程碑 M5 标记 ✅ 2026-07-06
- 下一步行动与已完成列表同步更新（指向 Phase 10）
 2026-07-06 05:43:47 +08:00
徐涛 88d00ac927 docs(roadmap): 补充 Phase 8 修复 commit 85b92ae 与最终行数 
Phase 8 章节实际新增小节从 6 commits 改为 7 commits（含 docs(roadmap)
自身 + 实施后修复 commit 85b92ae），并同步行数：

- quick_start 57 → 60 行（追加 trailing newline + 错误处理改进）
- end_to_end 237 → 246 行（除零修复 + drop 注释 + EchoTool 一致化）
- 新增 docs(roadmap) commit 项（标记 Phase 8 + M4 里程碑）
- 新增 fix(examples) commit 项（6 项审查问题：1 🔴 + 2 🟡 + 3 💭）

'已完成 / 进行中阶段' 列表同步补充 Phase 8 行末的三方审查修复标注。
 2026-07-05 21:10:24 +08:00
徐涛 57b2fbaaed docs(roadmap): 标记 Phase 8 MVP 集成出口已完成，v0.2.0-rc.1 标签 
Phase 8 全部 Step 完成（8.1 API 稳定性扫尾 + 8.2 quick_start + 8.3
end_to_end），更新 roadmap 同步：

- 顶部「当前状态」补充 v0.2.0-rc.1 标签信息
- Phase 8 章节 3 个 Step 全标 ✅；新增「实际新增」6 commits 小节
- 依赖关系图 P8 节点 class 从 mvp 改为 done
- M4 里程碑标 ✅ 2026-07-05
- 「下一步行动」从 Phase 8 改为 Phase 9 + v0.2.0 正式版规划
- 「已完成 / 进行中阶段」列表追加 ✅ Phase 8
 2026-07-05 20:06:43 +08:00
徐涛 7574f9c24c docs(roadmap): 标记 Phase 7 SqliteStore 已完成 
更新当前状态描述、Phase 7 交付物详情、里程碑 M3 状态、依赖性图谱及下一步行动
 2026-07-05 17:25:32 +08:00
徐涛 821cea8e60 feat(docs): 更新 roadmap，标记 Phase 6 交付完成 
Phase 6 ToolDef IR 的 5 个子步骤全部标注已完成，新增实际变更摘要，更新里程碑状态及下一步行动计划
 2026-07-05 10:49:50 +08:00
徐涛 d3067e2f53 docs(roadmap): 更新 Phase 5 完成状态和下一阶段计划 2026-07-05 09:04:44 +08:00
徐涛 76f3235ed7 docs(roadmap): 更新 v0.2 规划为 8 个增量 Phase 并细化实施步骤 2026-07-04 10:32:24 +08:00
徐涛 fba78f5f33 docs(roadmap): 更新路线图为 v0.2 生产就绪规划 
同步 v0.1.0 发布状态，将 v0.2+ 扩展项重
组为 12 项基础功能和 ContextSlot 上下文管
理，明确 v0.3+ 展望及边界范围
 2026-07-04 08:11:09 +08:00
徐涛 8dcd1f2482 docs(v0.1): 同步 roadmap 并初始化 CHANGELOG 
- docs/roadmap.md：更新顶部状态至 v0.1 发布完成（182 测试 / 0 警告 / 7 离线示例），末尾追加 v0.1 发布里程碑章节
- CHANGELOG.md：按 Keep a Changelog 规范记录 0.1.0 的 Added / Changed / Deprecated / Fixed / Removed 及版本基线
 2026-07-04 06:54:13 +08:00
徐涛 ce1f1aaca0 feat(agent): 实现 Phase 4c 会话级记忆功能 
- 新增 `SessionMemory` 结构体，基于 `MemoryStore` 按 namespace 隔离键值数据
- `AgentBuilder` 增加 `session_memory_backend` 配置入口
- `RuntimeBundle` 透传 `session_memory_backend` 字段
- `AgentSession` 将内联 `HashMap` 替换为完整的 `SessionMemory`，`set_session_data` 和 `get_session_data` 改为异步方法
- 新增 3 个内联测试，全量测试从 113 增至 116，clippy 0 警告
 2026-06-11 22:14:15 +08:00
徐涛 4de7db0b2c docs(roadmap): 更新 Phase 4b 状态为已完成 2026-06-11 21:57:10 +08:00
徐涛 2b189880a9 feat(agent): 实现 Agent Runtime 核心胶水层 (Phase 4a) 
- 添加 Agent trait、AgentSession、RuntimeBundle、AgentBuilder
- 添加 Plan/Step/StepStatus 任务规划数据结构
- 添加 AgentError 统一错误类型（聚合 LlmError/ToolError/MemoryError）
- 实现 submit_turn 单轮对话流程（含 hook 触发与 cost 累计）
- 扩展 LlmCycle 支持 Arc<dyn LlmProvider>
- 扩展 HookEvent 添加 OnTurnStart/OnTurnEnd
- 更新 roadmap 状态
 2026-06-11 21:45:28 +08:00
徐涛 59ec0f5597 docs(roadmap): 将 Phase 4 拆分为 4a/4b/4c 三个独立子阶段 2026-06-10 22:38:32 +08:00
徐涛 be595a6771 docs(agent-runtime): 补充 SessionMemory 设计与多 context 切换备忘 
- 在方案文档中新增 `SessionMemory` 作为会话级记忆桥接组件
- 将 AgentSession 的 `agent_name: String` 改为 `agent: Arc<dyn Agent>`
- RuntimeBundle 新增 `session_memory_backend` 可选字段
- 新增 `docs/note-context-switch-design.md` 记录多 context 切换方案
- 更新 Roadmap 状态并补充 Phase 4 范围界定
- Phase 4 仅实现 SessionMemory 数据结构与 API，ContextManager 延后至 v0.2+
 2026-06-10 22:22:18 +08:00
徐涛 75f8736931 feat(docs): 添加 OpenCode 借鉴的 Agent 切换与 Prompt 动态扩展项 2026-06-10 08:35:56 +08:00
徐涛 63c50e1fc7 docs(roadmap): 补充 v0.2+ 扩展项与参考项目调研沉淀 2026-06-09 22:32:48 +08:00
徐涛 0c51bb78a6 docs(roadmap): 更新 Phase 3 记忆系统为已完成状态 2026-06-09 21:34:25 +08:00
徐涛 692bff5751 feat(docs): 更新路线图 Phase 2 工具系统完成状态 
将所有 Phase 2 待办项标记为已完成，更新当前状态和下一步行动
 2026-06-07 10:57:20 +08:00
徐涛 dd9c5be1fe docs(roadmap): 更新路线图至 Phase 1 完成状态 2026-06-03 09:00:44 +08:00
徐涛 ea1e5c7f7e docs(roadmap): 更新 Phase 0 状态标记为已完成 2026-06-02 09:00:46 +08:00
徐涛 69b6dd942b docs: 将方案文档从 specs 目录迁移至 docs 目录 2026-06-01 23:06:50 +08:00