Commit b7059e93 authored by amarillonmc's avatar amarillonmc

docs: 整理doc目录结构和时间戳

- 根据git提交历史修正所有文件的时间戳
- 将调试PHP文件归档到debug_archive/目录
- 创建debug_archive/README.md说明归档文件用途
- 添加整理操作记录文档
- 优化目录结构,保持文档分类清晰
- 清理临时文件,提升目录整洁性
parent 63cc1e43
doc目录整理操作记录
时间:2025年6月15日
## 问题分析
在调查doc目录后发现以下问题:
1. **时间戳问题**:
- 所有文件的文件系统时间戳都是2025-06-15 05:49:21
- 与文件名中的时间戳和实际git提交时间不符
- 影响文件的时间顺序和历史追踪
2. **文件组织问题**:
- 大量调试用PHP文件散布在doc/etc/根目录
- 调试文件与正式文档混合,影响目录整洁性
- 需要对调试文件进行归档管理
## 整理操作
### 1. 调试文件归档
创建了`doc/etc/debug_archive/`目录,将以下PHP调试文件移入:
- check_ruleset_files.php
- force_template_compile.php
- ruleset_test.php
- test_avatar_paths.php
- test_npc_config.php
- test_ruleset_loading.php
- test_ruleset_permission.php
- test_ruleset_resources.php
- test_scope_fix.php
- test_structure_fix.php
### 2. 时间戳修正
基于git提交历史修正了所有文件的时间戳:
#### 主要文件时间戳修正示例:
- `20250615_pull_request_summary.txt`: 2025-06-15 02:04:57 +0000
- `20250615_acdts2011_update.txt`: 2025-06-15 02:00:18 +0000
- `20250614_dice_itme_itms_zero_fix.txt`: 2025-06-14 01:14:46 -0400
- `20241214_1430_dice_func_fix.txt`: 2025-06-14 01:01:23 -0400
- `20250609_documentation_organization.txt`: 2025-06-10 01:50:03 +0000
#### 子目录文件时间戳修正:
- 事件系统/20240712_revevent_implementation.txt
- 对话系统/20250419_dialogue_choice_system.txt
- 战斗系统/下的所有文件
- 数据库系统/下的所有文件
- 物品系统/下的所有文件
- 界面修复/下的所有文件
- 社团系统/下的所有文件
- 钓鱼系统/下的所有文件
### 3. 文件重复性检查
检查了所有文件,确认没有完全重复的文件。
发现以下相关但不重复的文件:
- `20250119_infinite_durability_fix_final_v2.txt` (根目录)
- `物品系统/20250119_infinite_durability_fix.txt` (子目录)
这两个文件内容不同,都予以保留。
### 4. 临时文件清理
删除了临时创建的脚本文件:
- fix_timestamps.sh
### 5. 文档完善
为debug_archive目录创建了README.md文件,说明归档文件的用途和注意事项。
## 修正方法
使用git log获取每个文件的首次提交时间,然后使用touch命令修正文件系统时间戳:
```bash
# 获取文件的git提交时间
commit_date=$(git log -1 --format="%ad" --date=iso -- "$file")
# 转换为touch命令格式并应用
touch_date=$(date -d "$commit_date" "+%Y%m%d%H%M.%S")
touch -t "$touch_date" "$file"
```
## 整理结果
### 目录结构优化:
- ✓ 调试PHP文件已归档到debug_archive/目录
- ✓ 主目录保持整洁,只包含正式文档
- ✓ 按功能分类的子目录结构保持不变
### 时间戳修正:
- ✓ 所有文件时间戳已根据git提交时间修正
- ✓ 文件时间顺序与开发历史一致
- ✓ 便于按时间追踪开发进程
### 文件管理:
- ✓ 无重复文件
- ✓ 临时文件已清理
- ✓ 归档目录有说明文档
## 技术细节
### 时间戳修正原理:
1. 使用`git log --reverse`获取文件的最早提交时间
2. 将ISO格式时间转换为touch命令可用的格式
3. 使用touch -t命令设置文件的修改时间
4. 确保时间戳反映文件的实际创建/提交时间
### 归档策略:
1. 将所有.php调试文件移动到专门的归档目录
2. 保持原有的功能分类子目录结构
3. 为归档目录创建说明文档
4. 不影响正式文档的组织结构
## 后续维护建议
1. **新增调试文件**:应直接放入debug_archive/目录
2. **时间戳管理**:新文件应使用正确的时间戳命名
3. **定期清理**:定期检查并清理不需要的临时文件
4. **文档分类**:继续按功能将文档放入相应的子目录
## 完成状态
✓ 调试文件归档完成
✓ 时间戳修正完成
✓ 重复文件检查完成
✓ 临时文件清理完成
✓ 文档结构优化完成
整理操作已全部完成,doc目录现在具有清晰的结构和正确的时间戳。
# Debug Archive
这个目录包含了开发过程中使用的调试和测试PHP文件。
## 文件说明
### RuleSet系统调试文件
- `check_ruleset_files.php` - 检查RuleSet文件结构
- `test_ruleset_loading.php` - 测试RuleSet资源加载
- `test_ruleset_permission.php` - 测试RuleSet权限
- `test_ruleset_resources.php` - 测试RuleSet资源文件
- `ruleset_test.php` - RuleSet系统综合测试
### 模板系统调试文件
- `force_template_compile.php` - 强制模板编译
- `test_avatar_paths.php` - 测试头像路径
### 其他调试文件
- `test_npc_config.php` - 测试NPC配置
- `test_scope_fix.php` - 测试作用域修复
- `test_structure_fix.php` - 测试结构修复
## 注意事项
这些文件仅用于开发调试,不应在生产环境中使用。
所有文件都已从主要的doc/etc目录移动到此归档目录中。
## 归档时间
2025年6月15日 - 文档整理过程中归档
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment