高級主題
本目錄收錄 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 路由管理(含單參註冊、元組響應約定)
數據存儲 —— 不懂連接失敗冷卻期語義,資料庫抖動時會誤判「框架掛了」(實際是快速失敗、冷卻後自動重連)
- 存儲後端 - sqlite / mysql / postgres 異步原生存儲後端的選擇、配置與切換
- SQL 查詢建構器 - 通用 SQL 鏈式查詢建構器及存儲後端抽象
- 網路客戶端 - 統一 HTTP 請求客戶端
消息對話 —— 不懂會話互斥租約,兩個模組同時等待同一用戶的回覆會互相踢掉
- Conversation 多輪對話 - 多輪對話上下文的交互方法
- 會話收件箱 - 消息自動記錄:保留策略旋鈕、運行時覆蓋 API 與風險/審計
- MessageBuilder 詳解 - OneBot12 消息段建構器的雙模式用法
- 國際化 (i18n) - 多語言支持、翻譯註冊與語言檢測
灰度影子 —— 不懂五道隔離閘就提前轉正,影子的出站消息會外溢到真實用戶
- 影子模組與灰度轉正 - 模組新版本獨立 owner 並行試運行:出站攔截記賬、行為 diff 對比、promote 轉正與失敗回滾
性能與觀測 —— 出問題只會重啟、不看指標,等於盲飛
- 性能基準與調優 - 實測基準數字(含 NoneBot2 對照)、基準自跑與回歸對比方法、調優要點、記憶體診斷
- runtime 工具帶 -
ErisPulse.runtime聚合導出層速查:歸屬權、後台任務、事件上下文、記憶體快照、dict 解析、排障診斷
異常與規範參考
Note
Dashboard 視窗註冊、Takumi 圖片渲染等 第三方生態模組 的文件已遷移至 生態模組 目錄。
適用對象
這些文件適合以下開發者:
- 已經熟悉 ErisPulse 基礎功能的開發者
- 需要深入理解框架內部機制的開發者
- 需要優化性能或實現複雜功能的開發者
前置知識
閱讀本目錄文件前,建議先了解: