ooodc/PicoBot
ooodc/PicoBot
1
0
Fork 0
Code Pull Requests Activity
547 Commits 1 Branch 0 Tags
Commit Graph

64 Commits

Author SHA1 Message Date
oudecheng
dc693fa80b feat(model): 主代理/子代理模型解析链 topic>session>expert>config + TaskToolResult 附带实际模型 
- 主代理解析链新增 topic 级选择（最高优先级），session 级首命中时物化固化为话题选择
- 子代理解析链共享 helper：def frontmatter > 话题级 > session 级 > 全局基础配置
- TaskToolResult 携带子代理实际使用的 provider/model，供前端差异展示
 2026-08-15 15:34:18 +08:00
oudecheng
fc3a95b152 feat: 异步子代理 v8 实现与 /stop 取消流程修复 
后端核心实现：
- 新增 wait_coordinator：释放/重获取 serial_lock 的 in-tool waiting 模式，替代旧的 break-exit 方案
- 新增 wait_for_subagents 工具：select! 等待子代理完成/用户消息/超时，支持 try_drain 批量消费
- task 工具异步 spawn 路径：CancellationToken 注册表 + RAII guard + Semaphore 并发限流
- process exit 安全检查：pending 子代理存在时抑制 ExecutionCompleted
- 崩溃恢复：启动时标记 running->interrupted，history 加载时对账占位

/stop 取消流程修复：
- wait_coordinator select! 添加 cancel 分支，完整清理状态
- ToolContext 注入 cancel_rx（watch::Receiver clone）
- agent_loop 工具执行 select! 对 wait 工具跳过竞速，防止 drop coordinator 清理逻辑
- 子代理完成状态通过 execution_completed metadata 传播

存储层：
- pending_subagents 表 + 条件 UPDATE
- mark_all_running_as_interrupted 崩溃恢复
 2026-08-13 22:12:20 +08:00
oudecheng
29060315a3 feat(observability): 端到端可观测性整改，修复 trace_id 断链与指标配对 
- 传播 trace_id：BusToolCallEmitter/SubAgentEmitter/processor 全链路设置

- AgentEnd 配对：补发 5 个 cancel/defensive 路径，闭合 AgentStart 指标

- LLM 计时修正：attempt_start 移入 retry 循环，排除退避等待时间

- /metrics auth：非 loopback 部署时纳入 Bearer token 校验

- recorder 复用：OnceLock 缓存 PrometheusHandle，热重启后不再返回 503

- 结构化日志：新增 tracing_ctx + JSON 日志格式支持
 2026-08-12 08:26:42 +08:00
oudecheng
510520e08e refactor: 提取公共工具函数，修复飞书正则重复编译和网关路由DRY问题，添加CI安全审计 2026-08-07 08:33:15 +08:00
oudecheng
bf8c227634 refactor: 迁移 parking_lot 锁并优化阻塞 IO 与内存管理 
## 锁迁移：std::sync → parking_lot
消除锁中毒（poison）导致的级联崩溃风险。parking_lot 锁不会中毒，
且性能更优。迁移覆盖全部生产代码：
- experts/mod.rs: 4 RwLock + 13 expect
- skills/mod.rs: 1 RwLock + 11 expect
- tools/registry.rs: 1 RwLock + 2 expect
- gateway/model_selection.rs: 1 RwLock + 2 expect
- tools/task/repository.rs: 1 RwLock + 4 unwrap
- tools/task/runtime.rs: 2 RwLock + 17 expect
- gateway/session.rs + task/runtime.rs: stream_message_id Mutex
- gateway/processor.rs: description_generation_in_flight Mutex
- command/handler.rs + help.rs: metadata Mutex（公开 API）
- mcp/client.rs: stderr_lines Mutex

测试代码中的 std::sync::Mutex（串行化锁 + TestObserver）有意保留，
已通过 unwrap_or_else(|err| err.into_inner()) 做中毒恢复。

## P1: 阻塞 IO 迁移到 spawn_blocking
将 3 处阻塞 async worker 的操作迁移到 blocking 线程池：
- file_read.rs: read_to_string + 行处理 + base64 编码整体包入 spawn_blocking
- agent_loop.rs: 新增 preencode_images_for_request 两阶段预编码
  （顺序分配预算 → 并行 spawn_blocking 编码），build_llm_request 改为 async
- wechat.rs: media_to_send_content 改为 async，std::fs::read 用 spawn_blocking 包裹

