🔬 進階技術細節 (Internals)

本區提供 RenUniversal 後端的深入實作文件，逐一拆解核心模組的內部運作、生命週期與資料流。適合要修改核心、除錯或評估架構的研發人員。

一般使用與擴充請先看 文件中心；本區假設你已讀過 系統架構與演算法。

---

📂 文件清單

文件	內容	主要對應原始碼
Agent Pipeline 實作與生命週期	run_cycle() 完整流程圖、多鏡頭融合、校準分支、可視化繪製、效能特性	core/pipeline.py
狀態管理與並行模型	執行緒拓撲、三把鎖、網路來源驅逐、偏好持久化、優雅關閉	core/state.py、stream_server.py
規則求值內部流程	規則轉換管線、幾何模式判定、AST 安全求值、保守失敗策略	core/generic_skill_detector.py、core/event_engine.py、core/safe_eval.py
HTTP API 與請求生命週期	認證守門流程、完整端點清單、輸入防護	stream_server.py

---

🗺 從影格到結果：全景資料流

flowchart LR
    CAM[鏡頭/手機] -->|upload_frame| ST[(SharedState<br/>network_frames)]
    ST --> PIPE[AgentPipeline.run_cycle]
    PIPE -->|MediaPipe| LM[臉部/身體地標]
    LM --> AE[ActionEngine<br/>技能求值]
    AE --> EE[EventEngine<br/>事件求值]
    AE --> ST2[(SharedState<br/>status)]
    EE --> ST2
    PIPE -->|標註影格| ST3[(SharedState<br/>frame)]
    ST2 -->|GET /status| UI[Web 儀表板]
    ST3 -->|MJPEG /live| UI

各環節的實作細節，請點入上方對應文件。