b8f1f82ee5
Some checks failed
CI / Lint (push) Has been cancelled
## 问题 旧版 Flutter 项目在 /vcode/check 返回 30164 时展示二级密码输入界面； 新版完全缺失此路径，有二级密码的账号无法登录。 ## 改动 ### networks_sdk - `networks_sdk_method_channel_datasource.dart`：executeRequest 的 generic catch 改为 rethrow，允许 decodeResponse override 抛出 自定义业务异常（原为 ApiError.unknown 包裹导致数据丢失） ### 数据层 - `errors.dart`：新增 `secondaryPasscodeRequired = 30164` - `exceptions.dart`（新增）：`SecondaryPasscodeRequiredException` 携带 vcodeToken / recoveryEmail / hint / resetStatus - `verify_otp_request.dart`：override decodeResponse，拦截 30164， 从响应 data 提取字段，throw SecondaryPasscodeRequiredException - `login_request.dart`：新增可选 password 字段 + toJson override （条件序列化，null 时不带 password 字段） - `auth_repository.dart`：新增 loginWithPasscode() 接口 - `auth_repository_impl.dart`：实现 loginWithPasscode() ### 业务层 - `login_usecase.dart`：新增 loginWithSecondaryPasscode() （MD5 哈希 passcode → 调 AuthRepository.loginWithPasscode） - `pubspec.yaml`：新增 crypto: ^3.0.6（用于 MD5） ### UI 层 - `login_state.dart`：新增 LoginStep.secondaryPasscode + vcodeToken / passcodeHint / recoveryEmail 字段 - `login_view_model.dart`：verifyAndLogin 捕获 SecondaryPasscodeRequiredException 跳转步骤 3；新增 verifyPasscode() - `login_secondary_passcode_step.dart`（新增）：密码输入 UI（hint 显示、 obscured 输入框、错误提示、忘记密码占位） - `login_page.dart`：switch 路由接入 LoginStep.secondaryPasscode
SDK 開發流程
IDE 開啟方式
請開啟 SDK 項目，不要直接開啟主項目或是根目錄。
- 範例：開發
networks_sdk，請開啟packages/networks_sdk
操作流程
- 開發：在功能分支開發，開發完成後手動更新
pubspec.yaml的版本號。 - 審核：提交 PR，通過測試與 Code Review，合併進入
dev分支。 - 發布：
- 執行
melos run publish:sdk -- <sdk-name> <version>- 範例：
melos run publish:sdk -- networks_sdk v1.1.0
- 範例：
- 執行
- 完成：Tag 已推送到遠端，其他專案可以引用該 Tag。
特殊情況
在一些緊急情況，或是特別難單獨在sdk解決的問題，必須跟主項目一起操作才能重現時， 可以透過指令執行： melos bootstrap:dev
執行後會產生一個 pubspec.overrides.yaml 的檔案，會自動鏈結所有項目強制讀取這個yaml 此時主項目中pubspec.yaml的sdk標籤引用會失效，會直接讀取sdk本地內容，可以幫助解決問題。
注意
如果使用特殊情況開發，開發完後，必須遵守：
- 執行 melos bootstrap:clean 刪除pubspec.overrides.yaml 的檔案(不可提交到gitea)
- 一樣必須走開發流程，不可主項目修改程式與sdk修改提交到同個commit。