## P2: session_history topic_histories 内存上限
新增 MAX_CACHED_TOPICS=32 上限和 evict_inactive_if_needed 方法。
超限时驱逐非活跃 topic（不在 chat_topic_ids、不在 compression_in_flight、
serial_lock 未被持有）。活跃 topic 永不误驱逐。
remove_history 同步清理 topic_serial_locks，防止无限增长。

## P3: 减少 panic 面
agent_loop.rs retry 循环的 response.expect(...) 改为 ok_or_else(...)?
返回 AgentError::Other，逻辑 bug 不再导致整个 agent 崩溃。

## 对抗性审查修复
- preencode_images_for_request: 用 seen HashSet 去重，防止同 path 重复
  编码导致 HashMap entry 覆盖（NoBudget 覆盖 Encoded 等）
- evict_inactive_if_needed: 检查 topic_serial_lock.try_lock()，防止驱逐
  正在 agent 处理中的 topic（original_topic_id 不在 chat_topic_ids 但
  agent 仍持锁）
- remove_history: 清理 topic_serial_locks

## 验证
- cargo check: 通过（仅既有 lifetime 警告）
- cargo test: 559 passed / 3 failed（均为环境/sandbox 权限问题，与本次改动无关）
 2026-08-06 08:18:04 +08:00
oudecheng
6252b600cd refactor(compression): 重构上下文压缩为两阶段+双阈值+三段保留 
压缩时机从 process 整体返回后提前到每轮工具调用完成后，更及时控制上下文大小。

两阶段压缩：
- 工程化压缩（70% 阈值触发）：截断非子代理 tool 结果到 100 token，仅改内存不影响 DB
- LLM 压缩（50% 阈值触发）：工程化压缩后仍超 50% 才调 LLM，避免不必要的 LLM 调用

LLM 压缩三段保留策略：
- 保留最旧 5 个 unit 和最新 5 个 unit 原样
- 中间段用 LLM 生成摘要（heavy prompt）
- SystemGuard 永远保留不计入配额
- ToolRound 原子性由 parse_to_units 保证，切分在 unit 边界

工程化压缩：
- truncate_tool_results_in_place 截断 role="tool" 且 tool_name!="task" 的消息
- 子代理返回（tool_name="task"）保持原样
- char_indices 确保 UTF-8 字符边界安全，截断后追加 "...[已截断]" 标记

AgentLoop 集成：
- 新增 CompactionSink trait，LLM 压缩结果通过 sink 回写 DB
- AgentProcessResult 新增 compaction_performed 和 engineering_compaction_applied 标记
- finalize_result 据此决定是否 reload DB 历史（避免重复 append）和跳过兜底压缩

错误恢复：
- LLM 压缩失败降级为仅工程化压缩，不中断 agent loop
- sink.compact 失败记 error 日志继续使用内存压缩结果，DB 下次 process 会重新触发压缩

清理旧的 two-segment 差异化压缩代码（OLDER_BUDGET_RATIO、find_safe_split_point、
build_light_summary_prompt 等），新增 unit_to_messages 辅助函数。
 2026-08-05 21:56:41 +08:00
oudecheng
c790ee1609 fix(gateway): 修复已完成子智能体任务卡在"子智能体正在执行..." 
TaskStarted 补发逻辑改为基于 tool_result 存在性判断（替代 state==Running），
并在补发事件中携带 tool_call_id 以实现前端精确匹配。

- TaskSession 新增 tool_call_id 字段，runtime.spawn 时从 parent_context 注入
- send_topic_history/send_task_messages 收集历史中已有 tool_result 的 tool_call_id
  集合，仅对没有 tool_result 的任务补发 TaskStarted（不论 Running/Completed）
- 补发时传入 task.tool_call_id，前端可精确匹配 task tool_call 卡片，
  避免多并行子智能体场景下 fallback 串扰
- 移除未使用的 TaskSessionState 导入

修复场景：父智能体启动多个并行子智能体，其中一个完成但另一个仍在运行时
重载 topic，已完成的子智能体因 state!=Running 被跳过，导致其 tool_call
卡片永远收不到 TaskStarted，卡在"子智能体正在执行..."无法变为"查看实时进度"。
 2026-08-05 17:34:03 +08:00
oudecheng
1e9075e1ed fix(subagent): 失败/超时子智能体返回结构化结果，支持前端点击查看详情 
spawn()/resume() 在会话创建后的失败（含超时、执行错误、AgentCreationFailed）
现返回 Ok(TaskToolResult { status: "failed"/"timeout", task_id }) 而非 Err(e)，
使 tool_result 内容始终为结构化 JSON。前端已有的 taskStatusConfig、StatusIcon、
"查看完整会话"按钮自动生效，同时修复服务重启后点击入口丢失的问题。

