Merge branch '3.5.x'

Author: CodeCasterX

.claude/README.md

@@ -13,7 +13,8 @@
     ├── pr-update.md       # 更新 PR 描述
     ├── commit.md          # 提交变更
     ├── upgrade-dep.md     # 升级依赖
-    └── review.md          # 审查 PR
+    ├── review.md          # 审查 PR
+    └── fix-permissions.md # 检查和修复文件权限
 ```
 
 ## 📋 项目规则
@@ -22,7 +23,8 @@
 
 ### 规则 1: 文件权限管理
 - 所有新建/修改的文件必须设置正确的所有者权限
-- 动态从 `pom.xml` 等参考文件获取权限信息
+- 动态从 `README.md` 等参考文件获取权限信息
+- README.md 是通用文件，适用于所有语言的项目
 - 避免硬编码用户名和用户组
 
 ### 规则 2: PR 提交规范
@@ -97,6 +99,20 @@
 - 测试覆盖情况
 - 生成审查报告
 
+### 检查和修复权限
+
+```bash
+# 检查并修复所有文件和目录权限
+/fix-permissions
+```
+
+**自动化流程：**
+1. 从 README.md 获取正确的所有者信息
+2. 扫描所有文件和目录
+3. 识别权限不一致的文件
+4. 自动修复为正确的所有者
+5. 生成检查报告
+
 ## 🎯 最佳实践
 
 ### 1. 使用 Slash Commands
@@ -188,7 +204,7 @@ gh pr view 369
 **解决方案**：使用 `/pr-update <pr-number>` 命令更新
 
 ### 问题：文件权限错误
-**解决方案**：已在 `project-rules.md` 中配置自动处理
+**解决方案**：使用 `/fix-permissions` 命令自动检查和修复
 
 ### 问题：想要自定义命令
 **解决方案**：在 `.claude/commands/` 目录创建新的 `.md` 文件

.claude/commands/fix-permissions.md

@@ -0,0 +1,88 @@
+检查并修复项目中所有文件和文件夹的权限，确保符合项目规范。
+
+**用法：**
+- `/fix-permissions` - 检查并自动修复所有权限问题
+
+**执行步骤：**
+
+1. **获取参考文件的所有者信息**
+   ```bash
+   ls -l README.md | awk '{print $3":"$4}'
+   ```
+   - 从项目根目录的 `README.md` 动态获取正确的所有者信息
+   - README.md 是所有项目都有的通用文件
+   - 不硬编码用户名和用户组
+
+2. **统计当前文件权限分布**
+   ```bash
+   # 检查所有文件的所有者分布
+   find . -type f -print0 2>/dev/null | xargs -0 ls -l 2>/dev/null | awk '{print $3":"$4}' | sort | uniq -c | sort -rn
+
+   # 检查所有目录的所有者分布
+   find . -type d -print0 2>/dev/null | xargs -0 ls -ld 2>/dev/null | awk '{print $3":"$4}' | sort | uniq -c | sort -rn
+   ```
+
+3. **识别权限不一致的文件**
+   ```bash
+   # 找出所有者不是参考用户的文件
+   find . -type f -print0 2>/dev/null | xargs -0 ls -l 2>/dev/null | awk '$3 == "root" {print $9}'
+
+   # 找出所有者不是参考用户的目录
+   find . -type d -print0 2>/dev/null | xargs -0 ls -ld 2>/dev/null | awk '$3 == "root" {print $9}'
+   ```
+
+4. **修复文件权限**
+   ```bash
+   # 获取正确的所有者信息
+   OWNER_GROUP=$(ls -l README.md | awk '{print $3":"$4}')
+
+   # 修复所有文件权限
+   find . -type f -print0 2>/dev/null | xargs -0 ls -l 2>/dev/null | awk '$3 == "root" {print $9}' | xargs sudo chown $OWNER_GROUP
+
+   # 修复所有目录权限
+   find . -type d -print0 2>/dev/null | xargs -0 ls -ld 2>/dev/null | awk '$3 == "root" {print $9}' | xargs sudo chown $OWNER_GROUP
+   ```
+
+5. **最终验证**
+   ```bash
+   # 统计修复后的权限分布
+   find . \( -type f -o -type d \) -print0 2>/dev/null | xargs -0 ls -ld 2>/dev/null | awk '{print $3":"$4}' | sort | uniq -c | sort -rn
+
+   # 抽查几个之前有问题的文件
+   ls -ld ./.claude/settings.local.json ./framework/.claude/settings.local.json
+   ```
+
+6. **生成检查报告**
+   - 显示参考所有者信息
+   - 显示发现的问题文件和目录数量
+   - 显示修复的文件和目录列表
+   - 显示最终验证结果
+
+**规范说明：**
+
+根据 `.claude/project-rules.md` 中的规则 1：
+- 所有文件必须设置正确的所有者权限
+- 不要硬编码用户名和用户组
+- 动态从 `README.md` 等参考文件获取权限信息
+- README.md 是通用文件，适用于所有语言的项目
+- 确保用户可以自主修改所有文件
+
+**常见问题：**
+
+**为什么有些文件是 root 所有者？**
+- 可能是使用 `sudo` 创建的文件或目录
+- Git 操作时使用了 sudo 权限
+- Claude Code 创建文件时权限设置不当
+
+**修复后会影响 Git 吗？**
+- 不会影响 Git 历史和提交
+- 只改变文件系统级别的所有者
+- Git 内容和状态保持不变
+
+**需要 sudo 权限吗？**
+- 修复 root 所有者的文件时需要 sudo
+- 确保当前用户在 sudoers 列表中
+
+**参考文档：**
+- 项目规则：`.claude/project-rules.md` (规则 1)
+- 动态获取权限方法的详细说明

.claude/project-rules.md

@@ -11,8 +11,8 @@
 **动态获取权限的方法：**
 
 ```bash
