laoyang/FamilyBook_harmonyos
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity
93 Commits 1 Branch 0 Tags
d4b9d08b7e36cf5fc6e732a4bde662b302319111
Commit Graph
5 Commits
Author SHA1 Message Date
laoyang aafd83b130 悬浮栏选中底圆角：999 -> 12，不再那么圆鼓 (#58) 
用户 2026-11-05：「颜色我感觉透明度什么的还是可以的，但是这个圆有点太圆了，
应该弄成更椭圆一点，效果可能是不是更好啊？」

borderRadius(999) 会把 40 高的块钳成两端完整半圆，看着很圆鼓。
改成 12：圆角半径只占高度的 30%，是"柔和的圆角矩形"，
视觉更平更舒展，也与 dock 外框的大圆角（28）形成内外层次。

ArkUI 的 borderRadius 是等比圆角（四角半径相同、正圆圆弧），
没有"椭圆角"（x/y 半径不同）的写法 —— 所以"更椭圆"只能靠减小半径近似，
半径越小圆弧越平。

实机偏圆就降到 10，偏方就加到 14，改动只有这一个数字。
 2026-11-05 13:25:06 +08:00
laoyang 5d9902bb82 底部悬浮栏：选中项加灰色椭圆底 (#58) 
用户 2026-11-05：「当选中其中一个按钮之后，它除了图标和文字颜色发生变化，
还给它加了一个那种椭圆的那种框那种背景，灰色的。这样更能清晰表示
现在正在被选中是哪一个功能。」

原来选中态只有变色 + 加粗，没有背景，观感偏弱。

结构上关键：不能直接给 Column 加 backgroundColor + borderRadius ——
那个 Column 是 layoutWeight(1)，椭圆会撑满整格，看起来像"选中了一整块"。
套两层：外层等分格（透明，负责布局与热区）+ 内层椭圆（自适应内容宽高）。

底色用半透明黑 #14000000 而不是实色灰：
dock 底色是 EBFFFFFF（92% 白叠模糊层），实色灰在深色系统主题下会突兀；
半透明黑与背景混合，浅色下浅灰、深色下深灰，两种主题都协调。

borderRadius 用 999 而非固定值：固定值在标签变长时圆角比例会失调。
 2026-11-05 13:21:34 +08:00
laoyang f020a671c0 v0.8.1 界面六条：删离线入口 / 标语统一 / 最近纪念日 / 图标真上色 / 真头像 / 日程四修 
用户 2026-10-18 六条（全部已在真机逐条验证）：

① 登录页「先不登录 / 离线使用」彻底删除
   用户：「把那些不登录、看离线数据之类的提示全部去掉。以后就不再拥有这样的
   功能了，把这些功能也全部删除。」
   ⇒ 两个按钮 + onSkip + allowSkip 参数 + Index 里的 skip 分支一起删净。
   这是产品决定（不是隐藏）：该路径本身就是安全缺口，v58 上了整库加密后更要堵死。

② 标语统一为「一家人用岁月写成的一本书」
   用户：「这也是我们"家书"这个名字的由来。所以你不要再乱换这个标语了，
   只要是想出现标语或者副标题的地方，就用这样一句话。」
   · 端上 FB_DEFAULT_SLOGAN 是唯一定义处（登录页副标题 + 抽屉回落都用它）；
   · 抽屉左上角原来是家庭名，现在显示**标语**；
   · 三层优先级（个人 slogan → 家庭 motto → 应用默认口号）**在服务端算**
     （Family::slogan，与网页端首页 heroSlogan 同一套），/login 与 /me 都返回。
   用户还说：「如果这个用户自己有标语……这个地方就是用户自己自定义的标语。」
   真机实测：登录者杨永全自己写了「修身，齐家」⇒ 抽屉就显示他那句。

③ 首页新增「最近纪念日」（放在近期任务之后、往年的今天之前）
   用户：「未来最近的三个纪念日，包括每个人的生日，以及手动填写的各个纪念日。
   以倒计时形式展示：距离哪个纪念日还有多少天，距离谁谁谁的生日还有多少天。」
   · /home.recent_days = Anniversary::upcoming(fam,pid,370) 取前 3 ——
     取满一年：窗口太小会让"刚过完生日"的家庭一个都取不到，模块直接空着；
   · 数据源 all() = 派生生日 + 自建纪念日，正好覆盖用户说的两样；
   · 倒计时：0 天显示「就是今天」（写「还有 0 天」读起来像已经过了）。

④ 悬浮栏图标也上色（用户：「除了下面的汉字，上面图标的颜色也变成跟汉字一样的颜色」）
   🔴🔴 真根因两层，都是"无报错失效"：
   · 第一层：Image.fillColor() **只对 SVG 生效**，而本工程 30+ 图标**全是 PNG**
     ⇒ 全工程 24 处图标染色一直是空操作（文字走 fontColor 所以只有文字变了）。
   · 第二层（真机才现形）：改用 colorFilter 后，矩阵写成了"系数乘 RGB"
     (R' = R_原 × 系数) —— 对白色图标成立，但本工程图标是**纯黑**，
     黑 × 任何系数 = 仍是黑 ⇒ 真机上图标像素依旧是 (0,0,0)。
   ⇒ 最终形态：`fbTint` 用 **alpha 当载体**（R' = (r/255) × A_原）：
     系数是归一化约定（官方灰度示例系数和为 1，量纲确定）；
     形状完全由原图 alpha 决定 ⇒ 黑/白图标都成立，描边抗锯齿自然过渡。
   真机像素实测：日程项图标与文字同为 (176,120,64)≈#B0763A；
   未选中项图标 (44,39,35) 深灰（不再是纯黑）。
   ⚠️ 全工程 24 处 fillColor 一并改掉；FbIconButton.tint 类型改成 string，
      让"误传 Resource"变成编译错误而不是又一个静默失效。

⑤ 顶栏：真实头像 + 拉开按钮间距
   用户：「右上角的头像应该是真实的……现在提醒的按钮距离头像的按钮太近了。」
   · /home 给 me_avatar、/login 给 avatar_url（avatar_url() 按线上存储驱动拼好）；
   · 三颗按钮（同步 / 铃铛 / 头像）统一用 FbMetric.gapTopActions = 8。

⑥ 日程四处
   · 「日期下面有几个点」⇒ 月视图与周视图的圆点全部删除，
     连 FbDot / dots() / count / dotColor 一起清（不留死代码）；
   · 「农历全部都是初一」⇒ 真根因是端上 lunarOf() **硬编码 return '初一'**，
     而服务端 lunarRange() 本来就每天给真实农历（title）⇒ 改取 title；
   · 「列表这个视图，今天的数据缺一条」⇒ 服务端 /calendar 的 from/to **默认只给本月**，
     而列表视图要显示 -7 ~ +60 天 ⇒ 端上显式传范围
     （loadModule 新增 pathOverride 参数）；
   · 「点击了某一天之后并不明显，应该把这一天的颜色变深，而今天用一个较浅的颜色」
     ⇒ 照 SyncCalendar：选中 = 深色实底白字、今天 = 浅色底。
       真机实测：17 号（选中）bg=#FFB0763A，18 号（今天）bg=#FFF5F0EA。

另：FbKeyStore 补上一个真机抓到的 HUKS 坑 —— isKeyItemExist 在密钥不存在时
**会抛 12000011**（不是返回 false），首次运行必被误判成"本机不支持 HUKS"
⇒ 永久明文降级。改成把"不存在"当正常分支，且降级态每次启动重试一次
（把同一把 DEK 重新用 KEK 包起来，不换密钥以免重下全部附件）。

验证：hvigor BUILD SUCCESSFUL；_fb_arkts_guard.js 328/0；
_fb_v59ui_falsify.py 19 项注入 23/0；_fb_home_api.py 60/0；
六条已在真机逐条取像素/布局树确认。
 2026-10-18 20:14:40 +08:00
laoyang 776c95ba0b v0.7.0 接上真实服务器：登录 / 设备会话 / 全量同步与各模块真实数据 
从「演示数据壳子」走到「真的能连家里的服务器用」。

登录（用户 2026-10-17「完整的登录功能」）
  · 首次启动先填服务器地址 → /api/v1/ping 自报门户（认得出"这地址上真是家书"）
  · 手机号或用户名 + 密码 → 拿令牌；失败提示统一，不泄露账号是否存在
  · FbDeviceStore：首次启动生成并持久化设备 UUID（三方应用拿不到 UDID），
    设备名取机型（marketName），并上报 platform / app_version

设备会话（v57，用户 2026-10-17）
  · 一把令牌 = 一台设备的一条会话；每次启动打一次 /me（有网就验）
  · 两种锁分开：need_login（401/被踢 → 清令牌）与 offline_expired
    （离线超 24h → 只锁界面、不清数据、联网自动恢复）——
    混成一种就会违背用户要的"一直联网就不用每天输密码"
  · 运行期任何请求 401 → 网络层全局回调立刻锁定跳登录页（FbHttp 的 authProbe
    让登录/校验类请求跳过，避免"两个地方同时跳登录页"）
  · 退出登录：先清本地令牌（主防线），再尽力通知服务端
  · 设置页显示版本号与「这台设备」

数据层
  · FbDb / FbSchema / FbParse / 各 Repo（日程 / 名册 / 观影 / 模块）+ FbSyncAll
  · 首页改为服务端 /home（农历/节气/纪念日/生日/天气/统计/往年的今天）
  · 日程页用 FbDayEventPanel，与网页端显示方式/红线/并排三处一致

验证：ArkTS 静态守卫 231/0；hvigor 编译 BUILD SUCCESSFUL（entry-default-signed.hap）。
 2026-10-18 03:36:04 +08:00
laoyang 7eaa641437 v0.6.0 图标改为开抽屉入口 + 新增底部悬浮快捷栏（照鸿蒙 6 悬浮导航规范） 
用户 2026-10-12 三条要求。

## ① 点顶栏图标 = 开抽屉
用户：「把那个图标改成这个功能吧，就是当用户点击左上角那个图标的时候，把抽屉列出来」。
⇒ `TopBar` 的 logo 加 `.onClick { drawerOpen = true }`。
⚠️ 点击直接挂在 Image 上、**不套 Button** —— Button 自带最小尺寸与内边距，
会把图标挤离左边线（用户要"图标靠左"）。
⇒ 开抽屉现有三个入口：点图标 / 应用内水平滑动 / 底部悬浮栏。

## ② 底部悬浮快捷栏 FbFloatDock（新增）
用户：「页面正下方设置几个浮动按钮…比如日程、名册、任务和笔记…
        这样用户不用拉抽屉，就可以直接点击使用。
        但一定要注意，使用浮动的方式，**不要固定在下面**，而是**浮动着的**。」

🔴 **形态照鸿蒙 6 官方设计规范的「悬浮导航（Float Navigation）」**：
「导航栏脱离底部边界，以**四周留白、圆角卡片**形态悬浮于内容之上」。
参考实现参数直接用上：`height(56) + margin({left:16,right:16,bottom:16})
+ borderRadius(28)`，材质用系统沉浸材质
`uiMaterial.ImmersiveMaterial({ style: ULTRA_THIN })`（设计规范的"超薄"档）。
⚠️ 用了 systemMaterial 就不再叠加 backgroundBlurStyle/backgroundColor ——
   材质自带模糊+边框+阴影，叠加会双重模糊发灰。

⚠️ **摆法关键**：`Index` 的根容器从 `Column` 改成
`Stack({ alignContent: Bottom })` —— 写在 Column 里它就是"占一行的固定底栏"
（老样式）；用 Stack 覆盖 ⇒ 内容从它下面穿过、它浮在上面。
（实测印证：栏体 y=2132..2307，而"我的家人"标题在 y=2336 仍可见 ⇒ 内容穿过去了。）

⚠️ 内容底部加 `FB_DOCK_RESERVE`(88vp) 预留，否则最后一屏内容会被悬浮栏压住。
12 个页面统一处理。
⚠️ 宽屏不显示（抽屉常驻，且屏宽用不上）；抽屉展开时也不显示（避免浮层叠浮层）。
⚠️ 选中项用模块主题色高亮，用户一眼知道"我在哪"。

## 验证（真机，全部通过）
· 点顶栏图标 ⇒ 抽屉打开 ✓
· 点悬浮栏「任务」⇒ 切到任务页 ✓；点「日程」⇒ 切到日程页 ✓
· 悬浮栏几何：栏体 x=21..1060、y=2132..2307（高 58vp），
  栏外 x=0..20 为纸色 ⇒ **四周留白** 符合规范 ✓
· 栏内呈半透材质色(#EFEBE2) ⇒ `ImmersiveMaterial` 生效 ✓
· 14 页遍历 **14/14**；深验 **12/12**；编译 **0 error / 0 warning**

## 过程中的一个坑
给 12 个页面补 `FB_DOCK_RESERVE` 的 import 时，脚本统一写成
`'../components/FloatDock'` —— 但**页面在 `pages/<模块>/` 下，需要 `../../`**
（`Index.ets` 在 `pages/` 下才是 `../`）。批量改 import 路径要按**文件深度**区分。
 2026-10-12 12:06:00 +08:00