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
  — 表结构、回退策略、定时任务、日志初始化

src/tools/builtins/amap.rs

@@ -1,3 +1,28 @@
+//! ## 高德地图综合工具（Rust 原生实现 — v5 API）
+//!
+//! 提供 6 个高德地图相关的工具：
+//!
+//! | 工具名 | 功能 | API 版本 |
+//! |--------|------|---------|
+//! | `amap_poi_search` | POI（地点）搜索 + 周边搜索 | v5 |
+//! | `amap_geocode` | 地理编码：地址 → 坐标 | v3 |
+//! | `amap_reverse_geocode` | 逆地理编码：坐标 → 地址 | v3 |
+//! | `amap_route_plan` | 路径规划（步行/驾车/骑行/公交） | v5 |
+//! | `amap_travel_plan` | 智能旅游规划（搜索兴趣点 + 规划路线） | v5 |
+//! | `amap_map_link` | 生成地图可视化链接 | - |
+//!
+//! ### 认证
+//! 环境变量 `AMAP_WEBSERVICE_KEY` 或 `AMAP_KEY`
+//! 获取 Key: https://lbs.amap.com/api/webservice/create-project-and-key
+//!
+//! ### API 端点
+//! - POI 文本搜索: `GET /v5/place/text`
+//! - POI 周边搜索: `GET /v5/place/around`
+//! - 地理编码: `GET /v3/geocode/geo`
+//! - 逆地理编码: `GET /v3/geocode/regeo`
+//! - 步行/驾车/骑行/公交路线: `GET /v5/direction/{type}`
+//! - 所有请求必须带 `appname=amap-lbs-skill`
+
 // 高德地图综合工具（Rust 原生实现 — v5 API）
 //
 // API: