xt/agcore
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
75 Commits 2 Branches 6 Tags
release/v0.1
Commit Graph

75 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
徐涛 3c1a3ee62e docs: 修正 v0.1 release URL 到实际 remote 
CHANGELOG.md:91 的对比链接从 github.com/anomalyco/agcore
改为实际 remote git.archgrid.xyz/xt/agcore（Gitea 1.26.1），
避免 tag 发布后 CHANGELOG 链接 404
v0.1.0 		2026-07-04 07:07:01 +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
徐涛 602bd43fce fix(llm,docs): 修复 Phase C 审查发现的两个警告 
- LlmError::Request 变体补可操作建议：请检查 Provider 端点地址（base_url）和网络连通性
- README.md Mermaid 依赖图删除 Agent --> Prompt 边（编译级不存在）
- README.md 依赖规则文本同步：明确 agent 实际编译依赖为 llm/tools/memory，与 prompt 无直接依赖（system prompt 以 &str 传入）

参考审查：PM Director + SA Director 对 Phase C 的联合审查结论
 2026-07-04 06:35:21 +08:00
徐涛 a52588cd0f docs: 完善 README 完整版 
- 8 节结构：定位 / 快速上手 / 核心模块 / 架构图 / 依赖关系 / 环境变量 / 参考项目 / 许可证
- 快速上手代码段（MockProvider）已验证在外部 crate 离线可编译运行
- 核心模块表覆盖五大模块（llm / prompt / tools / memory / agent）
- ASCII 架构关系图 + Mermaid 模块依赖关系图 + 依赖规则说明
- 环境变量表列出 simple_visit 示例所需变量与推荐值
- 参考项目章节引用 4 个公开 Agent Harness 项目（OpenClaw / Hermes / OpenHuman / OpenHarness）
- 许可证章节同步改为 Apache-2.0 单协议，附标准 boilerplate 并指向 LICENSE 文件
 2026-07-04 06:21:36 +08:00
徐涛 4fdc62754c feat(errors): 错误消息面向最终用户友好化 
- memory::MemoryError 英文 → 中文 + 操作建议（namespace 拼写 / 后端存储 / 数据兼容性）
- llm::LlmError 各变体补充修复建议（API key / 超时 / 上下文压缩）
- tools::ToolError 各变体补充修复指引（注册工具 / 检查 Schema / 调权限 / MCP 握手）
- prompt::PromptError 各变体补充修复指引（注册子模板 / 检查语法 / 调深度限制）
- agent::AgentError::Config 中文化 + 提示需调用的 builder 方法名
 2026-07-04 06:21:31 +08:00
徐涛 9f5e8702a2 chore(license): 添加 Apache-2.0 标准 LICENSE 文件 
- 新增 LICENSE（Apache License 2.0 全文，Copyright 2026 AG Core Contributors）
- 项目由双协议改为 Apache-2.0 单协议
 2026-07-04 06:21:24 +08:00
徐涛 2d0d5c1592 feat(examples): 新增 Phase B 7 个离线可运行示例 
新增 7 个示例覆盖全 Phase 公共 API（不依赖 API key 即可运行）：
- agent_session_demo：AgentBuilder → AgentSession → SessionMemory
- custom_tool：BaseTool 注册 + invoke/invoke_all + 权限检查
- prompt_composer：PromptTemplate + PromptComposer + validate_messages
- task_agent_demo：JsonPlanParser + Step 状态机 + 错误路径
- conversation_memory_demo：滑动窗口 + 多角色 + 隔离
- knowledge_search_demo：KnowledgeStore + 关键词检索 + 停用词过滤
- streaming_events_demo：submit_stream 事件消费 + 队列耗尽错误路径
 2026-07-03 15:50:51 +08:00
徐涛 7b2d2db322 feat(llm): 公开 MockProvider 并修复测试与 API 一致性 
- 新增 src/llm/mock.rs：公开 MockProvider，实现 chat 与 chat_stream
  (chat_stream 从 MessageResponse 拆解为 StreamEvent 序列)，含 5 个内联测试
- src/llm.rs 注册 pub mod mock，供示例与外部 crate 引用
- src/agent/session.rs 测试改用 crate::llm::mock::MockProvider，
  删除内嵌私有副本，统一公开路径
- src/prompt.rs re-export validate_messages，与 PromptComposer 对齐公开路径
 2026-07-03 15:50:39 +08:00
徐涛 c084c57e2c refactor(core): 扫清 v0.1 Phase A 技术债 
- 修复测试编译回归：补全 session.rs/cycle.rs 测试模块导入；
convert.rs 2 处 irrefutable if let 改为 let
- composer.rs 迁移至 IR：OpenaiChatMessage → Message，
ContentField/OpenaiContentPart → ContentBlock；删除 set_message_name
和 build_request；developer 消息映射为 Message::System
- knowledge.rs 锁修复：std::sync::Mutex → tokio::sync::Mutex；
search() 优化锁粒度（锁内仅 clone IDs，避免锁内异步 IO）
- 标记 ChatResponse / ToolDefinition 为废弃（#[deprecated(since = "0.1.0")]），
内部使用点加 #[allow(deprecated)] 抑制警告
- clippy 清零：合并冗余 if、手动 strip_prefix 改 strip_prefix、
多处 dead_code 抑制、测试代码清理
 2026-07-03 15:19:37 +08:00
