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
  — 表结构、回退策略、定时任务、日志初始化
This commit is contained in:
2026-06-10 09:46:42 +08:00
parent 74bb35bd26
commit a04447c7bc
28 changed files with 493 additions and 29 deletions
+16
View File
@@ -1,3 +1,19 @@
//! ## 内置工具实现集合
//!
//! 每个子模块对应一个具体的工具实现:
//!
//! | 模块 | 工具名 | 功能 |
//! |------|--------|------|
//! | `datetime` | `get_current_datetime` | 获取当前北京时间 |
//! | `weather` | `query_weather` | 和风天气查询(实时/预报/逐时) |
//! | `web_search` | `web_search` | Tavily 联网搜索 |
//! | `fetch_page` | `fetch_page` | 网页正文提取(可读性算法) |
//! | `memos` | `manage_memos` | 备忘录增删查 |
//! | `amap` | `amap_*` | 高德地图系列(POI/地理编码/路径规划/旅游规划) |
//!
//! 每个工具都提供 `spec()` 返回元数据,和 `execute()` 执行入口。
//! 通过 `BuiltinRegistry` 统一注册和路由。
pub mod amap;
pub mod datetime;
pub mod fetch_page;