docs: aggregate project documentation under docs/ with unified index

- Move all per-module security audit reports to docs/security/
- Move code review logs to docs/reviews/, analysis reports to docs/reports/
- Add docs/INDEX.md as single entry point for all project documentation
- Add documentation management conventions section to README.md
- Clean up empty per-module docs/ directories
This commit is contained in:
qing committed 2026-08-03 13:21:48 +08:00
1 parent 9dbe395484
commit a7a78d1424
22 files changed
+151

No files matched your search

-50
View File
@@ -1,50 +0,0 @@
# BotOps 模块安全审计报告
**审计日期**: 2026-08-01
**审计范围**: `app.py`、`ws_client.py`、`commands.py`、`widgets/`
**代码版本**: dev_qing 分支
---
## 修复进度
| 优先级 | 总数 | 已修复 | 待修复 |
|--------|------|--------|--------|
| P0 | 1 | 0 | 1 |
| P1 | 1 | 0 | 1 |
---
## 🔴 P0 — 严重问题
### P0-1: WebSocket 客户端连接无证书验证/无认证
- **位置**: `ws_client.py`
- **问题**: BotOps 作为运维管理客户端,连接后端 WebSocket 时:
- 若连接 aibox/core 的 WebSocket 管理接口,需要确认 TLS 证书验证是否启用
- Token/认证凭据存储方式需审计
- **修复建议**:
1. 启用 TLS 证书验证,不使用 `verify=False`
2. 认证 Token 安全存储(系统钥匙串而非明文配置文件)
---
## 🟠 P1 — 高危问题
| # | 问题 | 说明 |
|---|------|------|
| P1-1 | 命令执行权限 | BotOps 作为运维工具,可执行系统命令,需确认是否限制了可执行命令范围 |
---
## ✅ 已有安全机制
1. ✅ **桌面客户端架构**: 本地运行应用,天然隔离
2. ✅ **WebSocket 通信**: 与后端实时通信
---
## 修复路线图
### 短期
- [ ] 审计 ws_client.py 的 TLS 配置
- [ ] 确认命令执行白名单