呆呆面板 Flutter

呆呆面板 Flutter 是面向 Android 和 iOS 的移动端客户端，用于连接呆呆面板服务并在手机端管理定时任务、脚本、环境变量、依赖、安全设置和开放 API。项目基于 Dumb-Panel-APP 演进而来，采用 Riverpod 状态管理和 GoRouter 路由，提供低 GPU 占用的 Pure Flat 默认界面与可选的 Liquid Glass 视觉风格。

本仓库遵循开放协作原则，欢迎提交 Issue、讨论和 Pull Request。项目保留上游作者署名，并在 第三方开源声明 中列出主要依赖及许可证信息。

• App 版本：v1.0.1
• Dart SDK：>=3.11.3
• 适配面板：旧版至 v3.0.1+，增强功能按实际端点能力自动降级

• 修复 Liquid Glass 主题下环境变量卡片透明时，关闭状态仍会折射显示侧滑启用、禁用和删除按钮的问题。
• 侧滑操作层仅在卡片实际向左露出的区域内绘制，保持玻璃背景效果和操作按钮视觉隔离。
• 卡片位移与操作层裁剪使用同一吸附动画，避免展开、收起和返回手势收起期间出现按钮闪现。
• Android 继续沿用 v1.0.0 固定 JKS 证书，支持覆盖升级；iOS 继续提供无签名 IPA。

• Android 正式包启用固定 JKS 签名，发布链校验证书格式、算法、有效期和 SHA-256 指纹。
• v1.0.0 作为固定签名安装基线，后续版本可沿用同一证书覆盖升级。
• iOS 继续提供无签名 IPA，供持有 Apple 签名材料的使用者重新签名。
• 延续 v0.1.65 的上游能力对齐、会话隔离、SSE 续传和错误恢复加固。

• 完整保留 Multi-Cron 任务表达式、模板分组、面板时区和未知服务端枚举值。
• 引入 Session Epoch 与 Panel Scope，隔离认证、Token 刷新、REST、SSE 和跨面板页面状态。
• 增强 SSE 断线续传、事件 ID 去重、退避重连、生命周期暂停和终态处理。
• 完善任务、通知、订阅、用户、脚本、备份、Open API 等页面的错误恢复与重试。
• 增强原始日志票据续期、临时分享、文件保存和清理流程。
• 增加增强管理端点能力降级、HTTP/HTTPS 自动互试和全局任务完成通知。
• 环境变量卡支持左滑启用、禁用和删除，返回手势优先收起操作区。
• v0.1.65 提供临时证书 Android APK 与无签名 iOS IPA，并关闭跨签名自动更新和差分包。

• 新增按面板 URL 隔离的能力档案，通过实际端点响应识别任务视图、面板设置、版本信息和多 Python runtime 支持状态。
• 旧面板返回 404 或 405 时自动隐藏对应增强入口；超时、断网和 5xx 保留后续重试能力。
• 仪表盘优先展示系统与任务核心数据，面板标题和版本信息改为后台补充。
• 任务列表不再等待任务视图探测，依赖列表与 Python runtime 并行加载并减少重复计数请求。
• HTTP 与 SSE 认证请求使用进程内 Token 快照，减少安全存储平台通道访问。
• 并发 401 共享 Token 刷新结果，积压请求并发重放，并阻止旧面板响应清理新面板会话。
• 登录和可信会话恢复后由目标页面负责首次加载，消除重复仪表盘请求。
• 切换面板时统一失效主要页面 Provider，避免短暂显示上一面板数据。

• 修复 Pure Flat 主页面顶部状态栏区域显示黑边的问题。
• 页面纯色或背景图延伸至系统状态栏下方，业务内容继续遵守安全区。
• 状态栏保持透明，并根据浅色、深色主题自动切换系统图标亮度。
• 保持 Pure Flat 低占用路径，不增加 AppBar、半透明遮罩、模糊或玻璃渲染层。
• 增加状态栏背景层级、系统样式和零玻璃组件回归测试。

• 实时日志统一使用有界内存缓冲，同时限制行数和字符量，改善长时间运行时的内存占用。
• 修复日志自动刷新、分页和筛选请求竞争，页面进入后台时暂停周期轮询，恢复前台后按需刷新。
• Pure Flat 应用锁改用不透明遮罩，Liquid Glass 主框架减少页面级捕获层级。
• 背景图片按屏幕物理尺寸解码，并使用静态图片滤镜处理模糊，降低 GPU 与图片内存成本。
• 任务日志历史回放改用游标去重，避免大日志场景中的重复头部移动。
• Android Root 子进程移至后台执行器，并发读取输出流，增加超时和资源释放保护。

