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

563 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
oudecheng
7b459b8ca1 feat(config): 压缩算法关键参数暴露到设置页面 
将 4 个压缩参数（threshold_ratio、llm_compaction_threshold_ratio、
truncate_max_tokens、preserve_count）从硬编码提取到 config.json 顶层
compaction 节，前端新增 CompactionTab 供用户调整。

后端：
- config: 新增 CompactionConfig 结构体，Config 新增 compaction 字段
- context_compressor: 4 个参数内聚到 ContextCompressor 实例字段；
  新增 with_compaction_config() 构造函数和 truncate_tool_results() 方法；
  对用户配置做防御性 clamp（ratio ∈ [0.1,1.0]，整数 ≥ 1）
- agent_loop: 调用 compressor.truncate_tool_results() 实现零参数耦合
- agent_factory: 新增 build_compressor() 方法，in-loop 与 sync 兜底
  两条压缩路径共用同一套用户配置
- session: with_factories 改用 agent_factory.build_compressor()，修复
  sync 压缩路径忽略用户配置的 P0 问题

前端：
- types: 新增 CompactionConfig 接口，TabId 新增 'compaction'
- 新建 CompactionTab.tsx，4 个 number input 分两组 SectionCard
- constants + ConfigPage: 注册"上下文压缩" Tab（Archive 图标）

清理：删除无调用方的 from_provider_config/from_runtime_config/with_config
方法及 DEFAULT_THRESHOLD_RATIO/LLM_COMPACTION_THRESHOLD_RATIO 常量。

测试：context_compressor 18 + session 31 + agent_loop 42 全通过。
 2026-08-06 11:03:56 +08:00
oudecheng
fe7037e4ad fix(feishu,channel): 修正 reaction 语义并增容 bus 队列，避免丢最后一条消息 
- feishu.rs: 仅终态消息(AssistantResponse | ErrorNotification)成功发送
  后才移除 reaction，ToolCall 等中间过程不再触碰；发送失败/空内容
  保留 reaction 作为异常信号，解决『reaction 被提前移除掩盖最终响应
  丢失』的语义错位问题
- manager.rs: MessageBus 容量从 100 扩至 256，降低多 topic 并发场景下
  bus 级 try_send 的瞬时积压丢弃概率

与前一提交的 outbound_dispatcher 双队列优先级重构配合：AssistantResponse
/ ErrorNotification 走独立 high 队列必达，终态消息送达后才移除 reaction，
彻底解决『飞书经常丢最后一条消息且 reaction 状态误导』的问题。
 2026-08-06 10:08:36 +08:00
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
bc26c66169 chore: 升级版本号至 0.3.1 并更新 CHANGELOG 
收录自 0.3.0 以来 19 个 commit 的变更，涵盖五大方向：
- 历史压缩保留原消息（双视图分离）
- Topic 维度 token 统计
- 前端渲染稳定性修复
- 工具执行可靠性修复
- 网关吞吐与存储查询优化
 2026-08-05 12:56:58 +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
beb7b581a6 fix(web): 主代理执行结束时刷新 topic 列表以更新 token 统计 
LLM usage 在消息持久化后已写入 DB，主代理本次执行结束时触发 bumpTopicRefreshTrigger，list_topics 重新读取最新 token 统计并更新侧边栏。
 2026-08-05 11:15:12 +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
235f57c9ae feat(settings): 新增设置页重启按钮，区分保存后触发与手动触发 
状态从 showRestartDialog: bool 改为 restartDialogMode: 'saved' | 'manual' | null，三态清晰区分触发来源。

改动：- 保存后自动弹出 'saved' 模式对话框（标题 '配置已保存'，按钮 '稍后'） - 新增独立 '重启' 按钮，点击弹出 'manual' 模式对话框（标题 '重启服务'，按钮 '取消'），dirty 时提示未保存更改 - 重启中禁用保存与重启按钮，handleClose 阻断关闭并提示 - ESC 在对话框打开时仅关闭对话框，不关闭整个页面 - 重启按钮 loading 状态与 restarting 同步
 2026-08-05 09:43:05 +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
4e74d66a7c fix(web): 修复流式期间消息重渲染、WebSocket 无谓重连与新消息计数错误 
- MessageBubble 用 React.memo 包裹，流式 delta 只追加到最后一条消息，
  其余消息引用不变可被 memo 跳过，避免 N-1 条历史消息无谓重渲染
- useWebSocket 用 useRef 存储回调最新引用，connect 不再依赖回调引用，
  避免调用方回调变化触发 disconnect+connect 重连
