# 程序文件重组方案

## 当前问题分析

目前项目中的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. 检查是否有硬编码的文件路径需要更新