重构程序文件目录结构并更新相关路径引用

- 创建新的目录结构:research/、tools/(含子目录)和apps/
- 移动核心理论文件到research/core-theory/
- 移动天山理论文件到research/specialized/
- 重组tools/目录为多个子目录:content-generation/、data-processing/等
- 更新所有文档中的路径引用,包括README.md、项目结构说明.md等
- 更新工作流文件和脚本中的路径引用
- 更新文档索引文件中的路径引用
This commit is contained in:
ben 2025-10-27 12:54:26 +00:00
parent a60b82182d
commit 5b0a6c7bc1
22 changed files with 243 additions and 70 deletions

View File

@ -38,8 +38,8 @@ jobs:
- name: 生成 EPUB/HTML 文档
if: contains(github.event.head_commit.message, '[publish:ebook]') || contains(github.event.pull_request.title, '[publish:ebook]')
run: |
./documentation/analysis/phallic-worship-analysis/venv/bin/python3 tools/generate_ebook.py --output_format epub
./documentation/analysis/phallic-worship-analysis/venv/bin/python3 tools/generate_ebook.py --output_format html
./documentation/analysis/phallic-worship-analysis/venv/bin/python3 tools/content-generation/generate_ebook.py --output_format epub
./documentation/analysis/phallic-worship-analysis/venv/bin/python3 tools/content-generation/generate_ebook.py --output_format html
- name: 生成 Podcast 音频
if: contains(github.event.head_commit.message, '[publish:podcast]') || contains(github.event.pull_request.title, '[publish:podcast]')
@ -47,7 +47,7 @@ jobs:
# 假设有一个 Markdown 文件作为 Podcast 脚本的来源
# 例如core-theory/cultural_logic_system.md
mkdir -p artifacts/podcast
./documentation/analysis/phallic-worship-analysis/venv/bin/python3 tools/generate_podcast.py --text_file core-theory/cultural_logic_system.md --output_audio artifacts/podcast/cultural_logic_podcast.mp3
./documentation/analysis/phallic-worship-analysis/venv/bin/python3 tools/content-generation/generate_podcast.py --text_file core-theory/cultural_logic_system.md --output_audio artifacts/podcast/cultural_logic_podcast.mp3
- name: 生成视频
if: contains(github.event.head_commit.message, '[publish:video]') || contains(github.event.pull_request.title, '[publish:video]')
@ -55,7 +55,7 @@ jobs:
# 假设有一个 Markdown 文件作为视频脚本的来源
# 例如historical-research/geopolitical-codes/Y音正统性与地缘政治密码_完整理论框架.md
mkdir -p artifacts/video
./documentation/analysis/phallic-worship-analysis/venv/bin/python3 tools/generate_video.py --text_file historical-research/geopolitical-codes/Y音正统性与地缘政治密码_完整理论框架.md --output_video artifacts/video/geopolitical_codes_video.mp4 --audio_path artifacts/podcast/cultural_logic_podcast.mp3
./documentation/analysis/phallic-worship-analysis/venv/bin/python3 tools/content-generation/generate_video.py --text_file historical-research/geopolitical-codes/Y音正统性与地缘政治密码_完整理论框架.md --output_video artifacts/video/geopolitical_codes_video.mp4 --audio_path artifacts/podcast/cultural_logic_podcast.mp3
- name: 上传生成物 (Artifacts)
uses: actions/upload-artifact@v3

View File

@ -29,6 +29,22 @@
│ ├── 04-accounting-operation/ # 历史会计学
│ ├── 05-three-empires-framework/ # 三大帝国框架
│ └── 06-legacy-docs/ # 旧版核心理论 ⭐
├── research/ # 研究程序
│ ├── core-theory/ # 核心理论研究程序
│ ├── tianshan-theory/ # 天山理论研究程序
│ └── specialized/ # 专门研究程序
│ └── financial/ # 金融研究程序
├── tools/ # 技术工具
│ ├── ai-tools/ # AI工具集成
│ ├── analysis/ # 分析工具
│ ├── content-generation/ # 内容生成工具
│ ├── data-processing/ # 数据处理工具
│ │ ├── image-processing/ # 图像处理工具
│ │ └── text-processing/ # 文本处理工具
│ ├── visualization/ # 可视化工具
│ ├── document-management/ # 文档管理工具
│ └── development/ # 开发工具
├── apps/ # 应用程序
├── historical-research/ # 历史研究
│ ├── jade-road/ # 玉石之路研究 ⭐
│ ├── yanda-origins/ # 嚈哒起源研究
@ -44,10 +60,6 @@
│ │ └── lianyaohu.md # 炼妖壶GameFi
│ └── analysis/3body/ # 三体解读
│ └── the scripts.md
├── tools/ # 技术工具
│ ├── image-processing/ # 图像处理工具
│ ├── diagrams/ # 可视化工具
│ └── ai-tools/ # AI工具集成
├── documentation/ # 文档资料
│ ├── overview/ # 项目概览
│ │ └── DOCUMENTATION_OVERVIEW.md

View File

@ -28305,7 +28305,7 @@
"suggested_english_name": "core_theory_heaven_earth_logic_framework.md"
},
"64dcc5d173d7": {
"file_path": "tools/generate_ebook.py",
"file_path": "tools/content-generation/generate_ebook.py",
"file_name": "generate_ebook.py",
"file_size": 1555,
"created_time": "2025-10-16T12:39:44.105708",
@ -28316,7 +28316,7 @@
"suggested_english_name": "other_generate_ebook.py"
},
"7ed28ec9c4dd": {
"file_path": "tools/generate_video.py",
"file_path": "tools/content-generation/generate_video.py",
"file_name": "generate_video.py",
"file_size": 3547,
"created_time": "2025-10-16T12:37:49.919604",
@ -28327,7 +28327,7 @@
"suggested_english_name": "other_generate_video.py"
},
"631d2ababf2e": {
"file_path": "tools/generate_podcast.py",
"file_path": "tools/content-generation/generate_podcast.py",
"file_name": "generate_podcast.py",
"file_size": 2058,
"created_time": "2025-10-16T12:37:08.998739",
@ -28349,7 +28349,7 @@
"suggested_english_name": "other_doc_indexer.py"
},
"4da4c015eab4": {
"file_path": "tools/image-processing/image_converter.py",
"file_path": "tools/data-processing/image-processing/image_converter.py",
"file_name": "image_converter.py",
"file_size": 8594,
"created_time": "2025-10-16T12:05:12.555277",
@ -28360,7 +28360,7 @@
"suggested_english_name": "other_image_converter.py"
},
"ef214e4f4f41": {
"file_path": "tools/image-processing/quick_convert.py",
"file_path": "tools/data-processing/image-processing/quick_convert.py",
"file_name": "quick_convert.py",
"file_size": 3044,
"created_time": "2025-10-16T12:05:12.555277",
@ -28371,7 +28371,7 @@
"suggested_english_name": "other_quick_convert.py"
},
"fde1497fcacc": {
"file_path": "tools/image-processing/deepzoom_generator.py",
"file_path": "tools/data-processing/image-processing/deepzoom_generator.py",
"file_name": "deepzoom_generator.py",
"file_size": 10509,
"created_time": "2025-10-16T12:05:12.555277",
@ -28382,7 +28382,7 @@
"suggested_english_name": "other_deepzoom_generator.py"
},
"4eac6fe390e2": {
"file_path": "tools/image-processing/analyze_large_image.py",
"file_path": "tools/data-processing/image-processing/analyze_large_image.py",
"file_name": "analyze_large_image.py",
"file_size": 5323,
"created_time": "2025-10-16T12:05:12.555277",

View File

@ -28323,7 +28323,7 @@
"suggested_english_name": "core_theory_heaven_earth_logic_framework.md"
},
"64dcc5d173d7": {
"file_path": "tools/generate_ebook.py",
"file_path": "tools/content-generation/generate_ebook.py",
"file_name": "generate_ebook.py",
"file_size": 1555,
"created_time": "2025-10-16T12:39:44.105708",
@ -28334,7 +28334,7 @@
"suggested_english_name": "other_generate_ebook.py"
},
"7ed28ec9c4dd": {
"file_path": "tools/generate_video.py",
"file_path": "tools/content-generation/generate_video.py",
"file_name": "generate_video.py",
"file_size": 3547,
"created_time": "2025-10-16T12:37:49.919604",
@ -28345,7 +28345,7 @@
"suggested_english_name": "other_generate_video.py"
},
"631d2ababf2e": {
"file_path": "tools/generate_podcast.py",
"file_path": "tools/content-generation/generate_podcast.py",
"file_name": "generate_podcast.py",
"file_size": 2058,
"created_time": "2025-10-16T12:37:08.998739",
@ -28367,7 +28367,7 @@
"suggested_english_name": "other_doc_indexer.py"
},
"4da4c015eab4": {
"file_path": "tools/image-processing/image_converter.py",
"file_path": "tools/data-processing/image-processing/image_converter.py",
"file_name": "image_converter.py",
"file_size": 8594,
"created_time": "2025-10-16T12:05:12.555277",
@ -28378,7 +28378,7 @@
"suggested_english_name": "other_image_converter.py"
},
"ef214e4f4f41": {
"file_path": "tools/image-processing/quick_convert.py",
"file_path": "tools/data-processing/image-processing/quick_convert.py",
"file_name": "quick_convert.py",
"file_size": 3044,
"created_time": "2025-10-16T12:05:12.555277",
@ -28389,7 +28389,7 @@
"suggested_english_name": "other_quick_convert.py"
},
"fde1497fcacc": {
"file_path": "tools/image-processing/deepzoom_generator.py",
"file_path": "tools/data-processing/image-processing/deepzoom_generator.py",
"file_name": "deepzoom_generator.py",
"file_size": 10509,
"created_time": "2025-10-16T12:05:12.555277",
@ -28400,7 +28400,7 @@
"suggested_english_name": "other_deepzoom_generator.py"
},
"4eac6fe390e2": {
"file_path": "tools/image-processing/analyze_large_image.py",
"file_path": "tools/data-processing/image-processing/analyze_large_image.py",
"file_name": "analyze_large_image.py",
"file_size": 5323,
"created_time": "2025-10-16T12:05:12.555277",

View File

@ -43,13 +43,23 @@
## 技术工具 (tools/)
### 分析工具
- `tools/image-processing/` - 图像处理工具
- `tools/data-analysis/` - 数据分析脚本
- `tools/ai-integration/` - AI工具集成
- `tools/data-processing/image-processing/` - 图像处理工具
- `tools/data-processing/` - 数据处理脚本
- `tools/ai-tools/` - AI工具集成
### 内容生成工具
- `tools/content-generation/` - 电子书、播客和视频生成工具
### 开发工具
- `tools/development/` - 开发辅助工具
- `tools/setup/` - 项目设置工具
### 可视化工具
- `tools/diagrams/` - 图表和可视化
- `tools/network-analysis/` - 网络分析工具
- `tools/visualization/` - 数据可视化工具
### 分析工具
- `tools/analysis/` - 数据分析脚本
## 文档资料 (documentation/)
### 项目文档

View File

@ -6831,16 +6831,16 @@ mv "tools/generate_podcast.py" "tools/other_generate_podcast.py"
mv "tools/document-management/doc_indexer.py" "tools/document-management/other_doc_indexer.py"
# image_converter.py -> other_image_converter.py
mv "tools/image-processing/image_converter.py" "tools/image-processing/other_image_converter.py"
mv "tools/data-processing/image-processing/image_converter.py" "tools/data-processing/image-processing/other_image_converter.py"
# quick_convert.py -> other_quick_convert.py
mv "tools/image-processing/quick_convert.py" "tools/image-processing/other_quick_convert.py"
mv "tools/data-processing/image-processing/quick_convert.py" "tools/data-processing/image-processing/other_quick_convert.py"
# deepzoom_generator.py -> other_deepzoom_generator.py
mv "tools/image-processing/deepzoom_generator.py" "tools/image-processing/other_deepzoom_generator.py"
mv "tools/data-processing/image-processing/deepzoom_generator.py" "tools/data-processing/image-processing/other_deepzoom_generator.py"
# analyze_large_image.py -> other_analyze_large_image.py
mv "tools/image-processing/analyze_large_image.py" "tools/image-processing/other_analyze_large_image.py"
mv "tools/data-processing/image-processing/analyze_large_image.py" "tools/data-processing/image-processing/other_analyze_large_image.py"
# 序章图片分析.md -> other_序章图片分析.md
mv "tools/ai-tools/序章图片分析.md" "tools/ai-tools/other_序章图片分析.md"

View File

@ -41,43 +41,54 @@
## 目录结构
```
## 目录结构
```
爹学整理中心/
├── README.md # 本文档
├── 入门指南.md # 爹学入门指南
├── 小宇宙核心系统.md # 核心系统概述
├── 目录结构.md # 目录结构说明
├── 核心理论/ # 核心理论体系
│ ├── 音韵考古学/ # 音韵考古学理论
│ ├── 爹学理论/ # 爹学理论体系
│ └── 文明理论/ # 文明理论体系
├── 专题研究/ # 文明专题研究
│ ├── 蒙古文明/ # 蒙古文明研究
│ ├── 犹太文明/ # 犹太文明研究
│ ├── 中华文明/ # 中华文明研究
│ └── 西方文明/ # 西方文明研究
├── 应用实践/ # 理论应用实践
│ ├── 文学批评/ # 文学批评应用
│ ├── 当代文化分析/ # 当代文化分析
│ └── 政治批判/ # 政治批判应用
├── 实证论证体系/ # 实证论证系统
│ ├── 方法论验证框架.md # 方法论验证
│ ├── 案例研究深度分析.md # 案例研究分析
│ └── 音韵密码实证数据库.md # 音韵密码数据库
├── 历史档案/ # 历史档案系统
│ ├── 原始笔记/ # 原始研究笔记
│ └── 版本存档/ # 版本历史存档
├── 索引系统/ # 多维度索引系统
│ ├── 概念索引.md # 概念索引
│ ├── 人物索引.md # 人物索引
│ ├── 文明索引.md # 文明索引
│ ├── 音韵索引.md # 音韵索引
│ └── 理论索引.md # 理论索引
└── 工具资源/ # 工具资源系统
├── 研究方法论/ # 研究方法论
├── 分析工具/ # 分析工具
├── 参考文献/ # 参考文献
└── 外部链接/ # 外部链接
├── README.md # 本文件,项目概述和导航
├── 入门指南.md # 新手入门指导
├── 小宇宙核心系统.md # 核心系统架构说明
├── 目录结构.md # 详细目录结构说明
├── 爹学整理中心优化方案.md # 组织优化建议
├── 程序文件重组方案.md # 程序文件重组计划
├── 核心理论/ # 核心理论研究
│ ├── 爹学理论/ # 爹学理论体系
│ ├── 文明理论/ # 文明传播理论
│ └── 音韵考古学/ # 音韵考古学研究
├── 专题研究/ # 文明专题研究
│ ├── 中华文明/ # 中华文明研究
│ ├── 犹太文明/ # 犹太文明研究
│ ├── 蒙古文明/ # 蒙古文明研究
│ └── 西方文明/ # 西方文明研究
├── 实证论证体系/ # 实证研究和方法论
│ └── 方法论验证框架.md # 研究方法论
├── 应用实践/ # 理论应用案例
│ ├── 当代文化分析/ # 当代文化现象分析
│ ├── 政治批判/ # 政治现象批判
│ └── 文学批评/ # 文学作品批评
├── 工具资源/ # 研究工具和资源
│ ├── 分析工具/ # 数据分析工具
│ ├── 研究方法论/ # 研究方法指南
│ ├── 参考文献/ # 重要文献资料
│ └── 外部链接/ # 相关外部资源
├── 索引系统/ # 分类索引系统
│ ├── 人物索引.md # 历史人物索引
│ ├── 文明索引.md # 文明体系索引
│ ├── 概念索引.md # 核心概念索引
│ ├── 理论索引.md # 理论体系索引
│ └── 音韵索引.md # 音韵考古索引
└── 历史档案/ # 历史资料存档
├── 原始笔记/ # 原始研究笔记
└── 版本存档/ # 各版本历史存档
```
```
## 索引系统

View File

@ -0,0 +1,130 @@
# 程序文件重组方案
## 当前问题分析
目前项目中的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. 检查是否有硬编码的文件路径需要更新

View File

@ -36,14 +36,24 @@ huhan3000是一个综合性研究项目包含历史文化研究、理论分
- **research-topics/** - 研究主题,包含中华文明、犹太文明、蒙古文明等
### 理论体系
- **core-theory/** - 核心理论,包含文明传播模型、爹学理论体系、音韵考古学基础等
- **tianshan-theory/** - 天山理论研究
- **research/core-theory/** - 核心理论研究,包含文明传播模型、爹学理论体系、音韵考古学基础等
- **research/specialized/** - 专门研究领域,如金融研究等
- **tianshan-theory/** - 天山理论研究待整合到research目录
### 文档与工具
- **documentation/** - 项目文档包含分析、规划、RFC等
- **tools/** - 工具集包含AI工具、图像处理、文本处理等
### 程序工具与开发
- **tools/content-generation/** - 内容生成工具,包含电子书、播客、视频生成等
- **tools/data-processing/** - 数据处理工具,包含图像处理、文本处理等
- **tools/development/** - 开发工具,包含测试工具等
- **tools/ai-tools/** - AI相关工具
- **tools/analysis/** - 分析工具
- **tools/diagrams/** - 图表工具
- **tools/setup/** - 设置工具
- **tools/visualization/** - 可视化工具
- **scripts/** - 脚本文件,包含文档构建、测试等
### 应用程序
- **apps/** - 应用程序目录(新建)
### 资源文件
- **images/** - 图片资源,按章节和主题组织
- **literary-works/** - 文学作品,包含分析、诗歌、人物简介等