-# 方法1: 从项目根目录的 pom.xml 获取所有者
-REF_FILE="pom.xml"  # 或其他稳定存在的文件
+# 方法1: 从项目根目录的 README.md 获取所有者
+REF_FILE="README.md"  # 所有项目都有的通用文件
 OWNER=$(ls -l $REF_FILE | awk '{print $3}')
 GROUP=$(ls -l $REF_FILE | awk '{print $4}')
 
@@ -32,22 +32,47 @@ GROUP=$(stat -c "%G" $REF_FILE)   # Linux
 
 ```bash
 # 1. 先获取参考文件的所有者
-OWNER_GROUP=$(ls -l pom.xml | awk '{print $3":"$4}')
+OWNER_GROUP=$(ls -l README.md | awk '{print $3":"$4}')
 
 # 2. 应用到新文件
 sudo chown $OWNER_GROUP <file_path>
 
 # 或者分步执行
-OWNER=$(ls -l pom.xml | awk '{print $3}')
-GROUP=$(ls -l pom.xml | awk '{print $4}')
+OWNER=$(ls -l README.md | awk '{print $3}')
+GROUP=$(ls -l README.md | awk '{print $4}')
 sudo chown $OWNER:$GROUP <file_path>
 ```
 
+**⚠️ 强制执行规则（CRITICAL）：**
+
+每次使用 `Write` 或 `Edit` 工具创建/修改文件后，**必须立即**在同一个响应中使用 `Bash` 工具修复权限。
+
+**标准流程（必须遵循）：**
+
+```bash
+# 步骤 1: 创建或修改文件
+Write(file_path, content)  # 或 Edit(...)
+
+# 步骤 2: 立即动态获取正确的所有者并修复权限（在同一个响应中）
+Bash("OWNER_GROUP=$(ls -l README.md | awk '{print $3\":\"$4}') && sudo chown $OWNER_GROUP " + file_path)
+
+# 或者批量修复多个文件
+Bash("OWNER_GROUP=$(ls -l README.md | awk '{print $3\":\"$4}') && sudo chown $OWNER_GROUP file1 file2 file3")
+```
+
+**为什么必须这样做：**
+- Write 和 Edit 工具可能会将文件所有者更改为 root
+- 这会导致用户无法修改自己的文件
+- 必须动态获取权限，不能硬编码用户名
+- 必须在工具调用后立即修复，不能延后到下一个响应
+
 **检查清单：**
-- [ ] 使用 Write 工具创建新文件后，立即从已有文件获取权限并设置
-- [ ] 使用 Edit 工具修改文件时，确认文件所有者与项目其他文件一致
-- [ ] 批量创建文件后，统一修改所有权
+- [ ] 使用 Write 工具创建新文件后，**立即**在同一响应中动态获取并修复权限
+- [ ] 使用 Edit 工具修改文件后，**立即**在同一响应中动态获取并修复权限
+- [ ] 批量创建/修改文件后，统一修改所有权
 - [ ] 创建目录后，递归修改目录及其内容的所有权
+- [ ] 每次修改后验证权限是否正确
+- [ ] **绝对不要**硬编码用户名和用户组
 
 **完整示例：**
 
@@ -58,14 +83,14 @@ Bash("sudo chown jiyujie:staff " + file_path)  # 在其他人电脑上会失败
 
 # ✅ 正确做法：动态获取权限
 Write(file_path, content)
-# 从项目根目录的 pom.xml 获取所有者信息
-Bash("OWNER_GROUP=$(ls -l pom.xml | awk '{print $3\":\"$4}') && sudo chown $OWNER_GROUP " + file_path)
+# 从项目根目录的 README.md 获取所有者信息
+Bash("OWNER_GROUP=$(ls -l README.md | awk '{print $3\":\"$4}') && sudo chown $OWNER_GROUP " + file_path)
 
 # ✅ 更简洁的做法：批量处理
 Write(file1, content1)
 Write(file2, content2)
 Write(file3, content3)
-Bash("OWNER_GROUP=$(ls -l pom.xml | awk '{print $3\":\"$4}') && sudo chown $OWNER_GROUP file1 file2 file3")
+Bash("OWNER_GROUP=$(ls -l README.md | awk '{print $3\":\"$4}') && sudo chown $OWNER_GROUP file1 file2 file3")
 ```
 
 ## Pull Request 提交规范
@@ -201,8 +226,8 @@ mvn test
 # 检查文件权限
 ls -l <file>
 
-# 动态修改文件权限（从 pom.xml 获取所有者）
-OWNER_GROUP=$(ls -l pom.xml | awk '{print $3":"$4}')
+# 动态修改文件权限（从 README.md 获取所有者）
+OWNER_GROUP=$(ls -l README.md | awk '{print $3":"$4}')
 sudo chown $OWNER_GROUP <file>
 ```
 
@@ -225,6 +250,11 @@ sudo chown $OWNER_GROUP <file>
 **`/review <pr-number>`** - 审查 Pull Request
 - `/review 369` - 审查 #369 PR
 
+### 项目管理命令
+
+**`/fix-permissions`** - 检查和修复文件权限
+- `/fix-permissions` - 检查并自动修复所有权限问题
+
 ### 开发相关命令
 
 **`/commit [message]`** - 提交变更