【拆解】鸿蒙端对齐网页端：补齐 6 项未完成的功能 #22

New Issue

2026-10-28T12:52:45Z

laoyang commented

2026-10-28 12:52:45 +00:00

背景

用户 2026-10-28：「全员检查后门客户端（=鸿蒙客户端）的全部功能，看是不是都已经和网页端对齐，有没有没有完成的，有完成的抓紧时间尽快完成。」

已对两端做了系统盘点：逐模块对比了 Web 端模板、路由、API 端点，与鸿蒙端页面、FB_MODULES 清单、API 调用清单、代码里的占位/「暂未开放」标记。

结论

鸿蒙端 11 个业务模块基本对齐，但有 6 项「没完成」的功能欠账，其余都是对的。

其中两项不是缺口（用户此前明确要求从鸿蒙端删掉，勿补回）：

家谱（kin）：v74（2026-10-21）用户原话「家谱的相关功能，都删除」——端上已删，服务端 /api/v1/kin 仍保留（Web 在用）。
个人导航（nav）：用户明确「导航是专门为电脑端开发的，手机上不需要」。

6 项欠账（见子单，按依赖拆分）

子单	缺什么	端上现状	改动落点
资源	附件上传 + 共享给谁	明说「App 暂未开放」	服务端补 API + 端上 UI
电影	写影评/短评 + 评论	只能看评分	服务端补 API + 端上 UI
任务	共享给谁	无入口	服务端补 API + 端上 UI
读书	在线读 + 上传 EPUB + 笔记导入	明说「仍在网页端」	服务端补 API + 端上 UI
财务	折线图/趋势图	「第二轮接图表」占位	纯端上（可能补时序接口）
笔记	图片块（图文混排）	图片显示「[图片]」	纯端上

推进顺序

先做纯端上的两项（笔记图片块、财务折线图，不动服务端、见效快），再做需要「服务端 API + 端上 UI」双端联动的四项；读书那项因涉及文件上传与 EPUB 解析链路，放最后。

## 背景用户 2026-10-28：「全员检查后门客户端（=鸿蒙客户端）的全部功能，看是不是都已经和网页端对齐，有没有没有完成的，有完成的抓紧时间尽快完成。」已对两端做了系统盘点：逐模块对比了 Web 端模板、路由、API 端点，与鸿蒙端页面、`FB_MODULES` 清单、API 调用清单、代码里的占位/「暂未开放」标记。 ## 结论 **鸿蒙端 11 个业务模块基本对齐，但有 6 项「没完成」的功能欠账**，其余都是对的。其中两项**不是缺口**（用户此前明确要求从鸿蒙端删掉，勿补回）： - **家谱（kin）**：v74（2026-10-21）用户原话「家谱的相关功能，都删除」——端上已删，服务端 `/api/v1/kin` 仍保留（Web 在用）。 - **个人导航（nav）**：用户明确「导航是专门为电脑端开发的，手机上不需要」。 ## 6 项欠账（见子单，按依赖拆分） | 子单 | 缺什么 | 端上现状 | 改动落点 | |---|---|---|---| | 资源 | 附件上传 + 共享给谁 | 明说「App 暂未开放」 | 服务端补 API + 端上 UI | | 电影 | 写影评/短评 + 评论 | 只能看评分 | 服务端补 API + 端上 UI | | 任务 | 共享给谁 | 无入口 | 服务端补 API + 端上 UI | | 读书 | 在线读 + 上传 EPUB + 笔记导入 | 明说「仍在网页端」 | 服务端补 API + 端上 UI | | 财务 | 折线图/趋势图 | 「第二轮接图表」占位 | 纯端上（可能补时序接口） | | 笔记 | 图片块（图文混排） | 图片显示「[图片]」 | 纯端上 | ## 推进顺序先做纯端上的两项（笔记图片块、财务折线图，不动服务端、见效快），再做需要「服务端 API + 端上 UI」双端联动的四项；读书那项因涉及文件上传与 EPUB 解析链路，放最后。

laoyang commented

2026-10-28 12:53:25 +00:00

子单分配（同一需求：鸿蒙端对齐网页端）

工单	内容	类型
#23	笔记图片块（image 块显示成「[图片]」）	纯端上
#24	财务折线图（概览卡「折线图占位」）	纯端上（可能补时序接口）
#25	资源附件 + 共享给谁	服务端 API + 端上 UI
#26	任务共享给谁	服务端 API + 端上 UI
#27	电影影评 + 评论	服务端 API + 端上 UI
#28	读书上传 EPUB / 在线读 / 笔记导入	服务端 API + 端上 UI（最重）

推进顺序：先 #23、#24（纯端上），再 #25→#27（双端联动），#28 收尾。
不补：家谱（kin）、个人导航（nav）——用户此前明确要求从鸿蒙端删除。

各子单的 body 已写清现象、现状依据、要做的、验收标准。

