# K98 修复登录与手机号登录键盘遮挡

## 目标

- 登录/注册页在邮箱或密码框聚焦后，自动滚动到键盘上方。
- 手机号登录弹窗的手机号/验证码框同样保持可见。
- Android `adjustNothing` 下通过既有 MethodChannel 获取键盘高度，iOS 使用实时
  `MediaQuery.viewInsets`。

## 分支

- ReelShort：`fix/k98-auth-keyboard`，从最新 `origin/develop` 创建。
- FruitServer 仅写计划与 PROGRESS 留痕，不改后端功能代码。

## A. 有效键盘高度

在 `keyboard_inset.dart` 增加：

```dart
double effectiveKeyboardInset(
  BuildContext context,
  KeyboardInsetNotifier notifier, {
  double maxRatio = 0.6,
});
```

- 取 MediaQuery viewInsets 与 Android channel 逻辑像素值的最大值。
- Web/非 Android 不读取 channel。
- 超过屏幕高度 60% 时按 0 处理，负值/非法值归零。

## B. AuthPage

1. `initState` 启动 `KeyboardInsetNotifier`，监听并用 setState 刷新。
2. `SingleChildScrollView` 增加 `ScrollController`。
3. 底部 padding 使用固定底部留白 + effectiveKeyboardInset。
4. 邮箱/密码 FocusNode 监听焦点；聚焦或键盘高度变化后：
   - 通过 FocusNode.context 的 RenderBox 获取字段全局底边。
   - 与屏幕高度 - 键盘高度 - 24 比较。
   - 被遮挡时用 200ms easeOutCubic animateTo 补足滚动。
5. `resizeToAvoidBottomInset` 保持 false。

## C. PhoneAuthSheet

1. 接入 KeyboardInsetNotifier 和 ScrollController。
2. 底部 padding 改用 effectiveKeyboardInset。
3. 手机号/验证码 FocusNode 增加与 AuthPage 相同的焦点/键盘变化滚动校正。
4. 保持现有 SingleChildScrollView、弹窗和返回键行为。

## D. 测试

- iOS viewInsets=300：登录密码框、注册密码框均在键盘上方。
- Android platform + MethodChannel 键盘高度：密码框仍在键盘上方。
- iOS：手机号弹窗验证码框在键盘上方。
- 所有平台 override 测试返回前显式恢复
  `debugDefaultTargetPlatformOverride = null`。

## 门禁

- `dart analyze lib test`
- `flutter test`
- `flutter build apk --debug`

## Git

- ReelShort 提交：`fix(auth): 登录注册与手机号登录键盘避让`
- 作者 `Zhou Weidong <502333560@qq.com>`；禁止 `git add -A`。
- `--no-ff` 合回 `develop` 并 push，两仓库 PROGRESS 留痕。

## 约束

- 全程中文；不改后端、ReelShortWeb、specs。
- 不改评论输入框已验证的 Android pinned 策略。
- 不安装或操作真机；完成后停住等待验收。