sanguo_vnpy/jiangwei-platform/research/sanguo_vnpy目录整理提案.md

sanguo_vnpy 项目目录整理提案

提案人: 姜维（平台总督） 日期: 2026-04-29 状态: 待确认

---

一、现状扫描

目录	文件数	大小	现状评估
archives/	4	90M	⚠️ 含两个90M的旧Docker镜像tar + 过时pid文件
config/	21	84K	✅ 成果物，NAS部署用的nginx+systemd配置
data/	1	8K	✅ 成果物，quant_trading.db
docker/	5	20K	✅ 成果物，Dockerfile+entrypoint+requirements
jiangwei-platform/	11	60K	✅ 成果物，NAS部署脚本+模板+日志
logs/	8	32K	⚠️ 历史调试日志，大部分无用
research/	39	360K	⚠️ 混杂，有成果也有过程文件
scripts/	99	580K	❌ 重灾区：大量一次性修复/调试脚本
test/	88	772K	❌ 重灾区：大量重复测试脚本（v2/v3/v4/v5/v6）
backup/	0	0	空目录
*.log（根目录）	3	4.6M	❌ 垃圾日志

总计：279个文件，其中约170+是一次性调试/修复脚本，需要清理

---

二、分类判定

✅ 保留（核心成果物）

目录	内容	保留理由
config/	nginx(7) + systemd(14)	NAS多用户部署配置，直接使用
data/	quant_trading.db	回测数据库
docker/	Dockerfile + entrypoint.sh + requirements	Docker镜像构建核心文件
jiangwei-platform/deploy/nas/	部署脚本+模板+日志+计划	NAS部署全流程成果物

⚠️ 需要整理（有价值的混杂在垃圾里）

目录	保留	归档/清理
research/	NAS部署报告(7)、vnpy调研报告(5)、jq文章分析(1)	过程文件、临时爬虫脚本
scripts/backtest-service/	回测服务核心代码(9) → 这是最重要的成果物	models.py.bak
scripts/start_*.py	3个启动脚本	-

❌ 建议清理（垃圾/一次性文件）

目录	文件数	说明
archives/	4	旧Docker镜像tar（90M）+ pid文件，已无用
test/backtest/	70	大量v2/v3/v4重复测试脚本，调试完成不再需要
test/rpc/	6	RPC测试脚本，调试完成
scripts/deployment/	37	大量一次性修复/部署脚本
scripts/utils/	30	大量一次性检查/修复工具
scripts/verify/	2	验证脚本
logs/	8	历史日志
根目录*.log	3	auto-sync日志(4.6M)
backup/	0	空目录

---

三、整理提案

目标结构

sanguo_vnpy/
├── README.md                          # 项目总说明（新建）
├── docker/                            # Docker镜像构建
│   ├── Dockerfile
│   ├── entrypoint.sh
│   └── requirements/
├── scripts/
│   ├── backtest-service/              # 🔥 回测服务核心代码（最重要）
│   ├── start_backtest_service.py
│   ├── start_rpc_server.py
│   └── start_web_trader.py
├── config/                            # NAS部署配置
│   ├── nginx/
│   └── systemd/
├── jiangwei-platform/
│   └── deploy/nas/                    # NAS部署全流程
├── data/                              # 数据
├── research/                          # 调研报告（整理后）
│   ├── nas/                           # NAS部署相关调研
│   ├── vnpy/                          # vnpy框架调研
│   └── jq_essence_articles/           # 聚宽精华文章
└── archive/                           # 归档（清理后的历史文件）
    └── 2026-04-29-cleanup/            # 按日期归档

操作清单

#	操作	影响	风险
1	删除 archives/（90M旧镜像+pid）	释放90M	无
2	删除根目录 *.log（4.6M同步日志）	释放4.6M	无
3	删除 logs/ 历史日志	释放32K	无
4	删除 backup/ 空目录	0	无
5	整理 test/ → 归档到 archive/2026-04-29-cleanup/test/	移动88个文件	低
6	整理 scripts/deployment/ → 归档	移动37个文件	低
7	整理 scripts/utils/ → 归档	移动30个文件	低
8	整理 scripts/verify/ → 归档	移动2个文件	低
9	删除 scripts/backtest-service/models.py.bak	删除1个文件	无
10	清理 research/ 中的过程文件	移动少量文件	低
11	新建 README.md 项目总说明	新增1个文件	无

原则

1. 只清理不删除：所有清理的文件移到 archive/2026-04-29-cleanup/ 保持原有目录结构，万无一失
2. 保留全部成果物：核心代码、配置、调研报告全部原位保留
3. 不涉及NAS端：只整理本地仓库，NAS上的文件不受影响
4. 整理后git提交：一次清晰的commit记录

---

四、预计效果

指标	整理前	整理后
总文件数	279	~70
根目录文件	4个log + 1个md	1个README.md
scripts/	99个（大量噪音）	~12个（核心+启动脚本）
test/	88个	0（全部归档）
磁盘占用	~95M	~5M（归档另计）

---

请确认是否同意此方案，确认后立即执行。