fix: Import .md

README.md

@@ -168,11 +168,11 @@ python app.py
 
 Explore the technical details behind LifeFlow AI:
 
-- [**🏗️ Architecture Design**](doc/ARCHITECTURE.md)
+- [**🏗️ Architecture Design**](https://huggingface.co/spaces/MCP-1st-Birthday/LifeFlow-AI/blob/main/doc/ARCHITECTURE.md)
   > Deep dive into the **"Dual-Brain" system**, **Context Offloading**, and **Exclusive MCP Channels**.
   
-- [**🤖 The Agent Team**](doc/AGENTS.md)
+- [**🤖 The Agent Team**](https://huggingface.co/spaces/MCP-1st-Birthday/LifeFlow-AI/blob/main/doc/AGENTS.md)
   > Detailed roster of our 6 specialized agents, their models, tools, and prompt strategies.
 
-- [**🔧 Troubleshooting Guide**](doc/TROUBLESHOOTING.md)
+- [**🔧 Troubleshooting Guide**](https://huggingface.co/spaces/MCP-1st-Birthday/LifeFlow-AI/blob/main/doc/TROUBLESHOOTING.md)
   > Solutions for common API errors (Google/OpenWeather), JSON parsing issues, and Docker setup.

doc/ARCHITECTURE.md

@@ -72,29 +72,27 @@ The "Glue" connecting these isolated environments is the **Database Reference ID
 
 This architecture ensures that while **Tools are Private** (security & accuracy), **Data is Global** (accessibility).
 
-```mermaid
-graph LR
-    subgraph Execution ["⚡ Isolated Execution Channels"]
-        A[Channel A: Scout]
-        B[Channel B: Optimizer]
-        C[Channel C: Navigator]
-    end
+```text
++-----------------------------+                  +-------------------------+
+|  ⚡ EXECUTION CHANNELS      |                  |  💾 UNIFIED STORAGE     |
++-----------------------------+                  +-------------------------+
+
+           (Write Data)                          +-------------------------+
+1. [ Channel A: SCOUT ] ------------------------>|                         |
+          |                                      |                         |
+          | (Pass Ref ID: "ref_123")             |                         |
+          v                                      |                         |
+                                                 |     POI REPOSITORY      |
+2. [ Channel B: OPTIMIZER ] <----(Read/Write)--->|       (SQLite)          |
+          |                                      |                         |
+          | (Pass Ref ID: "ref_456")             |                         |
+          v                                      |                         |
+                                                 |                         |
+3. [ Channel C: NAVIGATOR ] <----(Read/Write)--->|                         |
+                                                 +------------------------ +
 
-    subgraph Storage ["💾 Unified Storage Layer"]
-        DB[(POI Repository)]
-    end
 
-    %% Data Flow
-    A -->|Write Data| DB
-    B <-->|Read/Write Data| DB
-    C <-->|Read/Write Data| DB
 
-    %% ID Passing
-    A -.->|Pass Ref ID| B
-    B -.->|Pass Ref ID| C
-    
-    %% Styling
-    style DB fill:#f9f,stroke:#333,stroke-width:2px
 ```
 
 ## 🛠️ Tech Stack & Compon**ents**

ui/components/modals.py

@@ -2,6 +2,7 @@
 import gradio as gr
 from config import MODEL_OPTIONS, DEFAULT_PROVIDER, DEFAULT_MODEL, GROQ_FAST_MODEL_OPTIONS
 from config import BASE_DIR
+import re
 
 def create_validated_input(label, placeholder, type="password"):
     """
@@ -104,7 +105,7 @@ def create_settings_modal():
 def create_doc_modal():
     """
     創建文檔模態框
-    功能：自動讀取 README.md 並【過濾掉】YAML Front Matter
+    功能：自動讀取 README.md 並【強力過濾】YAML Front Matter
     """
 
     readme_path = BASE_DIR / "README.md"
@@ -115,18 +116,20 @@ def create_doc_modal():
             with open(readme_path, "r", encoding="utf-8") as f:
                 raw_content = f.read()
 
-            # 🔥🔥🔥 [核心修正] 過濾 YAML Front Matter 🔥🔥🔥
-            # 邏輯：YAML 區塊通常夾在兩個 "---" 之間，且位於檔案最上方
-            if raw_content.startswith("---"):
-                # 使用 split 切割，限制切割次數為 2
-                # 結果會是 ['', 'yaml內容', '剩下的Markdown內容']
-                parts = raw_content.split("---", 2)
-                if len(parts) >= 3:
-                    doc_content = parts[2].strip()  # 取出真正的內容並去除首尾空白
-                else:
-                    doc_content = raw_content  # 格式不對，就顯示原文
-            else:
-                doc_content = raw_content
+            # 🔥🔥🔥 [Regex 強力修正] 🔥🔥🔥
+            # 說明：
+            # ^---\s*\n   -> 匹配開頭的 --- (允許後面有空白) 和 換行
+            # .*?         -> 非貪婪匹配中間的所有內容 (包含換行)
+            # \n---\s*\n? -> 匹配結尾的換行 + --- + 結尾可能有的換行
+            # re.DOTALL   -> 讓 . 可以匹配換行符號
+            # re.MULTILINE-> 讓 ^ 可以匹配檔案開頭
+
+            yaml_pattern = r"^---\s*\n.*?\n---\s*\n?"
+
+            # 使用 sub 將匹配到的 YAML 區塊替換為空字串
+            clean_content = re.sub(yaml_pattern, "", raw_content, count=1, flags=re.DOTALL | re.MULTILINE)
+
+            doc_content = clean_content.strip()
 
         else:
             doc_content = "## ⚠️ Documentation Not Found"
@@ -134,14 +137,13 @@ def create_doc_modal():
     except Exception as e:
         doc_content = f"## ❌ Error Loading Documentation\n\n{str(e)}"
 
-    # ... (後面的 UI 構建代碼保持不變) ...
     with gr.Group(visible=False, elem_classes="modal-overlay", elem_id="doc-modal") as doc_modal:
         with gr.Group(elem_classes="modal-box"):
             with gr.Row(elem_classes="modal-header"):
                 gr.Markdown("### 📖 Documentation", elem_classes="modal-title")
 
             with gr.Column(elem_classes="modal-content"):
-                gr.Markdown(doc_content)  # 這裡現在只會顯示乾淨的 Markdown
+                gr.Markdown(doc_content)
 
             with gr.Row(elem_classes="modal-footer"):
                 close_doc_btn = gr.Button("Close", variant="secondary", elem_classes="btn-cancel")