# 文件管理二期 — 递归 chmod + 不可读提示

| 项 | 内容 |
|----|------|
| 设计 | [2026-06-01-files-root-ownership-ui-design.md](../specs/2026-06-01-files-root-ownership-ui-design.md) §4.5 二期 |
| 日期 | 2026-06-01 |

## 范围

1. `POST /sync/chmod` 增加 `recursive`；仅目录、`test -d` 校验；禁止对 `/` 等系统根递归。
2. `FilePermissionDialog`：目录显示「同时修改子项」+ 二次确认。
3. `FilesPage`：按 `files-capability` + 读失败 + `ls` 权限启发式显示顶部提示条；行内 `mdi-shield-lock`。

## 安全

- 远程 path 仍 `normalize_remote_abs_path`；`chmod -R` / `chown -R` 经 `exec_ssh_command_with_fallback`。
- 递归超时 300s；审计记录 `recursive`。

## 验证

- `pytest tests/test_file_permissions.py`
- 浏览器：目录 chmod 勾选递归；非 root 属主文件显示锁图标与顶栏提示。