- runtime.rs: 提取 handle_task_failure 辅助方法统一处理失败；将 model_resolver/
  create_subagent 的 ? 纳入 result 块，确保所有会话后失败都返回结构化结果；
  修复 resume() 未区分 timeout 的 bug
- tool.rs: 根据 task_result.status 判断 success，失败时 output 仍为 JSON
- agent_loop.rs: 失败时 result.output 非空则透传（仅影响 task 工具），其他工具回退
  到 "Error: {error}" 纯文本
 2026-08-05 09:05:35 +08:00
oudecheng
c2cc072b2e feat(settings): 拆分设置页为懒加载标签页并支持子代理创建/删除 
- ConfigPage 拆分为 16 个懒加载 tab + 2 个 modal，首屏体积大幅下降
- 抽取 CapabilityTabs 共享组件，统一专家/子代理能力配置 UI
- 后端新增 POST /api/subagents/create、DELETE /api/subagents/delete
- SubagentRuntime 新增 create_subagent/delete_subagent，含路径校验与 builtin 保护
- SubagentModal 支持 create/edit 双模式、body 编辑、自身排除防自递归
- SubagentsTab 增加搜索、provider/model 标签、删除二次确认
- 修复 reload() 使用进程 cwd 而非 self.cwd 的隔离缺陷
 2026-08-04 21:06:17 +08:00
oudecheng
457f6b2408 feat(retry): 为 LLM 主调用添加可配置重试机制，默认 3 次 
- config: ProviderConfig 增加 max_retries 字段（serde default=3，向后兼容）
- config: LLMProviderConfig 透传 max_retries，不进 ProviderRuntimeConfig（保持 provider 构造包纯净）
- agent: AgentRuntimeConfig 增加 max_retries，归属 agent 行为层
- agent_loop: 流式 + summary 两个调用点实现重试循环
  - 指数退避 1s/2s/4s，仅对 429/502/503/504/timeout/connection reset 重试
  - 流式仅在未 emit delta 时重试（AtomicBool 跟踪），避免重复输出
  - 退避 sleep 期间响应 cancel_signal，取消优先
- 前端: ProviderConfig 类型和表单增加 max_retries 字段
- 测试: 7 个单元测试（3 判定 + 4 行为），540 个 lib 测试全绿
 2026-08-04 12:53:33 +08:00
oudecheng
14d903e067 fix: Agent 执行与显示层解耦，修复锁屏冻结根因 
浏览器锁屏导致 WebSocket 半死，ws_sender.send().await 永久阻塞，
级联阻塞 dispatcher → MessageBus → Agent Loop，后端停止执行直到解锁。

基于第一性原理建立"执行-显示解耦"原则：agent 执行只依赖 SQLite
持久化，实时广播是可丢弃的最佳努力通道。

核心改动：
- MessageBus::publish_outbound 由 send().await 改为 try_send()，
  bus 满时丢弃消息并告警，agent 不再被显示层阻塞
- WebSocket writer task 包裹 30s 超时，使用每连接独立的
  CancellationToken（非共享 CliChannel 级 token），避免一个连接
  超时关闭所有连接；writer 退出时 cancel 通知主 loop 退出
- CliChannel::send 由 send().await 改为 try_send()，避免 dispatcher
  单线程被卡住的 writer 阻塞 37s
- 全仓 13 处 publish_outbound 调用统一区分 Dropped(warn)/Closed(error)
- scheduler 3 处 ? 改为 warn，避免 Dropped 触发 misfire 重试风暴
- 前端 WebSocket 添加 25s ping + 指数退避重连(3s→60s封顶)
- 前端 session_list 区分重连恢复/首次连接，重连时保留 messages
  并刷新 topic 列表

经五轮对抗性审查验证，修复了共享 cancel token、dispatcher 阻塞、
load_chat_messages 跨 topic 污染、原 session 删除后状态不一致等
回归问题。

同时升级版本号至 0.3.0 并更新 CHANGELOG。

验证：cargo clippy --all-targets --all-features ✓
      npm run build ✓ | useChat.test.ts 13 passed ✓
 2026-08-04 10:55:52 +08:00
oudecheng
cda14360af chore: 建立工程化基线（rustfmt + clippy + CI + eslint + prettier） 
配置:
- rustfmt.toml: 固化 max_width=100 / 4 空格缩进，cargo fmt 全量格式化
- Cargo.toml: 配置 [lints.rust] 与 [lints.clippy] 渐进式规则
- .github/workflows/ci.yml: Rust(fmt+clippy+test) + 前端(eslint+tsc+test) 双平台 CI
- Makefile: 新增 check/fmt/fix 目标，clippy 对齐 --all-targets --all-features
- web: eslint flat config + prettier 配置 + package.json 脚本与依赖
- src/main.rs: loop→while 修复 clippy::never_loop

