feat: 为全部 39 个 Rust 源文件添加系统性中文注释

为整个项目添加了详尽的中文文档注释，覆盖所有模块：

入口与架构:
- main.rs — 架构图、数据流、4 个关键设计决策
- cli.rs — 所有 CLI 子命令中文化
- Cargo.toml — 每个依赖的作用说明
- channel/mod.rs — 渠道标识设计意图

核心守护进程与消息队列:
- daemon.rs — 三消费者架构图、审批流
- queue/* — 公平轮转算法、路由调度架构

LLM 层:
- types.rs — Role/Message/ToolCall 等每个字段含义
- provider.rs — Provider trait 设计 + SSE 解析
- conversation.rs — 工具循环流程图、摘要机制
- deepseek.rs — API 请求格式

上下文管理:
- context/types.rs — ChatSession 消息生命周期
- context/builder.rs — Token 预算管理策略
- context/tools.rs — MemoryStore 双写策略

工具系统:
- tools/mod.rs — 两层元工具架构图
- tools/approval.rs — 审批流程
- tools/definitions.rs — 声明式工具三要素
- tools/subprocess.rs — 执行流程 + 缓存策略

数据库与状态:
- db/* — 5 张表用途、回退策略
- state.rs — 文件存储回退方案
- scheduler.rs — SKIP LOCKED 防重复

已废弃模块:
- ipc.rs — 旧 UDS 协议
- worker.rs — 旧 vs 新架构对比

src/queue/message_queue.rs

@@ -1,14 +1,18 @@
-//! ## 多渠道消息队列 — MessageQueue
+//! ## 多渠道公平轮转消息队列 (MessageQueue)
 //!
-//! # 设计目标
+//! ### 设计目标
 //!
-//! 多用户场景下，保证公平性：
-//! - A 发了 3 条消息、B 发了 1 条 → 处理顺序 A1, B1, A2, A3
-//! - 不会因为 A 消息多而饿死 B
+//! 多用户场景下保证**公平性**：如果一个用户连续发了很多消息，不会让其他用户饿死。
+//! 出队顺序是**轮转（round-robin）**的：
+//! - A 发了 3 条、B 发了 1 条 → 处理顺序 A1, B1, A2, A3
 //!
-//! 每个消息携带 user_id + correlation_id，保证回复能追溯到正确的用户。
+//! ### 消息关联追踪
 //!
-//! # 架构位置
+//! 每条消息有一个 `correlation_id`（Uuid），用来追踪一次用户请求的完整生命周期：
+//! 用户消息 → LLM 处理 → 工具调用 → 工具结果回喂 → 最终回复发送。
+//! 这样即使多用户并发，回复也不会串。
+//!
+//! ### 架构位置
 //!
 //! ```text
 //! receive_messages → enqueue PipelineMessage

src/queue/runner.rs

@@ -1,9 +1,16 @@
-//! QueueRunner — 消息队列运行时
+//! ## QueueRunner —— 消息队列运行时（路由调度器）
 //!
-//! 从公平轮转 MessageQueue 中出队消息，按 MessageKind 路由到对应的
+//! 从公平轮转 `MessageQueue` 中出队消息，然后按 `MessageKind` 路由到对应的
 //! tokio mpsc 通道，由注册的消费者 task 处理。
 //!
-//! # 架构
+//! ### 角色定位
+//!
+//! QueueRunner 是整个消息管线的**调度核心**：
+//! 1. 持有 `MessageQueue`（公平轮转）+ 3 个 mpsc 通道
+//! 2. 在 `run()` 循环中不断出队 → 按类型路由 → 投递到正确的消费者
+//! 3. 支持优雅关闭（AtomicBool 信号）
+//!
+//! ### 架构
 //!
 //! ```text
 //!                    ┌──────────────┐