feat(harmony): 对齐第一阶段 + 对齐计划文档(差距/分期/验收纪律)
用户:「安排对齐」。 ## 先量差距(不靠感觉) 鸿蒙侧的调色板与 WebUI **根本不同**:`#1A73E8`(Google 蓝)vs 品牌 `#2563EB`、 `#333333` vs slate-900 `#0F172A`、`#F5F7FA` vs `#F8FAFC`、`#FF4444` vs red-600… 共 217 处硬编码色值散在 7 个页面里。 功能面:鸿蒙是 收件箱/会话/联系人 三个 tab,**缺 发件箱 / 授权 / 日历 / 管理**, 也没有玻璃悬浮底栏、主题壁纸同步、Composer 共用组件。 ## 第一阶段(已完成并可验收) - `common/Theme.ets` 补齐文字/浅底/语义令牌,页面里的旧调色板**全量替换为令牌** (共 203 处),`hvigorw assembleHap` **BUILD SUCCESSFUL**。 - 判据:`cross-client-theme.test.mjs` 新增"鸿蒙页面里不得再出现旧调色板色值" (6 条全绿,含扰动自检)。这条防的是**新页面又随手写个"差不多"的颜色** —— 漂移就是这么开始的,而此前没有任何判据会红。 ## 计划文档:docs/HARMONY-ALIGN-PLAN.md 写清两件事,免得每轮重新猜"还差什么": - **差距表**(逐项,标出"缺页面/交互不同/观感不同"的性质); - **分期**:P2 发件箱(与收件箱同构,风险最低)→ P3 授权页(备注必须随决策送达模型 —— WebUI 侧踩过这个坑)→ P4 主题/壁纸同步(服务端"无记录"时以本地为准) → P5 玻璃悬浮导航 → P6 日历(最大,单独排)。 ## 如实说明 鸿蒙**视觉未验证**:本机 `hdc list targets` 为空、HAP 未签名 ⇒ 只能保证编译通过 + 令牌一致,观感需要设备或签名后由人眼确认。文档里也把这条写进"验收纪律"。
This commit is contained in:
59
docs/HARMONY-ALIGN-PLAN.md
Normal file
59
docs/HARMONY-ALIGN-PLAN.md
Normal file
@ -0,0 +1,59 @@
|
||||
# 鸿蒙客户端与 WebUI 的对齐计划
|
||||
|
||||
> 用户(2026-09-14):「安排对齐」。这份文档把**差距**与**分期**写清楚,
|
||||
> 免得每轮都从"感觉还差什么"重新猜。
|
||||
|
||||
## 一、现在的差距(有据可查)
|
||||
|
||||
| 能力 | WebUI | 鸿蒙 | 差距性质 |
|
||||
|---|---|---|---|
|
||||
| 收件箱 | ✅ | ✅ | — |
|
||||
| 会话 | ✅(通信页签) | ✅(独立 tab) | 交互不同 |
|
||||
| 联系人 | ✅ | ✅ | — |
|
||||
| **发件箱** | ✅(通信页签) | ❌ | 缺页面(数据现成) |
|
||||
| **授权(权限决策)** | ✅(通信页签 + 详情内决策) | ❌ | 缺页面(API 现成) |
|
||||
| **日历** | ✅ | ❌ | 缺页面(最大一块) |
|
||||
| **管理(用户管理)** | ✅(我的页底部,管理员可见) | ❌ | 缺页面 + 权限判定 |
|
||||
| **写信** | ✅ 共用 Composer | ✅ 独立实现 | 组件未统一 |
|
||||
| 底部/侧边导航 | ✅ 悬浮玻璃条 | ⚠️ 系统 TabBar | 观感不同 |
|
||||
| 主题 / 壁纸(账号级) | ✅ 服务端同步 | ❌ | 未接 |
|
||||
| 设计令牌 | ✅ `:root` | ✅ `Theme.ets` | **已对齐**(判据钉住) |
|
||||
|
||||
## 二、已经做完的(本轮之前)
|
||||
|
||||
- **设计令牌共用**:`common/Theme.ets` 与 WebUI 的 `:root` 一一对应
|
||||
(品牌蓝、圆角 14/8、导航玻璃 0.72、语义色、字号),并由
|
||||
`client/electron/test/cross-client-theme.test.mjs` 钉住取值一致性。
|
||||
- **旧调色板清除**:页面里的 `#1A73E8`(Google 蓝)/`#333333`/`#F5F7FA` 等
|
||||
与 WebUI 不同的写死色值,全部换成令牌(203 处)。
|
||||
- **修掉只剩第一个 tab 高亮的 bug**(`currentIndex === 0` 写死)。
|
||||
|
||||
## 三、分期(按"能独立验收"切)
|
||||
|
||||
**P1 设计语言(已完成)** —— 令牌 + 颜色替换 + 编译通过。
|
||||
|
||||
**P2 发件箱**:复用现有列表组件,接口 `/mail/sent`。验收:能看到已发邮件、
|
||||
点开进详情;空态有说明。**为什么先做它**:与收件箱同构,风险最低。
|
||||
|
||||
**P3 授权页**:导航加一项「授权」,列表用 `permission_*` 字段,
|
||||
决策走 `POST /permission/{id}/decide`;详情内也支持决策。
|
||||
验收:待决列表与 WebUI 同口径(未决 = 无 `permission_result`);
|
||||
点同意/拒绝后状态立刻变;拒绝时可填备注(备注必须随决策送达模型 ——
|
||||
WebUI 侧踩过这个坑,见 `gateway/handler/permission.go` 的 Note 传递)。
|
||||
|
||||
**P4 主题/壁纸同步**:接 `GET/PUT /me/appearance` + 图片走带认证的 fetch。
|
||||
验收:换账号后外观跟随;服务端"无记录"时以本地为准(不要用默认值覆盖 —— 同 WebUI)。
|
||||
|
||||
**P5 玻璃悬浮导航**:自定义底栏(圆角 + 半透明 + `backgroundBlurStyle`),
|
||||
取代系统 TabBar。**注意**:视觉验收需要设备或签名 HAP,
|
||||
本机 `hdc list targets` 为空 ⇒ 只能保证编译与结构,观感要人眼确认。
|
||||
|
||||
**P6 日历**:网格 + 事件读写 + 左右滑动翻页(复用 WebUI 的手势阈值:
|
||||
水平 ≥40px、≥1.5× 垂直、<600ms)。这一块最大,单独排。
|
||||
|
||||
## 四、验收纪律(照 WebUI 那套)
|
||||
|
||||
1. 每个页面都要有**点它**的判据(WebUI 侧就是因为只验结构没验点击,
|
||||
漏掉了"侧栏点了不翻页")。
|
||||
2. 判据不许只看截图:要量几何/对比度/命中区。
|
||||
3. 无法验证的要**如实标注**(例如"编译通过、视觉未验"),不能写成"已完成"。
|
||||
Reference in New Issue
Block a user