对抗性审查发现并修复:
- eslint 缺 caughtErrorsIgnorePattern 导致 catch(_) 误报为 error
- 前端 lint 未接入 CI，现已补上 Lint 步骤
- Makefile 与 CI 的 clippy flags 不一致，已对齐
 2026-08-03 23:24:02 +08:00
oudecheng
dc9211548a feat(model): 专家和子代理支持独立配置 provider/model 
- 新增 ModelResolver 解析器，按 frontmatter 中的 provider/model 名覆盖基础 LLMProviderConfig

- Expert/SubagentDef 数据结构新增 provider/model 字段，frontmatter 解析与渲染支持往返

- AgentFactory 和 DefaultSubAgentRuntime 持有 ModelResolver，在创建 agent 时解析模型覆盖

- HTTP API 新增 /api/model-options 端点，ExpertResponse/Create/Update 和 SubagentUpdateRequest 支持 provider/model

- update_expert/update_subagent 支持 provider/model 字段写回 frontmatter

- 保持架构解耦：ModelResolver 位于 config 底层，不引入新的跨模块依赖
 2026-07-30 22:44:10 +08:00
oudecheng
c27efedb6c feat(capability): 扩展 CapabilityPolicy 支持子代理黑白名单 
- domain: CapabilityPolicy 新增 allowed_subagents/denied_subagents 字段及 check_subagent_allowed 方法
- experts: 专家 frontmatter 解析/渲染支持子代理策略字段
- task/runtime: spawn/resume 双路径校验父代理子代理策略；新增 update_subagent 写回 SUBAGENT.md（与 update_expert 对称）；新增 SubagentPromptProvider 按专家策略过滤子代理索引
- task/runtime: 子代理自身 capability 作为孙代理的 parent_capability 透传（ToolContext），保持解耦
- traits: ToolContext 新增 parent_capability 字段
- agent_factory: 主 agent 注入 expert_capability 到 ToolContext

安全：策略不通过即拒绝（与 def 不可用即拒绝范式一致），防止 LLM 通过选择被禁子代理绕过限制；max_nesting_depth 兜底防递归不可被 def 覆盖。
 2026-07-30 17:37:29 +08:00
oudecheng
12f1094426 feat(capability): 新增 CapabilityPolicy 统一策略模型并集成至专家/子代理/技能 
- domain: 定义 CapabilityPolicy（allowed/denied skills/tools）统一策略结构

- experts: 专家支持 capability 字段，新增 update_expert 写回 EXPERT.md

- skills: SkillRuntime 暴露 capability 过滤接口

- tools/task: SubagentDef 增加 capability 字段，SubagentRuntime 新增 update_subagent 写回 SUBAGENT.md，工具集按 capability 过滤

- agent_factory: 按 capability 构建专家/子代理工具集（白名单交集 + 黑名单扣除）
 2026-07-30 16:53:30 +08:00
xiaoxixi
56612389ae 改用gray_matter解析md头元数据，增加相应的日志 2026-07-21 16:33:55 +08:00
oudecheng
cea4bd3cfb feat: 子代理支持数据驱动的工具过滤（白名单+黑名单），删除内置 explore 
SUBAGENT.md frontmatter 新增 denied_tools 黑名单字段，启用已有的 allowed_tools 白名单；新增 ToolRegistry::only 白名单方法；抽取 build_subagent_tools_registry（白名单→黑名单→depth 兜底）；安全修复：resume 在 def 失踪时拒绝恢复而非降级为完整工具集（避免权限提升）；depth 阈值改为引用 max_nesting_depth 配置；SubagentWithStatus 暴露工具字段供前端只读展示；删除内置 explore 子代理及专属 explore_max_execution_secs 配置（全栈清理）；新增 23 个测试覆盖过滤矩阵、frontmatter 解析、状态投影
 2026-07-09 14:42:38 +08:00
oudecheng
46a1ca6853 refactor: 修复 3 项 P1 技术债（硬编码 URL / any 类型 / dead_code） 
P1-1: 硬编码 wechat URL 抽常量统一两处
  - config/mod.rs: 定义 pub const WECHAT_DEFAULT_BASE_URL
  - cli/init.rs: import 并引用常量，消除字面量重复
  - 消除两处不一致风险（default_wechat_base_url 与 init 向导）

P1-2: ConfigPage any 类型定义具体类型（8 处）
  - types.ts: 新增 FeishuChannelConfig/WechatChannelConfig/ChannelConfig/
    SchedulerJobConfig 类型；jobs?: any[] → SchedulerJobConfig[]；
    channels: Record<string, any> → Record<string, ChannelConfig>
  - api/config.ts: 新增 RestartResponse 类型，data: any → RestartResponse
  - ConfigPage.tsx: catch (e: any) ×2 → catch (e: unknown) + 类型守卫；
    as any → as SchedulerConfig['misfire_policy']；
    Record<string, any> → Partial<ChannelConfig>；(ch: any) → (ch: ChannelConfig)

P1-3: dead_code 18 处逐一审查清理
  - 删除 10 处未使用函数/struct（YAGNI 原则）：
    context_compressor.rs (into_messages, is_tool_round)
    agent_loop.rs (EmptySkillProvider struct + impl)
    memory_maintenance.rs (run_for_scope)
    session.rs (try_start/finish_background_compaction)
    session_history.rs (try_start/finish_background_compaction)
    tool_registry_factory.rs (shell_session_manager)
    task/runtime.rs (effective_allowed_tools)
  - 保留 8 处 serde 反序列化字段（删除会破坏 JSON 反序列化）：
    feishu.rs/openai.rs/anthropic.rs/skills/mod.rs/task/runtime.rs
 2026-07-08 14:51:42 +08:00
oudecheng
7eb2933ca5 chore: 清理 P0 技术债 
- 删除 web/src/components/Sidebar/.deprecated 目录(死代码)
- 清理 useChat.ts/useWebSocket.ts 中 13 条调试 console.log
- 修复 load_task_messages.rs 硬编码 task 状态: 新增 TaskSessionState::Unknown,
  DB 重建时返回 Unknown 而非误报 Completed, 前端显示"未知"
 2026-07-07 17:45:07 +08:00
oudecheng
b4b7c5a208 fix: 子智能体执行路径发布带 subagent_task_id 的完成/错误事件 
在 runtime.rs 新增 build_subagent_event_metadata/publish_subagent_completion/publish_subagent_error 函数，在 spawn/resume 的 Ok/Err 分支发布带 subagent_task_id=session.id 的 ExecutionCompleted/ErrorNotification 事件。

load_task_messages.rs 的 reconstruct_task_from_db 硬编码 Completed 加 TODO 注释，记录 DB 重建无法可靠推断 task 状态的已知缺陷。

Spec: fix-subagent-message-refresh-on-exit (Task 1.4, 9)
 2026-07-06 18:11:12 +08:00
oudecheng
8d30ccd020 feat: 新增子代理管理API，支持获取子代理列表和切换子代理状态 2026-07-06 14:41:30 +08:00
oudecheng
26cbe7aa2d feat: 更新 created_by_message_id 逻辑，仅在内容或状态变化时进行更新 2026-06-29 15:01:32 +08:00
oudecheng
ef18500100 feat: 更新 created_by_message_id 字段的赋值逻辑，确保使用 tool_call_id 进行消息关联 2026-06-25 10:50:16 +08:00
oudecheng
c72853c79d feat: 添加 user_message_id 字段以支持用户消息的关联和同步 2026-06-24 15:13:36 +08:00
oudecheng
4efc8b51e7 feat(todo): 添加待办项关联的创建消息ID并支持消息高亮 
- 在待办相关数据结构和存储中新增 created_by_message_id 字段
- 记录待办项创建时对应的消息ID，支持追溯来源
- 在前端待办列表项增加点击事件，点击后滚动并高亮对应消息
- 在消息列表组件中实现高亮动画及自动滚动功能
- 更新相关工具、协议和数据库查询，确保新字段正确传递和存储
- 增加 CSS 动画实现待办对应消息的高亮闪烁效果
- 优化前端状态管理，支持设置与获取高亮消息ID
 2026-06-22 14:50:37 +08:00
oudecheng
6a496ce212 feat(task): 优化孙智能体任务消息的发送与工具注册 
- 在发送任务消息时增加可选的任务仓库参数支持子任务重发
- 新增 extract_parent_task_id 函数用于提取孙智能体的父任务 ID
- 补发子任务（孙智能体）的 TaskStarted 事件，解决视图重进导致的 navigateToTaskId 丢失
- 判断并附加子任务的父任务 ID，完善日志记录与事件发送
- 在子智能体运行时根据深度排除 task 工具，防止无限嵌套调用
- ToolRegistry 新增 without 方法，可创建排除指定工具的新实例用于子智能体配置
 2026-06-22 11:31:41 +08:00
