mirror of https://github.com/Wei-Shaw/sub2api.git synced 2026-10-07 16:18:29 +08:00

Files

T

shaw 7d67eb083a docs(refactor): 插件化改造各阶段完成报告与审计记录归档

issues/plugin-refactor/：Phase-0~2 的任务完成报告、阶段总结、
两轮内核审计报告、Phase-2 接缝设计双视角评审与实施后对抗审计、调用点清单。

2026-06-11 23:00:19 +08:00

1.6 KiB

Raw Blame History

完成报告: [TASK-001] 内核包：module/registry + 单测

完成状态: Success
关联任务规格: 链接
完成日期: 2026-06-11

1. 任务完成简报

backend/internal/plugin/ 内核的类型与注册表部分落地：ModuleID（点分层级 + Namespace()/Name() + 校验）、ModuleInfo、Module 接口、四个可选生命周期接口（Provisioner/Validator/Starter/Stopper）、并发安全 Registry（包级默认实例 + NewRegistry 隔离实例）。接口签名与 ROADMAP 架构树逐项核对一致（主控抽查确认）。

2. 契约符合性要点

RegisterModule：空/非法/重复 ID panic，panic 信息含冲突 ID 并提示检查插装清单；nil module/nil New 亦 panic（插装错误尽早暴露）；
GetModulesInNamespace：精确命名空间匹配（Caddy 同语义）、按 ID 字典序稳定排序；
裁量决定：ModuleInfo 增加 EnabledByDefault bool（注册时声明默认启用态，零值 false 保证新模块未配置时零行为变更）；单段 ID 的 Namespace() 为 ""。

3. 文件变更详情

创建的文件

backend/internal/plugin/module.go（126 行）、registry.go（113 行）
backend/internal/plugin/module_test.go（55 行）、registry_test.go（176 行）

修改/删除

4. 验证记录

go test -race -count=1 ./internal/plugin/ → ok（含并发注册测试）；
go vet、golangci-lint run ./internal/plugin/... → 0 issues；
不引入第三方依赖。

1.6 KiB Raw Blame History Unescape Escape