commit cc6b6c54aaeba19797856f6727373c2b037567b5 Author: zhy200308 <2258391712@qq.com> Date: Mon Aug 17 13:40:53 2026 +0800 首次提交,未改动文件 diff --git a/README.md b/README.md new file mode 100644 index 0000000..350e616 --- /dev/null +++ b/README.md @@ -0,0 +1,67 @@ +# 📱 核心 UI 翻新与重构体系 (UITask 原型车间) + +> **⚠️ 智能体请注意 (Agent Prompt & Protocol)**: +> 如果您被唤醒并要求接手本目录的 UI 任务,**请不要一上来就盲目生成代码!** +> 您必须充当“UI 架构师”的角色,严格按照以下的 **“一步一答 (Step-by-Step) 交互式协议”** 引导人类用户完成工作流。您的最终目标是集齐 7 件标准物料。 + +## 🔄 您的交互式工作流 (Step-by-Step Protocol) + +当您(新手智能体)被人类协作者唤醒,并收到这张 README 时,请按顺序执行以下 6 个步骤。**每完成一步,必须停下来等待用户的回复,严禁抢跑**: + +### 📁 Step 1: 确定界面归属与建仓 (防覆盖) +- **您的动作**:询问用户:“请问本次重构属于哪个界面?是否是某个主界面下的子界面(例如:主界面/侧滑抽屉)?” +- **执行**:根据用户的回答,自动在 `.agents/UITask/` 下为您创建对应的物理文件夹路径。 +- **⚠️ 强制规则**:为了防止覆盖过往版本,创建的文件夹必须带有当天的日期后缀(例如:`UITask/用户管理界面-20260816/`)。 + +> **🌟 AI 能力自检探针 (Capability Check)** +> 在执行前,请 AI 评估自身当前具备哪些具体的 Tool/API 权限,并据此调整策略: +> - **文件读写能力**:能否在后台静默创建文件/目录并打包ZIP?(有则静默创建,无则转为纯对话指导模式) +> - **附件提取能力**:能否将人类发在聊天框里的**多媒体图片附件**直接转化为本地磁盘文件?(⚠️注意:绝大多数代码助手仅能读写文本,无法提取图片二进制流。**若无提取图片的 Tool,必须在涉及图片的步骤请求人类协助**)。 +> - **文件访问透明度**:人类能否直接在电脑上双击打开你写的文件?(如本地 IDE 插件可以;如果是云端沙盒,则需你在聊天框打印 HTML 代码供其复制)。 + +### 📷 Step 2 & 3: 获取视觉资产 (原图与效果图) +- **您的动作 (基于能力)**: + - **若有图片提取能力**:直接提取聊天框里的图片,静默保存为 `actual_ui.png` 和 `target_style.png`。 + - **若无图片提取能力 (最常见情况)**:向人类承认限制:“长官,由于我目前无法直接下载聊天附件,请您帮忙将原图存为 `actual_ui.png`,期望图存为 `target_style.png`,并放在我刚建好的目录中。存好后请通知我。” +- **交互**:确认图片就位后,再进行下一步。 + +### 💻 Step 4: 编码 HTML 与循环调优 (防死锁) +- **您的动作**:读取那两张图,开始编写 `baseline_ui.html`,完成后由您自动写入该目录中。 +- **交互**:告诉用户该 HTML 文件的本地绝对路径,让用户双击用浏览器打开。 +- **循环**:询问用户哪里有问题,反复修改 HTML 直到用户确认满意。 +- **⚠️ 防死锁警告**:HTML 原型的核心目的是敲定排版结构和颜色 Token。如果您在尝试还原复杂动画或生僻字体时遭遇挫折,请主动放弃像素级的死磕,向用户说明情况并以快速输出图纸为主,切勿陷入无限修改的死循环。 + +### 📸 Step 5: 获取最终定妆照 (final_effect.png) +- **您的动作**:在用户确认 HTML 完美后,请用户在浏览器里截取最终效果图。 +- **动作 (基于能力)**:有图片提取能力则自动保存;无提取能力则指导人类手动保存为 `final_effect.png`。 + +### 📐 Step 6: 自动生成图纸与资产交付 (终局) +- **您的动作**:提取 HTML 里的 CSS 逻辑,生成并保存以下 3 份标准文件: + 1. `DESIGN_SPEC.md` (视觉边界手册) + 2. `implementation_plan.md` (原生映射图纸) + 3. `CARD-YYYYMMDD-UITask-模块名.md` (最终的重构卡片模板) +- **资产终局交付 (基于能力)**: + - **若文件访问透明度高 (本地 IDE)**:输出完整的本地硬盘绝对路径,请用户验货。 + - **若在云端沙盒**:将 7 个文件打包为 ZIP,并提供下载链接/入口。 + - **若是纯聊天环境 (无文件写权限)**:将 3 份 Markdown 文档内容以代码块形式逐个在聊天框中输出,指导用户复制。 + +完成后,再次回到人机循环,等待用户的下一个新指令。 + +### 第一部分:视觉与 HTML 原型 (原型试错) +1. 📷 **`actual_ui.png`**:真实环境中的旧版/老旧界面截图(用于保底,确保任何原有信息槽位绝不丢失)。 +2. 🖼️ **`target_style.png`**:期望的视觉风格参考图。 +3. 🖼️ **`final_effect.png`**:最终定稿的完美 UI 效果图。 +4. 🌐 **`baseline_ui.html`**:**[核心输出]** 您必须手写的 HTML/CSS 源代码。所有排版、颜色、状态机的讨论都在此 HTML 上进行,直到视觉达成完全一致。 + +### 第二部分:约束字典与落地图纸 +5. 📐 **`DESIGN_SPEC.md`**:纯视觉说明手册(涵盖透明度、边界条件、空白状态、截断规则等)。 +6. 🛠️ **`implementation_plan.md`**:原生 Android 施工图纸。必须包含严格的 **CSS-to-Android Token 映射字典**(绝对禁止 XML 硬编码颜色和尺寸)。 + +### 第三部分:执行契约 +7. 📋 **`CARD-YYYYMMDD-UITask-模块名.md`**:最终的重构任务卡片。里面只需简明扼要地标明改动文件,并声明严格遵守 `UI_DEV_GUIDE.md` 即可。 + +--- + +## 🛑 行动准则 +- **只做设计,不碰原生**:您的工作止步于产出这 7 份文件。Android 端的实际修改,由后续的 `@coder` 去根据您产出的这 7 份物料执行。 +- **Token 宪法**:在您编写 `implementation_plan.md` 时,时刻对照同级目录下的 `UI_DEV_GUIDE.md`,把您 HTML 里的 `#FFFFFF` 映射为 `?attr/colorSurface`,把 `12px` 映射为 `@dimen/corner_radius_md`。 diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_142935.png b/ui_baseline/EAPManageUI/Screenshot_20260812_142935.png new file mode 100644 index 0000000..018436a Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_142935.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_142957.png b/ui_baseline/EAPManageUI/Screenshot_20260812_142957.png new file mode 100644 index 0000000..152582d Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_142957.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143005.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143005.png new file mode 100644 index 0000000..cde2db4 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143005.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143022.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143022.png new file mode 100644 index 0000000..b5f53f7 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143022.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143029.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143029.png new file mode 100644 index 0000000..1489505 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143029.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143033.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143033.png new file mode 100644 index 0000000..699fe0a Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143033.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143043.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143043.png new file mode 100644 index 0000000..00cdc94 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143043.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143048.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143048.png new file mode 100644 index 0000000..e1191b3 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143048.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143056.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143056.png new file mode 100644 index 0000000..d3d0898 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143056.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143103.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143103.png new file mode 100644 index 0000000..1866581 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143103.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143127.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143127.png new file mode 100644 index 0000000..f2548d3 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143127.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143232.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143232.png new file mode 100644 index 0000000..4a81da2 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143232.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143239.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143239.png new file mode 100644 index 0000000..c03ccea Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143239.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143248.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143248.png new file mode 100644 index 0000000..7bf1f52 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143248.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143303.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143303.png new file mode 100644 index 0000000..3c5eed0 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143303.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143341.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143341.png new file mode 100644 index 0000000..9d8355c Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143341.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143347.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143347.png new file mode 100644 index 0000000..bee2bd6 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143347.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143357.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143357.png new file mode 100644 index 0000000..b3f1fbe Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143357.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143405.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143405.png new file mode 100644 index 0000000..9684144 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143405.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143413.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143413.png new file mode 100644 index 0000000..f6e34db Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143413.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143424.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143424.png new file mode 100644 index 0000000..6cc5dad Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143424.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143432.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143432.png new file mode 100644 index 0000000..fc8d493 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143432.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143450.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143450.png new file mode 100644 index 0000000..2eb1217 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143450.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143456.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143456.png new file mode 100644 index 0000000..b5bc45e Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143456.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143502.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143502.png new file mode 100644 index 0000000..76b05b5 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143502.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143512.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143512.png new file mode 100644 index 0000000..e98ece5 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143512.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143522.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143522.png new file mode 100644 index 0000000..924ebdb Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143522.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143530.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143530.png new file mode 100644 index 0000000..78f4181 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143530.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143536.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143536.png new file mode 100644 index 0000000..49d310b Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143536.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143552.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143552.png new file mode 100644 index 0000000..ef1e0cf Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143552.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260812_143559.png b/ui_baseline/EAPManageUI/Screenshot_20260812_143559.png new file mode 100644 index 0000000..86e41c4 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260812_143559.png differ diff --git a/ui_baseline/EAPManageUI/Screenshot_20260813_011421.png b/ui_baseline/EAPManageUI/Screenshot_20260813_011421.png new file mode 100644 index 0000000..de0d506 Binary files /dev/null and b/ui_baseline/EAPManageUI/Screenshot_20260813_011421.png differ diff --git a/系统设置界面-20260816/CARD-20260816-UITask-系统设置界面.md b/系统设置界面-20260816/CARD-20260816-UITask-系统设置界面.md new file mode 100644 index 0000000..4a4612b --- /dev/null +++ b/系统设置界面-20260816/CARD-20260816-UITask-系统设置界面.md @@ -0,0 +1,81 @@ +--- +title: "APP界面优化 - 系统设置类页面(语言设置 / 选择版型 / 版本信息 / Logo 授权管理 / 数据上传)" +status: "TODO" +created: "2026-08-16" +level: 1 +--- + +# 任务目标 +对系统设置类 5 张页面执行**纯美化**重构(不改信息架构、不改交互范式、不丢任何字段), +核心解决平板宽屏下"内容顶左上角、右侧大片留白"的排版失衡问题,统一为 840dp 居中内容容器; +同时修复数据上传页三个输入框的物理重叠错位、选择版型页选中态描边逻辑颠倒等具体 Bug。 + +## 开发依据(4 件套约束) +> 🚨 **绝对约束**:请 `@coder` 在修改代码前,**必须必须必须**先阅读以下工作台目录的全部 3 份基准物料, +> 并同步阅读全局公约 `../BEAUTIFY_BASELINE_20260816.md` 与 Token 宪法 `../UI_DEV_GUIDE.md`。严禁自行发挥 UI 排版! +> +> **工作台路径**:`.agents/UITask/系统设置界面-20260816/` +> 1. `baseline_ui.html`:**[必读]** 终极 HTML 排版基准源代码,5 个 `
` 对应 5 屏,顶部 `:root` 为全量 Token 声明。 +> 2. `DESIGN_SPEC.md`:**[必读]** 视觉边界手册 —— 840dp 栅格规范、五屏逐项差异点、状态机、截断规则、最小点击区域、与公约的差异声明。 +> 3. `implementation_plan.md`:**[必读]** CSS→Android Token 映射字典 + 已实际检索确认的落地文件清单 + 风险/待确认项。 +> +> **原始截图**(未复制,相对路径引用,`@coder` 核对信息槽位用): +> - `../ui_baseline/EAPManageUI/Screenshot_20260812_143341.png`(语言设置) +> - `../ui_baseline/EAPManageUI/Screenshot_20260812_143347.png`(选择版型) +> - `../ui_baseline/EAPManageUI/Screenshot_20260812_143456.png`(版本信息) +> - `../ui_baseline/EAPManageUI/Screenshot_20260812_143502.png`(Logo 授权管理) +> - `../ui_baseline/EAPManageUI/Screenshot_20260812_143450.png`(数据上传) + +## 涉及文件(详细改动点见 `implementation_plan.md` §2,此处仅列清单) + +**Layout** +- `app/src/main/res/layout/activity_language_settings.xml` +- `app/src/main/res/layout/activity_edition_selection.xml` +- `app/src/main/res/layout/activity_version_info.xml` +- `app/src/main/res/layout/activity_logo_management.xml` +- `app/src/main/res/layout/activity_data_upload.xml` + +**Java / Activity / ViewModel** +- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/language/LanguageSettingsActivity.java` +- `app/src/main/java/com/umilab/eapmanage/team/edition/EditionSelectionActivity.java` +- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoActivity.java` +- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoViewModel.java` +- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementActivity.java` +- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementViewModel.java` +- `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/upload/DataUploadActivity.java` + +**资源(新增 Token / 样式 / drawable)** +- `app/src/main/res/values/dimens.xml`(新增 `content_max_width`、`settings_form_label_width`、`settings_row_height`) +- `app/src/main/res/values/colors.xml`(核对 `color_secondary_container` 取值) +- `app/src/main/res/values/themes.xml`(新增 `Widget.EAPManage.Button.Segmented`,补充 Toolbar `titleTextAppearance`) +- 新增 `app/src/main/res/drawable/selector_language_row_bg.xml` +- 新增 `app/src/main/res/drawable/shape_badge_error.xml`、`shape_badge_success.xml` + +## 执行步骤清单 +1. **840dp 居中容器**:按 `DESIGN_SPEC.md` §1 落地统一栅格规范,5 屏全部收敛;语言设置页保持"外层通栏可点、内层视觉居中"的双层结构(`implementation_plan.md` §3.2)。 +2. **修复数据上传页三输入框重叠错位**:`ConstraintLayout` 改写为竖向 `LinearLayout` + 四行横向两列结构(`implementation_plan.md` §2.5),标签列固定 140dp。 +3. **修复选择版型页选中态描边颠倒**:两张卡的 `strokeColor`/`strokeWidth`/圆点 tint 随选中状态动态联动,不再与卡片身份绑死(`implementation_plan.md` §3.3)。 +4. **语言设置**:行高 56dp、选中态背景反馈、分割线缩进对齐。 +5. **版本信息**:三卡标签列统一 140dp 对齐成列;"Debug" 由纯红字降级为徽章;下载更新按钮改为独立动作行。 +6. **Logo 授权管理**:分段控件按公约 §5.6 收口;预览条底色改为 surface+描边;计数器归位到输入框正下方。 +7. **黑色胶囊开关替换**:数据上传页 `SwitchCompat` → `MaterialSwitch`。 +8. 全部页面 AppBar 标题字号/返回箭头间距按公约 §3 统一。 +9. 自查 `DESIGN_SPEC.md` §6 清单逐条过一遍再提交。 + +## 验收标准 +- [ ] 平板横屏下 5 屏内容均为 840dp 居中显示,无"顶左上角+右侧大片留白"现象。 +- [ ] 数据上传页三个输入框标签与框对齐、互不重叠压盖。 +- [ ] 选择版型页:选中卡 = primary 描边 + primary-container 底,未选中卡为中性描边,两卡逻辑一致(不再一蓝一绿颠倒)。 +- [ ] 语言设置页:行高 56dp,选中行有背景反馈,分割线不再通栏到边。 +- [ ] 版本信息页:三张卡标签值对齐成列,Debug 变为浅红底徽章而非纯红字,下载更新按钮有分割线锚定。 +- [ ] Logo 授权管理页:分段控件、预览条、计数器均按 `DESIGN_SPEC.md` §3.4 收口。 +- [ ] 未丢失 `actual_ui.png`(原始截图)中的任何一个信息字段或功能入口。 +- [ ] 无散落十六进制颜色/尺寸,全部引用 `@color/`、`@dimen/`、`?attr/` Token(对照 `UI_DEV_GUIDE.md` §5 清单自查)。 + +## 附:待 @coder 二次确认的风险项(详见 `implementation_plan.md` §4,此处摘要) +1. 公约字号阶梯(15sp/13sp)与仓库现有 `dimens.xml`(14sp/11sp)不完全对齐,建议先与其他并行 UI 子任务对齐字号基准表。 +2. `radius_lg`(12dp)与 `corner_radius_lg`(20dp)命名相近但数值不同,落地时需明确版型卡用前者。 +3. `color_secondary_container` 实际取值是否已是浅绿,需核实。 +4. 项目中是否已有 `MaxWidthXxxLayout` 类自定义容器可复用(用于承载 840dp 居中逻辑)。 +5. `MaterialCardView.strokeColor` 是否支持 ColorStateList(取决于 Material Components 版本),若不支持则版型卡选中态必须走代码动态设置而非 XML selector。 +6. `values-w600dp/`、`layout-w600dp/` 当前为空目录,是否有其他并行模块也计划使用,需协调避免策略冲突。 diff --git a/系统设置界面-20260816/DESIGN_SPEC.md b/系统设置界面-20260816/DESIGN_SPEC.md new file mode 100644 index 0000000..e20b649 --- /dev/null +++ b/系统设置界面-20260816/DESIGN_SPEC.md @@ -0,0 +1,252 @@ +# 系统设置类页面(5 屏)— 视觉边界手册 DESIGN_SPEC + +- **模块**:系统设置类页面(语言设置 / 选择版型 / 版本信息 / Logo 授权管理 / 数据上传) +- **日期**:2026-08-16 +- **最高约束**:`../BEAUTIFY_BASELINE_20260816.md`(全局美化公约) + `../UI_DEV_GUIDE.md`(Token 宪法) +- **视觉基准**:同目录 `baseline_ui.html`(单文件,双击可开) +- **原始截图**(不复制文件,相对路径引用): + | 屏 | 截图 | + | --- | --- | + | 语言设置 | `../ui_baseline/EAPManageUI/Screenshot_20260812_143341.png` | + | 选择版型 | `../ui_baseline/EAPManageUI/Screenshot_20260812_143347.png` | + | 版本信息 | `../ui_baseline/EAPManageUI/Screenshot_20260812_143456.png` | + | Logo 授权管理 | `../ui_baseline/EAPManageUI/Screenshot_20260812_143502.png` | + | 数据上传 | `../ui_baseline/EAPManageUI/Screenshot_20260812_143450.png` | + +> **铁律复述**:本次只做美化。五屏的信息字段、按钮文案、区块顺序、交互范式全部原样保留。 +> 下文所有条目都属于「间距 / 对齐 / 描边 / 颜色语义 / 响应式收敛」范畴,不含信息架构改动。 + +--- + +## 1. ★ 宽屏内容容器(本模块要沉淀给全 App 的通用栅格规范) + +### 1.1 问题 +五张截图全部在平板横屏(2944×1840,约 1280dp 宽)下拍摄,**内容一律顶在左上角、右侧留出 40%~60% 空白**。 +数据上传页最严重:三个输入框从左标签一直横跨到屏幕最右侧,单行长度超过 1000dp,眼睛需要横扫整块屏幕才能读完一行, +且长 URL 在超宽单行里既读不出结构也无法快速比对。这是全 App 平板体验「廉价感」的头号来源。 + +### 1.2 规范(**全 App 通用,不限本模块**) + +| 项 | 值 | 说明 | +| --- | --- | --- | +| 内容容器最大宽度 | **840px / 840dp** | `--content-max-width`。超过即左右自动留白 | +| 水平对齐 | **居中**(`margin: 0 auto`) | 不是左对齐后加右 padding | +| 左右安全边距 | **24px / 24dp**(`--content-gutter`) | 窗口宽度 < 容器最大宽度时生效 | +| 窄屏断点 | **600dp** | < 600dp 时安全边距降为 16dp,表单标签列由「左列」改为「上置」 | +| 垂直起始留白 | 24dp(页面根 padding-top) | 列表型页面例外,见 1.4 | +| AppBar | **全宽通栏,不进容器** | 对齐 Android `MaterialToolbar` 的物理行为;仅其内部标题遵守 §2 的 inset | + +### 1.3 为什么是 840 +- 840dp 是 Material 3 Window Size Class 中 **Expanded 的下界**,天然与「平板横屏」这一档对齐; +- 单行正文 15sp 时,840dp 约 60~70 个西文字符 / 40 个汉字,落在最佳阅读行宽区间; +- 与项目已有但仍为空的 `res/values-w600dp/`、`res/layout-w600dp/` 资源目录方向一致,可直接落资源限定符。 + +### 1.4 三种页面的容器落法 + +| 页型 | 屏 | 落法 | +| --- | --- | --- | +| **卡片/表单型** | 选择版型、版本信息、Logo 管理、数据上传 | 滚动容器内包一层 `maxWidth=840dp + layout_gravity=center_horizontal` 的内容 LinearLayout,左右 padding 24dp | +| **通栏列表型** | 语言设置 | **列表本体保持 match_parent**(触摸高亮/涟漪必须通栏,否则宽屏下点击右半屏无反馈),但**每一行的内部内容再收进 840dp 居中盒**,分割线同宽。视觉是居中的,可点区域是通栏的 | +| **AppBar** | 全部 5 屏 | 通栏,不收敛 | + +### 1.5 红线 +- **禁止**用「左对齐 + 右侧硬塞 padding」冒充居中,窗口再变宽就又偏了。 +- **禁止**给 840 容器加背景色或描边把它做成一张「大卡片」——它是不可见的排版栅格,不是视觉元素。 +- 容器最大宽度必须走 `@dimen` Token(`content_max_width`),**禁止在 XML 里写死 840dp**。 + +--- + +## 2. AppBar 统一规范(5 屏共用,对齐公约 §3) + +| 项 | 值 | +| --- | --- | +| 高度 | 56dp(`--appbar-height`) | +| 背景 | `--color-surface`,底部 `1px --divider` | +| 返回箭头 | 图标 24dp,触控槽 48dp,**图标视觉左边界落在距屏幕左 16dp** | +| 箭头与标题间距 | **8dp**(标题文本起点固定在 72dp = 16 + 48 + 8) | +| 标题 | **20sp / 600 / `--text-primary`**,单行,超长 `ellipsize=end` | +| 副标题(若有) | 12sp / `--text-secondary` | + +> 截图现状:五屏标题字号目测在 22~24sp 之间浮动,箭头到标题的间距各屏不一(语言设置约 48dp、Logo 管理约 44dp)。统一收口到上表。 + +--- + +## 3. 分屏视觉规范 + +### 3.1 语言设置(`Screenshot_20260812_143341.png`) + +| 问题(现状) | 规范(目标) | +| --- | --- | +| 行高偏矮、上下气口不足 | **行高 56dp**(公约 §5.5 的 48dp 是下限,设置类整屏列表提到 56dp 更从容),整行可点,最小点击区 48dp | +| 分割线通栏顶到屏幕最左最右 | 分割线**左端缩进到文字起点**(与 840 容器左边界同轴),右端同样留 24dp 安全边距;**最后一行下方不画线** | +| 选中项只有一个蓝圆点,无背景反馈 | 选中行 `--color-primary-container` 整行底 + 文字 `--color-on-primary-container` + 字重 500;圆点 `--color-primary` | +| 分割线颜色用了 `colorSurfaceVariant`(面色当线色,偏重偏灰) | 统一 `--divider`(12% 黑),1dp | +| 无 hover / pressed 反馈 | hover:primary 4% 透明;pressed:primary 8% 透明(Android 用 `?attr/selectableItemBackground` 的涟漪即可) | + +- 文字:语言名 15sp / 400 / `--text-primary`;不缩写、不截断(9 个语种名最长 `Ελληνικά` 也很短,宽屏下永不溢出)。 +- 单选圆点:未选中 2dp `--outline` 空心圈;选中 2dp `--color-primary` 圈 + 内实心点。 + +### 3.2 选择版型(`Screenshot_20260812_143347.png`) + +**核心 Bug:两张卡的描边逻辑颠倒。** 现状是「专业版(未选中)=蓝框、自定义功能版(已选中)=绿框」, +描边颜色被写死成卡片身份色,跟选中状态毫无关系,用户第一眼会把蓝框读成「已选中」。 + +| 状态 | 描边 | 底色 | 圆点 | 投影 | +| --- | --- | --- | --- | --- | +| **未选中** | `1dp --divider` | `--color-surface` | `--outline` 空心 | Level 1 | +| **选中** | `2dp --color-primary` | `--color-primary-container` | `--color-primary` 实心 | Level 2 | +| hover(未选中) | `1dp --outline` | 不变 | 不变 | Level 1 | + +- 选中态描边从 1dp 变 2dp 时,**内边距同步 -1dp**(16 → 15dp),保证文字不发生 1px 位移抖动。 +- 圆点 tint **两张卡必须一致**,都用 `--color-primary`;现状自定义卡用了 `colorSecondary`(绿),必须去掉。 +- 卡片圆角 `--corner-md` 12dp;卡内 padding 16dp;卡间距 16dp。 +- 「确定」按钮:确认类 → `--color-secondary-container` 底 + `--color-secondary` 字(保留截图的浅绿视觉), + 高度 44dp,圆角 12dp,宽度 `match_parent`(保持截图的通栏形态),但**受 840 容器约束**,不再横跨全屏。 +- 顶部图标 72dp、标题 20sp/600、副标题 13sp/`--text-secondary`,整组居中。 + +### 3.3 版本信息(`Screenshot_20260812_143456.png`) + +| 问题 | 规范 | +| --- | --- | +| 三张卡的标签/值没有对齐成列(「硬件 ID:」「设备型号:」「Android 版本:」宽度各不同,值参差) | **左标签列固定 140dp**(`--label-col-width`),值列 `weight=1`;跨卡片共用同一列宽,三张卡的值形成一条通列 | +| 「Debug」红字直接砸在白底上,过于刺眼 | 降级为**徽章**:`--color-error-container` 底 + `--color-error` 字,12sp/600,高 22dp,圆角 `--corner-sm`。Release 走 `--color-secondary-container` + `--color-secondary` | +| 「下载更新」按钮孤悬卡片右下角,与上方文字无任何关联 | 独立成**动作行**:上方加 `1dp --divider` 分割线,行内 `justify-content: flex-end`,与分割线间距 16dp。按钮仍在右侧(不搬家),但被分割线「锚」住,不再漂浮 | +| 卡片同时有描边和阴影 | §4 红线:**只留投影 Level 1**,去掉描边 | +| 卡片间距 / 卡片内边距不一 | 卡片内边距 16dp,卡片之间 16dp | + +- 标签 13sp / `--text-secondary`;值 15sp / `--text-primary`。 +- 硬件 ID 用等宽字体(`monospace`),并 `word-break: break-all`,超长时**换行而不是截断**(ID 不能被 `…` 吃掉)。 +- 版本号:`版本号` 13sp `--text-secondary` + 数值 `--color-primary` 500 字重。 +- 「升级来源」是 layout 中真实存在的槽位(`tv_version_info_upgrade_source`),检查阶段显示、无更新时隐藏,**不要在重构时删掉**。 +- 底部版权 13sp / `--text-secondary` / 居中。 + +**系统更新卡状态机** + +| 状态 | 表现 | +| --- | --- | +| 检查中 | 状态文案「正在检查更新…」,按钮文案「检查更新」+ `disabled`(opacity .38) | +| 已是最新 | 状态文案「已是最新版本」,按钮「检查更新」可点 | +| 有新版本 | 显示「有新版本可用:x.xx.xxxx」,按钮「下载更新」(confirm 绿) | +| 下载中 | 显示 4dp 高进度条(`--color-primary` / 轨道 `--color-surface-variant`,圆角 999),按钮 disabled | +| 失败 | 状态文案 `--color-error`,按钮恢复为「重试」 | + +### 3.4 Logo 授权管理(`Screenshot_20260812_143502.png`) + +| 问题 | 规范 | +| --- | --- | +| 分段控件是两个拼在一起的 Outlined 按钮,选中的一个是浅绿底绿字,未选中是白底 + 深描边 | **公约 §5.6**:外层胶囊(999dp)`--color-surface-variant` 底 + 2dp 内衬;选中段 `--color-primary-container` 底 + `--color-on-primary-container` 字 + 前置 ✓ + Level 1 投影;未选中段透明底 + `--text-secondary` 字。段高 36dp,段最小宽 132dp | +| 预览条底色 `colorSurfaceVariant`(灰紫色块),与浅色页面割裂,像贴了一张异物 | 预览条改为 `--color-surface` 底 + `1dp --divider` 描边 + `--corner-md`,高度 56dp(= 真实 AppBar 高度)。**它是「顶部栏的样子」,就该长得像顶部栏,不该是一块深色底板** | +| 计数器「10/15」孤零零悬在输入框右下方外侧,位置突兀 | 计数器归位到**输入框正下方 4dp 的 field-footer 行**内,右对齐,13sp / `--text-secondary`;左侧同一行留给错误提示文案。超限时计数器与提示同时变 `--color-error` | +| 输入框描边偏重 | 默认 `1dp --divider`,聚焦 `2dp --color-primary`(同步 -1dp padding 防抖),圆角 `--corner-sm` | + +- 预览条内:返回箭头 24dp `--text-primary`,与标题间距 8dp;标题 20sp/600,`maxLines=1` + `ellipsize=end`(超 15 字符本就被计数器拦住,截断只是兜底)。 +- 按钮:「保存文本配置」= confirm 绿(`--color-secondary-container` + `--color-secondary`);「恢复默认名称」= 次按钮(透明底 + `1dp --outline` + `--color-primary` 字)。两按钮固定宽 240dp、居中、纵向间距 16dp(保持截图的上下堆叠形态)。 +- **图片 Logo 模式**(截图未拍到,但 layout 中真实存在):预览区无图时走公约 §5.7 三段式空态 —— 56dp `--text-disabled` 图标 → 「暂无 Logo 图片」16sp/500 → 「点击『添加 Logo』上传,建议 PNG 透明底」13sp/`--text-secondary`;图标与主文案间距 16dp,主辅 8dp。加载中显示 `ProgressBar`(`pb_cl900_loading`)。 + +### 3.5 数据上传(`Screenshot_20260812_143450.png`) + +**核心 Bug:三个输入框实际发生了重叠错位。** + +- **现象**:「表单上传地址」框的下沿压住「原始数据上传地址」框的上沿;「原始数据上传地址」框整体向右偏移了约一个标签的宽度, + 左边界与另外两个框对不齐;三个标签与各自输入框在垂直方向也没对准(标签偏上/偏下不一)。 +- **根因**(已核对 `activity_data_upload.xml`):每个 `TextInputLayout` 同时把 `Top_toTopOf` 和 `Bottom_toBottomOf` 约束到了自己那个 + `wrap_content` 的标签 `TextView` 上。标签实际只有约 24dp 高,而 OutlinedBox 输入框有 56dp 高——ConstraintLayout 只好把 56dp 的框 + **以 24dp 的标签为中心上下各溢出 16dp**。溢出部分不计入下一个控件的排版基准(下一个标签是 `Top_toBottomOf` 上一个 TIL), + 于是相邻两组之间就出现了物理重叠。此外三个 TIL 都写了 `layout_weight="1"`,在 ConstraintLayout 里是无效属性,纯噪音。 + +**规范版式:左标签 + 右输入框 两列对齐**(保留截图原有的「标签在左」信息架构,用户肌肉记忆不变) + +``` +├── 24dp ──┬──── 140dp 标签列 ────┬── 16dp ──┬───────── 输入框(占满剩余)─────────┬── 24dp ──┤ + 自动上传数据 [ M3 Switch ] + 表单上传地址 [ 56dp 输入框 ] + 原始数据上传地址 [ 56dp 输入框 ] + 数据传输端口 [ 56dp 输入框 ] +``` + +| 项 | 值 | +| --- | --- | +| 整块表单容器 | 840dp 居中(§1),左右安全边距 24dp | +| 标签列宽 | **固定 140dp**(`--label-col-width`),四行共用,形成硬左对齐列 | +| 标签 ↔ 输入框水平间距 | 16dp | +| 每行垂直对齐 | `center_vertical` —— 标签在 56dp 输入框的**垂直正中**,不再是「顶对齐 + 溢出」 | +| 行与行的垂直间距 | **16dp**(`--spacing-md` 级),由外层容器统一给,不再靠约束互推 | +| 输入框高度 | 56dp,圆角 `--corner-sm`,描边 `1dp --divider`,左内边距 16dp | +| 开关 | **M3 MaterialSwitch**(52×32dp,轨道 `--color-surface-variant` / 选中 `--color-primary`),替换截图中的黑色胶囊开关(公约 §5.5 明确点名的旧版残留) | +| 三按钮 | 与表单之间加 `1dp --divider` 分割线 + 16dp 间距;按钮横向排列、gap 16dp、高 44dp。「保存」= confirm 绿;「重置」「测试数据上传」= 次按钮(透明底 + `1dp --outline` + primary 字)。**顺序与文案完全不变** | +| 窄屏(< 600dp) | 标签自动上移到输入框正上方(`--label-col-width: 100%`),字号降到 13sp / `--text-secondary`,行内间距 4dp | + +**Android 侧的修法(细节见 `implementation_plan.md`)**: +把 `ConstraintLayout` 换成**竖向 `LinearLayout` + 每行一个横向 `LinearLayout(gravity=center_vertical)`**。 +四行同构,标签列宽由 `@dimen` 统一给。所有跨控件的顶/底互相约束全部删除——这类错位在约束式布局里极易复发, +线性布局在这个「四行等宽两列表单」的场景下更稳,也更符合「不改结构、只修错位」的目标。 + +**状态机** + +| 状态 | 表现 | +| --- | --- | +| 默认 | 空框 + `--text-hint` placeholder(`http://xxx.xxx.xxx.xxx:xxxx/upload/form` / `.../upload/json` / 端口示例) | +| 聚焦 | `2dp --color-primary` 描边,去掉底色 | +| 校验失败 | `--color-error` 描边 + 框下 13sp `--color-error` 行内提示(如「请填写完整的 http(s):// 地址」) | +| 自动上传关闭 | 三个地址/端口输入框整体 `opacity 0.38` 且不可编辑;**开关本体保持 1.0 且必须可交互**(沿用 `用户管理界面/DESIGN_SPEC.md` 的既有红线,否则用户无法重新开启) | +| 测试中 | 「测试数据上传」按钮 disabled + 文案保持不变,通过 Snackbar 反馈结果,不新增 UI 槽位 | + +--- + +## 4. 全模块通用状态与边界 + +### 4.1 状态机 +| 状态 | 通用表现 | +| --- | --- | +| 默认 | 见各屏规范 | +| 按下 / hover | 列表行 primary 8% / 4% 透明;按钮 `filter: brightness(0.96 / 0.92)` | +| 禁用 | **统一 `opacity: 0.38`**,禁止另造一套灰色值 | +| 加载 | 4dp 高线性进度条(`--color-primary`),或 24dp 圆形 `ProgressBar` | +| 空 | 公约 §5.7 三段式(仅 Logo 图片模式会遇到) | +| 错误 | `--color-error` 描边 + 13sp 行内提示;不用 Toast 顶替行内提示 | + +### 4.2 截断规则 +| 内容 | 规则 | +| --- | --- | +| AppBar 标题 | 单行 `ellipsize=end` | +| 语言名 | 不截断(内容极短,宽屏下永不溢出) | +| Logo 预览标题 | 单行 `ellipsize=end`(兜底;正常路径由 15 字符上限拦住) | +| 硬件 ID / 版本号 | **换行不截断**(`break-all`),完整 ID 必须可读可复制 | +| 上传地址 | 单行横向滚动(输入框原生行为),不换行 | +| 版型卡描述 | 最多 2 行,超出 `ellipsize=end`;840 容器下现有文案 1 行即可容纳 | + +### 4.3 最小点击区域 +- **全部可点元素 ≥ 48×48dp**。 +- 语言行:整行 56dp 高 × 通栏可点。 +- 单选圆点视觉 20dp,但外套 48dp 触控槽(`--touch-min`)。 +- AppBar 返回箭头:图标 24dp,触控槽 48dp。 +- 分段控件单段 36dp 高:**这是唯一低于 48dp 的例外**,M3 分段控件规范如此;靠段最小宽 132dp 保证横向易点。 + +### 4.4 数字排版 +所有版本号、端口、ID、计数器统一 `font-variant-numeric: tabular-nums`(Android 侧对应等宽数字字体或 monospace), +避免刷新时数值宽度跳动。 + +--- + +## 5. 与全局公约的差异点声明(必读) + +| # | 差异 | 公约原文 | 本模块取值 | 理由 | +| --- | --- | --- | --- | --- | +| 1 | 列表行高 | §5.5「选项行整行可点,行高 48px」 | **56dp** | 语言设置是整屏只有一个列表的设置页,48dp 在 1840px 高的平板上过于局促。48dp 仍作为**最小点击区**下限被满足 | +| 2 | 卡片描边 | §5.3「卡片 = surface 底 + corner-md + Level 1 投影」 | 版型卡在**选中态**额外加 `2dp --color-primary` 描边 | 单选卡必须有强选中信号;此时投影降为 Level 2 承担层级、描边承担状态,不构成 §4 红线所指的「深灰 1px 描边 + 重投影」双重包边 | +| 3 | 新增 Token | 公约未定义 | 新增 `--content-max-width: 840px`、`--content-gutter: 24px`、`--label-col-width: 140px` | 本模块沉淀的通用栅格规范,建议回写进公约 §2 供其余 7 个模块共用 | +| 4 | 页面根内边距 | §2「页面根内边距 24px」 | 语言设置页 **上下 0 / 左右由行内承担** | 通栏列表页若给根 padding,触摸涟漪会缩进一圈,宽屏下右半屏点不动。改为行内 padding + 通栏可点 | + +--- + +## 6. 自查清单(对照公约 §8) + +- [x] 每个信息字段都还在(含 layout 中存在但截图未拍到的 `升级来源` / `下载进度条` / `图片 Logo 模式`) +- [x] 页面结构与原截图一一对应,无区块搬家、无入口迁移 +- [x] `baseline_ui.html` 中无散落十六进制,全部走 `var(--*)` +- [x] 圆角 / 间距全部引用 Token 变量 +- [x] 字号只用了公约 §3 的层级(20 / 16 / 15 / 13 / 12) +- [x] 黑色胶囊开关(数据上传页)已替换为 M3 样式 +- [x] 描边与投影无双重包边(差异点 #2 已单独声明) +- [x] 空态、禁用态、加载态、错误态均已定义 +- [x] Token 映射字典见 `implementation_plan.md` diff --git a/系统设置界面-20260816/baseline_ui.html b/系统设置界面-20260816/baseline_ui.html new file mode 100644 index 0000000..fd268b7 --- /dev/null +++ b/系统设置界面-20260816/baseline_ui.html @@ -0,0 +1,986 @@ + + + + + +EAPManageUI - 系统设置类页面 美化基线 (5 屏) + + + + + +
屏 1 / 5  ·  Screenshot_20260812_143341.png  ·  语言设置(9 种语言单选列表)
+
+
+
+
语言设置
+
+ +
+
+ +
+
+ English + +
+
+
+ +
+
+ Français + +
+
+
+ + +
+
+ 中文 + +
+
+
+ +
+
+ 日本語 + +
+
+
+ +
+
+ 한국어 + +
+
+
+ +
+
+ Español + +
+
+
+ +
+
+ Italiano + +
+
+
+ +
+
+ Ελληνικά + +
+
+
+ + +
+
+ Português + +
+
+ +
+
+
+ + + +
屏 2 / 5  ·  Screenshot_20260812_143347.png  ·  选择版型(两张单选卡 + 确定)
+
+
+
+
选择版型
+
+ +
+
+ +
+
+ +
+
选择版型
+
请选择适合您使用场景的版型,后续可在设置中更改
+
+ + +
+ +
+
专业版
+
为专业场馆管理员设计,布局固定专业化,核心数据字段默认全开,开箱即用
+
+
+ + +
+ +
+
自定义功能版
+
高度可配置,所有高级功能开放,适合研究员和高级用户
+
+
+ +
+ +
+ +
+
+
+ + + +
屏 3 / 5  ·  Screenshot_20260812_143456.png  ·  版本信息(图标+版本号 + 设备/构建/系统更新 三卡)
+
+
+
+
版本信息
+
+ +
+
+ +
+
+ +
+
EAP Manage Team
+
版本号 1.00.0000
+
+ +
+ + +
+
设备信息
+
+
硬件 ID:
+
15EA5B1C22D14D97
+
+
+
设备型号:
+
TB375FC
+
+
+
Android 版本:
+
16 (API 36)
+
+
+ + +
+
构建信息
+
+
构建类型:
+
Debug
+
+
+ + +
+
系统更新
+ +
+
升级来源:
+
内置升级包
+
+
+
有新版本可用:
+
1.00.0001
+
+
+ +
+
+ + + +
+
+
+ + +
+