## 子单分配（同一需求：鸿蒙端对齐网页端） | 工单 | 内容 | 类型 | |---|---|---| | #23 | 笔记图片块（image 块显示成「[图片]」） | 纯端上 | | #24 | 财务折线图（概览卡「折线图占位」） | 纯端上（可能补时序接口） | | #25 | 资源附件 + 共享给谁 | 服务端 API + 端上 UI | | #26 | 任务共享给谁 | 服务端 API + 端上 UI | | #27 | 电影影评 + 评论 | 服务端 API + 端上 UI | | #28 | 读书上传 EPUB / 在线读 / 笔记导入 | 服务端 API + 端上 UI（最重） | **推进顺序**：先 #23、#24（纯端上），再 #25→#27（双端联动），#28 收尾。 **不补**：家谱（kin）、个人导航（nav）——用户此前明确要求从鸿蒙端删除。各子单的 body 已写清现象、现状依据、要做的、验收标准。

laoyang commented

2026-10-28 14:49:17 +00:00

收尾：6 项子单全部完成

「鸿蒙端对齐网页端」大盘点出的 6 项欠账已全部补齐、验证、部署，6 张子单已全部关闭：

工单	内容	服务端 commit	鸿蒙端 commit
#23	笔记图片块（图文混排）	`cd56a9d`	`9784602`
#24	财务折线图	`e44f37e`	`6f360fd`
#25	资源附件 + 共享	`47247e3`	`f93dd92`
#26	任务共享	`ad71c80`	`59a9d3d`
#27	电影影评 + 评论	`b6dc604`	`f1f279f`
#28	读书上传 / 在线读 / 笔记导入	`42aff02`	`f5a979f`

过程中的几个关键发现（都比表面更深一层）

#23 不只是「显示成 [图片]」：端上原来只传 body 保存，服务端会折成单个
text 块整组替换 ⇒ 编辑带图笔记会把图片块静默删光（P0 数据丢失，一并修了）。
#27 服务端已有半成品但坏了 3 处：comments 的参数完全错位、GET 写死「只有我写过才返回」、
缺删除端点 —— 不是从零补，是修 + 补。
#24 数据源服务端早有（Ledger::timeline），只缺 API，一行端点就打通。
越权访问一律返回 404 而非 403（find 对看不到的资源返 null），更安全 ——
判据不写死具体码。

验证总览

每项都有：服务端本地 API 冒烟（真实 HTTP + 真实库）+ 注入反证（判据有牙齿）+ 端上编译。

冒烟：11/0、8/0、21/0、13/0、22/0、11/0
反证：每项注掉对应分支都变红在预期编号
鸿蒙端编译全部 BUILD SUCCESSFUL，守卫 1324/0

部署

服务端最后一个批次 20261028-224748 已部署上线，两仓库全部 push。

⚠️ 遗留：真机点验

6 项全是「观感 + 手感」性质，本地只能保证「编译过 + 代码正确 + 服务端数据对」。
真机上的实际操作（插图、拖签、翻章阅读、评分星、选文件上传…）要等你设备恢复
（hdc list targets 现在还是 [Empty]，USB 物理层断了）再逐项点验。

如果点验发现问题，直接说，我按对应子单号追加评论继续修。

## 收尾：6 项子单全部完成「鸿蒙端对齐网页端」大盘点出的 6 项欠账已**全部补齐、验证、部署**，6 张子单已全部关闭： | 工单 | 内容 | 服务端 commit | 鸿蒙端 commit | |---|---|---|---| | #23 | 笔记图片块（图文混排） | `cd56a9d` | `9784602` | | #24 | 财务折线图 | `e44f37e` | `6f360fd` | | #25 | 资源附件 + 共享 | `47247e3` | `f93dd92` | | #26 | 任务共享 | `ad71c80` | `59a9d3d` | | #27 | 电影影评 + 评论 | `b6dc604` | `f1f279f` | | #28 | 读书上传 / 在线读 / 笔记导入 | `42aff02` | `f5a979f` | ### 过程中的几个关键发现（都比表面更深一层） 1. **#23 不只是「显示成 [图片]」**：端上原来只传 `body` 保存，服务端会折成单个 text 块整组替换 ⇒ **编辑带图笔记会把图片块静默删光**（P0 数据丢失，一并修了）。 2. **#27 服务端已有半成品但坏了 3 处**：comments 的参数完全错位、GET 写死「只有我写过才返回」、缺删除端点 —— 不是从零补，是修 + 补。 3. **#24 数据源服务端早有**（`Ledger::timeline`），只缺 API，一行端点就打通。 4. **越权访问一律返回 404 而非 403**（`find` 对看不到的资源返 null），更安全 —— 判据不写死具体码。 ### 验证总览每项都有：服务端本地 API 冒烟（真实 HTTP + 真实库）+ 注入反证（判据有牙齿）+ 端上编译。 - 冒烟：11/0、8/0、21/0、13/0、22/0、11/0 - 反证：每项注掉对应分支都变红在预期编号 - 鸿蒙端编译全部 **BUILD SUCCESSFUL**，守卫 1324/0 ### 部署服务端最后一个批次 `20261028-224748` 已部署上线，两仓库全部 push。 ### ⚠️ 遗留：真机点验 6 项全是「观感 + 手感」性质，本地只能保证「编译过 + 代码正确 + 服务端数据对」。真机上的实际操作（插图、拖签、翻章阅读、评分星、选文件上传…）要等你设备恢复（`hdc list targets` 现在还是 `[Empty]`，USB 物理层断了）再逐项点验。如果点验发现问题，直接说，我按对应子单号追加评论继续修。

laoyang closed this issue

2026-10-28 14:49:17 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: laoyang/FamilyBook#22