• 新增 Pure Flat 纯扁平视觉风格，并设为新安装及升级后的默认风格。
• Pure Flat 使用 Material 控件、不透明内容表面和无模糊背景原图，降低常用页面的 GPU 渲染负担。
• 主题设置支持在 Pure Flat 与 Liquid Glass 间切换，视觉风格与浅色、深色、跟随系统模式相互独立。
• Liquid Glass 保留背景模糊、折射和现有玻璃控件，切换后继续使用已保存的模糊强度。
• 增加视觉状态持久化、启动加载竞态和双渲染路径回归测试。
• 修复 Liquid Glass Slider 可空参数的编译兼容问题。

• 此标签的构建在质量门禁阶段发现编译兼容问题，正式安装包由 v0.1.61 提供。

• 修复 HTTPS 域名场景下登录长时间无响应的问题。
• 增强 TLS、DNS、连接超时和面板健康响应诊断。
• 优化首次连接的初始化状态检查与登录阶段提示。

• 完成 daidai-panel v3.0.1 上游契约兼容与数据安全更新。
• 修复任务和环境变量导入，补齐终止状态、通知配置、订阅鉴权与动态系统配置。

• 移除未完成的 Android 本地面板实验功能，App 保持为远程面板客户端。
• 启动流程统一使用用户配置的面板地址。
• 修复依赖日志错误终态、自动重连提示和长日志内存持续增长问题。

• 修复 Android 多次更新后 APK、差分包和下载残片持续占用缓存空间的问题。
• App 冷启动、开始更新、更新失败及安装器返回时自动清理更新缓存。

• 清理剩余行为型 Analyzer 问题，补齐异步上下文生命周期保护。
• 迁移 Flutter 下拉表单弃用 API，并清理用户卡冗余上下文与引用字段。

• 继续修复启动登录生命周期、通知深链、任务视图、配置脚本和 Android Runtime 状态问题。
• 迁移 14 处 Flutter 弃用下拉 API，进一步清理冗余上下文和字段。

• 完成 SSE、认证刷新、更新安装、分页、权限路由和通知深链稳定性加固。
• 重构 Android Runtime、任务视图、config.sh 和环境高级工具状态管理。
• 清理无引用导入、变量和环境变量旧方法，Analyzer 问题显著减少。

• Dashboard 自动更新检查调整为每 24 小时最多一次，同版本自动提醒每天最多一次。

• 主动更新检查可区分网络失败、最新版本、发现更新和 Release 缺少安装包。

• 本地任务通知支持点击跳转对应任务日志，兼容前台、后台和冷启动场景。

• 完成剩余日志状态、Dashboard 指标、本地通知图标和应用锁状态的透明语义色统一。

• 修复环境变量详情和全局弹层表面过透明、背景遮罩过度压暗问题。
• 任务“已启用”等状态徽标改为低透明语义玻璃色。
• 同步修复依赖、订阅、Cron、元数据和日志状态标签的浅色实底。

• 第二阶段新增平台令牌、高级配置脚本和 Android/Magisk 运行时管理。
• 新增 pip/npm 实际依赖清单与环境变量高级工具。
• 完成后端现有能力两阶段移动端映射。

• 第一阶段新增个人资料、头像、用户名与密码管理。
• 新增系统健康诊断和服务端任务自定义视图。
• 增加客户端角色路由守卫与共享 Loading/Empty/Error 状态。

• 完成 Android bsdiff 差分升级正式发布，并兼容 Android 23–27 的已安装 APK版本信息读取。
• Release 自动发布完整 APK、差分 patch 和固定地址 android-update.json。
• 补充 XeonBsDiff 第三方开源声明。

• Android 支持 GitHub 静态 JSON 驱动的 bsdiff 差分增量升级。
• 差分包通过原生后台 bspatch 与已安装 APK合并，完成后唤起系统安装器。
• 补丁和目标 APK执行文件大小、MD5 与 SHA-256 校验，异常时自动回退完整 APK。
• GitHub Actions 自动生成、反向验证并发布差分包与 android-update.json。

