wunianxiao
|
a04447c7bc
|
docs: 为全部 38 个源文件补充详细模块级注释
为 iAs 项目的所有 Rust 源文件添加了系统化的模块级文档注释(//!),
覆盖全部 src/ 下的文件。每个文件包含模块职责、架构设计、数据流
和关键设计决策的说明。
主要变更:
- 入口/CLI: main.rs, cli.rs — 系统架构概览、子命令说明
- Daemon/Worker: daemon.rs, worker.rs — 三消费者架构、旧架构说明
- 微信通道: mod.rs, client.rs, types.rs — API 端点、登录流程
- LLM 系统: mod.rs, types.rs, provider.rs, deepseek.rs, conversation.rs
— 架构分层、流式处理、工具循环、摘要机制
- 上下文管理: mod.rs, types.rs, builder.rs, tools.rs
— Checkpoint 机制、Token Budget、双重摘要
- 工具系统: mod.rs, types.rs, builtin.rs, approval.rs
— 两层元工具架构、审批流程
- 内置工具: mod.rs + 6 个工具 — API 端点、认证方式、参数说明
- 消息队列: mod.rs, message_queue.rs, runner.rs
— 公平轮转算法、三消费者路由
- 数据库/状态/调度/日志: db/mod.rs, state.rs, scheduler.rs, logger.rs
— 表结构、回退策略、定时任务、日志初始化
|
2026-06-10 09:46:42 +08:00 |
|
wunianxiao
|
713cbb7cc3
|
fix: 修复 daemon 架构中 3 个 blocking 正确性 bug
1. call_capability 元工具不可用
- execute_tool() 中缺失 call_capability 处理分支
- 添加解包 {name, prompt} → 提取目标工具并派发的逻辑
2. tool_call_id 传空字符串
- Tool Consumer 中 tool_call_id 被 _ 忽略,ToolResult 传空串
- 改为使用 LLM 原始 tool_call_id 传递
3. 高风险工具审批无限循环
- Tool Consumer 无条件触发审批,approved_tool 从未被读取
- ToolCall 新增 approved 字段,已批准的工具跳过审批
- ToolExecutor 根据 approved_tool 设置标记
4. Session TTL 时间戳不更新(should-fix)
- ToolResult 回喂时更新 last_access,防止长对话被误清理
5. 其他清理
- load_memories 魔数字符串比较改为 starts_with
- _sock_path 添加文档说明保留用于兼容
- MessageKind::ToolCall 新增 approved: bool 字段
|
2026-06-09 22:10:39 +08:00 |
|