oudecheng
606fcbcd29 feat(agent): 注入并传递 tool_call_id 实现任务与工具调用精准关联 
- 在 agent_loop 执行上下文中注入 tool_call_id，确保执行时传递该字段
- 在 agent_factory、ws、todo_read、todo_write 等多处构造对象时添加 tool_call_id 字段初始化
- 扩展协议定义及序列化，支持 tool_call_id 字段传递
- 在工具调用任务运行时传递 tool_call_id，便于事件追踪和层级关联
- 在前端 useChat hook 增加 tool_call_id 关联逻辑，实现 task_started 事件精准匹配和跳转
- 增加 pendingTaskNavs 缓存处理，解决 task_started 事件先于 tool_call 到达的顺序问题
- 调整消息渲染逻辑，根据 tool_call_id 进行优先匹配，提升用户交互体验
 2026-06-22 10:22:36 +08:00
ooodc
d802534abe feat(gateway): 支持网关平滑重启功能 
- 在 Gateway 运行逻辑中增加重启循环，可根据重启信号自动重启服务
- 添加取消管理器功能，支持取消所有运行中的 Agent 以便平滑重启
- 在 HTTP API 新增 /api/restart 接口，实现基于任务活动检测的安全重启
- GatewayState 增加重启信号通道，支持异步触发重启流程
- 修改主运行逻辑支持重启等待机制，实现优雅关闭或重启
- 日志初始化修复防止重复初始化导致的问题
- 技能和子代理加载支持自定义绝对路径来源，增加灵活性和扩展性
- 调整技能与子代理来源枚举，增加 Custom 选项支持动态路径
- 优化工具与任务运行时代码，完善路径处理和克隆逻辑
- 前端配置页增加时区选择下拉菜单，提供常用时区选项
- 新增来源路径编辑组件，支持启用/禁用已知来源及添加自定义绝对路径
- 配置页新增保存配置后重启提示，支持用户确认立即重启网关
- 实现重启操作的前端调用及重启状态展示，包括任务冲突提示与重启轮询恢复
- 频道绑定 Agent 字段由输入框改为下拉选择，提升配置体验和正确性
 2026-06-19 10:40:00 +08:00
oudecheng
9ea5849f22 refactor(task): 子智能体相关字段重命名及导航逻辑调整 
- 将 runtime 中的 sub_session_id 字段重命名为 task_id，作为持久化的 scope_key
- 调整持久化 todo_write 结果使用 task_id 代替 session_id 作为 scope_key
- 重命名前端消息中的 subagentTaskId 为 navigateToTaskId，增强导航表达
- 修改 MessageBubble 组件中子智能体任务导航相关的字段名和条件判断
- 优化 useChat 中 task tool_call 消息的 navigateToTaskId 设置逻辑，确保正确导航孙智能体任务
- 移除无用的 getTopicId 辅助方法，简化消息处理逻辑
- 在协议类型定义中新增 navigateToTaskId 字段，明确导航用途与关系
 2026-06-18 17:09:42 +08:00
oudecheng
175e7fc01b refactor(subagent): 支持带类型的子智能体标题格式 
- 将子智能体标题解析升级为支持 "Subagent [type]: description" 格式
- 兼容旧格式 "Subagent: description"，默认类型为 "general"
- 修改子智能体会话标题生成，包含类型信息
- 优化记录解析和会话创建逻辑，提高子智能体信息表达准确性
 2026-06-18 14:27:38 +08:00
oudecheng
2607ca4aa4 refactor(task): 优化任务工具和子代理深度管理 
- 在 AgentContext 中新增 task_id 字段，用于标识当前智能体任务 ID
- 统一 TaskTool 构造函数，使用 Option<u32> 表示最大嵌套深度限制
- 调整子代理工具注册，适配新的 TaskTool 构造函数
- 修改子代理运行时创建逻辑，传递并设置 task_id 和 parent_task_id
- 删除重复的 task_id 提取函数，改用传递参数进行关联
- 深度校验改为判断 Option，支持无深度限制和有限层数
- 增强子代理间的任务层级关联，正确传递 parent_task_id 元数据
 2026-06-18 11:41:40 +08:00
oudecheng
e506ffd539 feat(agent): 支持子孙智能体的父任务链路传递 
- 在 agent_factory 和子代理相关结构体中新增 parent_task_id 字段
- 协议层序列化、反序列化及 WebSocket 适配器支持 parent_task_id 信息传递
- todo_read 与 todo_write 工具添加 parent_task_id 以保持任务层级一致
- 在 DefaultSubAgentRuntime 中实现从 session_id 提取 parent_task_id 的逻辑
- 子智能体创建孙智能体时，正确设置并传递 parent_task_id 元数据
- 前端 useChat 钩子过滤孙智能体的 TaskStarted 事件，避免视图串扰
 2026-06-18 11:30:47 +08:00