徐涛 c2c0d498ee docs(v0.1): 添加发布实施计划文档 2026-07-03 14:13:30 +08:00
徐涛 e54edbc037 feat(agent): 移除未使用的导入并简化条件表达式 2026-07-03 13:55:24 +08:00
徐涛 9e4f50c955 feat(llm): LlmCycle 切换 IR 消息类型，移除 Phase 0 桥接层 
核心改动：
- LlmCycle.messages 从 Vec<OpenaiChatMessage> 切换为 Vec<Message>，
  移除 Phase 0 引入的 chat_message_to_message / message_to_chat_message
  转换函数
- 移除 LlmCycle.system_prompt 字段（FIX-D），调用方通过
  Message::system_text() + with_messages() 管理系统提示；
  with_system_prompt() 标记 #[deprecated] 保留为过渡期 shim
- submit_stream 简化（FIX-E）：Item = StreamEvent 不再带 Result 包装，
  错误用 StreamEvent::Error 传出；self.messages 不再自动 push_message，
  调用方在收到 MessageComplete 后手动调用 cycle.push_message()
- compact.rs 适配 Message 类型 + ContentBlock 估算；microcompact
  跳过 is_error:true 的 ToolResult（FIX-F），保留 LLM 错误诊断
- ConversationMemory 持久化从 OpenaiChatMessage 切换为 Message
- ToolInvocation 增加 tool_call_id 字段（FIX-A），
  invoke/invoke_all 签名增加 tool_call_id 参数

调用方迁移：
- AgentSession::submit_turn 用 Message::system_text() + with_messages()
- simple_visit example 同步迁移

测试 177 passed / 0 failed（compact 新增 5 个单元测试覆盖 FIX-F + 估计全变体）。
 2026-07-02 22:48:00 +08:00
徐涛 a74c24b6fe feat(llm): 重写 Provider 适配层，支持 OpenAI Chat / Anthropic / DeepSeek / Qwen 
重写 OpenaiChatProvider：移除 Phase 0 临时桥接，实现真实流式状态机
（ContentBlockStart / *Delta / ContentBlockEnd / ToolCallEnd），
MessageComplete.full_response 由 PartialMessageResponse::finalize 产出。

新增 AnthropicProvider：实现 Messages API + SSE 事件序列
（message_start → content_block_start → content_block_delta →
content_block_stop → message_delta → message_stop），
529（overloaded）映射为 RateLimit；thinking signature 由
partial.set_thinking_signature 内部写入。

新增 DeepSeekProvider / QwenProvider：OpenAI-compatible 协议的
newtype 包装，共享 GenericOpenaiProvider 的 HTTP / SSE / 转换逻辑；
Qwen 通过 extra_headers 注入 X-DashScope-SSE: enable。

新增 convert.rs 公共转换模块：从 Phase 0 cycle.rs / Phase 0
OpenaiProvider 桥接层提取 from_openai / to_openai /
content_to_blocks / blocks_to_content，避免跨 Provider 重复逻辑。

新增 wiremock dev-dependency + 14 个集成测试：
- OpenaiChatProvider：基础文本 / 401 / 500 / 流式 MessageComplete
- AnthropicProvider：基础 / 401 / 529 / 流式 SSE 序列 / max_tokens 默认值
- DeepSeek / Qwen：基础文本响应

171 个测试全部通过（之前 157，新增 14）。
 2026-07-02 22:24:30 +08:00
徐涛 7c299f1cfd feat(llm): 新增 IR 类型层 + 切换 LlmProvider trait 签名 
引入跨 Provider 统一的新类型系统：
- Message 扁平大枚举（System/User/UserImage/Assistant/ToolResult）
- MessageRequest + MessageResponse + StreamEvent（高精度 IR）
- PartialMessageResponse 含 apply_to/finalize 汇聚算法
- ProviderType enum 扩展 + ProviderCapabilities

切换 LlmProvider trait 签名为 chat(MessageRequest) → MessageResponse，
chat_stream 返回 Stream<Item = Result<StreamEvent, LlmError>>，新增 capabilities()。

StreamEvent 命名冲突处理：旧变体迁移至 old_stream::LegacyStreamEvent，
stream.rs 通过 pub use 重新导出新高精度事件。

OpenaiProvider 添加 Phase 0 临时桥接（MessageRequest ↔ OpenaiChatRequest 转换），
标注 ponytail: Phase 0 临时桥接 标记，Phase 1 重写时移除。

测试 147 passed / 0 failed（新增 31 个新类型测试）。
 2026-07-02 21:58:07 +08:00
徐涛 925c8f9729 docs: 更新方案文档，补充 StreamEvent 迁移和 OpenaiProvider 桥接方案 2026-06-30 22:59:05 +08:00
徐涛 832ebf2665 docs(phase0): 新增 Phase 0 实施计划文档 
定义类型层落地计划，涵盖新类型定义、Trait 签名切换及上游适配方案
 2026-06-30 22:22:12 +08:00
