130 lines
4.8 KiB
Markdown
130 lines
4.8 KiB
Markdown
# 程序文件重组方案
|
||
|
||
## 当前问题分析
|
||
|
||
目前项目中的Python脚本文件分布较为混乱，主要问题包括：
|
||
|
||
1. 核心理论相关脚本散落在不同位置
|
||
2. 工具类脚本没有按功能分类
|
||
3. 特定研究领域的脚本与通用工具混放
|
||
4. 根目录下有不应直接放置的程序文件
|
||
|
||
## 重组方案
|
||
|
||
### 1. 核心理论与研究程序
|
||
- `research/` - 研究程序目录
|
||
- `core-theory/` - 核心理论研究程序
|
||
- `core_definitions.py` (从 core-theory/01-foundational-concepts/ 移动)
|
||
- `tianshan-theory/` - 天山理论研究程序
|
||
- `merchant_sogdian_genealogy.py` (从 tianshan-theory/ 移动)
|
||
- `specialized/` - 专门研究程序
|
||
- `financial/` - 金融研究
|
||
- `阴间金融重估系统.py` (从 汇票/ 移动)
|
||
|
||
### 2. 工具程序
|
||
- `tools/` - 保留现有工具目录，但重组内部结构
|
||
- `ai-tools/` - AI相关工具 (保留)
|
||
- `analysis/` - 分析工具 (保留)
|
||
- `content-generation/` - 内容生成工具
|
||
- `generate_ebook.py` (从 tools/ 移动)
|
||
- `generate_podcast.py` (从 tools/ 移动)
|
||
- `generate_video.py` (从 tools/ 移动)
|
||
- `data-processing/` - 数据处理工具
|
||
- `image-processing/` (保留)
|
||
- `text-processing/` (保留)
|
||
- `visualization/` - 可视化工具 (保留)
|
||
- `document-management/` - 文档管理工具 (保留)
|
||
- `development/` - 开发工具
|
||
- `test_milvus_gpu.py` (从 tools/ 移动)
|
||
|
||
### 3. 应用程序
|
||
- `apps/` - 应用程序目录
|
||
- 用于放置完整的应用程序，未来扩展
|
||
|
||
## 目录结构图
|
||
|
||
```
|
||
huhan3000/
|
||
├── research/ # 研究程序
|
||
│ ├── core-theory/ # 核心理论研究
|
||
│ │ └── core_definitions.py
|
||
│ ├── tianshan-theory/ # 天山理论研究
|
||
│ │ └── merchant_sogdian_genealogy.py
|
||
│ └── specialized/ # 专门研究
|
||
│ └── financial/
|
||
│ └── 阴间金融重估系统.py
|
||
├── tools/ # 工具程序
|
||
│ ├── ai-tools/ # AI相关工具
|
||
│ ├── analysis/ # 分析工具
|
||
│ ├── content-generation/ # 内容生成工具
|
||
│ │ ├── generate_ebook.py
|
||
│ │ ├── generate_podcast.py
|
||
│ │ └── generate_video.py
|
||
│ ├── data-processing/ # 数据处理工具
|
||
│ │ ├── image-processing/
|
||
│ │ └── text-processing/
|
||
│ ├── visualization/ # 可视化工具
|
||
│ ├── document-management/ # 文档管理工具
|
||
│ └── development/ # 开发工具
|
||
│ └── test_milvus_gpu.py
|
||
└── apps/ # 应用程序
|
||
```
|
||
|
||
## 实施步骤
|
||
|
||
1. ✅ 创建新的目录结构
|
||
2. ✅ 移动文件到新位置
|
||
3. 🔄 更新相关文档和引用路径
|
||
4. ⏳ 提交并推送更改
|
||
|
||
## 实施进度
|
||
|
||
### 已完成的工作
|
||
|
||
1. **目录结构创建**：
|
||
- 创建了 `research/core-theory/` 目录
|
||
- 创建了 `research/tianshan-theory/` 目录
|
||
- 创建了 `research/specialized/financial/` 目录
|
||
- 创建了 `tools/content-generation/` 目录
|
||
- 创建了 `tools/data-processing/` 目录
|
||
- 创建了 `tools/development/` 目录
|
||
- 创建了 `apps/` 目录
|
||
|
||
2. **文件移动**：
|
||
- 移动了 `core_definitions.py` 到 `research/core-theory/`
|
||
- 移动了 `merchant_sogdian_genealogy.py` 到 `research/tianshan-theory/`
|
||
- 移动了 `阴间金融重估系统.py` 到 `research/specialized/financial/`
|
||
- 移动了 `generate_ebook.py` 到 `tools/content-generation/`
|
||
- 移动了 `generate_podcast.py` 到 `tools/content-generation/`
|
||
- 移动了 `generate_video.py` 到 `tools/content-generation/`
|
||
- 移动了 `image-processing/` 目录到 `tools/data-processing/`
|
||
- 移动了 `text-processing/` 目录到 `tools/data-processing/`
|
||
- 移动了 `test_milvus_gpu.py` 到 `tools/development/`
|
||
|
||
3. **文档更新**：
|
||
- 更新了主 `README.md` 中的目录结构部分
|
||
- 更新了 `项目结构说明.md` 中的理论体系和程序工具部分
|
||
- 更新了 `爹学整理中心/README.md` 中的目录结构部分
|
||
|
||
### 待完成的工作
|
||
|
||
1. **文档更新**：
|
||
- 检查并更新其他可能引用旧路径的文档
|
||
- 更新程序文件中的导入路径（如有）
|
||
|
||
2. **提交更改**：
|
||
- 提交所有更改到版本控制系统
|
||
- 推送到远程仓库
|
||
|
||
## 优势
|
||
|
||
1. **清晰分类**：按功能和用途分类，便于维护和查找
|
||
2. **权重区分**：核心研究、工具和应用分离，权重明确
|
||
3. **可扩展性**：预留了扩展空间，便于未来添加新的程序
|
||
4. **专业化**：专门研究内容独立存放，便于专题研究
|
||
|
||
## 注意事项
|
||
|
||
1. 移动文件后需要更新相关的导入路径
|
||
2. 可能需要更新README文档中的路径引用
|
||
3. 检查是否有硬编码的文件路径需要更新 |