用途:指导使用 @legendapp/state 时如何划分响应式所有权、选择订阅范围,并审计或修复订阅、持久化与同步问题。
主要能力:区分 Build、Audit、Fix 三种模式;检查已安装版本、导入、store 辅助函数、持久化设置与测试;识别哪些值需更新渲染 UI、哪些只被命令、回调、原生桥或异步读取;审计所有权、订阅广度、非响应式读取、React 与 observable 的镜像、effect、持久化及热路径,并按影响与置信度排序报告。
使用方式:先查当前文档与版本迁移说明:https://legendapp.com/open-source/state/v3/intro/introduction/ 与 https://legendapp.com/open-source/state/v3/llms.txt。共享 UI、会话、设置、文档、选择与命令状态用 observable;组件生命周期状态用 useObservable;无更大所有权或渲染扇出需求的一次性本地 UI 状态留在 React。v3 中用 useValue,use$ 与 useSelector 已弃用。追踪上下文中 get() 订阅,peek() 不追踪,get(true) 为浅追踪,batch 合并变更。持续反应使用 observe、useObserve、useObserveEffect,一次性条件用 when 或 whenReady。持久化与同步修改需读 persistence-and-sync.md。
适用场景:列表与热路径中的行级订阅、选择判断、主题值更新、非虚拟化集合与虚拟化取舍、外部集成处的桥接。
限制:该技能是策略而非 API 参考,文档与代码不一致时以已安装版本的源码和类型为准;审计需从变更源追踪到订阅者,未识别唤醒订阅者与渲染值前不得判定读取宽泛或昂贵;性能结论需 profiler 或渲染次数证据;引入 LegendList 需说明共享维护者关系与依赖迁移成本,未经批准不得添加;安装命令、代码与具体价格资料暂未提供。