归属权(owner)系统
Tip
什么时候需要读这篇:排查资源泄漏、理解卸载清理链路或声明归属资源时。不需要则跳过,不影响其它功能的使用。
读完你会知道:owner 上下文如何自动归属资源、归属资源全景表、卸载/禁用时 清理链的完整时序,以及哪些资源不随卸载清理(设计边界)。
本篇不涉及:资源"何时生效"的权限判定(见作用域(scope)); 后台任务的推荐写法与强制取消边界(见生命周期管理 · 后台任务归属与自动取消)。
归属权是模块"即插即用"的基石:模块在加载期间注册的一切框架资源自动记名, 卸载/禁用时按记名一键回收——模块作者只需声明资源,无需手写清理逻辑。
相关系统:作用域(scope)在事件分发时决定"资源是否生效", 归属权在生命周期中决定"资源归谁、谁卸载时被回收"。 作用域详见统一控制面(scope),后台任务详见 生命周期管理。
{!--< tips >!--}
- 归属在注册瞬间按
current_owner自动记录,模块代码零改动 - 卸载/禁用共用同一条清理链(
_cleanup_module_registrations),每步失败仅告警不中断 - 用户配置语义的资源(持久化覆写 / scope 规则 / 命令 ACL)不随模块卸载清理
- 工具模块托管的外部句柄可用
on_cleanup(cb)挂入清理链,对方模块卸载时自动回调(见工具模块指南) {!--< /tips >!--}
owner 上下文机制
owner 通过上下文变量 current_owner 传递(ErisPulse.runtime.context):
from ErisPulse.runtime import owner_scope, get_current_owner
with owner_scope("MyModule"):
# 此区间内注册的一切资源自动归属 MyModule
assert get_current_owner() == "MyModule"
框架在以下时机自动注入 owner(模块/适配器代码无需手动包裹):
| 时机 | owner 值 | 位置 |
|---|---|---|
模块 load() |
模块名 | 实例化 + on_load 全程 |
适配器 start() / restart() |
平台名 | 适配器启动全程 |
activate_on 懒加载 stub 注册 |
模块名 | 占位命令/处理器注册 |
| 事件处理器执行期 | 处理器归属模块名 | handler / 命令入口重注入 |
执行期重注入意味着:模块在 on_load 里声明的命令处理器运行中调用
注册型 API(如 sdk.adapter.on()、overrides.*.set(persist=False)),
同样会自动归属本模块。
bind_owner:把归属缝进回调与线程入口
owner_scope 作用于代码块;bind_owner(fn) 把上下文"缝进"函数本身——
包装瞬间捕获 current_owner,此后无论谁、从哪个线程或事件循环调用,都以
原 owner 身份执行。新线程默认空上下文(Timer / watcher / 第三方线程池的
触发路径 current_owner 为 None),其内创建的任务不进归属表、模块卸载时
取消不掉(跨 loop 残留的来源之一),经包装后归属随身携带:
from ErisPulse.runtime import bind_owner
class MyModule(BaseModule):
async def on_load(self, event):
# 交给第三方调度器 / 线程池前先包装:
external_scheduler.submit(bind_owner(self._poll))
async def _poll(self):
# 运行期间 current_owner == "MyModule",卸载时可被正确回收
...
async函数保持async,owner 跨全部await生效;普通函数仅在同步 执行期间生效- 框架自有入口(
self.spawn()/ 命令处理器)已自动携带归属,本函数只用于 框架之外的触发路径(外部调度器、threading.Timer、回调注册表等)
归属资源全景
模块在加载上下文内注册的以下资源均记录归属,卸载/禁用时自动回收:
| 资源 | 注册方式 | 清理调用 |
|---|---|---|
| 命令 | @command() / 命令 dict 声明 |
command.unregister_by_owner() |
| 事件处理器 | @message / @notice / @request / @meta |
handler.unregister_by_owner() |
| 适配器事件监听 | sdk.adapter.on() / raw=True |
adapter.unregister_handlers_by_owner() |
| 适配器中间件 | @sdk.adapter.middleware |
同上 |
| 路由(HTTP/WS/SSE) | router.http() / websocket() / sse() |
按命名空间 + 按 owner 双重兜底 |
| 路由中间件 | @router.middleware() / add_middleware() |
router.unregister_all_by_owner() |
| Dashboard 首页入口 | router.register_home_entry() |
unregister_home_entries_by_owner() |
| 自定义会话类型 | register_custom_type() |
unregister_custom_types_by_owner() |
| 平台事件方法注入 | register_event_method() / register_event_mixin() |
unregister_event_methods_by_owner()(模块卸载自动回收,旧闭包不再泄漏) |
| 后台任务 | self.spawn() |
cancel_owner_tasks() |
| 外部归属清理钩子(工具模块托管) | runtime.on_cleanup(cb) |
run_owner_cleanups()(卸载/禁用/适配器关闭链内触发) |
| 生命周期钩子 | lifecycle.register() |
lifecycle.unregister_by_owner() |
| 主人身源 provider | master.provider |
master.unregister_by_owner() |
| i18n 翻译键 | I18nClass 声明(domain=模块名) |
i18n.unregister_domain() |
| 事件覆写(运行时) | overrides.*.set(persist=False) |
overrides.unregister_by_owner() |
| 交互会话(wait_reply 等待 / 租约) | event.wait_reply() / sdk.interaction.acquire() |
interaction.cancel_by_owner()(等待方立即收到取消) |
| 上下文数据 | runtime/context 按 owner 记录 |
按模块精确清理 |
适配器侧的对应资源(以平台名为 owner)在适配器 shutdown() / restart()
时由 _cleanup_adapter_resources 回收,另含:
| 资源 | 清理调用 |
|---|---|
适配器自有的 on() 处理器与中间件 |
adapter.unregister_handlers_by_owner(platform) |
平台事件方法扩展(EventMixin) |
unregister_platform_event_methods(platform) |
| 自定义会话类型 | unregister_custom_types_by_owner(platform) |
| 交互会话(该平台挂起的 wait_reply / 租约) | interaction.cancel_by_platform(platform) |
| i18n 翻译域(domain=配置键) | i18n.unregister_domain(配置键) |
| 细颗粒命名空间路由 | router.unregister_all_by_owner(platform) |
卸载/禁用清理序列
unload() 与 disable() 共用同一条清理链(每步独立 try/except,
失败仅记日志,不中断后续清理):
flowchart TD
A["unload / disable"] --> B["on_unload()(超时保护)"]
B --> C["兜底取消后台任务(cancel_owner_tasks)"]
C --> C1["外部归属清理钩子<br/>(工具模块 on_cleanup 登记,run_owner_cleanups 触发)"]
C1 --> D["_cleanup_module_registrations<br/>= 归属权门面 ownership.reclaim_sync()"]
D --> D1["i18n 翻译域"]
D1 --> D2["路由:命名空间 + owner 兜底<br/>(按路由对象同一性精确删除,<br/>含中间件 / 首页入口)"]
D2 --> D3["适配器事件处理器 / 中间件"]
D3 --> D4["命令 + 事件处理器"]
D4 --> D5["自定义会话类型"]
D5 --> D5b["平台事件方法注入"]
D5b --> D6["运行时事件覆写(persist=False)"]
D6 --> D7["主人身源 provider"]
D7 --> D8["生命周期钩子"]
D8 --> E["移除 SDK 属性 + 懒加载代理"]
E --> F["自动轻审计:孤儿 owner 告警"]
sdk.uninit() 退出时另有全局兜底:全部适配器 shutdown → 全部模块 unload →
router.stop()(清空路由/中间件/首页入口)→ cancel_all_background_tasks() →
清空事件处理器与钩子。
归属权统一门面(ownership)
清理链的十六个步骤收敛在归属权统一门面 ErisPulse.Core.ownership 下,
四个动词覆盖"注销、计数、扫描、审计"——子系统各自的 *_by_owner 注销
函数保持不变,作为门面的内部实现:
| 动词 | 用途 |
|---|---|
ownership.reclaim(owner) |
统一注销 owner 名下全部资源(任务取消 → 清理钩子 → 注册类资源;异步完整版) |
ownership.reclaim_sync(owner) |
注册类资源注销(同步版,供同步卸载路径) |
ownership.counts(owner=None) |
只读统计 owner 在册资源(None 为全部 owner) |
ownership.orphans() |
孤儿扫描:资源在册而 owner 已注销(泄漏实锤清单) |
ownership.audit(owner, deep=) |
泄漏审计报告(计数 + 孤儿 + 可选 gc 实例普查) |
from ErisPulse.Core import ownership
ownership.reclaim_sync("MyModule") # {'commands': 1, 'routes_http': 2, ...}
ownership.counts("MyModule") # 在册资源计数
ownership.orphans() # [{"owner": "ghost", "total": 2, ...}]
审计入口:
- 卸载 / 重载后自动轻审计:发现孤儿 owner 资源即 WARNING 告警(零开销计数扫描)
sdk.module.audit(name, deep=True):模块实例 gc 普查——实例不可回收时 给出引用方类型(定位"谁攥着旧实例");有全局暂停开销,仅显式排障使用- 深普查属显式操作,不设配置键、不做自动修复
嵌套生命周期(ownership.nest)
本节特性需要 ErisPulse **2.12+**。
允许一个模块(父)托管另一批 owner(子),父被回收时子整体回收。典型场景: 脚本引擎模块内跑子插件、Dashboard 托管面板扩展、工具模块代管外部注册表条目。
from ErisPulse.Core import ownership
ownership.nest("ScriptEngine", "ScriptEngine.plugin_a")
ownership.nest("ScriptEngine", "ScriptEngine.plugin_b")
ownership.nested_children("ScriptEngine")
# frozenset({"ScriptEngine.plugin_a", "ScriptEngine.plugin_b"})
ownership.unnest("ScriptEngine", "ScriptEngine.plugin_a")
| 项 | 约定 |
|---|---|
| 回收顺序 | 子先于父;同级按注册逆序(后注册的先回收) |
| 回收范围 | 资源级(任务 / 连接 / 路由 / 命令 / tracked 资源 / 清理钩子),不触发子的模块级 on_unload |
| 环检测 | nest 拒绝自环与已存在的反向链,返回 False 并告警 |
| 子先亡 | 子被独立回收(reclaim / reclaim_sync)时自动 unnest,父侧不保留悬挂关系 |
| 超时 | 单个子回收受 CLEANUP_CALLBACK_TIMEOUT_SECS 约束;超时告警、移除父子关系并继续 |
| 可观测 | ownership.counts(parent) 增加 nested 计数;ownership.orphans() 对嵌套关系做传递闭包,父已消失的残留关系仍会暴露 |
**为什么不触发子的 on_unload**:模块完整卸载需要走管理器级流程(懒代理、
sdk 属性、事件广播),而 ownership 门面只负责资源回收,跨层调用会引入
卸载锁重入风险。需要子的 on_unload 时,由父在自己的 on_unload 里显式调用:
await self.sdk.module.unload(child, reason="cascade")
同步入口(如 sdk.module.disable)会先标记异步级联,后台任务回收子资源;
reclaim_sync 只在没有异步级联进行时自行级联子的注册类资源。
热重载失败回滚
热重载为"卸载前快照 → 失败自动恢复 → 重放 on_load":新版本语法错误、
依赖缺失、加载失败时,旧实例与注册状态(注册表条目、sdk 属性、sys.modules
条目)自动还原,随后在归属上下文内**重放旧实例的 on_load**(reason
为 "rollback"),让卸载阶段断开的外部资源重新建立;结束后发射
module.rollback 事件(载荷 {module_name, success})。
适配器热重载失败同样恢复旧注册态;旧实例原处于运行态且旧启动任务已结束时,
回滚后会重放 start(),并发射 adapter.rollback 事件(载荷
{adapter_name, replayed, success})。断连 / bot offline 等 unload 副作用
仍不可撤销。重放与 adapter.rollback 事件需要 ErisPulse **2.12+**。
边界说明:
- 重放失败或超时只告警,不回滚回滚——旧实例停留在"已收尾"状态 (与 2.11.2 及更早行为一致),日志会明确提示
- 第三方在运行期手动缓存的对旧实例的引用不在恢复范围
- 目标包已被卸载(entry-point 消失)视作卸载成功,不做回滚
on_unload载荷携带reason(unload/reload/disable/cascade/dormant/load-failed),模块可在reload时推迟关闭 需要跨重载存活的资源
热重载的完整能力边界、跨循环语义与模块侧守则见下节。
热重载边界
热重载能替换代码、重建注册、回滚失败的重载——但它不是进程重启。 回收的是归属权系统登记在册的运行时资源;不属任何 owner 的资源、用户 配置语义的数据、第三方库内部缓存的引用,都不会随重载消失。
能力边界
| 对象 | 重载后行为 | 说明 |
|---|---|---|
| 模块代码 / 类定义 | 支持,重新导入 | 旧 sys.modules 条目被清理 |
on_unload / on_load |
支持,按序触发 | 失败回滚时重放 on_load(见上节) |
| 命令 / 处理器 / 路由 / 生命周期钩子 | 支持,自动注销再注册 | 经归属回收链清理 |
spawn_background / spawn_later / spawn_thread |
支持,按 owner 取消 | 线程只登记观测、无法强杀 |
主循环上任何 asyncio.create_task |
支持,自动归属取消 | 任务工厂拦截(含第三方库内部创建) |
| 存储桥接循环上派生的任务 | 支持,自动归属取消 | 桥接循环同样装了任务工厂 |
ownership.track() 登记的资源 |
支持,调用 release() |
任务工厂够不着的 Loop-bound 资源 |
on_cleanup 钩子 |
支持,触发 | 工具模块借此抛弃托管的句柄 |
持久化覆写(persist=True)/ 配置文件 |
不处理,保留 | 用户资产 |
| 第三方库内部缓存的对象引用 | 不处理 | 框架看不到,需模块自行解引用 |
模块自己 new 的事件循环 / 裸线程 |
不回收 | 见下方守则 |
三层资源治理
- 无感拦截层——事件循环级任务工厂。owner 上下文内任何任务创建自动归属, 覆盖主循环与存储桥接循环。
- 归属化调度层——
spawn_background/spawn_later/spawn_thread。 - 合作式登记层——
ownership.track()/on_cleanup(),用于结构性 够不着的资源(Loop-bound 连接池、第三方 client)。
事件循环边界
| 循环 | 谁创建 | 装任务工厂 | 用途 |
|---|---|---|---|
| 主循环 | sdk.run() / sdk.init() |
已安装 | 全部业务代码 |
| 存储桥接循环 | AsyncBridge(首次同步存储调用) |
已安装 | 同步存储 API 的后台执行 |
| 临时循环 | spawn_background 兜底 |
未安装,用完即关 | 主循环未就绪时的最后手段 |
临时循环是最后手段:它会同步阻塞调用线程,且循环关闭后协程内部再派生的
子任务会丢失(日志有 temp_loop_fallback 警告)。看到该警告说明模块在错误
的时机调度了后台任务。
跨循环取消是尽力而为:cancel_owner_tasks 发现任务在其它仍在运行的循环
上时,用 call_soon_threadsafe 投递取消并打 cross_loop_task_residual
警告,但不等待其结束(跨循环等待不安全)。看到该警告应检查是否自建了
事件循环。
模块侧守则
# 推荐
spawn_background(self._poll()) # 归属化后台任务
spawn_later(30, lambda: self._cleanup()) # 归属化延迟任务
spawn_thread("poller", self._loop_body) # 归属化线程(入口自动带 owner)
ownership.track(pool) # 显式登记 Loop-bound 资源
await sdk.storage.aget(key) # 异步上下文直接用异步 API
# 避免
asyncio.create_task(self._poll()) # 裸调用:无引用易被 GC
asyncio.new_event_loop() # 自建循环:归属体系完全够不着
threading.Thread(target=self._loop_body) # 裸线程:入口无 owner 上下文
self._storage.get(key) # 异步上下文里同步调存储:阻塞主循环
排查清单
- 日志有
cross_loop_task_residual?→ 有资源落在自建循环上 - 日志有
temp_loop_fallback?→ 后台任务在主循环就绪前被调度 - 报
attached to a different loop?→ 检查是否自建循环或跨循环复用连接对象 ownership.orphans()有输出?→ 有 owner 名下资源在卸载后仍存活
设计边界:哪些资源不随卸载清理
归属权只回收模块代码注册的运行时资源。以下资源属用户配置语义 (控制权在用户,可能刻意配置),模块卸载后随配置持久保留:
| 资源 | 语义 | 说明 |
|---|---|---|
overrides.*.set(persist=True) |
持久化覆写 | 写入配置文件,跨重启生效;模块卸载不删(用户显式配置) |
scope.set_action() 等作用域规则 |
权限控制面 | 由用户/Dashboard 管理,卸载模块不回收规则 |
overrides.acl.set(persist=True) |
命令 ACL | 同上 |
Conversation save() 持久化 |
多轮对话存档 | 数据资产不清理 |
运行时临时写入(persist=False)则随 owner 回收——持久化与否即
"用户资产"与"模块运行时状态"的分界线。
内部实现:归属如何工作
一句话:归因链(contextvar 传播)决定"记在谁头上",取消链(任务登记表)决定"卸载时能否被取消"——两条链路独立运作,资源被正确清理需二者兼备。
归属系统由两条独立链路构成,理解它们的分工是排查归属问题的前提:
归因链(contextvar 传播)
runtime/context.py 的 current_owner 等 ContextVar 负责归因——
"此刻这段代码注册的资源/发起的调用记在谁头上"。传播规则遵循 Python
contextvars 语义:
| 执行路径 | context 是否传播 | 归因结果 |
|---|---|---|
同步调用链 / await 链 |
✅ 传播 | 正确归因 |
owner_scope 内 asyncio.create_task |
✅ 传播(task 拷贝创建时刻的 context) | 任务内部的框架调用正确归因 |
run_in_executor / 裸线程 |
❌ 不传播 | 归因丢失 |
| 自建事件循环 | ❌ 不传播 | 归因丢失 |
归因 ≠ 登记:context 传播只影响"记在谁头上",资源能否被清理 取决于是否进入了下述取消链。
取消链(任务登记表)
runtime/tasks.py 的 _owner_tasks 登记表负责生命周期——
"owner 名下有哪些未完成任务,卸载时统一取消"。任务进入登记表的途径:
- 显式调度:
spawn_background()/self.spawn()→ 创建时捕获current_owner(或显式owner=参数)→ 登记入表; - Task Factory 自动登记(2.8.3):
install_owner_task_factory()在框架启动时安装到主事件循环——任何任务创建(含第三方库内部的create_task)经过工厂时读取current_owner,非 None 即登记。
登记表自清理:每个任务带 done_callback,完成即从表中移除,无泄漏。
取消时序(模块卸载)
module.unload()
→ on_unload(event) # 模块自行清理(兜底超时保护)
→ 框架注销该 owner 的命令/事件/钩子/路由
→ cancel_owner_tasks(owner) # 任务登记表兜底取消
→ 逐个 task.cancel() # 排除当前执行取消逻辑的任务自身
→ await gather(pending, timeout) # 等待回收(超时不再阻塞)
排查思路
- 资源没被清理 → 查登记表:
get_owner_tasks("MyModule")是否含该任务; 不含即注册路径未经过归属链(import 期 / 线程 / 独立循环),对照上表定位。 - 归因错误 → 查
get_current_owner()在出错时刻的值;异步延迟执行 (回调/任务)的归因取自创建时刻 context,而非执行时刻。
模块作者指南
推荐写法
from ErisPulse import sdk
from ErisPulse.Core.Event import command
from ErisPulse.runtime import owner_scope, spawn_background
class MyModule(BaseModule):
async def on_load(self, event):
# 框架资源:自动归属,无需手动清理
self.task = self.spawn(self.polling()) # 后台任务
sdk.router.register_home_entry("我的模块", "/my") # 首页入口
# 模块自有资源:包进 owner_scope 即纳入归属体系
with owner_scope("MyModule"):
self.client.on_event(self._handle) # 假想的自定义注册
async def on_unload(self, event):
# 框架资源已被自动回收,只需清理 owner_scope 覆盖不到的自有资源
await self.client.close()
注意事项
- import 期注册无归属:模块顶层(import 时)注册的钩子/处理器发生在
owner_scope之前,会被视为框架级资源(owner=None)而不被清理。 一律放到on_load()内注册。 - 自定义 domain 的 i18n 注册:
i18n.register(domain=...)的 domain 不等于模块名时不会被自动回收,请保持 domain=模块名。 - 后台任务推荐
self.spawn():2.8.3 起裸asyncio.create_task也会自动隐式归属 (Task Factory 自动登记,卸载时兜底取消);但self.spawn()仍是推荐写法—— 支持非主循环线程调度回主循环、显式owner=指定与 fire-and-forget 防 GC。 2.8.3 之前的版本裸任务不归属,必须用self.spawn()。 - 清理链"失败仅告警":单步清理异常不会阻断其余资源回收,日志 DEBUG/WARNING 级别可见,排障时可开启 TRACE。
注册时机 → 归属结果对照表
| 注册场景 | 归属结果 | 说明 |
|---|---|---|
on_load() 内经框架 API(命令/事件/lifecycle/路由装饰器)注册 |
归属模块 | 卸载时自动注销 |
| 模块顶层(import 期)注册 | 无归属(owner=None) | 不被清理,请勿使用 |
self.spawn() 创建的后台任务 |
归属模块 | 卸载时自动取消 |
owner_scope("Name") 内经第三方 API 注册 |
归属模块 | 依赖第三方回调在 scope 内同步执行 |
裸 asyncio.create_task(含 loop.create_task / ensure_future) |
自动归属(Task Factory,2.8.3+) | 创建瞬间读取 current_owner,owner 上下文内自动登记、卸载兜底取消;见下文内部实现 |
| 第三方库异步回调(aiohttp / APScheduler 等)内部创建的任务 | 自动归属(Task Factory,2.8.3+) | 回调执行时若 current_owner 已注入(如框架处理器执行期间),任务自动登记 |
run_in_executor(线程池) |
无归属(非 asyncio.Task) | 线程不受任务工厂管辖,须自行管理生命周期 |
| 独立事件循环(自建 loop)中的注册 | 无归属 | Task Factory 仅安装于主循环;contextvars 也不跨事件循环传播 |
原则:归属跟随注册瞬间的
current_owner上下文;任何异步延迟、 线程池、独立循环都会脱离该上下文——需要归属时请显式进入owner_scope。
工具模块指南:托管其它模块的句柄
场景:定时任务、注册表、连接池这类"工具模块"会替其它模块保管东西——
对方在 on_load 里调用 sdk.Cron.on_trigger(handler),你的容器里就存下了
一个指向对方实例的回调。框架会自动清理对方注册的一切框架资源,但清理不了
你私有容器里的引用:对方卸载后你的容器还拉着它的实例,它就无法被
GC 回收(内存泄漏,purge 泄漏诊断报"不可回收")。
解法:在登记对方东西的同一个函数里调用 on_cleanup(),
框架会在对方卸载 / 禁用时自动回调你的清理函数:
from ErisPulse.Core.Bases import BaseModule
from ErisPulse.runtime import off_cleanup, on_cleanup
class CronModule(BaseModule):
def __init__(self):
self._entries = {} # {模块名: 该模块托管的回调列表}
def on_trigger(self, handler):
# 自动识别调用方模块名(on_load 直接调用 / module.call 均正确),
# 返回值是解析出的 owner,可直接用作记名键
owner = on_cleanup(self._drop)
self._entries.setdefault(owner, []).append(handler)
def _drop(self, owner: str):
"""对方模块被卸载/禁用时由框架自动调用:抛弃它的句柄即可"""
self._entries.pop(owner, None)
async def on_unload(self, event):
off_cleanup(self._drop) # ③ 自己卸载前注销钩子,避免钩子表持有 self
框架保证的行为:
| 关注点 | 行为 |
|---|---|
| 触发时机 | 对方模块 unload / disable,或适配器关闭——均在框架清理链内触发,早于 purge 泄漏诊断 |
| 调用方识别 | 直接调用取 current_owner;经 module.call() 被调用取调用方(current_caller);也可 on_cleanup(cb, owner="模块名") 显式指定。强制校验:owner 无法解析(三种来源均缺失)时抛 ValueError——私有工具模块应在自身加载上下文内登记钩子 |
| 回调签名 | cb(owner: str),同步 / 异步均可;异步带超时保护(CLEANUP_CALLBACK_TIMEOUT_SECS,默认 10 秒) |
| 容错 | 单个回调异常 / 超时只记日志,不影响其余钩子与清理链 |
| 重复登记 | 同一 (owner, callback) 幂等去重 |
什么时候不需要:如果对方注册的是框架资源(命令、事件处理器、路由、
后台任务……),框架已全自动清理(见上文归属资源全景)。
只有你私有容器里持有的对方句柄才需要 on_cleanup。
模块开发视角的速查版见
最佳实践 · 工具模块。
相关文档
按下一步意图选择:
- 想控制"资源是否生效"(权限面) → 作用域(scope)——归属权管"资源归谁、卸载谁回收",作用域管"资源何时生效"
- 后台任务 / 定时器的兜底取消 → 生命周期管理 · 后台任务归属与自动取消
- 以独立 owner 隔离做灰度发布 → 影子模块与灰度转正
- 模块开发视角的速查与推荐写法 → 模块最佳实践