• 定时任务页搜索、批量、排序、筛选、任务卡操作和底部操作区域统一为底部导航同款 Liquid Glass 材质。
• 降低全局原生按钮浅色背景不透明度，修复其他页面同类白色及偏白实底按钮。
• 保留按钮文字、图标、尺寸、点击区域、业务回调和危险操作语义。

• 统一弹窗、底部面板、信息预览、SSH 公钥和应用锁图案点位的 Liquid Glass 风格。
• 任务菜单“日志文件”改为结构化文件列表，可点击进入对应日志详情。
• root 二级页面使用无过渡导航和稳定首帧背景，修复更多页跳转时整屏闪烁。

• 修复认证刷新、SSE 重连、应用锁初始化、异步生命周期和请求竞态问题。
• 为订阅、依赖、安全日志和 Open API 日志补齐分页加载。
• 提升环境变量窄屏、键盘弹出和 Liquid Glass 滚动性能表现。
• 增加 API 解析回归测试与 Flutter Analyze/Test CI 质量门禁。

• 移除任务展开卡片中无效的“禁用 / 更多 / 删除”模糊侧滑按钮和整套侧滑手势状态。
• 任务卡恢复为单一点击/长按 Lens，保留运行/停止、状态、Cron 和订阅信息。
• 环境变量卡增加稳定间距和圆角裁剪，限制长值与备注行数，修复卡片紧贴和视觉重叠。

• 完成全应用 liquid_glass_easy 3.3.1 原生控件、交互动作和弹层迁移。
• 任务主卡、侧滑操作条、应用锁面板和高价值对话框统一为真实 Liquid Glass Lens。
• 全仓业务提示统一使用玻璃浮动通知，完整卡片和可点击表面统一使用共享 Lens 组件。
• Android/iOS Release 构建与 Shader 资产验证通过。

完整历史更新见 GitHub Releases。

• 玻璃效果：安全设置中的登录日志和在线会话列表改用真实 GlassCard 渲染，提升深色模式和快速滚动下的视觉一致性。

• 玻璃效果：通知渠道列表改用真实 GlassCard 渲染，提升深色模式和快速滚动下的视觉一致性。

• 深色模式：将暗色玻璃主题从白色高光玻璃调整为深色玻璃基底，更符合深色模式定义。
• 深色模式：提高卡片和输入框暗色底色不透明度，改善主页面和一级页面列表卡片对比度。
• 玻璃效果：滚动列表中的 GlassCard 明确固定为 standard 质量，减少快速滑动时玻璃效果变透明的问题。

• 玻璃效果：用户管理列表改用真实 GlassCard 渲染，提升深色模式和快速滚动下的视觉一致性。
• 稳定性：补充任务列表 GlassCard 所需 Liquid Glass 导入，确保任务列表玻璃层构建通过。

• 玻璃效果：任务列表卡片采用低风险 AnimatedContainer + GlassCard 包裹结构，保留左滑动画并增强液态玻璃稳定性。
• 稳定性：修复上一轮任务列表真实玻璃改造引入的构建语法问题。

• 主题：修复深色模式下主页面及一级页面卡片底色偏浅、对比不足的问题。
• 玻璃效果：固定滚动列表玻璃质量为 standard，关闭自适应质量自动降级，避免快速滑动时卡片看起来失去液态玻璃效果。
• 列表：任务列表和环境变量列表改用真实 GlassCard 渲染，替换伪玻璃 Container 背景。

• 清理：删除未使用的 AuthService.changePassword() 方法。
• 清理：删除未使用的 ApiEndpoints.password 常量。

• 通知：自定义通知渠道配置 JSON 解析失败时会阻止保存并提示格式错误。
• 清理：移除 main.dart 中未使用的导入，降低 analyzer warning 风险。

• 清理：删除 AuthService 中已被各功能模块 provider 替代的 legacy API 包装代码。
• 清理：删除未使用的 ApiEndpoints 常量，减少旧接口误用风险。

• 日志流：SSE 认证刷新失败时主动释放连接资源，避免认证失效后残留连接。
• 更新：安装包下载改为临时文件校验成功后再替换正式缓存，弱网失败时不破坏旧缓存。
• 通知：iOS 启动初始化阶段不再主动申请通知权限，仅在用户点击请求权限时弹窗。
• Open API：调用日志分页加载增加最大页数与重复页保护，避免异常 total 导致连续请求。
• 环境变量：排序模式会保存所有拖拽步骤，避免连续拖动后只提交最后一次移动。

• 兼容性：将 DropdownButtonFormField.initialValue 全部替换为 value，兼容更多 Flutter 稳定版。
• 任务：编辑历史任务时，已保存但当前运行时不可用的 Python 版本会保留为可选项，避免下拉值不匹配崩溃。
• 日志流：SSE 解析支持 CRLF 行尾，修复实时日志可能不刷新的问题。
• 登录：初始化管理员失败时停止后续登录流程，保留初始化状态并显示明确错误。

• 应用锁：后台返回触发锁定时改用根 ProviderContainer，不再依赖 rootElement! 强制解包，异常会输出调试日志。
• 架构：标记 AuthService 中旧式功能 API 包装，避免后续新功能误用旧路径或旧 HTTP 方法。
• Open API：调用日志改为自动分页加载全部记录，避免固定 page size 导致日志截断。

• 任务：新增 Cron 模板加载和 Cron 表达式解析预览。
• 任务：新增任务统计和任务日志文件入口。
• Open API：新增获取访问 Token 功能，可通过 App Key/App Secret 获取 24 小时访问令牌。
• 通知：新增主动发送通知入口，可选择渠道并发送自定义标题和正文。
• 系统：新增部署与 Python 运行时状态信息展示。
• 日志流：SSE 支持 Token 过期自动刷新后重连，并按标准 SSE 聚合多行 data 事件。
• 本地通知：权限检查不再触发系统权限申请弹窗，仅在用户点击申请权限时请求授权。
• 环境变量：加载失败时显示明确错误与重试入口。

• 任务：新增任务导入/导出入口，支持保存任务导出文件和从 JSON 文件导入任务。
• 环境变量：新增环境变量导入/导出入口，支持导出全部变量和从 JSON 文件导入变量。
• 登录：本地地址、localhost、内网 IP 默认使用 HTTP 协议，公网地址继续默认使用 HTTPS。
• 更新：下载更新包前校验 Release asset 的文件大小和 SHA256 digest，避免复用旧包或损坏包。
• 仪表盘：核心概览数据与可选接口分离加载，面板设置或版本接口异常时仍可展示仪表盘。
• 文档：新增上游功能与问题候选清单，便于按 P0/P1/P2 继续排期。

• 更新检测：修复安装同版本修复包后仍反复提示更新的问题，去除同版本 published_at 时间回退判定
• 更新检测：保留版本号和 build number 比较，安装当前 Release 后会正确显示已是最新版本
• 发布：重新生成 Android APK 和 iOS IPA 安装包，Release 与仓库说明同步更新

• 主题：移除经典风格，全部页面统一使用液态玻璃效果；全局 LiquidGlass theme 配置对齐 iOS26 ultraThickMaterial 材质（light: thickness=32/blur=12, dark: thickness=48/blur=18）

• 导航：主脚手架使用 LiquidGlassScaffold，底部选项卡使用 LiquidGlassBottomNavBar 折射材质

• 界面：恢复主题设置中的背景图片选择器和模糊强度滑块（0-20 可调）

• 界面：统一全部二级/三级页面卡片背景使用 glassCardColor，移除硬编码 Colors.white/slate900

• 架构：清理 glassMode 状态字段和所有条件分支，减少 200+ 行冗余代码

• 应用锁：开启开关时要求先配置解锁方式，未配置时引导用户前往设置

• 主题：修复经典模式下背景图片被过度模糊遮盖导致不可见问题

• 环境变量：列表卡片布局优化，增大文字和间距，长值自动折行（maxLines 2→8）

• 依赖管理：卡片扩容（padding 10→14），状态/版本/副标题字体增大，间距优化

• 任务列表：状态标签、底部时间、计划摘要字体和间距全面上调

• 用户管理：角色标签、登录/创建时间字体上调，行间距增加

• 日志/订阅/通知：统一调优辅助文字字体大小和行间距

• 应用锁：修复生物识别验证失败后界面卡死问题，静默失败时自动切换到密码/图案解锁
• 应用锁：修复仅开启生物识别时可能导致的 lockout 风险
• 界面：修复液态玻璃模式下滑动时底部选项卡变透明问题
• 通知：添加后台通知回调处理和 AppLifecycleObserver，修复后台运行时不推送通知问题
• 安全：添加 WidgetsBindingObserver 监听应用生命周期，切回前台自动触发二次验证

