Test_Agent/CHANGELIST.md
jiawei.chen 6d98241790 release: v1.1.0 - 安全加固与稳定性修复
🔒 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 添加安全加固和性能优化
2026-07-15 16:44:34 +08:00

4.6 KiB
Raw Permalink Blame History

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 连接泄漏已修复

兼容性

  • 向后兼容:是
  • 需要重启服务:是
  • 需要重新构建前端:是(已构建)

后续建议

  1. 定期审计:每月检查 platform_db.json 是否包含敏感数据
  2. 依赖更新:定期更新 requirements.txt 和 package.json
  3. 安全扫描:集成 SAST 工具(如 Bandit)到 CI/CD
  4. 日志监控:配置日志告警,及时发现异常请求

Generated: 2026-07-15