docs: explain Tessera modules and execution flows in Chinese

src/shell/activity.rs

@@ -1,3 +1,6 @@
+//! 有界 HTTP 活动记录。保存请求/响应的可显示预览供 Network 工具读取，不负责执行请求。
+//! 正文预览和允许显示的头部受限制，避免活动面板成为无限日志或暴露不必要数据的通道。
+//!
 //! Bounded observation of this process's local HTTP API, never external traffic.
 use std::{
     collections::VecDeque,
@@ -10,6 +13,7 @@ pub const BODY_PREVIEW: usize = 32 * 1024;
 const MAX_RECORDS: usize = 80;
 
 #[derive(Clone, Debug)]
+/// 一次 HTTP 请求/响应的有界观察记录，供 Network 工具查看。
 pub struct Exchange {
     pub id: u64,
     pub method: String,
@@ -26,11 +30,13 @@ pub struct Exchange {
 }
 
 #[derive(Debug, Default)]
+/// 按容量维护近期 HTTP 活动与请求身份，防止无限日志积累。
 pub struct ActivityLog {
     pub records: VecDeque<Exchange>,
     next_id: u64,
 }
 impl ActivityLog {
+    /// 为请求分配活动 ID 并登记其方法、来源和受限头部。
     pub fn begin(&mut self, method: String, path: String, origin: String, headers: String) -> u64 {
         self.next_id += 1;
         let id = self.next_id;
@@ -63,11 +69,13 @@ impl ActivityLog {
         }
         id
     }
+    /// 更新请求正文预览，内容长度仍由活动记录策略限制。
     pub fn body(&mut self, id: u64, body: &str) {
         if let Some(record) = self.records.iter_mut().find(|r| r.id == id) {
             record.request = preview(body);
         }
     }
+    /// 完成本模块当前阶段的结果整理，把后续工作交回调用方。
     pub fn finish(&mut self, id: u64, status: u16, body: &str, headers: String) {
         if let Some(record) = self.records.iter_mut().find(|r| r.id == id) {
             record.status = Some(status);
@@ -78,6 +86,7 @@ impl ActivityLog {
     }
 }
 
+/// 截取可显示的受限文本预览，避免日志无限保留完整大正文。
 pub fn preview(value: &str) -> String {
     if value.len() <= BODY_PREVIEW {
         return value.to_owned();