feat(flutter): 接入互动评论点赞举报

2026-10-17 15:26:42 +08:00
1 parent 45f5f25640
commit d361034226
@@ -10,15 +10,18 @@ import 'core/data/remote/api_client.dart';
 import 'core/data/remote/auth_api.dart';
 import 'core/data/remote/catalog_api.dart';
 import 'core/data/remote/category_api.dart';
+import 'core/data/remote/comment_api.dart';
 import 'core/data/remote/download_api.dart';
+import 'core/data/remote/interaction_api.dart';
 import 'core/data/remote/library_api.dart';
 import 'core/data/remote/playback_api.dart';
 import 'core/data/remote/watch_api.dart';
 import 'core/data/repositories/catalog_repository.dart';
 import 'core/data/repositories/category_repository.dart';
+import 'core/data/repositories/comment_repository.dart';
 import 'core/data/repositories/download_repository.dart';
-import 'core/data/repositories/engagement_repository.dart';
 import 'core/data/repositories/favorite_repository.dart';
+import 'core/data/repositories/interaction_repository.dart';
 import 'core/data/repositories/playback_repository.dart';
 import 'core/data/repositories/watch_history_repository.dart';
 import 'core/data/services/auth_controller.dart';
@@ -26,8 +29,8 @@ import 'core/data/services/auth_session_store.dart';
 import 'core/data/services/catalog_controller.dart';
 import 'core/data/services/category_controller.dart';
 import 'core/data/services/download_controller.dart';
-import 'core/data/services/engagement_controller.dart';
 import 'core/data/services/favorite_controller.dart';
+import 'core/data/services/interaction_controller.dart';
 import 'core/data/services/playback_session.dart';
 import 'core/data/services/video_player_port.dart';
 import 'l10n/app_localizations.dart';
@@ -43,6 +46,8 @@ class LumaDramaApp extends StatefulWidget {
    this.watchHistoryRepository,
    this.favoriteRepository,
    this.playbackRepository,
+    this.commentRepository,
+    this.interactionRepository,
  });

  final PlayerFactory playerFactory;
