Meshray-Manager/docs/Bug 修复计划.md

MeshRay Bug 和不合理问题修复计划

📋 问题分类

P0 - 严重问题（阻塞性）

1. wintun.dll 驱动缺失 - 导致 WireGuard 无法启动
2. TODO: 真实备份逻辑未实现 - 备份功能只有框架
3. TODO: 阿里云 DNS Provider 未实现 - DDNS 功能不完整

P1 - 重要问题（功能缺陷）

1. TODO: 核心服务重启未实现 - RestartCoreService 空实现
2. TODO: 版本号应从配置文件读取 - 硬编码在代码中
3. TODO: 通知清理逻辑未实现 - 可能导致数据库膨胀
4. DDNS Stats 关联查询错误 - 应通过 DDNSConfigID 关联

P2 - 次要问题（技术债务）

1. panic 使用不一致 - 有些地方应该 panic 但返回了 error
2. 类型断言安全检查 - ddns.go 中的类型断言可能 panic
3. 资源引用保存时机 - wg.go 中的设备引用可能丢失
4. bringUpDevice 跨平台支持 - 仅实现了 Linux

P3 - 优化建议（改进空间）

1. 错误信息不够友好 - 部分错误缺少上下文
2. 日志级别不合理 - 有些 warn 应该是 error
3. 代码重复 - 部分函数可以提取公共逻辑

---

🔧 修复优先级

Phase 1: 立即修复（本次执行）

1. ✅ wintun.dll 驱动安装文档完善
2. ✅ 添加启动时驱动检查
3. ✅ 备份功能真实性实现
4. ✅ 核心重启功能实现
5. ✅ 通知自动清理逻辑
6. ✅ 版本号配置化

Phase 2: 短期修复（下次迭代）

1. 阿里云 DNS Provider 实现
2. DDNS Stats 关联查询修复
3. 类型断言安全检查
4. 错误处理一致性改进

Phase 3: 中期优化

1. bringUpDevice 跨平台实现
2. 资源引用保存优化
3. 日志级别调整
4. 代码重构和去重

---

📊 当前状态

类别	总数	已修复	进行中	待开始	完成率
P0 - 严重	3	0	0	3	0%
P1 - 重要	4	0	0	4	0%
P2 - 次要	4	0	0	4	0%
P3 - 优化	3	0	0	3	0%
总计	14	0	0	14	0%

---

创建日期: 2026-03-20
最后更新: 2026-03-20
负责人: AI Assistant