原生前端改造指南.

已有可复用的壳、原型与核心。把它们接在一起，仍是一项明确的工程工作。

两套只读原生岛

现有资产jarvis-island 与 DynamicNotch 都保留着。可参考原生形态、屏幕处理和投影校验；正式壳尚需比较后唯一选定。

HTML 主面板原型

设计材料主面板与学习流程可供信息结构、材质和交互参考。演示数据与模拟日历不能充当正式 App 的业务状态。

原生动作桥未接通

接线缺口现有原生按钮保持只读禁用。逐卡路由、对象绑定、回执与超时语义需先定义，不能直接解除禁用。

正式事实继续由 SQLite 与既有 Coordinator 管理，确认走既有服务，日历走 Outbox；state.json 仅作受控只读投影。界面不另存一套事实。

先对齐三个决定，后续视觉与接线才能围绕同一份契约推进。

1. 选唯一的原生壳

   在现有两套工程中比较维护成本、主窗口、菜单栏、灵动岛与多屏支持，选定唯一宿主；另一套保留参考，不并行维护第三套正式客户端。若两套均不适合作主窗，可按完整规格提出复用岛引擎的唯一新宿主方案。

2. 逐卡写动作契约

   为每种卡列清身份、版本、可用动作、请求入口、回执、幂等、拒绝与超时。稍后、取消、信息错误、不存在不能被一个“跳过”混在一起。

3. 定义共享状态模型

   岛、主窗口与对话共用对象和状态词，保留新鲜度与版本。动作经过既有服务，Swift 不直接写领域 SQLite；缺失能力列出依赖，不在界面本地伪造。

回看前端设计顺序 ↗阅读完整动作与状态要求 ↗

每个动作都要让人知道：正在处理什么，结果到了哪一步，接下来能做什么。

同一对象

岛、主窗口和对话绑定同一对象与版本，重开窗口也能找回未处理事项。

先确认，后保存

来源事实、模型建议与用户选择分别标明。已入队只表示受理；只有领域提交回执成功后才显示“已保存”，不乐观移除未确认事项。

日历单独报告

Jarvis 已保存与日历已同步是两个结果。同步失败保留事实，并给出明确恢复入口。

过期与未知要可见

旧投影、过期卡片、等待超时与取消后的未知结果分别说明；没有回执就不写成功。

卡片锁保护眼前动作

指针、焦点或提交仍在卡片内时固定对象与版本。新提醒只更新数量；提交中冻结字段并防重复。

键盘与降级可完成

提供可见焦点、正确的焦点返回与减弱动效。无刘海用菜单栏入口，覆盖层不可用时仍可在主窗口完成。

Apple 可访问性来源 ↗焦点可见性来源 ↗

这是前端工作的推进顺序，不是完成标记，也不替代正式 S0–S9 阶段。

1. U0

   选壳与契约

   固定原生宿主、共享对象、逐卡动作和状态模型；先消除接线歧义。

2. U1

   灰阶外壳

   搭好主窗口、导航、菜单栏与岛的职责；先验证信息层级和键盘路径。

3. U2

   组件全状态

   把默认、加载、禁用、失败、重试、过期、取消与未知状态做完整，再加入视觉和轻动效。

4. U3

   真实单卡闭环

   用隔离数据接通一类已准入卡：录入、修改、确认，收到领域提交回执后更新保存状态，再核对投影、跨入口与重启恢复；日历结果单独报告。

5. U4

   拓展与试用

   在单卡闭环可靠后扩展场景，检查多屏、无刘海、通知打扰、可访问性与长期使用体验。

每一步以完整规格的交付物与成功标准过关。原生、真实用户数据、模型、IM 与 Calendar 的实际验收，需要对应证据。

从人会遇到的边界出发。不能只验“点击一次，顺利成功”。

• 重复提交连续操作只产生一次有效副作用。
• 过期请求拒绝过期卡片，并给出重新核对的下一步。
• 旧卡与新提醒眼前对象不被替换，旧版本不能误答新卡。
• 取消与迟到结果取消持久化确认后拒收后续结果；已先提交的事实保留，已发动作的未知状态如实显示。
• 关闭与重启关窗不等于拒绝；重启后能恢复真实未处理状态。
• 日历失败已保存事实保留，日历错误单独呈现并可恢复。
• 只用键盘可以到达、理解、确认与退出，焦点不会丢失。
• 无刘海与多屏菜单栏与主窗口可完成同一任务，屏幕切换不遮挡系统内容。

核对正式阶段与已有验收 ↗

历史基础 18 项资源，已够开始视觉探索、信息层级与动效讨论。本轮补充 8 项桌面专项来源，设计库现共 26 项；进入原生实施仍需按具体问题核对平台与状态细节。

资料是判断与验证的依据。页面观感通过，不代表原生动作、安全桥或真实平台链路已经验收。