diff --git a/docs/plans/2026-10-21-K86-comments-sheet.md b/docs/plans/2026-10-21-K86-comments-sheet.md new file mode 100644 index 0000000..f154693 --- /dev/null +++ b/docs/plans/2026-10-21-K86-comments-sheet.md @@ -0,0 +1,59 @@ +# K86 评论面板按参考图重做实施计划 + +## 目标 + +仅调整 ReelShort 客户端评论面板和评论行视觉,使顶部标题、评论元信息、回复入口和底部输入区接近参考图;不修改后端接口、控制器数据逻辑或评论业务能力。 + +## 范围 + +- `lib/pages/player/widgets/drama_comments_sheet.dart` +- `lib/pages/player/widgets/comment_tile.dart` +- `test/comment/drama_comments_sheet_test.dart` +- 必要的 PROGRESS 留痕 + +## 实现计划 + +1. 顶部栏 + - 删除拖拽把手和剧名行。 + - 左侧放置 44x44 向下箭头,保留 `player-comments-close`,点击关闭面板。 + - 中间使用现有 `commentsWithCount` / `comments`,16px、w600、`AppColors.onSurface`,保留 `comment-count-label`。 + - 右侧留空,保持标题视觉居中。 + +2. 评论行 + - 头像改为 40px,回复行 28px;文字区左间距 12。 + - 昵称 12px muted、正文 16px cream、行高 1.4。 + - 时间与回复入口组合为灰色元信息行,时间继续使用 `formatLocalizedDateTime`。 + - 删除点赞按钮、心形图标与数字展示,控制器点赞逻辑保留但不绑定 UI。 + - 举报/删除入口改为右上角 18px 的更多图标,保留 `comment-menu-{id}` 和现有菜单行为。 + - 去除行间分隔线,调整上下留白为 12/14。 + +3. 回复 + - 展开/收起回复使用 12px muted 文本,前面增加 16x1 的 border 色短横线。 + - 展开后的回复沿用相同评论行样式,并通过 40px 头像宽度加 12px 间距与正文对齐。 + +4. 输入区 + - 输入框改为 44px 高、22px 圆角、`AppColors.commentInput` 底色。 + - 保留登录提示、回复态 banner、橙色 38px 发送按钮及 `comment-post` Key。 + - 保持现有键盘避让和面板高度 clamp。 + +5. 状态与交互 + - 保留加载、错误、空态、待审核、展开回复、翻页、回复、删除、举报和发送逻辑。 + - 保留登录闸、自动聚焦和登录后输入框聚焦行为。 + +## 测试 + +- 删除依赖 `comment-like-10` 的点赞展示用例。 +- 断言不存在任何 `comment-like-*` 按钮或心形计数。 +- 断言 `player-comments-close` 可关闭面板。 +- 断言标题居中、字号和字重符合规格。 +- 断言头像、正文、元信息、回复入口、输入框与发送按钮尺寸。 +- 保持既有评论分页、登录、发布、展开回复、删除和举报用例通过。 + +## 门禁与 Git + +- ReelShort 从 `develop` 创建 `fix/comments-sheet-style`。 +- 提交:`fix(player): 评论面板按参考图重做`。 +- 作者:`Zhou Weidong <502333560@qq.com>`。 +- `--no-ff` 合回 ReelShort `develop` 并 push,不使用 force push,不执行 `git add -A`。 +- 门禁:`dart analyze lib test` 零告警、`flutter test` 全过。 +- 不安装真机;完成后等待用户验收。 diff --git a/docs/plans/PROGRESS.md b/docs/plans/PROGRESS.md index ca95fdc..5b16035 100644 --- a/docs/plans/PROGRESS.md +++ b/docs/plans/PROGRESS.md @@ -22968,3 +22968,29 @@ $ flutter test - 定向安全链测试通过:`Tests run: 1, Failures: 0, Errors: 0`。 - 功能提交:`7579d31 fix(security): 放行评论数接口匿名访问`。 - 完整门禁通过:JDK 21 下 14 个模块 `BUILD SUCCESS`,app-api `Tests run: 69, Failures: 0, Errors: 0`;全仓仅保留既有 ffmpeg smoke 用例 1 条环境跳过。 + +## 2026-10-21 ReelShort:K86 评论面板按参考图重做 + +- 计划文档:`docs/plans/2026-10-21-K86-comments-sheet.md`,计划提交 `76d6cc9`。 +- 功能分支:`fix/comments-sheet-style`,从 ReelShort develop `bdd3a53` 创建。 +- 功能提交:`7862e0b fix(player): 评论面板按参考图重做`。 +- develop 合并提交:`22cb74d merge: 合并 K86 评论面板重做`,已推送 `bdd3a53..22cb74d`。 +- 顶部删除拖拽把手和剧名行,改为左侧 44x44 向下箭头、居中 16 w600 评论数标题;关闭箭头保留 `player-comments-close`,标题保留 `comment-count-label`。 +- 评论行改为 40 圆头像(回复 28)、12 muted 昵称、16 cream 正文;时间与回复合并为灰色元信息行,更多菜单移至右上角 18px 横向三点。 +- 评论点赞按钮、心形和数字全部从 UI 移除,`CommentController` 的点赞能力保持不动;所有 `comment-like-*` Key 已消失。 +- 展开/收起回复改为 12 muted 文本、16x1 border 短横线和灰色箭头;展开回复缩进到正文列,取消评论行分隔线。 +- 底部输入区改为整宽 44 高、22 圆角 commentInput 胶囊,右侧橙色发送按钮 38;登录提示、回复态 banner、键盘避让及面板高度 clamp 保持。 +- 测试专项 17 条通过,新增无点赞控件、向下箭头关闭、标题居中及新尺寸断言;删除原依赖 `comment-like-10` 的展示用例。 + +门禁原始输出: + +```text +$ dart analyze lib test +Analyzing lib, test... +No issues found! + +$ flutter test +00:47 +497: All tests passed! +``` + +解读:ReelShort 静态检查零告警,497 条测试全部通过。未安装真机,等待用户验收。