docs: close debt governance status

This commit is contained in:
jxxghp
2026-08-23 04:01:02 +08:00
parent ba7ab398a8
commit 4d1be26a31
3 changed files with 15 additions and 8 deletions
@@ -65,13 +65,13 @@ MoviePilot V3 已经完成一轮重要基础工作:原 `app/core`、`app/helpe
7. **插件兼容面大且缺少版本化。**旧导入、SDK、管理器具体类型、动态 API、事件装饰器、模块方法和热重载行为共同构成 ABI;目前主要靠兼容清单和测试样例保护。
8. **治理缺少可量化收敛目标(历史基线)。**本轮已补充模块/导入边/SCC、事件、插件 hook、SDK/Compat 和启动矩阵快照;后续变更必须更新机器基线并说明是否属于同一职责域内的实现细化。
### 3.1 当前未完成项
### 3.1 持续治理边界
按“全部拆完”的边界,宿主跨层职责已经收口;当前只剩三类不宜继续机械拆分的工作
按“全部拆完”的边界,宿主跨层职责已经收口;以下三类是已明确边界的持续治理工作,不构成当前跨层重构遗漏
1. `app/runtime/extensions/plugin_manager.py``app/adapters/external/market.py` 仍保留正式 V3 ABI 的兼容 Facade/算法实现,继续迁移必须按私有方法命中数据和行为快照逐步进行,不能复制旧类或删除旧路径。
1. `app/runtime/extensions/plugin_manager.py``app/adapters/external/market.py` 仍保留正式 V3 ABI 的兼容 Facade/算法实现;已拆出的生命周期、投影、目录、安装、包和依赖职责均走 canonical 组件,未迁出的私有算法只有在获得真实命中数据和行为快照后才可逐项内移,不能复制旧类或删除旧路径。
2. `app/modules/themoviedb/` 等第三方移植代码的局部 SCC 属于上游实现隔离项,不纳入宿主跨层拆分目标。
3. 新增业务能力仍需遵守端口、组合根、单词文件命名和插件 raw 响应约束;这些是持续门禁,不是本轮遗留拆分任务。
3. 新增业务能力仍需遵守端口、组合根、单词文件命名和插件 raw 响应约束;这些是持续门禁,不是本轮遗留拆分任务。普通用户自定义通知和第三方插件自行写库/上报不可能由宿主事务自动包裹,宿主只对可追踪的主链业务写入提供 outbox durable 语义,并在文档中明确其外部边界。
治理顺序必须是:**先冻结行为契约和补门禁,再拆环和依赖,再拆职责,最后才讨论缩减兼容面。**