oudecheng
761f8577be fix(tools): 修正 scope_key 计算逻辑及任务运行时 topic_id 设置 
- 调整 scope_key_from_context 根据 nesting_depth 区分主代理和子代理的 key 策略
- 主代理优先使用 topic_id，子代理使用 session_id 避免污染父代理 todo
- 任务运行时将 parent_topic_id 传入 topic_id，修正为正确的引用
- 完善函数注释，增强代码可读性和维护性
 2026-06-18 10:40:27 +08:00
oudecheng
879f5f243a feat(task): 增加子代理最大嵌套深度支持，更新相关文档和提示 2026-06-17 17:55:22 +08:00
oudecheng
631c61fea2 feat(agent): 支持子代理最大嵌套深度控制 
- 在配置结构体中新增 max_nesting_depth 字段，设置子代理最大嵌套深度
- 在 AgentFactory、todo_read、todo_write 等处初始化 nesting_depth 字段为 0
- 允许 Task 工具注册，使用 max_nesting_depth 控制子代理嵌套层数
- SubAgentRuntimeConfig 新增 max_nesting_depth 配置项，默认值为 1
- TaskTool 新增 max_nesting_depth 字段和带深度限制的构造函数
- 任务执行时增加嵌套深度校验，超过最大深度返回错误提示，防止无限递归创建子代理
 2026-06-17 14:43:55 +08:00
oudecheng
8af7edfb32 fix(todos): 修复子智能体 todo 列表污染主智能体的问题 
子智能体创建时 ToolContext.topic_id 继承了父智能体的 topic_id，
导致 scope_key_from_context 优先使用 topic_id 作为 scope key，
父子智能体共享同一个内存中的 TodoItem 列表。

修改为 topic_id: None，使 scope_key_from_context 回退到
子智能体唯一的 session_id (sub:{parent}:task:{uuid})，
实现完全隔离。消息持久化和前端加载链路均不受影响。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-16 17:46:25 +08:00
oudecheng
027e8661bc feat(todo): 实现待办事项列表的动态刷新和状态管理 
- 在 runtime 中为待办事项添加基于系统时间的时间戳
- 修复前端 TodoPanel 组件的数据刷新逻辑
- 添加 setTodos 状态更新函数以支持待办事项清空操作
- 实现根据当前视图动态选择请求命令的功能
- 优化待办事项数据的过滤和映射处理流程
 2026-06-15 16:20:40 +08:00
ooodc
b67848180b feat(stream): 添加子代理消息流增量处理功能 
- 在 runtime 模块中新增 handle_stream_delta 方法，支持子代理消息流的增量和结束事件处理
- 为流消息新增 stream_message_id，用于标识和管理消息流状态
- 修改 ConversationContext 初始化，加入 stream_message_id 互斥锁字段
- 更新 web 端 Chat 组件，添加对流增量内容的条件渲染，避免空字符串渲染
- 在 useChat 钩子内增加对 stream_delta 和 stream_end 类型消息的识别和处理逻辑
- 实现流增量消息的累积更新，合并多次流增量内容和推理文本
- 处理流结束消息时的无操作逻辑，确保消息流完整性
- 对 assistant_response 消息进行替换更新，修正流消息的最终呈现内容
 2026-06-14 12:51:26 +08:00
ooodc
fc7df67474 feat(streaming): 支持流式文本增量与结束信号功能 
- 新增 StreamDelta 和 StreamEnd 类型，支持流式数据增量传输
- 扩展 LLMProvider trait，添加带回调的 chat_with_streaming 接口
- 修改 OpenAI Provider 实现，支持流式聊天回调传输增量数据
- Agent 流处理改为异步消费增量消息并传递给前端
- 保证流式增量和最终消息使用相同消息 ID 以便前端替换
- 修改消息总线和协议层，支持携带和识别流式消息的消息 ID
- 客户端 CLI 通过增量输出实现交互式流式响应显示
- Web 前端接收流式增量消息，追加到对应消息，实现实时显示
- 各通道（飞书、微信）支持转发流式增量和结束消息
- 任务工具运行时添加消息 ID 支持，保持消息一致性
- 统一消息构造函数新增流式增量和结束信号的构建方法
 2026-06-14 10:24:52 +08:00