版本信息 · 系统更新卡状态机

+
+
检查中:正在检查更新…
+
已是最新:
+
下载中: + + + + 62% +
+
构建类型 Release:Release
+
+
+ + + +
屏 4 / 5  ·  Screenshot_20260812_143502.png  ·  Logo 授权管理(分段控件 + 实时预览 + 输入框 + 两按钮)
+
+
+
+
Logo 授权管理
+
+ +
+
+ + +
+
+ + +
+
+ + +
顶部栏实时效果预览
+
+ + EAP Manage +
+ +
+ + +
+ 输入自定义团队名称 + +
+ + +
+ + +
+ +
+
+
+ + +
+

Logo 授权管理 · 图片模式 / 边界态

+
+
+
图片 Logo 未上传(§5.7 空态)
+
+
+ +
暂无 Logo 图片
+
点击「添加 Logo」上传,建议 PNG 透明底
+
+
+
+
+
超长输入(错误态 + 计数器变红)
+
+ 输入自定义团队名称 + +
+ +
+
+
+ + + +
屏 5 / 5  ·  Screenshot_20260812_143450.png  ·  数据上传(自动上传开关 + 三输入框 + 保存/重置/测试)
+
+
+
+
数据上传
+
+ +
+
+ +
+ + +
+
自动上传数据
+
+
+
+
+ + +
+ +
+
+ +
+
+
+ +
+ +
+
+ +
+
+
+ +
+ +
+
+ +
+
+
+ +
+ + + +
+ +
+ +
+
+
+ + +
+

数据上传 · 状态机

+
+
+
聚焦态(2px primary 描边)
+
+ +
+
+
+
校验失败(error 描边 + 行内提示)
+
+ +
+ +
+
+
自动上传关闭 → 三输入框禁用(opacity .38)
+
+
+ +
+
+
+
+ + + diff --git a/系统设置界面-20260816/implementation_plan.md b/系统设置界面-20260816/implementation_plan.md new file mode 100644 index 0000000..4df16a9 --- /dev/null +++ b/系统设置界面-20260816/implementation_plan.md @@ -0,0 +1,173 @@ +# 系统设置类页面(5 屏)— 原生落地图纸 implementation_plan + +- **依据**:同目录 `baseline_ui.html` + `DESIGN_SPEC.md`,严格对齐 `../UI_DEV_GUIDE.md`(Token 宪法)与 `../BEAUTIFY_BASELINE_20260816.md`(全局公约)。 +- **性质**:本文件只做「原生落地图纸」,不改任何源码。所有路径均已在仓库 `E:\Bitbucket\EAPManageTeam\app\src\main\` 下实际检索确认(Glob + Read),无编造路径。 +- **执行方**:`@coder`。 + +--- + +## 1. CSS → Android Token 映射字典 + +### 1.1 颜色(`baseline_ui.html :root` → `res/values/colors.xml` 语义别名) + +| HTML CSS 变量 | 取值 | Android 语义 Token | 现状 | +| --- | --- | --- | --- | +| `--color-primary` | #3949AB | `?attr/colorPrimary`(= `@color/color_primary` = `@color/md_theme_primary`) | ✅ 已存在,直接复用 | +| `--color-on-primary` | #FFFFFF | `?attr/colorOnPrimary` | ✅ 已存在 | +| `--color-primary-container` | #E8EAF6 | `?attr/colorPrimaryContainer`(= `@color/color_primary_container`) | ✅ 已存在 | +| `--color-on-primary-container` | #1A237E | `?attr/colorOnPrimaryContainer` | ✅ 已存在 | +| `--color-secondary` | #00897B | `?attr/colorSecondary`(= `@color/color_secondary`) | ✅ 已存在 | +| `--color-secondary-container` | #E0F2F1 | `?attr/colorSecondaryContainer` | ⚠️ 需核对 `colors.xml` 中该 container 值是否为浅绿;若当前指向 M3 默认紫调,需在 `values/colors.xml` 补充/校正为浅绿,**不要新建平行 Token** | +| `--color-on-secondary` | #FFFFFF | `?attr/colorOnSecondary` | ✅ 已存在 | +| `--color-surface` | #FFFBFE | `?attr/colorSurface`(= `@color/color_surface`) | ✅ 已存在 | +| `--color-on-surface` | #1C1B1F | `?attr/colorOnSurface` | ✅ 已存在 | +| `--color-surface-variant` | #E7E0EC | `?attr/colorSurfaceVariant`(= `@color/color_surface_variant`) | ✅ 已存在 | +| `--color-on-surface-variant` | #49454F | `?attr/colorOnSurfaceVariant` | ✅ 已存在 | +| `--color-background` | #F1F1F1 | `?attr/colorBackground` / `@color/color_background` | ✅ 已存在 | +| `--color-error` | #B3261E | `?attr/colorError`(= `@color/color_error`) | ✅ 已存在 | +| `--color-error-container` | #FCEDEA | `?attr/colorErrorContainer` | ✅ 已存在(`Widget.App.Button.Danger` 已在用) | +| `--text-primary` | = on-surface | `@color/text_primary` | ✅ 已存在 | +| `--text-secondary` | = on-surface-variant | `@color/text_secondary` | ✅ 已存在 | +| `--text-disabled` | #9E9E9E | `@color/text_disabled` | ✅ 已存在 | +| `--text-hint` | #BDBDBD | `@color/text_hint` | ✅ 已存在 | +| `--divider` | rgba(0,0,0,.12) | `@color/divider`(#1F000000) | ✅ 已存在 | +| `--outline` | rgba(0,0,0,.24) | `@color/outline`(#99000000,公约标注"原 0.6 过重",本模块沿用公约值,不额外新增) | ✅ 已存在,语义值需与公约 §1 描述一致核对 | + +### 1.2 尺寸 / 圆角(新增 Token,需在 `res/values/dimens.xml` 补充) + +| HTML CSS 变量 | 取值 | 建议新增 Android Token | 说明 | +| --- | --- | --- | --- | +| `--content-max-width` | 840px | **新增** `@dimen/content_max_width` = 840dp | ★ 本模块核心新增 Token,建议同步提给其余 7 个并行模块复用 | +| `--content-gutter` | 24px | 复用现有 `@dimen/spacing_lg`(16dp)**不匹配**,需**新增** `@dimen/content_gutter` = 24dp | 24dp 与 spacing_lg(16dp)/spacing_xl(24dp) 撞值;直接复用 `@dimen/spacing_xl` 即可,无需新增,见下方"精简建议" | +| `--label-col-width` | 140px | **新增** `@dimen/settings_form_label_width` = 140dp | 数据上传页 / 版本信息页共用 | +| `--row-height` | 56px | 复用现有 `@dimen/toolbar_height`(56dp)或**新增** `@dimen/settings_row_height` = 56dp 语义更清晰 | 建议新增语义 Token,避免和 AppBar 高度混用同一个 dimen 名 | +| `--field-height` | 56px | Material TextInputLayout OutlinedBox 默认即约 56dp,无需新增 | `Widget.EAPManage.TextInputLayout` 已定义圆角,高度走组件默认值 | +| `--corner-sm` | 8px | `@dimen/corner_radius_sm`(8dp) | ✅ 已存在 | +| `--corner-md` | 12px | `@dimen/corner_radius_md`(12dp)或已用的 `@dimen/radius_lg`(12dp,命名歧义,见 §4 风险) | ⚠️ 见下方风险项 | +| `--corner-lg` | 20px | `@dimen/corner_radius_lg`(20dp) | ✅ 已存在 | +| `--spacing-xs/sm/md/lg/xl` | 4/8/16/24/32 | `@dimen/spacing_xs/sm/md/lg/xl` | ✅ 已存在,直接复用 | +| `--touch-min` | 48px | `@dimen/touch_target_min`(48dp) | ✅ 已存在 | + +**精简建议**:`--content-gutter` 直接映射到已有的 `@dimen/spacing_xl`(24dp),**不新增**同值 Token,避免 dimens.xml 进一步膨胀。 + +### 1.3 字号(`res/values/dimens.xml` 已有字号阶梯,按公约 §3 对齐) + +| HTML CSS 变量 | 取值 | Android Token | 现状 | +| --- | --- | --- | --- | +| `--font-title`(AppBar 标题) | 20px | `@dimen/text_size_headline`(20sp) | ✅ 已存在,但 `activity_*.xml` 里 Toolbar 标题目前吃 `?attr/textAppearance` 默认值,**未显式引用**,需在 `Widget.EAPManage.Toolbar` 样式中显式指定 titleTextAppearance | +| `--font-subtitle`(区块标题/卡片标题) | 16px | `@dimen/text_size_title`(16sp) | ✅ 已存在 | +| `--font-body`(正文) | 15px | ⚠️ `dimens.xml` 现有阶梯是 14/16/18(`text_size_body=14sp`),**没有 15sp** | 需新增 `@dimen/text_size_body_15` = 15sp,或将本模块正文对齐到就近的 `text_size_body`(14sp)。**建议**:为保持与公约 §3 表格严格一致,新增 15sp Token,命名 `text_size_body`(与现有 14sp 的 `text_size_body` 冲突,需要 @coder 与全局 UI 组核实 14 vs 15 何者为准,本任务不擅自改现有 Token 语义) | +| `--font-caption`(辅助说明) | 13px | ⚠️ 现有 `text_size_caption` = 11sp,不等于 13sp | 同上,建议新增或核实,@coder 落地前需与其他并行模块对齐,避免各模块各定义一套 13sp/11sp | +| `--font-unit` | 12px | `@dimen/text_size_sm`(12sp) | ✅ 已存在 | + +> **⚠️ 风险提示(写入 §4)**:公约 §3 定义的字号阶梯(20/16/15/13)与仓库现有 `dimens.xml` 字号阶梯(20 headline / 16 title / 14 body / 11 caption)**不完全对齐**(15 vs 14,13 vs 11)。这是**跨模块共性问题**,不是本模块独有,建议 @coder 在实施前先与其他并行 UI 子任务对齐一次"字号 Token 最终基准表",避免 8 个模块分别新增 8 套相近字号。本模块 `implementation_plan` 暂按"复用最接近的现有 Token"处理,**不新增字号 Token**,待全局基准表拍板后再统一改。 + +### 1.4 Elevation + +| HTML CSS 变量 | Android 落地 | +| --- | --- | +| `--elev-1` | `app:cardElevation="@dimen/dimen_2dp"`(现有 `activity_version_info.xml` 已用 2dp,视觉上接近 Level 1,**沿用现状不改**) | +| `--elev-2` | `app:cardElevation="@dimen/elevation_card"` 或新增 `card_elevation_selected` = 4dp(仅版型选中卡使用) | +| `--elev-3` | 本模块无弹窗/BottomSheet,不涉及 | + +### 1.5 组件样式复用 + +| HTML class | Android 复用样式 | +| --- | --- | +| `.btn--confirm`(浅绿确认按钮) | `Widget.EAPManage.Button.Tonal`(已在 5 个 layout 中普遍使用,**保持不变**,但需核对其 `backgroundTint`/`textColor` 是否真的落在 `colorSecondaryContainer`/`colorSecondary`,若当前 Tonal 样式走的是默认 M3 紫色系,需按 DESIGN_SPEC §3 补充 tint 覆盖) | +| `.btn--secondary`(次按钮) | `Widget.EAPManage.Button.Outlined` | +| `.switch`(M3 开关) | `com.google.android.material.materialswitch.MaterialSwitch`(**需替换** `activity_data_upload.xml` 中的 `androidx.appcompat.widget.SwitchCompat`,SwitchCompat 在部分主题下会渲染成黑色胶囊,正是公约 §5.5 点名的"旧版残留") | +| `.card`(信息卡) | `com.google.android.material.card.MaterialCardView`,去描边只留 `cardElevation` | +| `.textfield`(输入框) | `Widget.EAPManage.TextInputLayout`(已存在,8dp 圆角),聚焦态由 M3 组件默认处理,无需自定义 | +| `.badge`(Debug/Release 徽章) | 新增极小号 `TextView` + `res/drawable/shape_badge_error.xml` / `shape_badge_success.xml`(背景色引用 `?attr/colorErrorContainer` / `?attr/colorSecondaryContainer`,圆角引用 `@dimen/corner_radius_sm`) | +| `.segmented`(Logo 分段控件) | `MaterialButtonToggleGroup`(`activity_logo_management.xml` 已在用,仅需补充 `app:cornerRadius` 走 999dp 胶囊 + 选中态样式覆盖为 `colorPrimaryContainer`,当前是 `?attr/materialButtonOutlinedStyle`,选中态默认落 `colorSecondary` 系,需要单独定义 `Widget.EAPManage.Button.Segmented` 覆盖选中态 tint) | + +--- + +## 2. 落地文件清单(已实际检索确认路径) + +### 2.1 屏 1 — 语言设置 + +| 类型 | 路径 | 改动点 | +| --- | --- | --- | +| Layout | `app/src/main/res/layout/activity_language_settings.xml` | 9 个 `row_language_settings_lang_*` 行:`android:layout_height="@dimen/toolbar_height"` → 新增 `@dimen/settings_row_height`(56dp);分割线 `View` 的 `android:background="?attr/colorSurfaceVariant"` → 改为 `?attr/colorOutlineVariant`(或直接映射 `@color/divider`)并加左右 margin 对齐 840dp 容器;给每个 `row_*` 增加选中态背景(`android:background` 换成 `selector`,见下方新增 drawable) | +| Activity | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/language/LanguageSettingsActivity.java` | 补充选中行的背景/文字色切换逻辑(当前很可能只切 `RadioButton.setChecked`,需要联动整行 `LinearLayout` 的 `isSelected` 状态) | +| 工具类 | `app/src/main/java/com/umilab/eapmanage/team/util/LanguageUtils.java` | 待 @coder 确认是否涉及選中态回填逻辑,本次不改业务逻辑,仅核对 | +| 新增 drawable | `app/src/main/res/drawable/selector_language_row_bg.xml`(新建) | `state_selected` → `?attr/colorPrimaryContainer`;默认 → `?attr/selectableItemBackground` | + +### 2.2 屏 2 — 选择版型 + +| 类型 | 路径 | 改动点 | +| --- | --- | --- | +| Layout | `app/src/main/res/layout/activity_edition_selection.xml` | 两张 `MaterialCardView`(`card_edition_selection_professional` / `card_edition_selection_custom`)的 `app:strokeColor` 当前分别写死 `?attr/colorPrimary` 和 `?attr/colorSecondary`(与选中状态无关,是本次要修的核心 Bug)→ 改为**动态 selector** 或代码控制:未选中 `?attr/colorOutlineVariant` 1dp,选中 `?attr/colorPrimary` 2dp;两张卡的 `RadioButton buttonTint` 统一为 `?attr/colorPrimary`(当前自定义卡是 `colorSecondary`,需统一) | +| Activity | `app/src/main/java/com/umilab/eapmanage/team/edition/EditionSelectionActivity.java` | `onCheckedChangeListener` 回调中补充:切换卡片的 `strokeColor`(`professional`/`custom`)、`strokeWidth`、卡片 `backgroundTint`(选中态 `colorPrimaryContainer`,未选中 `colorSurface`)随选中状态联动。当前逻辑只处理了 RadioButton 的 checked,未处理视觉态 | +| 关联类 | `app/src/main/java/com/umilab/eapmanage/team/edition/AppEdition.java`、`EditionManager.java` | 数据枚举与持久化,不涉及本次视觉改动,仅供 @coder 理解上下文 | + +### 2.3 屏 3 — 版本信息 + +| 类型 | 路径 | 改动点 | +| --- | --- | --- | +| Layout | `app/src/main/res/layout/activity_version_info.xml` | 三张 `MaterialCardView` 内的 `LinearLayout(horizontal)` 标签列 `android:layout_width="@dimen/dimen_120dp"` → 统一改为新增 Token `@dimen/settings_form_label_width`(140dp),三卡共用同一 dimen 保证列对齐;`tv_version_info_build_type` 的 `android:textColor="?attr/colorError"` 纯红字 → 改为徽章样式(背景 `shape_badge_error.xml` + padding),文字色不变;升级卡内按钮 `btn_version_info_check_or_update` 外层补一层 `View` 分割线 + 顶部 margin,做出"动作行"效果 | +| Activity | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoActivity.java` | 补充按钮容器分割线的显隐逻辑(若沿用现有 XML 静态分割线则无需改代码) | +| ViewModel | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoViewModel.java` | 不涉及视觉改动,仅核对状态字段(检查中/已最新/有更新/下载中/失败)是否已有对应 LiveData,供 Activity 侧驱动徽章与进度条显隐 | +| 新增 drawable | `app/src/main/res/drawable/shape_badge_error.xml`、`shape_badge_success.xml`(新建) | 徽章背景,圆角 `@dimen/corner_radius_sm` | + +### 2.4 屏 4 — Logo 授权管理 + +| 类型 | 路径 | 改动点 | +| --- | --- | --- | +| Layout | `app/src/main/res/layout/activity_logo_management.xml` | `tg_logo_mode`(`MaterialButtonToggleGroup`)内两个 `MaterialButton` 当前 `style="?attr/materialButtonOutlinedStyle"` → 新增 `Widget.EAPManage.Button.Segmented` 样式(胶囊圆角 + 选中态 `colorPrimaryContainer`/`colorOnPrimaryContainer`);文本/图片模式内的预览卡 `MaterialCardView`(`app:cardCornerRadius="@dimen/radius_md"`)内部 `LinearLayout` 的 `android:background="?attr/colorSurfaceVariant"` → 改为 `?attr/colorSurface` + 卡片本身补 `app:strokeColor="?attr/colorOutlineVariant"` `app:strokeWidth="@dimen/dimen_1dp"`;`til_custom_text` 的 `app:counterEnabled` 计数器默认样式已由 M3 TextInputLayout 承担(位置在框下方),**基本符合 DESIGN_SPEC 要求,核实实际渲染位置是否与截图一致**,若组件默认渲染已经在下方则此项标记"确认无需改" | +| Activity | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementActivity.java` | 分段切换时补充卡片描边/底色的联动(若靠 selector 自动处理则无需改代码) | +| ViewModel | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementViewModel.java` | 不涉及视觉改动 | +| Repository | `app/src/main/java/com/umilab/eapmanage/team/data/repository/LogoRepository.java` | 不涉及视觉改动,仅上下文参考 | +| 工具类 | `app/src/main/java/com/umilab/eapmanage/team/util/LogoPickerHelper.java` | 不涉及视觉改动 | +| 复用 Layout | `app/src/main/res/layout/layout_empty_state.xml` | 图片 Logo 空态直接复用该已有空态布局(`tv_logo_management_logo_empty` 已 `include` 了它),核对其内部图标/文案样式是否符合公约 §5.7 三段式,不符合则按 §5.7 微调该公共文件(**注意**:此文件可能被其他模块共用,改动前需确认无副作用,@coder 谨慎处理) | + +### 2.5 屏 5 — 数据上传 + +| 类型 | 路径 | 改动点 | +| --- | --- | --- | +| Layout | `app/src/main/res/layout/activity_data_upload.xml` | **核心修复**:内层 `androidx.constraintlayout.widget.ConstraintLayout` 改写为 `LinearLayout(vertical)`,四行(自动上传开关 / 表单地址 / 原始数据地址 / 端口)改写为四个横向 `LinearLayout(gravity=center_vertical)`,每行左侧标签 `TextView(width=@dimen/settings_form_label_width)` + 右侧输入控件 `weight=1`;删除现有互相错位的 `layout_constraintTop_toBottomOf`/`Bottom_toBottomOf` 链;三个 `TextInputLayout` 上残留的无效 `android:layout_weight="1"`(ConstraintLayout 中不生效)一并清理;`androidx.appcompat.widget.SwitchCompat`(`sw_upload_auto`)→ 替换为 `com.google.android.material.materialswitch.MaterialSwitch` | +| Activity | `app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/upload/DataUploadActivity.java` | 因 `id` 全部保留(`et_upload_form_url`/`et_upload_json_url`/`et_upload_port`/`sw_upload_auto`/`btn_user_save`/`btn_data_upload_reset`/`btn_data_upload_test`),View Binding 引用**不受结构调整影响**,理论上无需改代码;仅需核对"自动上传关闭 → 三输入框 alpha 0.38 且禁用"的联动是否已实现,若未实现需按 DESIGN_SPEC §3.5 状态机补充 | + +### 2.6 全局资源文件 + +| 类型 | 路径 | 改动点 | +| --- | --- | --- | +| dimens | `app/src/main/res/values/dimens.xml` | 新增:`content_max_width`(840dp)、`settings_form_label_width`(140dp)、`settings_row_height`(56dp)。**不新增**与 `spacing_xl` 同值的 gutter Token(直接复用) | +| colors | `app/src/main/res/values/colors.xml` | 核对 `color_secondary_container` 实际取值是否为浅绿(`#E0F2F1` 系),如已是 M3 默认紫需要新增/校正 | +| styles | `app/src/main/res/values/themes.xml` | 新增 `Widget.EAPManage.Button.Segmented`(Logo 分段控件选中态样式);`Widget.EAPManage.Toolbar` 补充 `titleTextAppearance` 显式引用 `@dimen/text_size_headline` | +| 响应式限定符 | `app/src/main/res/values-w600dp/`(**已存在但为空目录**)、`app/src/main/res/layout-w600dp/`(**已存在但为空目录**) | ★ 840dp 容器规范落地的推荐路径:在 `values-w600dp/dimens.xml` 中覆写内容 padding 相关 Token 为宽屏取值,或在 `layout-w600dp/` 下为 5 个 activity 提供宽屏专用布局变体(外层多一层 840dp 居中容器)。**待 @coder 决策**采用"运行时用代码设置 maxWidth"还是"资源限定符切两套布局",两种方案在 5 个 layout 中一致处理 | + +--- + +## 3. 关键实现难点与建议方案 + +### 3.1 840dp 居中容器的两种落地方式 + +| 方案 | 做法 | 优劣 | +| --- | --- | --- | +| A. 资源限定符 | `layout-w600dp/activity_xxx.xml` 中给内容区套一层 `maxWidth=840dp` 的容器 | 与项目已有空 `layout-w600dp/` 目录意图吻合;但 5 个文件要维护两份,维护成本高 | +| B. 自定义 `MaxWidthLinearLayout`/`MaxWidthConstraintLayout` | 写一个继承 `LinearLayout` 的容器 View,`onMeasure` 里钳制最大宽度后居中 | 只需在默认 layout 里换一个自定义 ViewGroup 标签,无需维护双份布局,跨模块可复用 | + +**建议**:采用方案 B,新增 `com.umilab.eapmanage.team.ui.widget.MaxWidthFrameLayout`(或类似命名),5 屏统一用它包裹内容区。此类不在本次检索范围内确认是否已存在,**待 @coder 确认**:检索关键字 `MaxWidth`、`CenteredContainer`。若已存在同类容器则直接复用,避免重复造轮子。 + +### 3.2 语言设置"通栏可点 + 视觉居中"的矛盾 + +若采用方案 B 的 MaxWidth 容器包裹每一**行**,涟漪效果会被限制在 840dp 内,宽屏下点击行两侧空白区域无反馈,与 DESIGN_SPEC §1.4 的要求(列表本体通栏、内容居中)冲突。 +**建议**:`row_language_settings_lang_*` 的 `LinearLayout` 本身保持 `match_parent` 承载点击与涟漪,内部再套一层 840dp 居中的 `LinearLayout` 只包文字和 RadioButton。即"外层可点通栏,内层视觉居中",与 `baseline_ui.html` 中 `.lang-row` / `.lang-row-inner` 的双层结构完全对应。 + +### 3.3 版型卡描边颜色的动态切换 + +`MaterialCardView` 的 `app:strokeColor` 不支持直接写 `selector`(部分 M3 版本支持 ColorStateList,需验证当前依赖的 Material Components 版本)。若不支持,只能在 `EditionSelectionActivity.java` 的 `onCheckedChangeListener` 回调中用代码 `card.setStrokeColor(...)`、`card.setStrokeWidth(...)`、`card.setCardBackgroundColor(...)` 显式设置,这是**必须改代码**的一项,不能只靠 XML。 + +--- + +## 4. 风险与待确认项(禁止编造,如下均需 @coder 或 UI 组二次确认) + +1. **字号 Token 冲突**(§1.3):公约 §3 的 15sp 正文 / 13sp 辅助说明,与仓库现有 `dimens.xml` 的 14sp/11sp 不一致,需与其他并行 UI 子任务对齐后再定新 Token,避免重复定义。 +2. **`radius_lg` 命名歧义**:`dimens.xml` 中同时存在 `radius_lg`(12dp,用于版型卡圆角) 与语义应为 20dp 的公约 `corner_radius_lg`(实际也已存在,20dp),两者数值不同但命名相似,容易在 XML 中引用错。@coder 落地时需明确:版型卡沿用现有 `radius_lg`(12dp,对应公约的 `corner-md`),不要误用 20dp 的 `corner_radius_lg`。 +3. **`color_secondary_container` 实际取值**:未在本次检索中读取 `colors.xml` 完整内容确认该值是否已是浅绿,需 @coder 核实(检索关键字:`color_secondary_container`)。 +4. **`MaxWidthXxxLayout` 自定义容器是否已存在**:检索关键字 `MaxWidth`、`CenteredContainer`、`widget`包下的自定义 ViewGroup,本次未做穷尽检索。 +5. **Material Components 版本对 `strokeColor` ColorStateList 的支持情况**:需 @coder 查看 `app/build.gradle` 中 `com.google.android.material:material` 版本号后确认,本次未检索 build.gradle。 +6. **`values-w600dp/` / `layout-w600dp/` 现为空目录**:是否有其他并行模块已计划使用这两个目录,需要与其他 7 个子任务协调,避免资源限定符策略打架。