@@ -54,6 +59,8 @@ class LumaDramaApp extends StatefulWidget {
  final WatchHistoryRepository? watchHistoryRepository;
  final FavoriteRepository? favoriteRepository;
  final PlaybackRepository? playbackRepository;
+  final CommentRepository? commentRepository;
+  final InteractionRepository? interactionRepository;

  @override
  State<LumaDramaApp> createState() => _LumaDramaAppState();
@@ -113,6 +120,16 @@ class _LumaDramaAppState extends State<LumaDramaApp> {
    _downloadRepository,
  );

+  late final CommentRepository _commentRepository =
+      widget.commentRepository ?? HttpCommentRepository(CommentApi(_apiClient));
+
+  late final InteractionRepository _interactionRepository =
+      widget.interactionRepository ??
+      HttpInteractionRepository(InteractionApi(_apiClient));
+
+  late final InteractionController _interactionController =
+      InteractionController(_interactionRepository);
+
  @override
  void initState() {
    super.initState();
@@ -128,6 +145,7 @@ class _LumaDramaAppState extends State<LumaDramaApp> {
  void _onAuthChanged() {
    if (_auth.isSignedIn == _wasSignedIn) return;
    _wasSignedIn = _auth.isSignedIn;
+    _interactionController.clear();
    if (_auth.isSignedIn) {
      unawaited(_favoriteController.load());
    } else {
@@ -141,6 +159,7 @@ class _LumaDramaAppState extends State<LumaDramaApp> {
    _auth.removeListener(_onAuthChanged);
    _favoriteController.dispose();
    _downloadController.dispose();
+    _interactionController.dispose();
    _apiClient.close();
    super.dispose();
  }
@@ -154,6 +173,8 @@ class _LumaDramaAppState extends State<LumaDramaApp> {
        Provider<PlaybackRepository>.value(value: _playback),
        Provider<WatchHistoryRepository>.value(value: _watchHistory),
        Provider<FavoriteRepository>.value(value: _favorites),
+        Provider<CommentRepository>.value(value: _commentRepository),
+        Provider<InteractionRepository>.value(value: _interactionRepository),
        ChangeNotifierProvider(
          create: (_) => CatalogController(_catalogRepository)..load(),
        ),
@@ -163,11 +184,7 @@ class _LumaDramaAppState extends State<LumaDramaApp> {
        ChangeNotifierProvider(create: (_) => LocaleController()..load()),
        ChangeNotifierProvider.value(value: _favoriteController),
        ChangeNotifierProvider.value(value: _downloadController),
-        ChangeNotifierProvider(
-          create: (_) =>
-              EngagementController(SharedPreferencesEngagementRepository())
-                ..load(),
-        ),
+        ChangeNotifierProvider.value(value: _interactionController),
        ChangeNotifierProvider.value(value: _auth),
      ],
      child: Consumer<LocaleController>(
@@ -0,0 +1,132 @@
+// Author: fruit.com.cn
+
+import 'json_numbers.dart';
+
+/// 评论游标分页大小，契约 §1.7 使用游标而非页码。
+const int commentPageSize = 20;
+
+/// 评论列表页。
+class CommentPage {
+  const CommentPage({
+    this.comments = const [],
+    this.nextCursor,
+    this.hasMore = false,
+  });
+
+  final List<DramaComment> comments;
+  final String? nextCursor;
+  final bool hasMore;
+
+  /// 解析后端 `CursorResult{list,nextCursor,hasMore}`。
+  factory CommentPage.fromJson(Map<String, dynamic> json) {
+    final rawList = json['list'];
+    return CommentPage(
+      comments: [
+        if (rawList is List)
+          for (final item in rawList)
+            if (item is Map<String, dynamic>) DramaComment.fromJson(item),
+      ],
+      nextCursor: json['nextCursor'] == null
+          ? null
+          : jsonToId(json['nextCursor']),
+      hasMore: json['hasMore'] == true,
+    );
+  }
+}
+
+/// 服务端评论视图，字段对应 `CommentRespVO`。
+class DramaComment {
+  const DramaComment({
+    required this.id,
+    required this.dramaId,
+    required this.episodeId,
+    required this.parentId,
+    required this.rootId,
+    required this.userId,
+    required this.uid,
+    required this.nickname,
+    required this.avatarUrl,
+    required this.content,
+    required this.status,
+    required this.auditReason,
+    required this.likeCount,
+    required this.replyCount,
+    required this.reportCount,
+    required this.createdAt,
+    required this.mine,
+    required this.liked,
+  });
+
+  final String id;
+  final String dramaId;
+  final String episodeId;
+  final String parentId;
+  final String rootId;
+  final String userId;
+  final String uid;
+  final String nickname;
+  final String avatarUrl;
+  final String content;
+  final String status;
+  final String auditReason;
+  final int likeCount;
+  final int replyCount;
+  final int reportCount;
+  final DateTime? createdAt;
+  final bool mine;
+  final bool liked;
+
+  /// 待人工审核的评论仅本人可见。
+  bool get isPending => status == 'pending';
+
+  /// 顶层评论没有父评论。
+  bool get isTopLevel => parentId.isEmpty || parentId == '0';
+
+  /// 解析 `CommentRespVO`，所有 ID 字段只走字符串解析。
+  factory DramaComment.fromJson(Map<String, dynamic> json) => DramaComment(
+    id: jsonToId(json['id']),
+    dramaId: jsonToId(json['dramaId']),
+    episodeId: jsonToId(json['episodeId'], fallback: '0'),
+    parentId: jsonToId(json['parentId'], fallback: '0'),
+    rootId: jsonToId(json['rootId'], fallback: '0'),
+    userId: jsonToId(json['userId']),
+    uid: json['uid']?.toString() ?? '',
+    nickname: json['nickname']?.toString() ?? '',
+    avatarUrl: json['avatarUrl']?.toString() ?? '',
+    content: json['content']?.toString() ?? '',
+    status: json['status']?.toString() ?? '',
+    auditReason: json['auditReason']?.toString() ?? '',
+    likeCount: jsonToInt(json['likeCount']),
+    replyCount: jsonToInt(json['replyCount']),
+    reportCount: jsonToInt(json['reportCount']),
+    createdAt: DateTime.tryParse(json['createdAt']?.toString() ?? ''),
+    mine: json['mine'] == true,
+    liked: json['liked'] == true,
+  );
+
+  /// 局部更新点赞或回复数，列表中的其他字段保持不变。
+  DramaComment copyWith({
+    int? likeCount,
+    int? replyCount,
+    bool? liked,
+  }) => DramaComment(
+    id: id,
+    dramaId: dramaId,
+    episodeId: episodeId,
+    parentId: parentId,
+    rootId: rootId,
+    userId: userId,
+    uid: uid,
+    nickname: nickname,
+    avatarUrl: avatarUrl,
+    content: content,
+    status: status,
+    auditReason: auditReason,
+    likeCount: likeCount ?? this.likeCount,
+    replyCount: replyCount ?? this.replyCount,
+    reportCount: reportCount,
+    createdAt: createdAt,
+    mine: mine,
+    liked: liked ?? this.liked,
+  );
+}
@@ -1,13 +0,0 @@
-// Author: fruit.com.cn
-
-class EngagementSnapshot {
-  const EngagementSnapshot({
-    this.savedDramaIds = const {},
-    this.likedDramaIds = const {},
-    this.commentsByDrama = const {},
-  });
-
-  final Set<String> savedDramaIds;
-  final Set<String> likedDramaIds;
-  final Map<String, List<String>> commentsByDrama;
-}
@@ -0,0 +1,70 @@
+// Author: fruit.com.cn
+
+import 'json_numbers.dart';
+
+/// 互动目标类型，契约只允许短剧与评论。
+enum InteractionTargetType {
+  drama('DRAMA'),
+  comment('COMMENT');
+
+  const InteractionTargetType(this.apiValue);
+
+  final String apiValue;
+}
+
+/// 客户端固定举报原因，后端当前未限制枚举值。
+enum ReportReason {
+  spam('SPAM'),
+  abuse('ABUSE'),
+  porn('PORN'),
+  ad('AD'),
+  other('OTHER');
+
+  const ReportReason(this.apiValue);
+
+  final String apiValue;
+}
+
+/// 一次性互动请求，供仓库和测试断言使用。
+class ReportRequest {
+  const ReportRequest({
+    required this.targetType,
+    required this.targetId,
+    required this.reasonCode,
+    this.description = '',
+  });
+
+  final InteractionTargetType targetType;
+  final String targetId;
+  final String reasonCode;
+  final String description;
+}
+
+/// 点赞切换后的服务端状态。
+class LikeToggleResult {
+  const LikeToggleResult({required this.liked, required this.count});
+
+  final bool liked;
+  final int count;
+
+  /// 计数按 Long 字符串兼容解析。
+  factory LikeToggleResult.fromJson(Map<String, dynamic> json) =>
+      LikeToggleResult(
+        liked: json['liked'] == true,
+        count: jsonToInt(json['count']),
+      );
+}
+
+/// 控制器统一返回结果；失败消息可直接展示后端 `message`。
+class OperationResult<T> {
+  const OperationResult._(this.data, this.errorMessage);
+
+  const OperationResult.success([T? data]) : this._(data, null);
+
+  const OperationResult.failure(this.errorMessage) : data = null;
+
+  final T? data;
+  final String? errorMessage;
+
+  bool get isSuccess => errorMessage == null;
+}
@@ -11,3 +11,10 @@ int jsonToInt(dynamic value, {int fallback = 0}) {
  if (value is String) return int.tryParse(value.trim()) ?? fallback;
  return fallback;
 }
+
+/// ID 字段统一转字符串；后端按契约下发字符串，同时兼容测试或旧数据的数字形式。
+String jsonToId(dynamic value, {String fallback = ''}) {
+  if (value is String) return value;
+  if (value is num) return value.toString();
+  return fallback;
+}
@@ -0,0 +1,59 @@
+// Author: fruit.com.cn
+
+import '../models/comment.dart';
+import 'api_client.dart';
+
+/// 评论接口，对应契约 §1.7 的 `/app/comments*`。
+class CommentApi {
+  const CommentApi(this._client);
+
+  final ApiClient _client;
+
+  /// 拉取游标分页；`rootId` 用于加载某一楼层的回复。
+  Future<CommentPage> page({
+    required String dramaId,
+    String? rootId,
+    String? cursor,
+    int size = commentPageSize,
+  }) async {
+    final data = await _client.get(
+      '/app/comments',
+      query: {
+        'dramaId': dramaId,
+        'rootId': ?rootId,
+        'cursor': ?cursor,
+        'size': '$size',
+      },
+    );
+    if (data is! Map<String, dynamic>) return const CommentPage();
+    return CommentPage.fromJson(data);
+  }
+
+  /// 发表评论或回复；回复只提交 `parentId`，不自行拼层级。
+  Future<DramaComment> publish({
+    required String dramaId,
+    String? episodeId,
+    required String content,
+    String? parentId,
+  }) async {
+    final data = await _client.post(
+      '/app/comments',
+      body: {
+        'dramaId': dramaId,
+        if (episodeId != null && episodeId.isNotEmpty)
+          'episodeId': episodeId,
+        'content': content,
+        if (parentId != null && parentId.isNotEmpty) 'parentId': parentId,
+      },
+    );
+    if (data is! Map<String, dynamic>) {
+      throw const ApiException(500, '评论响应格式错误');
+    }
+    return DramaComment.fromJson(data);
+  }
+
+  /// 删除自己的评论。
+  Future<void> delete(String commentId) async {
+    await _client.delete('/app/comments/$commentId');
+  }
+}
@@ -0,0 +1,44 @@
+// Author: fruit.com.cn
+
+import '../models/interaction.dart';
+import 'api_client.dart';
+
+/// 点赞与举报接口，对应契约 §1.7。
+class InteractionApi {
+  const InteractionApi(this._client);
+
+  final ApiClient _client;
+
+  /// 切换点赞，服务端返回的状态与计数为最终真相。
+  Future<LikeToggleResult> toggleLike({
+    required InteractionTargetType targetType,
+    required String targetId,
+  }) async {
+    final data = await _client.post(
+      '/app/likes/toggle',
+      body: {
+        'targetType': targetType.apiValue,
+        'targetId': targetId,
+      },
+    );
+    if (data is! Map<String, dynamic>) {
+      throw const ApiException(500, '点赞响应格式错误');
+    }
+    return LikeToggleResult.fromJson(data);
+  }
+
+  /// 提交举报，返回工单 ID。
+  Future<String> report(ReportRequest request) async {
+    final data = await _client.post(
+      '/app/reports',
+      body: {
+        'targetType': request.targetType.apiValue,
+        'targetId': request.targetId,
+        'reasonCode': request.reasonCode,
+        if (request.description.isNotEmpty)
+          'description': request.description,
+      },
+    );
+    return data?.toString() ?? '';
+  }
+}
@@ -0,0 +1,62 @@
+// Author: fruit.com.cn
+
+import '../models/comment.dart';
+import '../remote/comment_api.dart';
+
+/// 评论数据来源抽象，页面与控制器不直接依赖 HTTP。
+abstract interface class CommentRepository {
+  /// 拉取评论或回复的分页。
+  Future<CommentPage> page({
+    required String dramaId,
+    String? rootId,
+    String? cursor,
+    int size = commentPageSize,
+  });
+
+  /// 发表评论或回复。
+  Future<DramaComment> publish({
+    required String dramaId,
+    String? episodeId,
+    required String content,
+    String? parentId,
+  });
+
+  /// 删除指定评论。
+  Future<void> delete(String commentId);
+}
+
+/// HTTP 评论仓库。
+class HttpCommentRepository implements CommentRepository {
+  const HttpCommentRepository(this._api);
+
+  final CommentApi _api;
+
+  @override
+  Future<CommentPage> page({
+    required String dramaId,
+    String? rootId,
+    String? cursor,
+    int size = commentPageSize,
+  }) => _api.page(
+    dramaId: dramaId,
+    rootId: rootId,
+    cursor: cursor,
+    size: size,
+  );
+
+  @override
+  Future<DramaComment> publish({
+    required String dramaId,
+    String? episodeId,
+    required String content,
+    String? parentId,
+  }) => _api.publish(
+    dramaId: dramaId,
+    episodeId: episodeId,
+    content: content,
+    parentId: parentId,
+  );
+
+  @override
+  Future<void> delete(String commentId) => _api.delete(commentId);
+}
@@ -1,70 +0,0 @@
-// Author: fruit.com.cn
-
-import 'dart:convert';
-
-import 'package:shared_preferences/shared_preferences.dart';
-
-import '../models/engagement_snapshot.dart';
-
-abstract interface class EngagementRepository {
-  Future<EngagementSnapshot> load();
-  Future<void> save(EngagementSnapshot snapshot);
-}
-
-class SharedPreferencesEngagementRepository implements EngagementRepository {
-  SharedPreferencesEngagementRepository({SharedPreferencesAsync? preferences})
-    : _preferences = preferences ?? SharedPreferencesAsync();
-
-  static const _key = 'engagement.v1.demo-local-v1';
-  final SharedPreferencesAsync _preferences;
-
-  @override
-  Future<EngagementSnapshot> load() async {
-    final raw = await _preferences.getString(_key);
-    if (raw == null) return const EngagementSnapshot();
-    try {
-      final json = jsonDecode(raw);
-      if (json is! Map<String, dynamic>) return const EngagementSnapshot();
-      Set<String> ids(Object? value) =>
-          value is List ? value.whereType<String>().toSet() : <String>{};
-      final comments = <String, List<String>>{};
-      final rawComments = json['comments'];
-      if (rawComments is Map<String, dynamic>) {
-        for (final entry in rawComments.entries) {
-          if (entry.value is List) {
-            comments[entry.key] = (entry.value as List)
-                .whereType<String>()
-                .toList();
-          }
-        }
-      }
-      return EngagementSnapshot(
-        savedDramaIds: ids(json['saved']),
-        likedDramaIds: ids(json['liked']),
-        commentsByDrama: comments,
-      );
-    } catch (_) {
-      return const EngagementSnapshot();
-    }
-  }
-
-  @override
-  Future<void> save(EngagementSnapshot snapshot) => _preferences.setString(
-    _key,
-    jsonEncode({
-      'saved': snapshot.savedDramaIds.toList(),
-      'liked': snapshot.likedDramaIds.toList(),
-      'comments': snapshot.commentsByDrama,
-    }),
-  );
-}
-
-class InMemoryEngagementRepository implements EngagementRepository {
-  EngagementSnapshot snapshot = const EngagementSnapshot();
-
-  @override
-  Future<EngagementSnapshot> load() async => snapshot;
-
-  @override
-  Future<void> save(EngagementSnapshot value) async => snapshot = value;
-}
@@ -0,0 +1,32 @@
+// Author: fruit.com.cn
+
+import '../models/interaction.dart';
+import '../remote/interaction_api.dart';
+
+/// 点赞与举报数据来源抽象。
+abstract interface class InteractionRepository {
+  /// 切换目标点赞状态。
+  Future<LikeToggleResult> toggleLike({
+    required InteractionTargetType targetType,
+    required String targetId,
+  });
+
+  /// 提交举报并返回工单 ID。
+  Future<String> report(ReportRequest request);
+}
+
+/// HTTP 互动仓库。
+class HttpInteractionRepository implements InteractionRepository {
+  const HttpInteractionRepository(this._api);
+
+  final InteractionApi _api;
+
+  @override
+  Future<LikeToggleResult> toggleLike({
+    required InteractionTargetType targetType,
+    required String targetId,
+  }) => _api.toggleLike(targetType: targetType, targetId: targetId);
+
+  @override
+  Future<String> report(ReportRequest request) => _api.report(request);
+}
@@ -0,0 +1,378 @@
+// Author: fruit.com.cn
+
+import 'package:flutter/foundation.dart';
+
+import '../models/comment.dart';
+import '../models/interaction.dart';
+import '../remote/api_client.dart';
+import '../repositories/comment_repository.dart';
+import '../repositories/interaction_repository.dart';
+
+/// 评论列表、发布、回复、删除与评论点赞的状态控制器。
+class CommentController extends ChangeNotifier {
+  CommentController({
+    required CommentRepository comments,
+    required InteractionRepository interactions,
+    required this.dramaId,
+    this.episodeId,
+  }) : _commentRepository = comments,
+       _interactionRepository = interactions;
+
+  final CommentRepository _commentRepository;
+  final InteractionRepository _interactionRepository;
+  final String dramaId;
+  final String? episodeId;
+  final List<DramaComment> _comments = [];
+  final Map<String, List<DramaComment>> _replies = {};
+  final Map<String, String?> _replyCursors = {};
+  final Map<String, bool> _replyHasMore = {};
+  final Set<String> _expandedRoots = {};
+  final Set<String> _loadingReplies = {};
+  final Set<String> _loadingMoreReplies = {};
+  final Set<String> _likingCommentIds = {};
+  final Set<String> _deletingCommentIds = {};
+  bool _disposed = false;
+  bool loading = false;
+  bool loadingMore = false;
+  bool submitting = false;
+  bool hasMore = false;
+  String? nextCursor;
+  String? error;
+
+  /// 当前已加载的顶层评论。
+  List<DramaComment> get comments => List.unmodifiable(_comments);
+
+  /// 某一楼层已加载的回复。
+  List<DramaComment> repliesFor(String rootId) =>
+      List.unmodifiable(_replies[rootId] ?? const []);
+
+  /// 楼层回复是否已展开。
+  bool repliesExpanded(String rootId) => _expandedRoots.contains(rootId);
+
+  /// 楼层回复是否正在首屏加载。
+  bool repliesLoading(String rootId) => _loadingReplies.contains(rootId);
+
+  /// 楼层回复是否还有下一页。
+  bool repliesHasMore(String rootId) => _replyHasMore[rootId] ?? false;
+
+  /// 评论是否正在提交点赞，用于防连点。
+  bool likingComment(String id) => _likingCommentIds.contains(id);
+
+  void _notify() {
+    if (!_disposed) notifyListeners();
+  }
+
+  /// 加载首屏评论，成功后替换当前顶层列表。
+  Future<void> load() async {
+    loading = true;
+    error = null;
+    _notify();
+    try {
+      final page = await _commentRepository.page(
+        dramaId: dramaId,
+        size: commentPageSize,
+      );
+      _comments
+        ..clear()
+        ..addAll(page.comments);
+      nextCursor = page.nextCursor;
+      hasMore = page.hasMore;
+    } catch (failure) {
+      error = _errorMessage(failure) ?? 'commentsLoadFailed';
+    } finally {
+      loading = false;
+      _notify();
+    }
+  }
+
+  /// 使用 `nextCursor` 续拉顶层评论。
+  Future<void> loadMore() async {
+    final cursor = nextCursor;
+    if (loadingMore || !hasMore || cursor == null) return;
+    loadingMore = true;
+    error = null;
+    _notify();
+    try {
+      final page = await _commentRepository.page(
+        dramaId: dramaId,
+        cursor: cursor,
+        size: commentPageSize,
+      );
+      _comments.addAll(page.comments);
+      nextCursor = page.nextCursor;
+      hasMore = page.hasMore;
+    } catch (failure) {
+      error = _errorMessage(failure) ?? 'commentsLoadFailed';
+    } finally {
+      loadingMore = false;
+      _notify();
+    }
+  }
+
+  /// 展开并用 `rootId` 加载一层楼层回复。
+  Future<void> loadReplies(String rootId) async {
+    _expandedRoots.add(rootId);
+    if (_replies.containsKey(rootId) || _loadingReplies.contains(rootId)) {
+      _notify();
+      return;
+    }
+    _loadingReplies.add(rootId);
+    error = null;
+    _notify();
+    try {
+      final page = await _commentRepository.page(
+        dramaId: dramaId,
+        rootId: rootId,
+        size: commentPageSize,
+      );
+      _replies[rootId] = List.of(page.comments);
+      _replyCursors[rootId] = page.nextCursor;
+      _replyHasMore[rootId] = page.hasMore;
+    } catch (failure) {
+      error = _errorMessage(failure) ?? 'commentsLoadFailed';
+    } finally {
+      _loadingReplies.remove(rootId);
+      _notify();
+    }
+  }
+
+  /// 收起楼层回复，不丢弃已加载数据。
+  void hideReplies(String rootId) {
+    if (_expandedRoots.remove(rootId)) _notify();
+  }
+
+  /// 续拉楼层回复。
+  Future<void> loadMoreReplies(String rootId) async {
+    final cursor = _replyCursors[rootId];
+    if (_loadingMoreReplies.contains(rootId) || cursor == null) return;
+    if (!(_replyHasMore[rootId] ?? false)) return;
+    _loadingMoreReplies.add(rootId);
+    _notify();
+    try {
+      final page = await _commentRepository.page(
+        dramaId: dramaId,
+        rootId: rootId,
+        cursor: cursor,
+        size: commentPageSize,
+      );
+      (_replies[rootId] ??= []).addAll(page.comments);
+      _replyCursors[rootId] = page.nextCursor;
+      _replyHasMore[rootId] = page.hasMore;
+    } catch (failure) {
+      error = _errorMessage(failure) ?? 'commentsLoadFailed';
+    } finally {
+      _loadingMoreReplies.remove(rootId);
+      _notify();
+    }
+  }
+
+  /// 发布评论或回复，输入框是否清空由调用方根据成功结果决定。
+  Future<OperationResult<DramaComment>> publish(
+    String rawContent, {
+    DramaComment? replyTo,
+  }) async {
+    final content = rawContent.trim();
+    if (content.isEmpty || submitting) {
+      return const OperationResult.failure(null);
+    }
+    submitting = true;
+    _notify();
+    try {
+      final comment = await _commentRepository.publish(
+        dramaId: dramaId,
+        episodeId: episodeId,
+        content: content,
+        parentId: replyTo?.id,
+      );
+      _insertPublished(comment, replyTo);
+      return OperationResult.success(comment);
+    } catch (failure) {
+      return OperationResult.failure(_errorMessage(failure));
+    } finally {
+      submitting = false;
+      _notify();
+    }
+  }
+
+  /// 乐观删除自己的评论，失败时恢复到原位置。
+  Future<OperationResult<void>> delete(DramaComment comment) async {
+    if (!comment.mine || _deletingCommentIds.contains(comment.id)) {
+      return const OperationResult.failure(null);
+    }
+    _deletingCommentIds.add(comment.id);
+    final location = _removeComment(comment.id);
+    _notify();
+    try {
+      await _commentRepository.delete(comment.id);
+      return const OperationResult.success();
+    } catch (failure) {
+      _restoreComment(comment, location);
+      return OperationResult.failure(_errorMessage(failure));
+    } finally {
+      _deletingCommentIds.remove(comment.id);
+      _notify();
+    }
+  }
+
+  /// 评论点赞先乐观更新，再用服务端 `{liked,count}` 校准。
+  Future<OperationResult<LikeToggleResult>> toggleLike(
+    DramaComment comment,
+  ) async {
+    if (_likingCommentIds.contains(comment.id)) {
+      return const OperationResult.failure(null);
+    }
+    final current = _findComment(comment.id) ?? comment;
+    _likingCommentIds.add(comment.id);
+    _replaceComment(
+      current.copyWith(
+        liked: !current.liked,
+        likeCount: current.liked
+            ? (current.likeCount > 0 ? current.likeCount - 1 : 0)
+            : current.likeCount + 1,
+      ),
+    );
+    _notify();
+    try {
+      final result = await _interactionRepository.toggleLike(
+        targetType: InteractionTargetType.comment,
+        targetId: comment.id,
+      );
+      _replaceComment(
+        current.copyWith(liked: result.liked, likeCount: result.count),
+      );
+      return OperationResult.success(result);
+    } catch (failure) {
+      _replaceComment(current);
+      return OperationResult.failure(_errorMessage(failure));
+    } finally {
+      _likingCommentIds.remove(comment.id);
+      _notify();
+    }
+  }
+
+  /// 举报评论，失败消息原样返回给界面展示。
+  Future<OperationResult<String>> report(
+    DramaComment comment, {
+    required ReportReason reason,
+    String description = '',
+  }) async {
+    try {
+      final reportId = await _interactionRepository.report(
+        ReportRequest(
+          targetType: InteractionTargetType.comment,
+          targetId: comment.id,
+          reasonCode: reason.apiValue,
+          description: description.trim(),
+        ),
+      );
+      return OperationResult.success(reportId);
+    } catch (failure) {
+      return OperationResult.failure(_errorMessage(failure));
+    }
+  }
+
+  void _insertPublished(DramaComment comment, DramaComment? replyTo) {
+    final rootId = comment.rootId != '0'
+        ? comment.rootId
+        : replyTo?.isTopLevel == true
+        ? replyTo!.id
+        : replyTo?.rootId;
+    if (replyTo == null || rootId == null || rootId == '0') {
+      if (!_comments.any((item) => item.id == comment.id)) {
+        _comments.insert(0, comment);
+      }
+      return;
+    }
+    final replies = _replies.putIfAbsent(rootId, () => []);
+    if (!replies.any((item) => item.id == comment.id)) {
+      replies.insert(0, comment);
+    }
+    _expandedRoots.add(rootId);
+    final rootIndex = _comments.indexWhere((item) => item.id == rootId);
+    if (rootIndex >= 0) {
+      final root = _comments[rootIndex];
+      _comments[rootIndex] = root.copyWith(replyCount: root.replyCount + 1);
+    }
+  }
+
+  _CommentLocation? _removeComment(String id) {
+    final topIndex = _comments.indexWhere((item) => item.id == id);
+    if (topIndex >= 0) {
+      final removed = _comments.removeAt(topIndex);
+      return _CommentLocation(comment: removed, topIndex: topIndex);
+    }
+    for (final entry in _replies.entries) {
+      final index = entry.value.indexWhere((item) => item.id == id);
+      if (index < 0) continue;
+      final removed = entry.value.removeAt(index);
+      return _CommentLocation(
+        comment: removed,
+        rootId: entry.key,
+        replyIndex: index,
+      );
+    }
+    return null;
+  }
+
+  void _restoreComment(DramaComment comment, _CommentLocation? location) {
+    if (location == null) return;
+    if (location.topIndex != null) {
+      final index = location.topIndex!.clamp(0, _comments.length);
+      _comments.insert(index, comment);
+      return;
+    }
+    final replies = _replies.putIfAbsent(location.rootId!, () => []);
+    final index = location.replyIndex!.clamp(0, replies.length);
+    replies.insert(index, comment);
+  }
+
+  DramaComment? _findComment(String id) {
+    for (final comment in _comments) {
+      if (comment.id == id) return comment;
+    }
+    for (final replies in _replies.values) {
+      for (final comment in replies) {
+        if (comment.id == id) return comment;
+      }
+    }
+    return null;
+  }
+
+  void _replaceComment(DramaComment replacement) {
+    final topIndex = _comments.indexWhere((item) => item.id == replacement.id);
+    if (topIndex >= 0) {
+      _comments[topIndex] = replacement;
+      return;
+    }
+    for (final replies in _replies.values) {
+      final index = replies.indexWhere((item) => item.id == replacement.id);
+      if (index >= 0) {
+        replies[index] = replacement;
+        return;
+      }
+    }
+  }
+
+  String? _errorMessage(Object failure) =>
+      failure is ApiException ? failure.message : null;
+
+  @override
+  void dispose() {
+    _disposed = true;
+    super.dispose();
+  }
+}
+
+class _CommentLocation {
+  const _CommentLocation({
+    required this.comment,
+    this.topIndex,
+    this.rootId,
+    this.replyIndex,
+  });
+
+  final DramaComment comment;
+  final int? topIndex;
+  final String? rootId;
+  final int? replyIndex;
+}
@@ -1,80 +0,0 @@
-// Author: fruit.com.cn
-
-import 'package:flutter/foundation.dart';
-
-import '../models/engagement_snapshot.dart';
-import '../repositories/engagement_repository.dart';
-
-/// Local demo interactions, indexed by drama ID. No public/social backend.
-class EngagementController extends ChangeNotifier {
-  EngagementController(this._repository);
-
-  final EngagementRepository _repository;
-  final Set<String> _saved = {};
-  final Set<String> _liked = {};
-  final Map<String, List<String>> _comments = {};
-  Future<void> _loadFuture = Future<void>.value();
-  Future<void> _pendingSave = Future<void>.value();
-
-  bool isSaved(String dramaId) => _saved.contains(dramaId);
-  bool isLiked(String dramaId) => _liked.contains(dramaId);
-  List<String> commentsFor(String dramaId) =>
-      List.unmodifiable(_comments[dramaId] ?? const []);
-
-  Future<void> load() => _loadFuture = _loadFromRepository();
-
-  Future<void> _loadFromRepository() async {
-    try {
-      final snapshot = await _repository.load();
-      _saved.addAll(snapshot.savedDramaIds);
-      _liked.addAll(snapshot.likedDramaIds);
-      for (final entry in snapshot.commentsByDrama.entries) {
-        _comments[entry.key] = List.of(entry.value);
-      }
-      notifyListeners();
-    } catch (_) {
-      // Local preferences are best effort for this demo.
-    }
-  }
-
-  Future<void> toggleSaved(String dramaId) async {
-    await _loadFuture;
-    if (!_saved.add(dramaId)) _saved.remove(dramaId);
-    notifyListeners();
-    await _persist();
-  }
-
-  Future<void> toggleLiked(String dramaId) async {
-    await _loadFuture;
-    if (!_liked.add(dramaId)) _liked.remove(dramaId);
-    notifyListeners();
-    await _persist();
-  }
-
-  Future<void> addComment(String dramaId, String text) async {
-    await _loadFuture;
-    final clean = text.trim();
-    if (clean.isEmpty) return;
-    (_comments[dramaId] ??= []).add(
-      clean.length > 300 ? clean.substring(0, 300) : clean,
-    );
-    notifyListeners();
-    await _persist();
-  }
-
-  Future<void> _persist() {
-    final snapshot = EngagementSnapshot(
-      savedDramaIds: Set.of(_saved),
-      likedDramaIds: Set.of(_liked),
-      commentsByDrama: {
-        for (final entry in _comments.entries) entry.key: List.of(entry.value),
-      },
-    );
-    _pendingSave = _pendingSave
-        .then((_) => _repository.save(snapshot))
-        .catchError((Object _) {
-          // Keep the current in-memory state if local persistence fails.
-        });
-    return _pendingSave;
-  }
-}
@@ -0,0 +1,107 @@
+// Author: fruit.com.cn
+
+import 'package:flutter/foundation.dart';
+
+import '../models/interaction.dart';
+import '../remote/api_client.dart';
+import '../repositories/interaction_repository.dart';
+
+/// 剧集点赞与举报的会话状态控制器。
+///
+/// 剧集契约暂未下发初始点赞状态与计数，本批只维护当前会话内的 liked 状态，
+/// 不展示数字，也不伪造初始值。
+class InteractionController extends ChangeNotifier {
+  InteractionController(this._repository);
+
+  final InteractionRepository _repository;
+  final Set<String> _likedDramaIds = {};
+  final Set<String> _busyDramaIds = {};
+  bool _disposed = false;
+
+  /// 当前会话内该剧是否已点赞。
+  bool isLiked(String dramaId) => _likedDramaIds.contains(dramaId);
+
+  /// 点赞请求是否进行中，用于防连点。
+  bool isBusy(String dramaId) => _busyDramaIds.contains(dramaId);
+
+  /// 乐观切换剧集点赞，失败时回滚并以服务端返回状态校准。
+  Future<OperationResult<LikeToggleResult>> toggleDramaLike(
+    String dramaId,
+  ) async {
+    if (_busyDramaIds.contains(dramaId)) {
+      return const OperationResult.failure(null);
+    }
+    final wasLiked = _likedDramaIds.contains(dramaId);
+    _busyDramaIds.add(dramaId);
+    if (wasLiked) {
+      _likedDramaIds.remove(dramaId);
+    } else {
+      _likedDramaIds.add(dramaId);
+    }
+    _notify();
+    try {
+      final result = await _repository.toggleLike(
+        targetType: InteractionTargetType.drama,
+        targetId: dramaId,
+      );
+      if (result.liked) {
+        _likedDramaIds.add(dramaId);
+      } else {
+        _likedDramaIds.remove(dramaId);
+      }
+      return OperationResult.success(result);
+    } catch (failure) {
+      if (wasLiked) {
+        _likedDramaIds.add(dramaId);
+      } else {
+        _likedDramaIds.remove(dramaId);
+      }
+      return OperationResult.failure(_errorMessage(failure));
+    } finally {
+      _busyDramaIds.remove(dramaId);
+      _notify();
+    }
+  }
+
+  /// 举报剧集，失败消息原样返回给界面。
+  Future<OperationResult<String>> reportDrama(
+    String dramaId, {
+    required ReportReason reason,
+    String description = '',
+  }) async {
+    try {
+      final reportId = await _repository.report(
+        ReportRequest(
+          targetType: InteractionTargetType.drama,
+          targetId: dramaId,
+          reasonCode: reason.apiValue,
+          description: description.trim(),
+        ),
+      );
+      return OperationResult.success(reportId);
+    } catch (failure) {
+      return OperationResult.failure(_errorMessage(failure));
+    }
+  }
+
+  /// 登录账号变化时清理会话内状态，避免跨账号串联。
+  void clear() {
+    if (_likedDramaIds.isEmpty && _busyDramaIds.isEmpty) return;
+    _likedDramaIds.clear();
+    _busyDramaIds.clear();
+    _notify();
+  }
+
+  String? _errorMessage(Object failure) =>
+      failure is ApiException ? failure.message : null;
+
+  void _notify() {
+    if (!_disposed) notifyListeners();
+  }
+
+  @override
+  void dispose() {
+    _disposed = true;
+    super.dispose();
+  }
+}
@@ -11,6 +11,7 @@ String errorText(AppLocalizations l10n, String? code, String fallback) {
    'progressError' => l10n.progressError,
    'favoritesError' => l10n.favoritesError,
    'ticketError' => l10n.playbackError,
+    'commentsLoadFailed' => l10n.commentsLoadFailed,
    final value => value,
  };
 }
@@ -65,10 +65,50 @@
  "save": "Save",
  "comments": "Comments",
  "share": "Share",
-  "localOnlyComments": "Only visible on this device",
  "noComments": "No comments yet.",
  "writeComment": "Write a comment",
  "postComment": "Post",
+  "loadMore": "Load more",
+  "commentsLoadFailed": "Comments could not be loaded.",
+  "commentPostFailed": "Could not post your comment.",
+  "delete": "Delete",
+  "deleteComment": "Delete comment",
+  "deleteCommentTitle": "Delete this comment?",
+  "deleteCommentMessage": "This removes your comment from the conversation.",
+  "commentDeleteFailed": "Could not delete this comment.",
+  "underReview": "Under review",
+  "reply": "Reply",
+  "replyingTo": "Replying to {name}",
+  "@replyingTo": {
+    "placeholders": {
+      "name": {}
+    }
+  },
+  "cancelReply": "Cancel reply",
+  "viewReplies": "View replies ({count})",
+  "@viewReplies": {
+    "placeholders": {
+      "count": {
+        "type": "int"
+      }
+    }
+  },
+  "hideReplies": "Hide replies",
+  "anonymousUser": "Viewer",
+  "more": "More",
+  "likeFailed": "Could not update like. Please retry.",
+  "reportComment": "Report comment",
+  "reportDrama": "Report drama",
+  "reportReason": "Reason",
+  "reportReasonSpam": "Spam",
+  "reportReasonAbuse": "Harassment",
+  "reportReasonPorn": "Sexual content",
+  "reportReasonAd": "Advertising",
+  "reportReasonOther": "Other",
+  "reportDescriptionHint": "Describe the issue (optional)",
+  "reportSubmit": "Submit report",
+  "reportSubmitted": "Report submitted. Thank you.",
+  "reportFailed": "Could not submit report.",
  "shareFailed": "Could not open the share sheet.",
  "nowPlaying": "Playing now",
  "watchFullscreen": "Watch in landscape",
@@ -65,10 +65,50 @@
  "save": "Simpan",
  "comments": "Komentar",
  "share": "Bagikan",
-  "localOnlyComments": "Hanya terlihat di perangkat ini",
  "noComments": "Belum ada komentar.",
  "writeComment": "Tulis komentar",
  "postComment": "Kirim",
+  "loadMore": "Muat lebih banyak",
+  "commentsLoadFailed": "Komentar tidak dapat dimuat.",
+  "commentPostFailed": "Komentar tidak dapat dikirim.",
+  "delete": "Hapus",
+  "deleteComment": "Hapus komentar",
+  "deleteCommentTitle": "Hapus komentar ini?",
+  "deleteCommentMessage": "Komentar ini akan dihapus dari percakapan.",
+  "commentDeleteFailed": "Komentar tidak dapat dihapus.",
+  "underReview": "Sedang ditinjau",
+  "reply": "Balas",
+  "replyingTo": "Membalas {name}",
+  "@replyingTo": {
+    "placeholders": {
+      "name": {}
+    }
+  },
+  "cancelReply": "Batal membalas",
+  "viewReplies": "Lihat balasan ({count})",
+  "@viewReplies": {
+    "placeholders": {
+      "count": {
+        "type": "int"
+      }
+    }
+  },
+  "hideReplies": "Sembunyikan balasan",
+  "anonymousUser": "Penonton",
+  "more": "Lainnya",
+  "likeFailed": "Status suka tidak dapat diperbarui.",
+  "reportComment": "Laporkan komentar",
+  "reportDrama": "Laporkan drama",
+  "reportReason": "Alasan",
+  "reportReasonSpam": "Spam",
+  "reportReasonAbuse": "Pelecehan",
+  "reportReasonPorn": "Konten seksual",
+  "reportReasonAd": "Iklan",
+  "reportReasonOther": "Lainnya",
+  "reportDescriptionHint": "Jelaskan masalah (opsional)",
+  "reportSubmit": "Kirim laporan",
+  "reportSubmitted": "Laporan terkirim. Terima kasih.",
+  "reportFailed": "Laporan tidak dapat dikirim.",
  "shareFailed": "Tidak bisa membuka menu berbagi.",
  "nowPlaying": "Sedang diputar",
  "watchFullscreen": "Tonton mode lanskap",
@@ -448,12 +448,6 @@ abstract class AppLocalizations {
  /// **'Share'**
  String get share;

-  /// No description provided for @localOnlyComments.
-  ///
-  /// In en, this message translates to:
-  /// **'Only visible on this device'**
-  String get localOnlyComments;
-
  /// No description provided for @noComments.
  ///
  /// In en, this message translates to:
@@ -472,6 +466,180 @@ abstract class AppLocalizations {
  /// **'Post'**
  String get postComment;

+  /// No description provided for @loadMore.
+  ///
+  /// In en, this message translates to:
+  /// **'Load more'**
+  String get loadMore;
+
+  /// No description provided for @commentsLoadFailed.
+  ///
+  /// In en, this message translates to:
+  /// **'Comments could not be loaded.'**
+  String get commentsLoadFailed;
+
+  /// No description provided for @commentPostFailed.
+  ///
+  /// In en, this message translates to:
+  /// **'Could not post your comment.'**
+  String get commentPostFailed;
+
+  /// No description provided for @delete.
+  ///
+  /// In en, this message translates to:
+  /// **'Delete'**
+  String get delete;
+
+  /// No description provided for @deleteComment.
+  ///
+  /// In en, this message translates to:
+  /// **'Delete comment'**
+  String get deleteComment;
+
+  /// No description provided for @deleteCommentTitle.
+  ///
+  /// In en, this message translates to:
+  /// **'Delete this comment?'**
+  String get deleteCommentTitle;
+
+  /// No description provided for @deleteCommentMessage.
+  ///
+  /// In en, this message translates to:
+  /// **'This removes your comment from the conversation.'**
+  String get deleteCommentMessage;
+
+  /// No description provided for @commentDeleteFailed.
+  ///
+  /// In en, this message translates to:
+  /// **'Could not delete this comment.'**
+  String get commentDeleteFailed;
+
+  /// No description provided for @underReview.
+  ///
+  /// In en, this message translates to:
+  /// **'Under review'**
+  String get underReview;
+
+  /// No description provided for @reply.
+  ///
+  /// In en, this message translates to:
+  /// **'Reply'**
+  String get reply;
+
+  /// No description provided for @replyingTo.
+  ///
+  /// In en, this message translates to:
+  /// **'Replying to {name}'**
+  String replyingTo(Object name);
+
+  /// No description provided for @cancelReply.
+  ///
+  /// In en, this message translates to:
+  /// **'Cancel reply'**
+  String get cancelReply;
+
+  /// No description provided for @viewReplies.
+  ///
+  /// In en, this message translates to:
+  /// **'View replies ({count})'**
+  String viewReplies(int count);
+
+  /// No description provided for @hideReplies.
+  ///
+  /// In en, this message translates to:
+  /// **'Hide replies'**
+  String get hideReplies;
+
+  /// No description provided for @anonymousUser.
+  ///
+  /// In en, this message translates to:
+  /// **'Viewer'**
+  String get anonymousUser;
+
+  /// No description provided for @more.
+  ///
+  /// In en, this message translates to:
+  /// **'More'**
+  String get more;
+
+  /// No description provided for @likeFailed.
+  ///
+  /// In en, this message translates to:
+  /// **'Could not update like. Please retry.'**
+  String get likeFailed;
+
+  /// No description provided for @reportComment.
+  ///
+  /// In en, this message translates to:
+  /// **'Report comment'**
+  String get reportComment;
+
+  /// No description provided for @reportDrama.
+  ///
+  /// In en, this message translates to:
+  /// **'Report drama'**
+  String get reportDrama;
+
+  /// No description provided for @reportReason.
+  ///
+  /// In en, this message translates to:
+  /// **'Reason'**
+  String get reportReason;
+
+  /// No description provided for @reportReasonSpam.
+  ///
+  /// In en, this message translates to:
+  /// **'Spam'**
+  String get reportReasonSpam;
+
+  /// No description provided for @reportReasonAbuse.
+  ///
+  /// In en, this message translates to:
+  /// **'Harassment'**
+  String get reportReasonAbuse;
+
+  /// No description provided for @reportReasonPorn.
+  ///
+  /// In en, this message translates to:
+  /// **'Sexual content'**
+  String get reportReasonPorn;
+
+  /// No description provided for @reportReasonAd.
+  ///
+  /// In en, this message translates to:
+  /// **'Advertising'**
+  String get reportReasonAd;
+
+  /// No description provided for @reportReasonOther.
+  ///
+  /// In en, this message translates to:
+  /// **'Other'**
+  String get reportReasonOther;
+
+  /// No description provided for @reportDescriptionHint.
+  ///
+  /// In en, this message translates to:
+  /// **'Describe the issue (optional)'**
+  String get reportDescriptionHint;
+
+  /// No description provided for @reportSubmit.
+  ///
+  /// In en, this message translates to:
+  /// **'Submit report'**
+  String get reportSubmit;
+
+  /// No description provided for @reportSubmitted.
+  ///
+  /// In en, this message translates to:
+  /// **'Report submitted. Thank you.'**
+  String get reportSubmitted;
+
+  /// No description provided for @reportFailed.
+  ///
+  /// In en, this message translates to:
+  /// **'Could not submit report.'**
+  String get reportFailed;
+
  /// No description provided for @shareFailed.
  ///
  /// In en, this message translates to:
@@ -187,9 +187,6 @@ class AppLocalizationsEn extends AppLocalizations {
  @override
  String get share => 'Share';

-  @override
-  String get localOnlyComments => 'Only visible on this device';
-
  @override
  String get noComments => 'No comments yet.';

@@ -199,6 +196,98 @@ class AppLocalizationsEn extends AppLocalizations {
  @override
  String get postComment => 'Post';

+  @override
+  String get loadMore => 'Load more';
+
+  @override
+  String get commentsLoadFailed => 'Comments could not be loaded.';
+
+  @override
+  String get commentPostFailed => 'Could not post your comment.';
+
+  @override
+  String get delete => 'Delete';
+
+  @override
+  String get deleteComment => 'Delete comment';
+
+  @override
+  String get deleteCommentTitle => 'Delete this comment?';
+
+  @override
+  String get deleteCommentMessage =>
+      'This removes your comment from the conversation.';
+
+  @override
+  String get commentDeleteFailed => 'Could not delete this comment.';
+
+  @override
+  String get underReview => 'Under review';
+
+  @override
+  String get reply => 'Reply';
+
+  @override
+  String replyingTo(Object name) {
+    return 'Replying to $name';
+  }
+
+  @override
+  String get cancelReply => 'Cancel reply';
+
+  @override
+  String viewReplies(int count) {
+    return 'View replies ($count)';
+  }
+
+  @override
+  String get hideReplies => 'Hide replies';
+
+  @override
+  String get anonymousUser => 'Viewer';
+
+  @override
+  String get more => 'More';
+
+  @override
+  String get likeFailed => 'Could not update like. Please retry.';
+
+  @override
+  String get reportComment => 'Report comment';
+
+  @override
+  String get reportDrama => 'Report drama';
+
+  @override
+  String get reportReason => 'Reason';
+
+  @override
+  String get reportReasonSpam => 'Spam';
+
+  @override
+  String get reportReasonAbuse => 'Harassment';
+
+  @override
+  String get reportReasonPorn => 'Sexual content';
+
+  @override
+  String get reportReasonAd => 'Advertising';
+
+  @override
+  String get reportReasonOther => 'Other';
+
+  @override
+  String get reportDescriptionHint => 'Describe the issue (optional)';
+
+  @override
+  String get reportSubmit => 'Submit report';
+
+  @override
+  String get reportSubmitted => 'Report submitted. Thank you.';
+
+  @override
+  String get reportFailed => 'Could not submit report.';
+
  @override
  String get shareFailed => 'Could not open the share sheet.';

@@ -187,9 +187,6 @@ class AppLocalizationsId extends AppLocalizations {
  @override
  String get share => 'Bagikan';

-  @override
-  String get localOnlyComments => 'Hanya terlihat di perangkat ini';
-
  @override
  String get noComments => 'Belum ada komentar.';

@@ -199,6 +196,98 @@ class AppLocalizationsId extends AppLocalizations {
  @override
  String get postComment => 'Kirim';

+  @override
+  String get loadMore => 'Muat lebih banyak';
+
+  @override
+  String get commentsLoadFailed => 'Komentar tidak dapat dimuat.';
+
+  @override
+  String get commentPostFailed => 'Komentar tidak dapat dikirim.';
+
+  @override
+  String get delete => 'Hapus';
+
+  @override
+  String get deleteComment => 'Hapus komentar';
+
+  @override
+  String get deleteCommentTitle => 'Hapus komentar ini?';
+
+  @override
+  String get deleteCommentMessage =>
+      'Komentar ini akan dihapus dari percakapan.';
+
+  @override
+  String get commentDeleteFailed => 'Komentar tidak dapat dihapus.';
+
+  @override
+  String get underReview => 'Sedang ditinjau';
+
+  @override
+  String get reply => 'Balas';
+
+  @override
+  String replyingTo(Object name) {
+    return 'Membalas $name';
+  }
+
+  @override
+  String get cancelReply => 'Batal membalas';
+
+  @override
+  String viewReplies(int count) {
+    return 'Lihat balasan ($count)';
+  }
+
+  @override
+  String get hideReplies => 'Sembunyikan balasan';
+
+  @override
+  String get anonymousUser => 'Penonton';
+
+  @override
+  String get more => 'Lainnya';
+
+  @override
+  String get likeFailed => 'Status suka tidak dapat diperbarui.';
+
+  @override
+  String get reportComment => 'Laporkan komentar';
+
+  @override
+  String get reportDrama => 'Laporkan drama';
+
+  @override
+  String get reportReason => 'Alasan';
+
+  @override
+  String get reportReasonSpam => 'Spam';
+
+  @override
+  String get reportReasonAbuse => 'Pelecehan';
+
+  @override
+  String get reportReasonPorn => 'Konten seksual';
+
+  @override
+  String get reportReasonAd => 'Iklan';
+
+  @override
+  String get reportReasonOther => 'Lainnya';
+
+  @override
+  String get reportDescriptionHint => 'Jelaskan masalah (opsional)';
+
+  @override
+  String get reportSubmit => 'Kirim laporan';
+
+  @override
+  String get reportSubmitted => 'Laporan terkirim. Terima kasih.';
+
+  @override
+  String get reportFailed => 'Laporan tidak dapat dikirim.';
+
  @override
  String get shareFailed => 'Tidak bisa membuka menu berbagi.';

@@ -184,9 +184,6 @@ class AppLocalizationsZh extends AppLocalizations {
  @override
  String get share => '分享';

-  @override
-  String get localOnlyComments => '仅在本机可见';
-
  @override
  String get noComments => '还没有评论。';

@@ -196,6 +193,97 @@ class AppLocalizationsZh extends AppLocalizations {
  @override
  String get postComment => '发布';

+  @override
+  String get loadMore => '加载更多';
+
+  @override
+  String get commentsLoadFailed => '评论加载失败，请重试。';
+
+  @override
+  String get commentPostFailed => '评论发布失败，请重试。';
+
+  @override
+  String get delete => '删除';
+
+  @override
+  String get deleteComment => '删除评论';
+
+  @override
+  String get deleteCommentTitle => '删除这条评论？';
+
+  @override
+  String get deleteCommentMessage => '删除后，这条评论将从评论列表中移除。';
+
+  @override
+  String get commentDeleteFailed => '评论删除失败，请重试。';
+
+  @override
+  String get underReview => '审核中';
+
+  @override
+  String get reply => '回复';
+
+  @override
+  String replyingTo(Object name) {
+    return '回复 $name';
+  }
+
+  @override
+  String get cancelReply => '取消回复';
+
+  @override
+  String viewReplies(int count) {
+    return '查看回复（$count）';
+  }
+
+  @override
+  String get hideReplies => '收起回复';
+
+  @override
+  String get anonymousUser => '观众';
+
+  @override
+  String get more => '更多';
+
+  @override
+  String get likeFailed => '点赞状态更新失败，请重试。';
+
+  @override
+  String get reportComment => '举报评论';
+
+  @override
+  String get reportDrama => '举报短剧';
+
+  @override
+  String get reportReason => '举报原因';
+
+  @override
+  String get reportReasonSpam => '垃圾广告';
+
+  @override
+  String get reportReasonAbuse => '辱骂骚扰';
+
+  @override
+  String get reportReasonPorn => '色情低俗';
+
+  @override
+  String get reportReasonAd => '引流广告';
+
+  @override
+  String get reportReasonOther => '其他';
+
+  @override
+  String get reportDescriptionHint => '补充说明（选填）';
+
+  @override
+  String get reportSubmit => '提交举报';
+
+  @override
+  String get reportSubmitted => '举报已提交，感谢反馈。';
+
+  @override
+  String get reportFailed => '举报提交失败，请重试。';
+
  @override
  String get shareFailed => '无法打开系统分享面板。';

@@ -65,10 +65,50 @@
  "save": "收藏",
  "comments": "评论",
  "share": "分享",
-  "localOnlyComments": "仅在本机可见",
  "noComments": "还没有评论。",
  "writeComment": "写评论",
  "postComment": "发布",
+  "loadMore": "加载更多",
+  "commentsLoadFailed": "评论加载失败，请重试。",
+  "commentPostFailed": "评论发布失败，请重试。",
+  "delete": "删除",
+  "deleteComment": "删除评论",
+  "deleteCommentTitle": "删除这条评论？",
+  "deleteCommentMessage": "删除后，这条评论将从评论列表中移除。",
+  "commentDeleteFailed": "评论删除失败，请重试。",
+  "underReview": "审核中",
+  "reply": "回复",
+  "replyingTo": "回复 {name}",
+  "@replyingTo": {
+    "placeholders": {
+      "name": {}
+    }
+  },
+  "cancelReply": "取消回复",
+  "viewReplies": "查看回复（{count}）",
+  "@viewReplies": {
+    "placeholders": {
+      "count": {
+        "type": "int"
+      }
+    }
+  },
+  "hideReplies": "收起回复",
+  "anonymousUser": "观众",
+  "more": "更多",
+  "likeFailed": "点赞状态更新失败，请重试。",
+  "reportComment": "举报评论",
+  "reportDrama": "举报短剧",
+  "reportReason": "举报原因",
+  "reportReasonSpam": "垃圾广告",
+  "reportReasonAbuse": "辱骂骚扰",
+  "reportReasonPorn": "色情低俗",
+  "reportReasonAd": "引流广告",
+  "reportReasonOther": "其他",
+  "reportDescriptionHint": "补充说明（选填）",
+  "reportSubmit": "提交举报",
+  "reportSubmitted": "举报已提交，感谢反馈。",
+  "reportFailed": "举报提交失败，请重试。",
  "shareFailed": "无法打开系统分享面板。",
  "nowPlaying": "正在播放",
  "watchFullscreen": "横屏全屏观看",
@@ -8,17 +8,21 @@ import 'package:provider/provider.dart';
 import '../../core/data/models/drama.dart';
 import '../../core/data/services/catalog_controller.dart';
 import '../../core/data/services/favorite_controller.dart';
+import '../../core/data/services/interaction_controller.dart';
 import '../../core/formatting/error_text.dart';
 import '../../core/formatting/localized_content.dart';
 import '../../core/widgets/remote_image.dart';
 import '../../core/widgets/auth_gate.dart';
 import '../../core/widgets/download_action.dart';
 import '../../l10n/app_localizations.dart';
+import '../interaction/widgets/report_dialog.dart';
 import 'drama_detail_binding.dart';
 import 'drama_detail_logic.dart';
 import '../../core/data/repositories/watch_history_repository.dart';
 import '../../core/data/repositories/playback_repository.dart';

+const String _reportMenuValue = 'report';
+
 class DramaDetailPage extends StatefulWidget {
  const DramaDetailPage({super.key, required this.drama});
  final Drama drama;
@@ -138,6 +142,7 @@ class _DramaDetailPageState extends State<DramaDetailPage> {
            backgroundColor: const Color(0xFF111111),
            foregroundColor: Colors.white,
            actions: [
+              _reportAction(context, l10n),
              _downloadAction(context, l10n),
              _favoriteAction(context, l10n),
            ],
@@ -291,6 +296,42 @@ class _DramaDetailPageState extends State<DramaDetailPage> {
    );
  }

+  /// 详情页更多菜单：本批只提供举报短剧。
+  Widget _reportAction(BuildContext context, AppLocalizations l10n) {
+    return PopupMenuButton<String>(
+      key: const Key('detail-more'),
+      tooltip: l10n.more,
+      onSelected: (_) => unawaited(_reportDrama(l10n)),
+      itemBuilder: (_) => [
+        PopupMenuItem(
+          value: _reportMenuValue,
+          child: Text(l10n.reportDrama),
+        ),
+      ],
+    );
+  }
+
+  Future<void> _reportDrama(AppLocalizations l10n) async {
+    if (!await ensureSignedIn(context) || !mounted) return;
+    final draft = await showReportDialog(context, title: l10n.reportDrama);
+    if (draft == null || !mounted) return;
+    final result = await context.read<InteractionController>().reportDrama(
+      logic.drama.id,
+      reason: draft.reason,
+      description: draft.description,
+    );
+    if (!mounted) return;
+    ScaffoldMessenger.of(context).showSnackBar(
+      SnackBar(
+        content: Text(
+          result.isSuccess
+              ? l10n.reportSubmitted
+              : result.errorMessage ?? l10n.reportFailed,
+        ),
+      ),
+    );
+  }
+
  /// 收藏按钮：状态取自服务端（乐观更新，失败回滚并提示）。
  Widget _favoriteAction(BuildContext context, AppLocalizations l10n) {
    final favorites = context.watch<FavoriteController>();
@@ -0,0 +1,125 @@
+// Author: fruit.com.cn
+
+import 'package:flutter/material.dart';
+
+import '../../../core/data/models/interaction.dart';
+import '../../../l10n/app_localizations.dart';
+
+const int _maxDescriptionLength = 300;
+
+/// 举报弹窗收集的结果。
+class ReportDialogResult {
+  const ReportDialogResult({
+    required this.reason,
+    required this.description,
+  });
+
+  final ReportReason reason;
+  final String description;
+}
+
+/// 打开举报原因单选弹窗；取消时返回 null。
+Future<ReportDialogResult?> showReportDialog(
+  BuildContext context, {
+  required String title,
+}) => showDialog<ReportDialogResult>(
+  context: context,
+  builder: (_) => _ReportDialog(title: title),
+);
+
+class _ReportDialog extends StatefulWidget {
+  const _ReportDialog({required this.title});
+
+  final String title;
+
+  @override
+  State<_ReportDialog> createState() => _ReportDialogState();
+}
+
+class _ReportDialogState extends State<_ReportDialog> {
+  final _description = TextEditingController();
+  ReportReason _reason = ReportReason.spam;
+
+  @override
+  void dispose() {
+    _description.dispose();
+    super.dispose();
+  }
+
+  void _submit() {
+    Navigator.of(context).pop(
+      ReportDialogResult(
+        reason: _reason,
+        description: _description.text.trim(),
+      ),
+    );
+  }
+
+  String _reasonLabel(AppLocalizations l10n, ReportReason reason) =>
+      switch (reason) {
+        ReportReason.spam => l10n.reportReasonSpam,
+        ReportReason.abuse => l10n.reportReasonAbuse,
+        ReportReason.porn => l10n.reportReasonPorn,
+        ReportReason.ad => l10n.reportReasonAd,
+        ReportReason.other => l10n.reportReasonOther,
+      };
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = AppLocalizations.of(context)!;
+    return AlertDialog(
+      title: Text(widget.title),
+      content: SingleChildScrollView(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
+            Text(l10n.reportReason),
+            RadioGroup<ReportReason>(
+              groupValue: _reason,
+              onChanged: (value) {
+                if (value == null) return;
+                setState(() => _reason = value);
+              },
+              child: Column(
+                children: [
+                  for (final reason in ReportReason.values)
+                    RadioListTile<ReportReason>(
+                      key: Key('report-reason-${reason.apiValue}'),
+                      value: reason,
+                      contentPadding: EdgeInsets.zero,
+                      dense: true,
+                      title: Text(_reasonLabel(l10n, reason)),
+                    ),
+                ],
+              ),
+            ),
+            const SizedBox(height: 8),
+            TextField(
+              key: const Key('report-description'),
+              controller: _description,
+              maxLength: _maxDescriptionLength,
+              maxLines: 3,
+              minLines: 2,
+              decoration: InputDecoration(
+                hintText: l10n.reportDescriptionHint,
+                border: const OutlineInputBorder(),
+              ),
+            ),
+          ],
+        ),
+      ),
+      actions: [
+        TextButton(
+          onPressed: () => Navigator.of(context).pop(),
+          child: Text(l10n.cancel),
+        ),
+        FilledButton(
+          key: const Key('report-submit'),
+          onPressed: _submit,
+          child: Text(l10n.reportSubmit),
+        ),
+      ],
+    );
+  }
+}
@@ -9,7 +9,7 @@ import '../../core/formatting/localized_content.dart';
 import '../../core/data/models/drama.dart';
 import '../../core/data/repositories/watch_history_repository.dart';
 import '../../core/data/services/auth_controller.dart';
-import '../../core/data/services/engagement_controller.dart';
+import '../../core/data/services/interaction_controller.dart';
 import '../../core/data/services/favorite_controller.dart';
 import '../../core/formatting/error_text.dart';
 import '../../core/widgets/remote_image.dart';
@@ -474,14 +474,14 @@ class _MyPageState extends State<MyPage> {
        logic.filter == 0 ||
        (logic.filter == 1 && fraction < 0.99) ||
        (logic.filter == 2 && fraction >= 0.99);
-    final engagement = context.watch<EngagementController>();
-    // 收藏以服务端为准（收藏列表接口返回卡片结构）；点赞仍是本地状态（K3 接互动）。
+    final interactions = context.watch<InteractionController>();
+    // 收藏以服务端为准；剧集点赞暂按当前会话状态过滤 feed。
    final favorites = context.watch<FavoriteController>();
    final isWatchlist = logic.section == 1;
    final markedDramas = isWatchlist
        ? favorites.cards
        : (widget.dramas ?? [widget.drama])
-              .where((drama) => engagement.isLiked(drama.id))
+              .where((drama) => interactions.isLiked(drama.id))
              .toList();
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
@@ -9,8 +9,8 @@ import 'package:video_player/video_player.dart';

 import '../../core/data/models/drama.dart';
 import '../../core/data/models/play_ticket.dart';
-import '../../core/data/services/engagement_controller.dart';
 import '../../core/data/services/favorite_controller.dart';
+import '../../core/data/services/interaction_controller.dart';
 import '../../core/data/services/playback_session.dart';
 import '../../core/data/services/video_player_port.dart';
 import '../../core/formatting/error_text.dart';
@@ -108,7 +108,7 @@ class _PlayerPageState extends State<PlayerPage> with WidgetsBindingObserver {
  }

  Widget _buildPlayer(BuildContext context) {
-    final engagement = context.watch<EngagementController>();
+    final interactions = context.watch<InteractionController>();
    final indices = logic.visibleIndices;
    final pages = logic.pages;
    final content = AnimatedBuilder(
@@ -124,7 +124,7 @@ class _PlayerPageState extends State<PlayerPage> with WidgetsBindingObserver {
          unawaited(logic.selectEpisode(index));
        },
        itemBuilder: (context, position) =>
-            _buildEpisode(context, indices[position], engagement),
+            _buildEpisode(context, indices[position], interactions),
      ),
    );
    return AnnotatedRegion<SystemUiOverlayStyle>(
@@ -141,7 +141,7 @@ class _PlayerPageState extends State<PlayerPage> with WidgetsBindingObserver {
  Widget _buildEpisode(
    BuildContext context,
    int index,
-    EngagementController engagement,
+    InteractionController interactions,
  ) {
    final l10n = AppLocalizations.of(context)!;
    final entry = logic.queue.entryAt(index);
@@ -336,7 +336,7 @@ class _PlayerPageState extends State<PlayerPage> with WidgetsBindingObserver {
            drama: drama,
            episode: episode,
            controller: ready ? videoPort!.controller : null,
-            liked: engagement.isLiked(drama.id),
+            liked: interactions.isLiked(drama.id),
            // 收藏以服务端为准（FavoriteController 由 app 注入，登录后自动加载）
            saved: context.watch<FavoriteController>().isSaved(drama.id),
            onBack: widget.embedded
@@ -348,7 +348,17 @@ class _PlayerPageState extends State<PlayerPage> with WidgetsBindingObserver {
            // 收藏/点赞要对到具体账号：未登录先引导登录（首页/详情仍可匿名浏览）
            onLike: () async {
              if (await ensureSignedIn(context)) {
-                unawaited(engagement.toggleLiked(drama.id));
+                final result = await interactions.toggleDramaLike(drama.id);
+                if (!result.isSuccess && context.mounted) {
+                  ScaffoldMessenger.of(context).showSnackBar(
+                    SnackBar(
+                      content: Text(
+                        result.errorMessage ??
+                            AppLocalizations.of(context)!.likeFailed,
+                      ),
+                    ),
+                  );
+                }
              }
            },
            onSave: () async {
@@ -0,0 +1,149 @@
+// Author: fruit.com.cn
+
+import 'package:flutter/material.dart';
+
+import '../../../core/data/models/comment.dart';
+import '../../../core/data/services/comment_controller.dart';
+import '../../../core/theme/app_colors.dart';
+import '../../../l10n/app_localizations.dart';
+
+const String _deleteAction = 'delete';
+const String _reportAction = 'report';
+
+/// 评论条目的交互回调集合。
+class CommentInteractionHandlers {
+  const CommentInteractionHandlers({
+    required this.onReply,
+    required this.onLike,
+    required this.onDelete,
+    required this.onReport,
+  });
+
+  final ValueChanged<DramaComment> onReply;
+  final Future<void> Function(DramaComment) onLike;
+  final Future<void> Function(DramaComment) onDelete;
+  final Future<void> Function(DramaComment) onReport;
+}
+
+/// 单条评论或回复的展示与操作行。
+class CommentTile extends StatelessWidget {
+  const CommentTile({
+    super.key,
+    required this.comment,
+    required this.controller,
+    required this.handlers,
+    this.isReply = false,
+  });
+
+  final DramaComment comment;
+  final CommentController controller;
+  final CommentInteractionHandlers handlers;
+  final bool isReply;
+
+  @override
+  Widget build(BuildContext context) {
+    final l10n = AppLocalizations.of(context)!;
+    final name = comment.nickname.isEmpty ? l10n.anonymousUser : comment.nickname;
+    return Padding(
+      key: Key('comment-item-${comment.id}'),
+      padding: const EdgeInsets.symmetric(vertical: 8),
+      child: Row(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          CircleAvatar(
+            radius: isReply ? 12 : 16,
+            backgroundColor: AppColors.blue.withValues(alpha: 0.2),
+            child: Icon(
+              Icons.person_rounded,
+              size: isReply ? 14 : 18,
+              color: AppColors.blueSoft,
+            ),
+          ),
+          const SizedBox(width: 12),
+          Expanded(
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                Row(
+                  children: [
+                    Expanded(
+                      child: Text(
+                        name,
+                        style: const TextStyle(
+                          color: AppColors.muted,
+                          fontSize: 12,
+                        ),
+                      ),
+                    ),
+                    PopupMenuButton<String>(
+                      key: Key('comment-menu-${comment.id}'),
+                      tooltip: l10n.more,
+                      onSelected: (value) {
+                        if (value == _deleteAction) {
+                          handlers.onDelete(comment);
+                        } else if (value == _reportAction) {
+                          handlers.onReport(comment);
+                        }
+                      },
+                      itemBuilder: (_) => [
+                        if (comment.mine)
+                          PopupMenuItem(
+                            value: _deleteAction,
+                            child: Text(l10n.deleteComment),
+                          )
+                        else
+                          PopupMenuItem(
+                            value: _reportAction,
+                            child: Text(l10n.reportComment),
+                          ),
+                      ],
+                    ),
+                  ],
+                ),
+                Text(
+                  comment.content,
+                  style: const TextStyle(color: Colors.white, fontSize: 14),
+                ),
+                if (comment.isPending)
+                  Padding(
+                    padding: const EdgeInsets.only(top: 4),
+                    child: Text(
+                      l10n.underReview,
+                      key: Key('comment-pending-${comment.id}'),
+                      style: const TextStyle(
+                        color: AppColors.blueSoft,
+                        fontSize: 11,
+                      ),
+                    ),
+                  ),
+                Row(
+                  children: [
+                    TextButton.icon(
+                      key: Key('comment-like-${comment.id}'),
+                      onPressed: controller.likingComment(comment.id)
+                          ? null
+                          : () => handlers.onLike(comment),
+                      icon: Icon(
+                        comment.liked
+                            ? Icons.favorite_rounded
+                            : Icons.favorite_border_rounded,
+                        size: 16,
+                      ),
+                      label: Text('${comment.likeCount}'),
+                    ),
+                    if (!isReply)
+                      TextButton(
+                        key: Key('comment-reply-${comment.id}'),
+                        onPressed: () => handlers.onReply(comment),
+                        child: Text(l10n.reply),
+                      ),
+                  ],
+                ),
+              ],
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}
@@ -1,12 +1,27 @@
 // Author: fruit.com.cn

+import 'dart:async';
+
 import 'package:flutter/material.dart';
 import 'package:provider/provider.dart';

+import '../../../core/data/models/comment.dart';
 import '../../../core/data/models/drama.dart';
-import '../../../core/data/services/engagement_controller.dart';
+import '../../../core/data/repositories/comment_repository.dart';
+import '../../../core/data/repositories/interaction_repository.dart';
+import '../../../core/data/services/comment_controller.dart';
+import '../../../core/formatting/error_text.dart';
+import '../../../core/theme/app_colors.dart';
+import '../../../core/widgets/auth_gate.dart';
 import '../../../l10n/app_localizations.dart';
+import '../../interaction/widgets/report_dialog.dart';
+import 'comment_tile.dart';

+const double _minSheetHeight = 240;
+const double _maxSheetHeight = 460;
+const int _maxCommentLength = 300;
+
+/// 服务端评论底部弹窗：匿名列表、游标翻页、回复、点赞和本人删除。
 class DramaCommentsSheet extends StatefulWidget {
  const DramaCommentsSheet({super.key, required this.drama});

@@ -18,26 +33,120 @@ class DramaCommentsSheet extends StatefulWidget {

 class _DramaCommentsSheetState extends State<DramaCommentsSheet> {
  final _input = TextEditingController();
+  final _inputFocus = FocusNode();
+  late final CommentController _controller;
+  DramaComment? _replyTo;
+
+  @override
+  void initState() {
+    super.initState();
+    _controller = CommentController(
+      comments: context.read<CommentRepository>(),
+      interactions: context.read<InteractionRepository>(),
+      dramaId: widget.drama.id,
+    );
+    unawaited(_controller.load());
+  }

  @override
  void dispose() {
+    _controller.dispose();
    _input.dispose();
+    _inputFocus.dispose();
    super.dispose();
  }

-  void _post() {
-    final text = _input.text.trim();
-    if (text.isEmpty) return;
-    context.read<EngagementController>().addComment(widget.drama.id, text);
-    _input.clear();
+  Future<void> _post() async {
+    if (_controller.submitting) return;
+    if (_input.text.trim().isEmpty) return;
+    if (!await ensureSignedIn(context) || !mounted) return;
+    final result = await _controller.publish(_input.text, replyTo: _replyTo);
+    if (!mounted) return;
+    if (result.isSuccess) {
+      _input.clear();
+      setState(() => _replyTo = null);
+      return;
+    }
+    _showMessage(
+      result.errorMessage ?? AppLocalizations.of(context)!.commentPostFailed,
+    );
+  }
+
+  void _beginReply(DramaComment comment) {
+    setState(() => _replyTo = comment);
+    _inputFocus.requestFocus();
+  }
+
+  void _cancelReply() {
+    if (_replyTo == null) return;
+    setState(() => _replyTo = null);
+  }
+
+  Future<void> _like(DramaComment comment) async {
+    if (!await ensureSignedIn(context) || !mounted) return;
+    final result = await _controller.toggleLike(comment);
+    if (!result.isSuccess && mounted) {
+      _showMessage(
+        result.errorMessage ?? AppLocalizations.of(context)!.commentPostFailed,
+      );
+    }
+  }
+
+  Future<void> _confirmDelete(DramaComment comment) async {
+    final l10n = AppLocalizations.of(context)!;
+    final confirmed = await showDialog<bool>(
+      context: context,
+      builder: (dialogContext) => AlertDialog(
+        title: Text(l10n.deleteCommentTitle),
+        content: Text(l10n.deleteCommentMessage),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.of(dialogContext).pop(false),
+            child: Text(l10n.cancel),
+          ),
+          FilledButton(
+            key: const Key('comment-delete-confirm'),
+            onPressed: () => Navigator.of(dialogContext).pop(true),
+            child: Text(l10n.delete),
+          ),
+        ],
+      ),
+    );
+    if (confirmed != true || !mounted) return;
+    final result = await _controller.delete(comment);
+    if (!result.isSuccess && mounted) {
+      _showMessage(
+        result.errorMessage ?? AppLocalizations.of(context)!.commentDeleteFailed,
+      );
+    }
+  }
+
+  Future<void> _report(DramaComment comment) async {
+    if (!await ensureSignedIn(context) || !mounted) return;
+    final l10n = AppLocalizations.of(context)!;
+    final draft = await showReportDialog(context, title: l10n.reportComment);
+    if (draft == null || !mounted) return;
+    final result = await _controller.report(
+      comment,
+      reason: draft.reason,
+      description: draft.description,
+    );
+    if (!mounted) return;
+    _showMessage(
+      result.isSuccess
+          ? l10n.reportSubmitted
+          : result.errorMessage ?? l10n.reportFailed,
+    );
+  }
+
+  void _showMessage(String message) {
+    ScaffoldMessenger.of(
+      context,
+    ).showSnackBar(SnackBar(content: Text(message)));
  }

  @override
  Widget build(BuildContext context) {
-    final l10n = AppLocalizations.of(context)!;
-    final comments = context.watch<EngagementController>().commentsFor(
-      widget.drama.id,
-    );
    final available =
        MediaQuery.sizeOf(context).height -
        MediaQuery.viewInsetsOf(context).bottom -
@@ -45,83 +154,244 @@ class _DramaCommentsSheetState extends State<DramaCommentsSheet> {
    return Padding(
      padding: EdgeInsets.only(bottom: MediaQuery.viewInsetsOf(context).bottom),
      child: SizedBox(
-        height: available.clamp(240.0, 460.0),
+        height: available.clamp(_minSheetHeight, _maxSheetHeight),
        child: SafeArea(
          top: false,
          child: Padding(
            padding: const EdgeInsets.fromLTRB(16, 12, 16, 8),
-            child: Column(
-              crossAxisAlignment: CrossAxisAlignment.start,
-              children: [
-                Text(
-                  l10n.comments,
-                  style: const TextStyle(
-                    fontSize: 20,
-                    fontWeight: FontWeight.w700,
-                  ),
-                ),
-                const SizedBox(height: 3),
-                Text(
-                  l10n.localOnlyComments,
-                  style: const TextStyle(color: Color(0xFFE6E1E3), fontSize: 13),
-                ),
-                const SizedBox(height: 14),
-                Expanded(
-                  child: comments.isEmpty
-                      ? Center(
-                          child: Text(
-                            l10n.noComments,
-                            style: const TextStyle(color: Color(0xFFE6E1E3)),
-                          ),
-                        )
-                      : ListView.separated(
-                          itemCount: comments.length,
-                          separatorBuilder: (_, _) => const Divider(height: 1),
-                          itemBuilder: (context, index) => ListTile(
-                            leading: const CircleAvatar(
-                              radius: 16,
-                              child: Icon(Icons.person_rounded, size: 18),
-                            ),
-                            title: Text(comments[index]),
-                            contentPadding: EdgeInsets.zero,
-                          ),
-                        ),
-                ),
-                Row(
-                  children: [
-                    Expanded(
-                      child: TextField(
-                        key: const Key('comment-input'),
-                        controller: _input,
-                        maxLength: 300,
-                        maxLines: 1,
-                        decoration: InputDecoration(
-                          hintText: l10n.writeComment,
-                          counterText: '',
-                          filled: true,
-                          fillColor: const Color(0xFF35353A),
-                          border: OutlineInputBorder(
-                            borderRadius: BorderRadius.circular(14),
-                            borderSide: BorderSide.none,
-                          ),
-                        ),
-                        onSubmitted: (_) => _post(),
-                      ),
-                    ),
-                    const SizedBox(width: 8),
-                    IconButton.filled(
-                      key: const Key('comment-post'),
-                      tooltip: l10n.postComment,
-                      onPressed: _post,
-                      icon: const Icon(Icons.send_rounded),
-                    ),
-                  ],
-                ),
-              ],
+            child: ListenableBuilder(
+              listenable: _controller,
+              builder: (context, _) => _content(context),
            ),
          ),
        ),
      ),
    );
  }
+
+  Widget _content(BuildContext context) {
+    final l10n = AppLocalizations.of(context)!;
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        Text(
+          l10n.comments,
+          style: const TextStyle(fontSize: 20, fontWeight: FontWeight.w700),
+        ),
+        const SizedBox(height: 8),
+        Expanded(child: _list(l10n)),
+        if (_replyTo != null) _replyBanner(l10n, _replyTo!),
+        _composer(l10n),
+      ],
+    );
+  }
+
+  Widget _list(AppLocalizations l10n) {
+    if (_controller.loading && _controller.comments.isEmpty) {
+      return const Center(
+        child: CircularProgressIndicator(key: Key('comment-list-loading')),
+      );
+    }
+    if (_controller.error != null && _controller.comments.isEmpty) {
+      return Center(
+        key: const Key('comment-list-error'),
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            Text(
+              errorText(l10n, _controller.error, l10n.commentsLoadFailed),
+              textAlign: TextAlign.center,
+              style: const TextStyle(color: AppColors.muted),
+            ),
+            const SizedBox(height: 8),
+            TextButton(
+              key: const Key('comment-list-retry'),
+              onPressed: _controller.load,
+              child: Text(l10n.retry),
+            ),
+          ],
+        ),
+      );
+    }
+    if (_controller.comments.isEmpty) {
+      return Center(
+        key: const Key('comment-list-empty'),
+        child: Text(
+          l10n.noComments,
+          style: const TextStyle(color: AppColors.muted),
+        ),
+      );
+    }
+    return ListView.builder(
+      key: const Key('comment-list'),
+      itemCount: _controller.comments.length + 1,
+      itemBuilder: (context, index) {
+        if (index == _controller.comments.length) return _footer(l10n);
+        return _CommentThread(
+          comment: _controller.comments[index],
+          controller: _controller,
+          handlers: CommentInteractionHandlers(
+            onReply: _beginReply,
+            onLike: _like,
+            onDelete: _confirmDelete,
+            onReport: _report,
+          ),
+        );
+      },
+    );
+  }
+
+  Widget _footer(AppLocalizations l10n) {
+    if (_controller.loadingMore) {
+      return const Padding(
+        padding: EdgeInsets.symmetric(vertical: 12),
+        child: Center(child: CircularProgressIndicator()),
+      );
+    }
+    if (_controller.hasMore) {
+      return TextButton(
+        key: const Key('comment-list-load-more'),
+        onPressed: _controller.loadMore,
+        child: Text(l10n.loadMore),
+      );
+    }
+    return const SizedBox(height: 8);
+  }
+
+  Widget _replyBanner(AppLocalizations l10n, DramaComment replyTo) => Padding(
+    padding: const EdgeInsets.only(bottom: 6),
+    child: Row(
+      children: [
+        Expanded(
+          child: Text(
+            l10n.replyingTo(
+              replyTo.nickname.isEmpty ? l10n.anonymousUser : replyTo.nickname,
+            ),
+            style: const TextStyle(color: AppColors.blueSoft, fontSize: 12),
+          ),
+        ),
+        IconButton(
+          key: const Key('comment-cancel-reply'),
+          tooltip: l10n.cancelReply,
+          onPressed: _cancelReply,
+          visualDensity: VisualDensity.compact,
+          icon: const Icon(Icons.close_rounded, size: 18),
+        ),
+      ],
+    ),
+  );
+
+  Widget _composer(AppLocalizations l10n) => Row(
+    children: [
+      Expanded(
+        child: TextField(
+          key: const Key('comment-input'),
+          controller: _input,
+          focusNode: _inputFocus,
+          maxLength: _maxCommentLength,
+          maxLines: 1,
+          decoration: InputDecoration(
+            hintText: l10n.writeComment,
+            counterText: '',
+            filled: true,
+            fillColor: const Color(0xFF35353A),
+            border: OutlineInputBorder(
+              borderRadius: BorderRadius.circular(14),
+              borderSide: BorderSide.none,
+            ),
+          ),
+          onSubmitted: (_) => _post(),
+        ),
+      ),
+      const SizedBox(width: 8),
+      IconButton.filled(
+        key: const Key('comment-post'),
+        tooltip: l10n.postComment,
+        onPressed: _controller.submitting ? null : _post,
+        icon: _controller.submitting
+            ? const SizedBox.square(
+                dimension: 18,
+                child: CircularProgressIndicator(strokeWidth: 2),
+              )
+            : const Icon(Icons.send_rounded),
+      ),
+    ],
+  );
+}
+
+class _CommentThread extends StatelessWidget {
+  const _CommentThread({
+    required this.comment,
+    required this.controller,
+    required this.handlers,
+  });
+
+  final DramaComment comment;
+  final CommentController controller;
+  final CommentInteractionHandlers handlers;
+
+  @override
+  Widget build(BuildContext context) {
+    final replies = controller.repliesFor(comment.id);
+    final expanded = controller.repliesExpanded(comment.id);
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        CommentTile(
+          comment: comment,
+          controller: controller,
+          handlers: handlers,
+        ),
+        if (comment.replyCount > 0 || replies.isNotEmpty)
+          Padding(
+            padding: const EdgeInsets.only(left: 44, bottom: 8),
+            child: TextButton(
+              key: Key('comment-replies-${comment.id}'),
+              onPressed: () => _toggleReplies(context),
+              child: Text(
+                expanded
+                    ? AppLocalizations.of(context)!.hideReplies
+                    : AppLocalizations.of(
+                        context,
+                      )!.viewReplies(comment.replyCount),
+              ),
+            ),
+          ),
+        if (expanded)
+          Padding(
+            padding: const EdgeInsets.only(left: 28),
+            child: Column(
+              children: [
+                if (controller.repliesLoading(comment.id))
+                  const Padding(
+                    padding: EdgeInsets.symmetric(vertical: 8),
+                    child: CircularProgressIndicator(),
+                  ),
+                for (final reply in replies)
+                  CommentTile(
+                    comment: reply,
+                    controller: controller,
+                    handlers: handlers,
+                    isReply: true,
+                  ),
+                if (controller.repliesHasMore(comment.id))
+                  TextButton(
+                    onPressed: () => controller.loadMoreReplies(comment.id),
+                    child: Text(AppLocalizations.of(context)!.loadMore),
+                  ),
+              ],
+            ),
+          ),
+        const Divider(height: 1),
+      ],
+    );
+  }
+
+  Future<void> _toggleReplies(BuildContext context) async {
+    if (controller.repliesExpanded(comment.id)) {
+      controller.hideReplies(comment.id);
+      return;
+    }
+    await controller.loadReplies(comment.id);
+  }
 }