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

438 Commits

Author SHA1 Message Date
oudecheng
e037de88a2 fix(agent,gateway): 替换 unreachable!() 为防御性错误返回 
将 run_final_summary 和 send_with_retry 中的 unreachable!() 替换为
错误返回，避免未来重构导致循环体未返回时 panic 终止所有会话。

- agent_loop.rs: run_final_summary 兜底构造错误 AgentProcessResult，
  含 emit_live_tool_call_message 推送，与 Err 不可重试路径一致
- outbound_dispatcher.rs: send_with_retry 兜底返回 ChannelError::SendError，
  覆盖 RETRY_DELAYS_SECS 为空数组的边界情况

同时 outbound_dispatcher.rs 包含优先级队列重构：高优消息使用独立
high 队列和扩展重试策略，保证最终响应不被中间过程挤占丢弃。
 2026-08-06 10:01:02 +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
fa420b713f feat(gateway): 添加 HTTP API 认证与 CORS 防护，修复密钥泄露风险 
- 新增 auth_token 配置项：非 loopback 绑定强制认证，loopback 可选加固
- 新增 auth.rs：loopback 判定（IpAddr 解析）、常量时间 token 比较、RFC 6750 Bearer 解析
- 新增 Bearer token 中间件（/api/*）与 WebSocket ?token= 校验
- 新增 CORS layer：loopback 镜像 Origin 防 DNS rebinding，非 loopback permissive
- 修复 .gitignore 遗漏 tests/test.env，补充通用 *.env 规则
- 修复前端 experts/skills/subagents.ts 直接 fetch 不带 token（13 处），统一走 authedFetch
- config.json host 从 0.0.0.0 改回 127.0.0.1
- mask_config/save_config 处理 auth_token 掩码与保留
- ConnectionTab/GatewayTab 增加认证 token 配置入口
 2026-08-05 22:41:00 +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
81fbee4878 feat(storage): 历史压缩保留原消息，前端展示完整对话、LLM 用压缩摘要 
将压缩流程从物理删除原消息改为标记位 is_compacted 分离两个视图：
- LLM 视角(load_messages_for_topic)：只看 is_compacted=0 的压缩摘要+新消息
- UI 视角(load_messages_for_topic_full)：看原消息(含 is_compacted=1)+新消息，排除摘要

新增 compact_topic_history：不删除原消息，仅打标记+插入摘要，
同事务内删除旧摘要避免累积。修复 token 统计因压缩丢失 usage 的问题。
 2026-08-05 12:46:43 +08:00
oudecheng
bb2774c6b5 feat(web): token 统计从侧边栏迁移到右侧面板，支持子代理每轮刷新 
- 新增 TopicTokenStatsPanel 面板，显示五字段 + 上下文占用进度条

- 移除 TopicList 侧边栏的 token 统计显示

- 后端新增 get_session_token_stats，按 session_id 精确查询子代理 token

- TaskMessagesLoaded 协议扩展 token_stats 字段，ws.rs 转发至前端

- useMessages/useSubAgentView 每轮 assistant_response/execution_completed 触发刷新

- App.tsx 根据当前视图分派 list_topics（主代理）或 load_task_messages（子代理）

- 抽取 utils/tokenStats.ts 共享格式化与占用率计算函数
 2026-08-05 12:09:40 +08:00
oudecheng
6fc6d5628f perf(gateway): send_with_retry 对 ChannelFull 不重试，加速队列消费 
ws 连接队列满时，sender task 原本重试 3 次浪费 1+2+4=7s，期间 channel 队列堆积。新增 ChannelError::ChannelFull 变体区分队列满错误，CliChannel::send 在 try_send Full 时返回该变体；send_with_retry 遇到 ChannelFull 立即返回不重试，sender task 记 warn（预期背压丢弃）而非 error。

- base.rs: 新增 ChannelFull 变体及 Display 实现
- cli.rs: try_send 错误区分 Full（ChannelFull，不可重试）与 Closed（SendError，可重试）
- outbound_dispatcher.rs: send_with_retry 短路返回 ChannelFull；run_sender_task 区分日志级别；新增 TestChannel.with_channel_full 及单测验证不重试（500ms 阈值内返回 + send 仅调用一次）
 2026-08-05 11:14:53 +08:00
oudecheng
deab3699fe fix(web): token 统计按 topic_id 聚合，避免同 session 多 topic 共享总和 
batch_session_token_stats 重命名为 batch_topic_token_stats，SQL 从 GROUP BY session_id 改为 GROUP BY topic_id，修复同一 session 下多个 topic 显示相同 token 总和的问题。

子代理天然隔离：子代理消息的 topic_id 属于子代理自身的 topic，不在主 topic 列表中。topic_id IN (...) 自动排除 NULL topic_id 的旧消息。

对抗性审查补充：latest assistant 消息查询的 JOIN 条件 m.topic_id = latest.topic_id AND m.seq = latest.max_seq 可能匹配到子代理消息（seq 是 session 级递增，主/子 session 可能有相同 seq）。在外层 JOIN 添加 WHERE m.session_id NOT LIKE 'sub:%'，避免重复行导致 stats.entry(tid) 被覆盖、结果不确定。
 2026-08-05 09:43:59 +08:00
oudecheng
2255d2e774 fix(tools): 修复 shell 工具超时未生效 
根因 A：子进程派生守护进程（如 adb daemon）继承 stdout 管道写端，父进程退出后 EOF 永不到达，child.wait() 分支进入无界 drain 循环，select! 已退出导致 deadline 失效，永久阻塞。

根因 B：deadline 分支调用 is_process_waiting_on_stdin 误判 socket 等待为 stdin 等待，且 should_return_pending 关键词过宽，绕过硬 kill 转 pending 会话，表面未超时实则进程未终止。

修复：- 新增 STREAM_DRAIN_MS=1000，用 tokio::time::timeout 包裹 drain 循环 - 新增 kill_and_reap：start_kill → 5s wait 超时 → kill().await + 3s 兜底 - 收集 read_tasks JoinHandles，返回前 abort 避免任务泄漏 - deadline 分支移除绕过逻辑，一律硬 kill 并返回超时错误 - timeout 参数改用 .clamp(1, MAX_TIMEOUT_SECS) 防御 timeout:0
 2026-08-05 09:42:53 +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
5eec77ae10 perf: 减少热路径无谓拷贝与重复正则编译，并跳过已完成迁移 
- agent_loop::filter_images_by_age_and_count 改返回 Cow<[ChatMessage]>，
  无图片或无需过滤时零拷贝返回原切片引用，避免每次 LLM 调用都完整克隆消息列表
- anthropic::convert_image_url_to_anthropic 用 OnceLock 缓存 data URL 正则，
  避免每次图片转换都重新编译正则
- memory_scope_key 迁移用 PRAGMA user_version 记录已迁移版本，
  避免每次启动都执行全表 DELETE + UPDATE
 2026-08-05 08:10:36 +08:00
oudecheng
adada2652c fix(web): 修复话题重命名预填字段与写入字段不一致 
Bug: 点击铅笔编辑时，输入框显示的是 topic.title（系统生成的 id+时间），
而不是用户看到的 topic.description（AI 生成的摘要）。且后端 rename 写入 title，
但列表显示优先 description，导致改名后视觉上无变化。

根因：显示用 'description || title'，编辑预填用 'title'，写入也改 'title'，
三者不一致。

修复:
- 前端 startEdit: 预填 'description || title'（与显示逻辑一致）
- 后端 rename_topic: 改用 update_topic_description 写入显示字段，
  保留 title 作为内部标识；'未变化'比较也基于当前显示值
- 新增测试: 验证有 description 时比较逻辑基于 description 而非 title
 2026-08-04 23:57:04 +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
2e4b1931a6 feat(tokens): 添加 topic 维度 token 消耗与上下文窗口占用统计 
后端：
- openai provider 流式响应启用 stream_options.include_usage，从 SSE 末帧捕获 usage
- ChatMessage 新增 MessageUsage（prompt/completion/total/context_window_tokens）
- agent_loop 三处 LLM 调用点持久化 usage，含 context_window_tokens
- storage 新增 context_window_tokens 列及 migration，batch_session_token_stats 聚合查询
- last_prompt_tokens 查询过滤 prompt_tokens IS NOT NULL，跳过 error/cancel 消息
- build_topic_summaries 简化签名，context_window_tokens 从消息记录读取
- protocol 扩展 TopicTokenStats，按 session_id 聚合天然隔离子代理

前端：
- protocol.ts 新增 TopicTokenStats 类型
- useTopics 映射 token_stats 到 Topic
- TopicList 展示总 token 消耗与上下文占用百分比（绿/黄/红三色）

测试：outbound_dispatcher 4 个测试修复（drop(bus) 不关闭 bus，改用 abort）
 2026-08-04 17:01:54 +08:00
oudecheng
07247ed140 perf(storage): get_topic_message_count 改用 COUNT(*) 查询 
原实现调用 load_messages_for_topic 加载该 topic 的所有消息
（含 content、tool_calls_json 等大字段反序列化）到内存，
仅为调用 .len() 计数。长会话可能加载数千条消息，且在
list_sessions 列出所有 topic 时会按 topic 数量倍增。

改为 SELECT COUNT(*) FROM messages WHERE topic_id = ?1，
在数据库侧计数：无需反序列化任何字段，命中已有的
idx_messages_topic_seq(topic_id, seq) 索引。

对 N 条消息的 topic，从 O(N) 内存 + 反序列化降为 O(1)
内存 + 索引扫描。新增测试覆盖计数正确性与隔离性。
 2026-08-04 15:18:21 +08:00
oudecheng
924017fe7b fix(web_fetch): 加固 SSRF 防护，对齐 http_request 实现 
修复 extract_host 的 4 处 host 解析缺口，使 web_fetch 与
http_request 的内网拦截策略完全一致：

- 拒绝 userinfo（authority 中的 "@"）：防止 http://evil.com@127.0.0.1/
  以 evil.com 作为表面 host 绕过检查，实际请求发往 127.0.0.1
- 拒绝 IPv6 字面量（authority 以 "[" 开头）：防止 http://[::1]/
  被拆分为 "[" 导致 IpAddr::parse 失败而放行
- trim_end_matches('.') 规范化末尾点：防止 http://127.0.0.1./
  因标准库解析失败绕过检查（reqwest 视为 FQDN 解析为 loopback）
- is_private_host 补充 is_broadcast/is_multicast：拦截
  255.255.255.255 与 224.0.0.1 等广播/组播地址

新增 5 个针对性测试覆盖以上场景。
 2026-08-04 15:17:52 +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
6901659849 fix(mcp): 限制 server 名称字符并兜底 tool_name 清洗 
OpenAI 要求 function name 匹配 ^[a-zA-Z0-9_-]+$，否则整个请求 400。MCP 工具名由 mcp_{server_key}_{tool_name} 拼成，两个输入源：server_key 用户可控（前端 addMcp/renameMcp 正则校验 + toast），tool_name 由 MCP server 上报（后端 sanitize_tool_name 替换非法字符为 _）。

前端：MCP 卡片头部改用 MapEntryHeader 支持点击重命名，状态指示灯移到上方独立行。顺手修了 MapEntryHeader 进入编辑时 val 未同步当前 name 的 bug。

后端：保留 server_key 和 tool_name 原值用于路由，仅清洗 LLM 可见的 full_name，并在发生清洗时打 warn 日志便于定位。
 2026-08-04 11:17:41 +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
1e2d64e28b fix(web_fetch): 禁用 HTTP 重定向，防止 SSRF 重定向绕过 
validate_url 只校验初始 URL 的 host，若跟随 302 跳转，攻击者可用公网 URL
重定向到 169.254.169.254（云元数据）或 127.0.0.1 等内网地址，绕过 is_private_host
的 SSRF 防护。与 http_request 工具保持一致，使用 redirect::Policy::none()。
 2026-08-04 08:25:57 +08:00
oudecheng
cd314742ad fix(test): 修复 anthropic 错误链嵌套测试为真正的 source 链 
对抗性审查发现 test_format_error_chain_nested 是无效测试：
声称测嵌套错误链但实际没构造 source 链，inner 变量被 let _ 抑制。
改用 thiserror 构造真正的 #[source] 嵌套错误，验证 'caused by' 拼接。
 2026-08-03 23:47:43 +08:00
oudecheng
e6b2fcfb6d docs+test: 补充架构文档与 anthropic provider 单测 
P3 文档:
- 新增 ARCHITECTURE.md，聚焦数据流与 7 个关键设计决策
  （MessageBus 解耦/SessionPool 隔离/AgentLoop 循环/SQLite 池化/重启机制/嵌入静态文件/Safety Guard）
- 不写代码导读，只写'为什么这样设计'，代码是唯一真相源

P2 测试:
- src/providers/anthropic.rs 曾零测试（396 行），补 15 个纯函数单测
- 覆盖：data URL 解析、图片过滤逻辑、内部字段过滤、响应反序列化、错误链格式化
- providers 模块测试密度 31% -> 提升，重点补齐 anthropic 空白
 2026-08-03 23:45:41 +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
f37a5ffe6e fix(platform): 收紧 safety guard 的 format 正则并按平台分组 
原 \bformat\s+ 正则精度不足，会误伤 dart format、buf format、
pytest --format 等合法命令；Remove-Item 大写正则经 to_lowercase
后永远匹配不到，是潜在 bug。

改动：
- format 正则收紧为 \bformat\s+.*[a-z]:，要求出现盘符才拦截
- 按 Platform 分组注入规则，Unix 不再注入 Windows 专用规则
- Remove-Item 正则改为小写，与 guard_command 的大小写处理一致
- 平台相关测试加 #[cfg] 属性，避免跨平台失败
- 新增 test_format_pattern_precision 覆盖危险命令与误伤场景
- 新增 test_legitimate_format_commands_not_blocked 回归测试

验证：
- cargo test --lib platform::  11/11 通过
- cargo test --lib tools::bash 13/13 通过
 2026-08-03 22:45:36 +08:00
oudecheng
c7ee6bb519 fix: 修复并发 sub-agent 持久化时 SQLite database is locked 错误 
将 7 个写事务从 BEGIN DEFERRED 改为 BEGIN IMMEDIATE,在事务开始即获取写锁,消除多 sub-agent 并发写入时的死锁路径。同时将 busy_timeout 从 5s 提升至 30s,为并发写者排队提供 100 倍余量。

根因:BEGIN DEFERRED 下多个事务可同时读 MAX(seq) 不持写锁,提交时互相阻塞,5s timeout 耗尽后返回 SQLITE_BUSY。BEGIN IMMEDIATE 强制写者串行排队,顺带消除 MAX(seq)+1 竞态导致的 UNIQUE 约束冲突。
 2026-08-03 22:15:13 +08:00
oudecheng
2a5a0277c0 feat(web): 添加话题重命名功能 
新增 RenameTopic 命令与 TopicRenamed 协议消息，复用存储层已有的
update_topic_title 方法。后端响应携带刷新后的完整 topic 列表，
前端零额外往返即可同步侧边栏。

前端 TopicList 侧边栏增加内联编辑入口：悬停显示铅笔图标，点击进入
编辑模式，Enter 提交 / Esc 取消 / blur 取消；通过 onMouseDown
preventDefault 防止按钮点击时 input 提前失焦。

包含 5 个单元测试覆盖成功、空标题、不存在、标题未变跳过写入、
can_handle 等场景。
 2026-08-03 22:10:25 +08:00
oudecheng
389e222b11 feat: 默认 max_tool_iterations 调整为 1000 2026-08-03 14:46:49 +08:00
oudecheng
0aa9050b12 fix: 修复 3 个失败测试 - agent_md_template 写入模板内容/StreamingAccumulator BTreeMap 保序/source_order 断言补全 2026-08-03 14:26:20 +08:00
oudecheng
3b0de7d071 refactor: 清理未使用的 dead code 函数与方法 2026-08-03 14:21:01 +08:00
oudecheng
7f05545488 fix: session pool 锁范围收敛与 replace_todos 原子性 
- SessionPool.ensure_session_internal 改为 double-checked locking：
  先短暂持锁检查存在性，释放锁后执行耗时的 session 创建（含配置加载、
  agent 工厂构造），再次持锁插入并处理竞态。避免跨 session_factory.create().await
  持有全局锁导致所有 channel 的 session 访问串行化。
- storage::replace_todos 用 transaction() 包裹 DELETE + INSERT，保证原子性：
  中途失败自动回滚，避免 todos 列表丢失且无法恢复。事务内复用同一连接
  查询返回值，消除 drop(conn) 后重新 pool.get() 的冗余。
 2026-07-31 08:23:13 +08:00
oudecheng
92db80dc3f perf(agent-loop): 缓存工具定义与轻量 token 估算，DB 写入 offload 至 blocking 池 
- 工具定义在 process() 循环外构建一次（快照语义：单次 process 内 Arc<ToolRegistry> 不变）
- 工具 token 估算循环外预算一次，避免每轮 serde_json::to_string 全量序列化
- 新增 estimate_text_tokens_from_chat_messages 直接基于 ChatMessage 累加字段长度，
  消除中间 text_only_messages: Vec<Message> 构造（N 条消息 × 5 字段双克隆 → 0）
- PersistingEmittedMessageHandler 用 spawn_blocking 包装 SQLite 同步写，
  解除 tokio worker 线程阻塞，不改变失败语义（仅记日志不阻断主流程）
 2026-07-31 08:22:58 +08:00
oudecheng
a825b10c48 feat(model): 主 agent 支持会话级模型覆盖 
新增 ModelSelectionStore 存储 session_id -> (provider, model) 映射,职责单一,仅依赖 std,不引入业务模块耦合。

AgentFactory::create 中按链式覆盖应用模型配置: 专家 frontmatter 覆盖 -> 用户手动选择覆盖(最高优先级)。

HTTP API: POST /api/session/select-model 设置/清除用户模型覆盖(校验 provider/model 存在性); GET /api/session/selected-model 读取当前 session 的用户覆盖(与 experts/selected 对称)。

在 build_session_manager 系列函数中创建并注入 ModelSelectionStore,GatewayState 持有 Arc<ModelSelectionStore> 供 HTTP handler 访问。
 2026-07-30 23:24:51 +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
89c444ad3f feat(gateway): 新增 /api/tools 与 /api/subagents/update 端点 
- /api/tools: 只读访问 ToolRegistry，返回 builtin + MCP 工具的 name/description/source

- /api/subagents/update: PUT 接口，调用 SubagentRuntime::update_subagent 写回 SUBAGENT.md frontmatter

- 路由表两处同步注册新端点
 2026-07-30 16:54:19 +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
oudecheng
4baa8e7a6b fix: 内存历史按 topic_id 键化，新增 replace_topic_history 修复 DB 压缩覆盖 
- SessionHistory.chat_histories 改为 topic_histories 按 topic_id 键化，消除多话题并发时内存历史互相覆盖的根因

- is_current_turn 改用 current_topic == original_topic_id 直接比较，替代失效的内存最新消息匹配判断

- 新增 ConversationRepository::replace_topic_history 按 topic 删除/插入消息，解决 replace_active_history 删除整个 session 消息的 pre-existing 问题

- compaction 路径改用 replace_topic_history，避免压缩时覆盖其他 topic 的 DB 消息

- switch_topic 不再 remove_history，不同 topic 历史独立存储互斥

- append_persisted_message 仅当 topic_id == current_topic 时更新内存，防止延迟消息污染新话题历史
 2026-07-28 15:32:42 +08:00
oudecheng
b042b45ac7 fix: 话题隔离 - topic_id 全程显式传递，修复消息错投与并发阻塞 
问题：WS 端一个话题执行中时新建另一话题发消息，新会话无响应
（串行锁按 chat_id 阻塞），且首个话题完成后用户消息错误出现在
旧话题而非新话题（执行路径多次从共享 UI 状态读取 topic_id 产生竞态）。

核心修复（第一性原则）：
执行上下文应在消息接收时一次性捕获，全程显式传递，不从共享可变
状态重复读取。

1. processor.rs: process_one 入口捕获 current_topic，传入 handle_message
   和 set_agent_cancel_token
2. session_message_service.rs: handle_message 签名加 topic_id 参数，
   透传给 MessageExecutionRequest
3. execution.rs: MessageExecutionRequest 加 topic_id 字段；
   - 串行锁键改用 topic_id（不同 topic 并发，同 topic 串行）
   - original_topic_id 优先用传入值，消除锁等待期间 topic 切换竞态
   - append_persisted_message 调用传入 original_topic_id
   - create_agent 调用传入 original_topic_id
4. session.rs: append_persisted_message 加 explicit_topic_id 参数；
   create_agent/create_agent_with_provider_config 加 explicit_topic_id；
   set_cancel_receiver/set_agent_cancel_token 加 topic_id 参数；
   pending_cancel_tokens 查找改为优先 topic_id（避免并发 topic 执行时
   cancel token 互相覆盖）

对抗性审查补丁：
- append_persisted_message: 仅当写入 topic 匹配当前活跃 topic 时才更新
  内存历史，避免旧 topic 的排队消息污染已切换到的新 topic 内存历史
- prepare_and_execute_scheduled_task: 锁前一次性捕获 topic_id，锁后
  复用同一值作为 original_topic_id，保证锁键与写入目标一致

已验证：cargo check 通过，gateway 模块 48 个测试通过（1 个预存在的
prompt 模板测试失败，与本次修改无关）。
 2026-07-28 14:19:20 +08:00
oudecheng
3a8da51936 refactor: 串行锁按 topic_id 键化，支持多话题并发执行 
将 chat_serial_locks 重命名为 topic_serial_locks，串行锁粒度从
chat_id 改为 topic_id。同一 topic 的消息处理仍串行执行，不同
topic 之间互不阻塞，为后续多话题并发修复铺路。

本提交仅重命名锁结构和访问方法，调用点仍用 chat_id 作为锁键
（回退兼容），不影响现有行为。
 2026-07-28 14:17:12 +08:00
xiaoxixi
56612389ae 改用gray_matter解析md头元数据，增加相应的日志 2026-07-21 16:33:55 +08:00
oudecheng
141ffda1ee feat: 实现聊天消息的串行锁，确保同一聊天的消息处理串行执行 2026-07-15 17:47:52 +08:00
oudecheng
303f6d83e3 feat: 添加工具调用序列的前向检查，确保工具消息紧随助手消息后 2026-07-15 16:36:13 +08:00
oudecheng
cde41e32a8 refactor: 优化工具使用说明，简化记忆检索和写入规则 2026-07-13 17:00:40 +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
c276381d6c 增加整理意识，确保同类工作输出到同一文件夹 2026-07-08 16:32:43 +08:00
oudecheng
58f461c953 fix: 修复 SSRF 重定向绕过 + 符号链接路径遍历 + TodoItemSummary 字段缺失 
P0: src/tools/http_request.rs SSRF 重定向绕过
  - reqwest::Client 默认跟随最多 10 次重定向，is_private_host 仅检查初始 URL
  - 攻击者可用公网 URL 返回 302 → http://127.0.0.1/ 或
    http://169.254.169.254/（云元数据端点）绕过防护访问内网
  - 修复：.redirect(reqwest::redirect::Policy::none()) 完全禁用重定向

P1: src/tools/file_read/write/edit.rs 符号链接路径遍历
  - resolve_path 用 starts_with 检查但未 canonicalize
  - 攻击者可在 allowed_dir 内创建指向 /etc/passwd 的符号链接绕过限制
  - 修复：对 resolved 和 allowed 均执行 canonicalize 后比较
  - file_read: 文件必须存在，canonicalize 失败直接报错
  - file_write/edit: 文件可能不存在，降级到父目录 canonicalize

P1: src/protocol/mod.rs + list_todos.rs TodoItemSummary 字段缺失
  - 后端 TodoItemSummary 仅返回 4 字段，前端期望 7 字段
  - 缺失 priority, created_at, updated_at，前端 TodoPanel 无法显示
    优先级和时间戳
  - 修复：struct 补齐 3 字段，list_todos 构造时传递完整字段
 2026-07-08 16:23:09 +08:00
oudecheng
53a45ad7c4 修复mcp log 2026-07-08 15:52:36 +08:00
oudecheng
0a8d21fe40 fix: 修复专家发现与前端选择多项问题 
后端：
- split_frontmatter 兼容 CRLF/LF 行尾符，修复 Windows 下 EXPERT.md 解析失败
- Config::load_from 移除 fallback 到 cwd/config.json 的逻辑，避免静默加载项目目录配置导致 experts 字段缺失
- ExpertRuntime 新增 update_config 方法，save_config 时同步更新 ExpertRuntime 内部 config，sources 变更即时生效
- source_order 空数组不再兜底返回 [User, Project]，尊重用户关闭所有源的意图
- from_config_with_cwd 增加诊断日志，输出 enabled/sources/cwd/discovered

前端：
- ExpertSelector 弹窗改为按钮上方居中展开
- 专家卡片 name 完整显示（break-all），路径显示在卡片底部
- "管理专家"入口仅在无专家时显示
- 每次打开下拉都重新拉取列表和选中状态
- 监听设置弹窗关闭事件刷新已选专家（处理已选专家被禁用的情况）
 2026-07-08 14:53:30 +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