ooodc
229221aab1 refactor(todo): 重构待办事项管理逻辑及更新状态规则 
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段
- 强制每个任务都必须有唯一 id，且由用户负责生成
- 修改合并模式逻辑，merge=true 下保留未提及的旧任务
- 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress）
- 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled
- 优化状态转换校验，允许特定状态间合法切换
- 简化任务变更消息，移除详细的新增/更新/移除统计
- 更新文档和示例，明确 id 必须由用户生成和使用
- 修复和补充测试，增强状态转换和合并模式验证
- 调整任务时间戳生成逻辑，统一使用当前时间及索引
- 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
 2026-06-13 17:38:18 +08:00
oudecheng
24bbd5f8c9 feat: 子代理 todo 列表支持 — 进入子代理视图时显示子代理的待办 
- SubAgentEmitter 添加 todo_write 持久化（照搬 BusToolCallEmitter 模式）
- DefaultSubAgentRuntime 加 store 字段，透传给 emitter
- Command::ListTodos 加 task_id 参数
- list_todos handler: 当 task_id 存在时，scope_key = sub:{parent}:{task_id}
- 前端: 子代理视图下自动带 task_id 请求子代理的 todo

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-12 18:01:57 +08:00
oudecheng
881fcace47 feat: 添加 todo_write 工具，支持全量替换和增量合并两种模式 
- Tool: 纯内存实现 (Arc<RwLock<HashMap>>)，零 DB 依赖，解耦持久化
- 状态机: pending → in_progress → completed/cancelled，单 in_progress 约束
- merge=false: 全量替换模式（默认）
- merge=true: 增量更新模式，只传变更的项，其余保留
- 隔离: scope_key = topic_id.unwrap_or(session_id)，topic 和子代理隔离
- 持久化: TodoRepository trait + SessionStore SQLite 实现，在 Session 拦截器层完成
- 前端推送: WsOutbound::TodoList 事件
- Prompt: TodoPromptProvider 中文指令，子代理模板也包含
- 测试: 16 个单元测试，全部通过

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-12 14:19:07 +08:00
oudecheng
cedd8b2a69 feat: 添加 topic_id 字段到消息结构，优化消息处理逻辑 2026-06-12 12:22:21 +08:00
oudecheng
0ce89a0e4e feat: 添加 reasoning_content 字段到多个消息结构，支持思考过程展示 2026-06-11 12:04:52 +08:00
ooodc
e8a3a47ac7 feat: 添加 TaskStarted 事件，支持任务开始通知功能 2026-06-03 21:53:37 +08:00
oudecheng
f8fc0f7d0f feat: 添加工具结果处理功能，支持执行时长记录和显示 2026-06-02 16:15:05 +08:00
oudecheng
06756a4816 fix: 修复消息持久化缺失 topic 关联和 assistant 文本丢失 
- PersistingEmittedMessageHandler 新增 topic_id 参数，使用 append_message_with_topic 替代 append_message
- agent_loop 的所有退出路径中为最终 assistant 文本添加 emit_live_tool_call_message
- 更新 finalize_result filter，live_emitter 存在时抑制所有消息的 post-loop 广播

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-05-29 18:09:00 +08:00
oudecheng
d0051baa07 refactor: 消息持久化从批量改为实时逐条，通过装饰器模式实现 
- 新增 PersistingEmittedMessageHandler 装饰器，在 emitter 广播前逐条落库
- processor 和 task/runtime 使用装饰器包裹 emitter，替代 post-loop 批量写入
- 移除 session_history 中的批量 DB 写入，仅保留内存历史更新
- execution 中跳过已由 live emitter 实时广播的工具消息，避免重复
- 前端支持运行中 task 工具卡片"查看实时进度"跳转子智能体视图

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-05-29 16:47:57 +08:00
oudecheng
3b0b4c1f2e refactor: 消息持久化改为批量单事务插入 
- 新增 append_messages_batch 方法，所有消息在一个事务内插入
- session_history 移除逐条 append_persisted_message，统一走批量路径
- 子智能体消息保存从 for 循环改为批量调用

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-05-29 13:02:15 +08:00
oudecheng
4cb26b5b67 feat: 子智能体任务消息查看，实时广播工具调用事件 
- 新增 LoadTaskMessages 命令，加载子智能体任务的历史消息
- SubAgentEmitter 通过 MessageBus 实时广播子智能体工具调用
- 前端新增子智能体视图，支持导航进入/退出子智能体会话
- 外部渠道过滤子智能体事件，避免推送到飞书/微信
- ToolCall/ToolResult 新增 subagent_task_id 字段

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-05-29 11:15:38 +08:00