ErisPulse ErisPulse
在互動式文檔中心打開 →
本頁章節
本文為靜態鏡像,內容以互動版為準 在互動式文檔中心打開 →

高級主題

本目錄收錄 ErisPulse 框架的進階專題——權限管控、灰度發布、多輪互動、儲存後端等 深度能力,每篇解決一類具體問題。

Note

本目錄全部為按需查閱的專題文件——請先讀完首頁的 L1 核心五篇, 遇到對應需求再來翻。每篇開頭標有「什麼時候需要讀這篇」。

L2 必讀四篇

撰寫生產級模組繞不開的四篇,建議在開發複雜模組前通讀(口徑與文件首頁一致):

  • 作用域(scope) - 三維作用域控制:模組可用性 / 事件准入 / 出站動作限制(含方法級細粒度規則與綁定繼承 merge)
  • 歸屬權(owner)系統 - 資源歸屬與自動回收:owner 上下文機制、歸屬資源全景、卸載清理序列、熱重載邊界與設計邊界
  • 生命週期管理 - 生命週期事件系統:模組 / 轉接器載入、卸載、重載、停用時各自該做什麼
  • 互動會話系統 - wait_reply / 會話定時器 / 多路等待 / 會話互斥租約 / 收件匣 / 訊息事務 / 鏈路追蹤

按場景分組

與文件首頁「深入理解原理」的分組標準一致,每組首篇標註「不懂會踩什麼坑」。

執行啟動 —— 不懂啟動鏈路(Finder / Loader / Manager / Router),模組加載失敗時只能對著日誌干瞪眼

  • 啟動流程與手動控制 - 啟動鏈路拆解(Finder/Loader/Manager/Router)與手動完整啟動
  • 懶加載系統 - 懶加載模組系統的工作原理、配置與事件驅動懶激活(activate_on)

通信連接 —— 不懂服務契約(meta.services)白名單,跨模組 module.call 會被 ServiceNotProvidedError 拒絕且不知原因

  • 模組間通信 - RPC 協議化(module.call)、服務契約與目錄、定向事件、冷啟動回放、事件冪等去重
  • 連接池與廣播 - 連接註冊表:廣播、分組訂閱、跨模組傳遞與複用、連接池查看
  • 路由管理器 - HTTP 和 WebSocket 路由管理(含單參註冊、元組響應約定)

數據存儲 —— 不懂連接失敗冷卻期語義,資料庫抖動時會誤判「框架掛了」(實際是快速失敗、冷卻後自動重連)

消息對話 —— 不懂會話互斥租約,兩個模組同時等待同一用戶的回覆會互相踢掉

灰度影子 —— 不懂五道隔離閘就提前轉正,影子的出站消息會外溢到真實用戶

  • 影子模組與灰度轉正 - 模組新版本獨立 owner 並行試運行:出站攔截記賬、行為 diff 對比、promote 轉正與失敗回滾

性能與觀測 —— 出問題只會重啟、不看指標,等於盲飛

  • 性能基準與調優 - 實測基準數字(含 NoneBot2 對照)、基準自跑與回歸對比方法、調優要點、記憶體診斷
  • runtime 工具帶 - ErisPulse.runtime 聚合導出層速查:歸屬權、後台任務、事件上下文、記憶體快照、dict 解析、排障診斷

異常與規範參考

Note

Dashboard 視窗註冊、Takumi 圖片渲染等 第三方生態模組 的文件已遷移至 生態模組 目錄。

適用對象

這些文件適合以下開發者:

  • 已經熟悉 ErisPulse 基礎功能的開發者
  • 需要深入理解框架內部機制的開發者
  • 需要優化性能或實現複雜功能的開發者

前置知識

閱讀本目錄文件前,建議先了解: