把液态玻璃放下之后，
我们怎样做这个客户端。

01 / SUMMARY结论先行。

这不是一份“设想中的方案”。截至 0.5.2，客户端已经完成时间线、发现、友链、详情、评论、九图发布、草稿 / 队列、6 种扩展卡、热力图、Zen、按月侧栏、主题色盘与纸张背景的完整闭环。

这份手记用源码、线上实例、模拟器实测和 26 条 mock 数据替换了初版的估算与推演。它不试图证明一切都已完成，而是把已经验证的、尚未验证的、明确不做的，分开讲清楚。

02 / PLATFORM平台不只有发帖接口。

Ech0 是自托管的个人微博客 / 说说平台。它的极简部署形态是最重要的产品特征：单个 Go 二进制同时提供 REST API 与内嵌 Vue3 SPA，默认 SQLite；OpenAPI 由 Huma 类型生成。前台是“时间线 + 说说 + 评论 + 友链”的轻社区，后台是完整的管理面板。

这决定了移动端不该做成一个“只会发帖的壳”。但平台的能力边界同样重要，尤其是下面这些会直接影响 UI 文案的约束：

• 发帖、上传、建标签仅限管理员。普通用户仍可浏览、点赞、评论；发布入口必须如实显示权限，不诱导。
• private 是布尔值。只有公开 / 私密，没有好友可见、密码可见等分级。客户端不能伪造不存在的选项。
• 没有草稿 API。草稿箱只能是本地能力，换设备不同步；这一点必须在界面里说清楚。
• 点赞没有 unlike。服务端只提供点赞，客户端记录已赞状态，重复取消时提示“服务端不支持取消”。
• refresh token 在 HttpOnly cookie 里。原生客户端需要持久化 CookieJar，401 时自动续期并重放一次。
• 友链是实例对实例。Hub 必须按来源分页、失败隔离，不能因为一个实例超时就整页空白。

API 契约本身并不复杂：统一信封 {code, msg, data}，Authorization: Bearer，X-Timezone / X-Locale；时间线用 POST /api/echo/query 分页，发布用全量替换的 POST /api/echo，上传拿 24 小时临时 file_id，发帖时转正。真正花时间的是把这些契约在手机上做得顺手，而不是把接口逐个包一层。

03 / DESIGN玻璃适合展示，时间线需要稳定。

初版方案想把 backdrop 的液态玻璃铺满全站：lens 折射、边缘高光、嵌套玻璃，视觉记忆点最强。真正把列表、评论、编辑器、输入法和低端机跑一遍之后，结论变了。

最终方案：MD3E 做全站骨架，保留 AndroidLiquidGlass-kmp 的动效与 tokens 作为参考；玻璃皮肤留到 P2，不在 0.5.2 引入依赖。这个决定让 0.5.x 的迭代速度从“调 shader”回到“补功能”。

04 / PAPER把背景调回纸的温度。

0.5.2 把内置「纸张」从偏橙的奶油色改成更接近宣纸的低饱和暖白，并同步调整深色纸张。目标不是“更黄”，而是让背景和 surfaceContainerLow 卡片、留白、蓝色主色在同一个温度里。

截图里能明显看到顶部与卡片之间的过渡更干净。默认蓝 #0B57D0 仍是唯一的强调色；用户可以在 160dp 的色相 / 饱和度色盘上自由取色，恢复默认一键返回。

05 / ENGINEERING六个真实取舍。

// 修复前：引用不变，缓存不会失效
val normalized = remember(days) { ... }

// 修复后：用内容快照作为 key
val normalized = remember(days.toList()) { ... }

06 / VALIDATION哪些验证过，哪些还没。

我们尽量不把“代码路径存在”写成“功能已验证”。下面这张表区分了本轮实测、代码实现和仍需复验的部分。

已知边界

• 管理面板（评论审核 / 文件管理 / 系统日志 / 设置）仍在 Web；App 只做轻量入口。
• Copilot SSE、Access Token 管理、S3 预签名直传尚未做 UI。
• 用户资料编辑 / 头像上传未做。
• 草稿与队列是本地能力，不跨设备同步。
• 截图数据来自 mock，不代表真实生产内容；线上实例仍需代理访问。
• 仅 Android；iOS / Web 不在本期范围。

07 / VERSIONS九个版本，九次收敛。

1. 0.2.0
   首个 MD3E 版本：时间线、发现、友链、我的、About、写说说、草稿 / 队列、主题与缓存基础。起点
2. 0.3.0
   启动静默同步、160dp 色盘、更新检查、点赞统一。
3. 0.3.1
   编辑说说、图片查看器、画质、话题、定位。
4. 0.3.2
   友链分页 / 远端详情、自定义背景、服务端资料。
5. 0.3.3
   修复检查更新仓库迁移。
6. 0.4.0
   低流量模式、图片手势、6 种扩展卡、补记选择器、评论默认身份。
7. 0.5.0
   长文折叠、二级评论、Markdown 图片、卡片粘贴识别、音乐播放。
8. 0.5.1
   按月侧栏、评论重构、草稿编辑、背景模糊。
9. 0.5.2
   详情缓存、底部渐变、友链头像、刷新去重、纸张调色、热力图修复。当前

08 / NEXT下一步。

1. 0.6 管理轻量版：评论审核 / 置顶 / 删除、文件管理、访客统计，让管理员在手机上处理 80% 的日常操作。
2. Copilot：SSE 流式对话 + 近况总结，先做只读，再开放管理动作。
3. 玻璃皮肤 P2：用 backdrop 做 1–2 个展示型页面（关于 / 启动 / 分享卡），不铺全站。
4. 质量：Baseline Profile、Compose 稳定性、固定 mock 数据与状态栏的截图回归。
5. 发布：把最新 APK、SHA-256 与 16 张截图同步到网站和 GitHub Releases。