Build #106: 支持单独更新 file metadata

[nil4u]

Source issue

• 支持单独更新 file 的 metadata #106 支持单独更新 file 的 metadata

Summary

• 新增 PUT /v1/files/{fileId}/metadata，请求体仅需提供 metadata。
• 复用现有文件查询、鉴权与更新链路，文件不存在时保持既有 404 处理。
• metadata 更新不递增内容版本，也不修改文件内容、文件名、description、cities 或 tags。
• 新增 metadata 更新事件 scope，继续发送既有 FILE_UPDATED 事件。
• 普通文件和目录均支持该接口；未偏离 issue 方案。

Validation

• git diff --check（通过）
• 新增 Controller 测试：普通文件成功、目录成功、缺少 metadata、文件不存在。
• 新增 Repo 测试：仅 metadata 发生变化，其他字段及版本保持不变。
• 新增 Service 测试：更新事件为 FILE_UPDATED 且 scope=metadata。
• 未运行 JUnit：当前执行环境未安装 Java 和 Maven（java: command not found、mvn: command not found）。

[Jiakaic]

@claude 检查提交的代码，使用中文回复

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8a16488be8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Reject metadata updates for resource nodes

When fileId identifies a resource node, this check accepts it and the endpoint overwrites its metadata. Resource creation deliberately fixes metadata to {}, and the adjacent description, cities, and tags update handlers reject resources; this also exceeds the stated ordinary-file-and-directory scope. Add the equivalent NodeType.RESOURCE guard before constructing the update operation.

Useful? React with 👍 / 👎.