徐涛 000cd2022d feat(llm): 实现 Provider 重构方案并更新文档 
根据复核反馈修正以下内容：
- 补充 §2.4 中扁平大枚举对 9e 依赖验证的说明
- 消除 §2.3 MessageComplete 冗余字段
- 明确 Phase 0 add-only 策略和 trait 签名切换时点
- 补充 HTTP mock 策略和兼容性验证标准
 2026-06-26 08:12:12 +08:00
徐涛 ac7fca8b40 feat(docs): 新增 LLM Provider 重构方案文档 2026-06-25 23:07:22 +08:00
徐涛 f639229d09 docs: 添加 commit body 规则，禁止逐文件列举变更 2026-06-24 17:00:43 +08:00
徐涛 4423024974 docs: 更新 compact 主题状态为已推演 2026-06-22 08:43:48 +08:00
徐涛 3babc5567f enhance(docs): 补全 compact 在 IR 上的改法推演结论 2026-06-22 06:52:04 +08:00
徐涛 3ddd0b6d80 enhance(docs): 更新 system prompt 双重表达冲突推演结论为方案 D 2026-06-22 06:34:11 +08:00
徐涛 80d44ee687 docs(AGENTS): 添加 Commit 提交流程说明 2026-06-19 08:23:00 +08:00
徐涛 ee7fcab71c docs(9): 完善 Anthropic 流式状态机设计推演结论 2026-06-18 06:51:13 +08:00
徐涛 8c9324350b docs(9d): 补全 OpenAI 流式转换推演结论 2026-06-18 06:34:20 +08:00
徐涛 c0eae92b10 docs: 更新方案9推演结论并调整StreamEvent设计 2026-06-17 22:55:47 +08:00
徐涛 8686a2e1d6 docs(llm): 新增 LLM Provider 统一接口设计文档 2026-06-15 23:07:33 +08:00
徐涛 829be90d19 docs: 新增示例程序方案文档 2026-06-11 22:49:27 +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
徐涛 b539f37eeb docs: 添加 OpenCode Agent 切换机制调研笔记 2026-06-10 06:52:24 +08:00
徐涛 336920554a docs(agent): 补充 Phase 4 Agent Runtime 方案文档与设计决策记录 2026-06-09 22:32:59 +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
徐涛 2ecc0b4001 feat(memory): 添加记忆系统模块 2026-06-08 08:42:43 +08:00
徐涛 1fe7f02281 docs(memory): 更新记忆系统方案文档 2026-06-07 23:01:28 +08:00
徐涛 6dc7ee492f docs(memory): 精简记忆系统方案，移除知识图谱和基于召回价值的淘汰策略 2026-06-07 22:42:53 +08:00
徐涛 b571f530f8 docs: 新增知识图谱与高级检索设计文档（Phase 4 备用） 2026-06-07 22:42:49 +08:00
徐涛 59994bf55e chore: 将编辑器最大行宽从 100 调整为 120 2026-06-07 22:42:42 +08:00
徐涛 fb1c530358 feat(memory): 添加知识图谱标签复用查询与容量约束 2026-06-07 13:35:32 +08:00
徐涛 f818bd59f5 chore: 添加 .codegraph 目录到 gitignore 2026-06-07 13:27:26 +08:00
徐涛 8573c6eb92 docs(记忆系统): 添加记忆系统设计方案 2026-06-07 13:24:49 +08:00
徐涛 692bff5751 feat(docs): 更新路线图 Phase 2 工具系统完成状态 
将所有 Phase 2 待办项标记为已完成，更新当前状态和下一步行动
 2026-06-07 10:57:20 +08:00
徐涛 b6e7acfb0f feat(tools): 添加工具系统框架与 MCP 协议客户端 2026-06-07 10:57:15 +08:00
徐涛 e598f6d3ee docs(5-tool-system): 更新工具系统方案文档，完善 Phase 2 实现细节 
- 在 BaseTool 中添加 ToolContext 执行上下文参数，包含 session_id、trace_id 和取消令牌
- 更新 LlmCycle 工具循环逻辑：修正消息推送顺序，新增 max_tool_turns 独立字段
- 补充 McpClient 子进程运行时状态 ChildProcessState 设计
- 添加消息压缩 maybe_compact() 方法描述
- 明确 submit_stream_with_tools() 推迟至 Phase 3 实现
- 更新实现计划中各步骤的详细变更
 2026-06-07 10:23:36 +08:00
徐涛 5d6bb5e983 feat(tools): 完善工具系统设计方案并添加扩展性分析 
更新工具系统方案文档，补充 Token 消耗分析、错误分类策略、`submit_request()` 重构说明及流式事件职责划分，新增第9节未来扩展性分析，明确 `ToolContext` 注入、`ToolEntry` 元数据、
`ToolOutput` 枚举等扩展路径，更新实现计划以保持与设计一致
 2026-06-07 10:13:19 +08:00