- MessageList 用 prevMessageCountRef 追踪消息条数变化，仅当真正新增
  消息条数时才累加 newMessageCount；流式 delta 不增加条数不再误计数，
  滑到底部按钮触发的清零路径与时序经审查覆盖各种边界场景
 2026-08-05 08:10:44 +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
134aa073d5 docs: CHANGELOG 补充 LLM 重试机制条目并修正 commit 计数 2026-08-04 13:10:59 +08:00
oudecheng
949ba650ee chore: 删除临时计划文件 PLAN.md 2026-08-04 12:53:49 +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
94a0dd0169 ci: 扩大构建与测试覆盖范围，纳入集成测试与二进制入口 
cargo build --lib 改为 cargo build，确保 main.rs（gateway 二进制入口）也被编译验证；
cargo test --lib 改为 cargo test，纳入 tests/ 目录的集成测试。
test_request_format.rs 的 8 个序列化测试此前从未在 CI 中运行，现在会实际执行；
test_integration.rs / test_tool_calling.rs 中的 #[ignore] 测试会被编译但跳过执行（需真实 API key）。
 2026-08-04 08:09:51 +08:00
oudecheng
b790a39c1f fix(cargo): 修正依赖分类错误，将跨平台依赖移出 windows target 段 
rmcp/schemars/http/tower-http/rust-embed 均为跨平台 crate 且在源码中被无条件引用，错放在 [target.'cfg(windows)'.dependencies] 下导致 Linux 构建必然失败。仅 windows-sys 是真正的 Windows 专用依赖，保留在 target 段。
 2026-08-04 07:58:51 +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
c724bbf864 chore(web): prettier 一次性格式化并在 CI 启用 format:check 
对 47 个前端文件统一执行 npm run format，消除存量格式差异。
随后在 CI 与 Makefile check 中启用 format:check，确保后续提交强制遵守 prettier 风格。
 2026-08-03 23:25:22 +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
c484a918b5 feat: 添加 build.rs 自动构建前端，cargo build 时自动执行 npm install + npm run build 2026-08-03 17:29:46 +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
f8e1f3c2eb chore: bump 版本至 0.2.0 并新增 CHANGELOG 
- Cargo.toml / Cargo.lock: 0.1.2 → 0.2.0
- 新增 docs/CHANGELOG.md，记录 0.2.0 相对 0.1.2 的 47 个 commit 迭代内容，
  按新增功能/性能优化/修复/重构/内部改进分类，涵盖四大方向：
  CapabilityPolicy 统一策略模型、专家/子代理模型独立配置、
  话题级并发隔离、Agent Loop 性能优化
 2026-07-31 08:28:36 +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
649ea2998d feat(web): 集成 ModelSelector 实现主 agent 模型选择 UI 
新建 ModelSelector 组件(参考 ExpertSelector 交互模式): 显示当前生效模型,下拉支持 provider/model 选择,草稿暂存+应用提交,重置为默认。

ChatContainer 用共享 flex 容器并排渲染 ExpertSelector 和 ModelSelector,ExpertSelector 简化外层 wrapper(去除冗余 padding/max-width)。

API 层: 新增 sessionSelectedModel 端点常量和 getSelectedModel 函数; types.ts 为 ModelOptionsResponse 添加 current 字段。

按钮语义: 已覆盖时显示 provider/model,未覆盖时显示 '默认 provider/model'。
 2026-07-30 23:25:14 +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
5ff1e8455c feat(web,docs): 前端支持模型下拉选择并更新 README 专家系统章节 
- 前端类型 ExpertItem/SubagentItem 新增 provider/model 字段，新增 ModelOptionsResponse 类型

- API 层 createExpert/updateExpert/updateSubagent payload 支持 provider/model，新增 listModelOptions

- ConfigPage 专家/子代理模态框新增模型配置 SectionCard（Provider/Model 下拉框，留空继承默认）

- 空字符串转 undefined 传后端，避免 P0 反序列化为 Some(vec![]) 导致全禁

- README 新增第 8 节专家系统，更新子代理 SUBAGENT.md 字段说明（含 provider/model 和子代理黑白名单）

- README 新增 max_nesting_depth 配置项说明，重排后续章节编号
 2026-07-30 22:44:28 +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
003eab4f21 fix(web): 修复点击设置后白屏（React hooks 顺序违规） 
子模态框 ESC 处理的 useEffect 被放在 if(loading)/if(!config) 条件 return 之后，导致首次渲染（loading=true）时不执行该 hook，config 加载后重新渲染才执行 → hooks 数量不一致 → React error #310 白屏崩溃。

修复：将 useEffect 移到所有条件 return 之前，与其他 hooks 放在一起。
 2026-07-30 18:56:43 +08:00