保存并恢复视图状态

维护期（已弃用）

@ahoo-wang/fetcher-viewer 已进入维护期（弃用），仅维护现有功能，不再新增功能。数据视图能力的后续演进由 @ahoo-wang/fetcher-view-engine 承担，新项目请使用 View Engine。本页保留供存量项目维护参考；两者模型与 API 不同，迁移需要适配。

前提

从完整本地 Viewer 示例开始。它明确使用 React 内存保存数据，可以无需服务端验证保存行为。是否需要刷新后保留、用户共享或服务端授权，要由应用另外决定。

连接保存回调

查看 LocalViewer.tsx 的 onCreateView、onUpdateView 和 onDeleteView。创建时用 crypto.randomUUID 分配 ID，更新应用的 savedViews，再用已接受的视图调用 onSuccess。更新按 ID 替换，删除按 ID 移除。Viewer 通过这些成功回调修改内部集合。

示例还显示 Saved: <name>，使接受动作可观察。点击保存按钮本身不证明已经持久化。由应用决定什么时候修改才算成功。

验证恢复

1. 按过滤指南应用 Active true 与 Name 降序。
2. 选择另存为，输入 Active descending 并确认，应出现 Saved: Active descending。
3. 切换到 All users，第 1 页恢复 Ada、Lin。
4. 切换到 Active descending，恢复 Grace、Ada，以及 true 过滤和降序表头。
5. 刷新或重新挂载本地应用，新保存视图消失，因为存储所有者是内存。

保存状态包含每页大小、列、过滤器、条件和排序。示例切换视图从第 1 页开始，当前页码不是保存的偏好。

需要时接入真实持久化

将内存回调替换成存储或 API 操作，等待接受后再用确认的视图调用成功回调。创建时保留服务端返回的 ID。后端必须验证定义身份与允许的视图归属。失败时显示错误，不调用成功回调，让用户能够重试或取消。不要把本地更新报告为服务端确认。

localStorage 适配器可在一个浏览器配置内持久化，但不提供服务端共享或权限。FetcherViewer 使用独立的 Wow 修改协议，只有满足远端契约才应采用。

清理与错误

所有者切换时停止等待中的应用修改，并忽略属于旧身份的结果。取消网络请求不能撤销服务端修改。组件内存保存不需要外部监听清理；存储订阅与共享总线需要。保留可见失败信息，不要为了关闭对话框就调用成功回调。

参阅保存视图参考、存储集成与状态归属。