docs: explain Tessera modules and execution flows in Chinese

src/shell/system_ui/theme.rs

@@ -1,3 +1,5 @@
+//! 宿主控件的颜色与状态调色。根据背景、强调色和交互状态生成可读颜色，不改变业务状态。
+//!
 use crate::display_list::Color;
 pub const BG: Color = Color::rgb(255, 255, 255);
 // A visibly separate chrome layer against the warm, near-white content canvas.
@@ -16,25 +18,31 @@ pub const PALETTE: [Color; 6] = [
     Color::rgb(52, 123, 78),
 ];
 #[derive(Clone, Copy, Debug)]
+/// 当前管理界面的配色基础，派生状态颜色由方法统一计算。
 pub struct Theme {
     pub accent: Color,
 }
 impl Theme {
+    /// 构造本类型并初始化其状态；资源建立和默认字段以函数体为准。
     pub fn new(accent: Color) -> Self {
         Self {
             accent: readable_accent(accent),
         }
     }
+    /// 从当前主题生成对应交互状态颜色，保持控件在状态变化时的视觉一致性。
     pub fn soft(self) -> Color {
         mix(BG, self.accent, 0.10)
     }
+    /// 从当前主题生成对应交互状态颜色，保持控件在状态变化时的视觉一致性。
     pub fn hover(self) -> Color {
         mix(BG, self.accent, 0.17)
     }
+    /// 从当前主题生成对应交互状态颜色，保持控件在状态变化时的视觉一致性。
     pub fn pressed(self) -> Color {
         mix(BG, self.accent, 0.29)
     }
 }
+/// 按比例混合颜色通道，作为状态颜色的基础运算。
 pub fn mix(a: Color, b: Color, amount: f32) -> Color {
     let channel =
         |a: u8, b: u8| (a as f32 + (b as f32 - a as f32) * amount.clamp(0.0, 1.0)).round() as u8;
@@ -44,6 +52,7 @@ pub fn mix(a: Color, b: Color, amount: f32) -> Color {
         channel(a.blue, b.blue),
     )
 }
+/// 根据背景选择可读的强调色，供选中与焦点状态使用。
 pub fn readable_accent(mut c: Color) -> Color {
     while (c.red as u32 * 299 + c.green as u32 * 587 + c.blue as u32 * 114) / 1000 > 155 {
         c = Color::rgb(