• 安全中心：新增登录统计和审计日志 Tab，当前共 6 个 Tab
• SSH 密钥管理：新增 SSH Key 增删改查页面，支持在订阅中关联 SSH Key 进行 Git 认证
• 订阅管理：创建/编辑订阅时新增 SSH Key 下拉选择器
• 面板设置：新增可视化面板外观配置页面（标题、图标、编辑器/日志背景色）
• 脚本调试：新增 _runCode() 代码直接执行和 _clearRun() 清除运行记录
• 登录诊断：健康检查失败时显示 CORS / NAS 反向代理配置指引，HTTP 状态码异常时给出友好提示
• 移除 android-native/ 和 ios-native/ 原生模块

• 初始版本，提供 14 个功能模块的完整管理能力

lib/
  core/        -- 基础设施层：认证、网络、存储、主题、路由、系统服务
  features/    -- 功能模块层：每个模块含 views / providers / widgets
  shared/      -- 共享层：数据模型、工具类、公共 UI 组件

UI (Views) -> Riverpod Providers -> AuthService / DioClient -> REST API
                                                     \-> SSE Client -> Stream

• Views：用户界面层，Flutter Widget 构建
• Providers：Riverpod 状态管理，负责数据获取、缓存与业务逻辑
• Services：与后端通信的 API 封装层，包括 REST（Dio）和 SSE 流式推送
• Storage：flutter_secure_storage + SharedPreferences 双层持久化

使用 GoRouter 声明式路由，通过认证守卫控制访问权限。底部导航栏 5 个 Tab：仪表盘、任务、日志、环境变量、更多。

Material 3 主题 + liquid_glass_easy 3.3.1 实时折射液态玻璃风格。主界面使用 LiquidGlassScaffold 和 LiquidGlassBottomNavBar，内容组件使用 LiquidGlassLens，支持 Impeller/Skia、浅色/深色模式、自定义背景图片和模糊强度调节。

所有版本见 GitHub Releases。

启动 App 后在登录页填写面板地址：

• 面板地址示例：https://panel.example.com
• 常规接口：/api
• 流式接口：/api/v1

flutter pub get
flutter analyze
flutter test
flutter build apk --release
flutter build ios --release --no-codesign

推送到 main、master 或 flutter-app 分支会触发 build.yml，完成质量检查并生成 CI 使用的 APK 和 IPA artifacts。分支构建不生成正式差分更新资产。

推送与 pubspec.yaml 版本一致的 v* 标签会触发 release.yml。Release 工作流要求配置 ANDROID_KEYSTORE_BASE64、ANDROID_KEYSTORE_PASSWORD、ANDROID_KEY_ALIAS、ANDROID_KEY_PASSWORD 和 ANDROID_CERT_SHA256 五项 GitHub Actions Secrets；任一项缺失都会终止正式 Android 构建。工作流验证 JKS 证书属性及 APK 签名指纹，发布固定证书签名 APK 和无签名 IPA。当前自动更新清单与差分包保持关闭，v1.0.0 作为固定 Android 签名的安装基线。

android-build.yml 和 ios-build.yml 用于手动触发单平台构建；build.yml 用于分支与 Pull Request 的统一 CI 构建；release.yml 专用于标签正式发布。

本项目是社区维护的开源客户端，基于以下项目和开源生态构建：

• Dumb-Panel-APP -- 原始 Flutter 客户端，提供核心功能模块和 UI 设计；上游仓库当前未检测到独立 LICENSE 文件，使用和分发前请核对上游声明
• daidai-panel (MIT) -- 呆呆面板后端服务，提供 API 接口和数据模型
• Flutter (BSD-3-Clause) -- Google 的跨平台 UI 框架
• Riverpod -- Dart/Flutter 响应式状态管理库
• GoRouter -- Flutter 声明式路由库
• Dio -- Dart HTTP 客户端
• fl_chart -- Flutter 图表库
• Liquid Glass Easy (MIT) -- 实时折射液态玻璃 UI 组件库
• flutter_secure_storage -- Flutter 安全存储
• local_auth -- 本地生物认证
• webview_flutter -- Flutter WebView

完整依赖、来源与许可证清单见 docs/THIRD_PARTY_NOTICES.md。依赖库的商标、版权和许可证归各自权利人所有。

• 提交问题前请先搜索已有 Issue，并提供版本、平台、复现步骤和日志。
• 代码贡献请参阅 CONTRIBUTING.md。
• 安全问题请参阅 SECURITY.md，避免在公开 Issue 中披露敏感细节。

MIT License