Nexus/docs/changelog/2026-06-01-files-phase2-recursive-read-hint.md

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

项	内容
日期	2026-06-01
类型	功能

摘要

• POST /sync/chmod 支持 recursive：仅目录、test -d 校验，禁止对 / 等系统路径递归；超时 300s。
• 权限对话框：目录可勾选「同时修改子项」并二次确认。
• 文件页：根据 files-capability、读失败与 ls 权限显示顶部提示条；不可读文件行内 mdi-shield-lock。

动机

完成设计文档 §4.5 二期与 L1 不可读场景可观测性。

涉及文件

• server/utils/files_chmod_policy.py（新建）
• server/api/schemas.py、server/api/sync_v2.py
• frontend/src/utils/fileMode.ts
• frontend/src/components/FilePermissionDialog.vue
• frontend/src/pages/FilesPage.vue
• tests/test_file_permissions.py
• docs/design/plans/2026-06-01-files-phase2-recursive-read-hint.md

迁移 / 重启

• 无 DB 变更；需重启后端并重新构建前端。

验证

pytest tests/test_file_permissions.py -q

浏览器：选非 root 服务器 → 顶栏提示；目录 chmod 勾选递归；打开无读权限文件触发提示更新。