更新统一使用 PHPDoc + PSR-19 标准注释

app/repository/file/FileRecordRepository.php

@@ -6,15 +6,29 @@ use app\common\base\BaseRepository;
 use app\model\file\FileRecord;
 
 /**
- * 文件仓储。
+ * 文件记录仓储。
+ *
+ * 封装文件资产表的基础查询方法。
  */
 class FileRecordRepository extends BaseRepository
 {
+    /**
+     * 构造方法。
+     *
+     * @return void
+     */
     public function __construct()
     {
         parent::__construct(new FileRecord());
     }
 
+    /**
+     * 按 ID 查询文件记录。
+     *
+     * @param int $id 文件记录ID
+     * @param array $columns 字段列表
+     * @return FileRecord|null 文件记录
+     */
     public function findById(int $id, array $columns = ['*']): ?FileRecord
     {
         $model = $this->find($id, $columns);
@@ -22,3 +36,6 @@ class FileRecordRepository extends BaseRepository
         return $model instanceof FileRecord ? $model : null;
     }
 }
+
+
+