Class FatFsFileOps

src/filesystem/fatfs/include/fatfs.hpp:185–245

   * @brief FatFS 文件操作实现
   */
  class FatFsFileOps : public vfs::FileOps {
   public:
    explicit FatFsFileOps(FatFsFileSystem* fs) : fs_(fs) {}

    /**
     * @brief 打开文件，准备底层 FIL 句柄
     * @param file 文件对象
     * @return Expected<void> 成功或错误
     */
    auto Open(vfs::File* file) -> Expected<void> override;

    /**
     * @brief 从文件读取数据
     * @param file  文件对象
     * @param buf   读取缓冲区
     * @param count 请求读取的字节数
     * @return Expected<size_t> 实际读取字节数或错误
     */
    auto Read(vfs::File* file, void* buf, size_t count)
        -> Expected<size_t> override;

    /**
     * @brief 向文件写入数据
     * @param file  文件对象
     * @param buf   写入数据缓冲区
     * @param count 请求写入的字节数
     * @return Expected<size_t> 实际写入字节数或错误
     */
    auto Write(vfs::File* file, const void* buf, size_t count)
        -> Expected<size_t> override;

    /**
     * @brief 移动文件读写位置
     * @param file   文件对象
     * @param offset 偏移量
     * @param whence 定位基准（kSet / kCur / kEnd）
     * @return Expected<uint64_t> 新的文件偏移量或错误
     */
    auto Seek(vfs::File* file, int64_t offset, vfs::SeekWhence whence)
        -> Expected<uint64_t> override;

    /**
     * @brief 关闭文件，释放底层 FIL 对象
     * @param file 文件对象
     * @return Expected<void> 成功或错误
     */
    auto Close(vfs::File* file) -> Expected<void> override;

    /**
     * @brief 读取目录条目
     * @param file   目录文件对象
     * @param dirent 输出缓冲区
     * @param count  最多读取的条目数
     * @return Expected<size_t> 实际读取条目数或错误
     */
    auto ReadDir(vfs::File* file, vfs::DirEntry* dirent, size_t count)
        -> Expected<size_t> override;