🔒 Security: - 修复 API Key 泄露,移除 platform_db.json 明文存储 - 限制 CORS 允许来源,不再全开放 - 添加路径校验防止目录穿越攻击 - Git 命令使用列表传参防止注入 - os.killpg 添加异常处理 🐛 Bug Fixes: - 生产环境禁用 Flask debug 模式 - 修复 SSE 连接泄漏(useTaskLogs + ReposView) - 修复 fetch 静默吞错误,添加 console.error 日志 - 补全 _run_ui_fix 函数签名 - 修复 .coveragerc source 配置 - _load_db 添加文件锁和 Queue maxsize - SSE log_queues 使用 WeakValueDictionary 🔧 Refactor: - BaseAPI → APIClient 统一命名 - 删除后端死代码和重复 import - 删除 business_backup 备份代码 - 删除 conftest_metrics 死代码 📝 Docs: - 新增 CHANGELOG.md 和 CHANGELIST.md - 更新 QUICKSTART.md 添加安全注意事项 - 更新 CONFIG.md 添加安全加固和性能优化
4.6 KiB
4.6 KiB
Changelist - v1.1.0 (2026-07-15)
变更摘要
本次更新包含 17 项修复,涵盖安全性、稳定性、代码质量三个方面。
🔒 Security (5 项)
| # | 修复项 | 文件 | 说明 |
|---|---|---|---|
| 1 | API Key 泄露 | backend/app.py |
从 platform_db.json 移除明文 API Key |
| 2 | CORS 全开放 | backend/app.py |
限制 CORS 允许来源 |
| 3 | 路径穿越漏洞 | backend/app.py |
添加路径校验防止 ../ 攻击 |
| 4 | Git 参数注入 | backend/app.py |
使用列表传参替代字符串拼接 |
| 5 | os.killpg 信号处理 | backend/app.py |
添加异常处理避免信号发送失败 |
🐛 Bug Fixes (7 项)
| # | 修复项 | 文件 | 说明 |
|---|---|---|---|
| 6 | Flask debug 模式 | backend/__main__.py |
生产环境禁用 debug=True |
| 7 | SSE 连接泄漏 | frontend/src/hooks/useTaskLogs.ts |
组件卸载时自动关闭 EventSource |
| 8 | SSE 连接泄漏 | frontend/src/components/repos/ReposView.tsx |
内联 SSE 添加 ref 管理和 cleanup |
| 9 | fetch 静默吞错误 | frontend/src/components/dashboard/Dashboard.tsx |
.catch(() => {}) → console.error |
| 10 | fetch 静默吞错误 | frontend/src/components/tasks/TasksView.tsx |
.catch(() => {}) → console.error |
| 11 | fetch 静默吞错误 | frontend/src/components/repos/ReposView.tsx |
.catch(() => {}) → console.error |
| 12 | fetch 静默吞错误 | frontend/src/components/reports/ReportsView.tsx |
.catch(() => {}) → console.error |
| 13 | fetch 静默吞错误 | frontend/src/components/existing/ExistingTestsView.tsx |
.catch(() => {}) → console.error |
| 14 | _run_ui_fix 签名 |
backend/app.py |
补全函数参数定义 |
| 15 | .coveragerc 配置 |
.coveragerc |
source = tests → source = . |
| 16 | _load_db 并发安全 |
backend/app.py |
添加文件锁 + Queue maxsize + finally |
| 17 | SSE log_queues 泄漏 | backend/app.py |
WeakValueDictionary 替代普通 dict |
🔧 Refactor (3 项)
| # | 修复项 | 文件 | 说明 |
|---|---|---|---|
| 18 | BaseAPI → APIClient | backend/app.py |
统一 API 客户端命名 |
| 19 | 删除后端死代码 | backend/app.py |
移除重复 import、未使用变量 |
| 20 | 删除备份代码 | framework/business_backup/ |
清理遗留备份目录 |
| 21 | 删除死代码 | tests/conftest_metrics.py |
清理未使用的测试配置 |
📝 Documentation (2 项)
| # | 修复项 | 文件 | 说明 |
|---|---|---|---|
| 22 | 新增 CHANGELOG | CHANGELOG.md |
新增版本变更日志 |
| 23 | 更新 QUICKSTART | docs/QUICKSTART.md |
添加安全注意事项和常见问题 |
| 24 | 更新 CONFIG | docs/CONFIG.md |
添加安全加固和性能优化章节 |
文件变更统计
修改文件:
- backend/__main__.py
- backend/app.py
- .coveragerc
- .env.example
- docs/CONFIG.md
- docs/QUICKSTART.md
- frontend/src/components/dashboard/Dashboard.tsx
- frontend/src/components/existing/ExistingTestsView.tsx
- frontend/src/components/reports/ReportsView.tsx
- frontend/src/components/repos/ReposView.tsx
- frontend/src/components/tasks/TasksView.tsx
- frontend/src/hooks/useTaskLogs.ts
- frontend/vite.config.ts
- framework/business/billing.py
- framework/business/meal_reminder.py
- plugins/pylint_analyzer/__init__.py
- plugins/test_runner/__init__.py
新增文件:
- CHANGELOG.md
- CHANGELIST.md
删除文件:
- framework/business_backup/cloud_desktop_page.py
- framework/business_backup/dev_machine_page.py
- framework/business_backup/image_generation_page.py
- framework/business_backup/login.py
- framework/business_backup/login_page.py
- framework/business_backup/mirror_assets_page.py
- framework/business_backup/openclaw_page.py
- framework/business_backup/quantization_page.py
- framework/business_backup/three_d_assets_page.py
- framework/business_backup/three_d_generation_page.py
- tests/conftest_metrics.py
验证结果
- 前端构建成功 (
pnpm build) - 后端启动正常 (
python3 -m backend) - 健康检查通过 (
/api/health→ 200) - 所有
.catch(() => {})已替换 - SSE 连接泄漏已修复
兼容性
- 向后兼容:是
- 需要重启服务:是
- 需要重新构建前端:是(已构建)
后续建议
- 定期审计:每月检查
platform_db.json是否包含敏感数据 - 依赖更新:定期更新
requirements.txt和package.json - 安全扫描:集成 SAST 工具(如 Bandit)到 CI/CD
- 日志监控:配置日志告警,及时发现异常请求
Generated: 2026-07-15