用途:介绍 Amethyst 客户端的账户状态与本地缓存架构。Account 表示每个已登录用户的派生视图,LocalCache 是保存所有已见 Note 与 User 的单例事件存储。适用于修改 Account.kt、LocalCache.kt,新增账户级设置(静音、书签、自定义中继列表、私有列表),读写用户元数据或笔记状态,以及判断该查询 LocalCache 还是订阅 Account 的 StateFlow。
主要能力:Account 持有 50 多个状态对象,每个对应特定 Nostr kind,如 kind3FollowList(NIP-02 kind 3)、nip65RelayList(NIP-65 kind 10002)及 dmRelayList、searchRelayList 等,muteList(NIP-51 kind 10000)、bookmarkState(kind 10003)等。每个 XState 类通过 cache.getOrCreateAddressableNote 固定可寻址笔记,暴露由笔记元数据流派生的 StateFlow,并提供 suspend 变更辅助方法。加密列表配有 DecryptionCache。LocalCache 使用 LargeCache 保存 notes、users、addressables 等,LocalCacheFlow 发出粗粒度变更信号,细粒度响应式由 Account 的各 kind StateFlow 承担。
使用方式:渲染具体笔记或用户时用 LocalCache.getOrCreateNote(id) 并收集 note.flowSet.metadata;渲染“我的关注/静音/中继”时用 account.<feature>.flow;渲染信息流时用 FeedFilter 与 FeedViewModel。新增账户级设置需选择合适 kind,在 model/nipXX 下仿照现有 XState 类创建,固定可寻址笔记、暴露 flow、添加 suspend 变更方法,并在 Account.kt 中实例化。
限制:LocalCache 跨账户单例,切换账户不会清空;不要期望 Flow 在 Note/User 被驱逐后仍存活;状态对象的变更方法只返回已签名事件,发布由调用方负责;Note 可变,需按身份对待;Android 上 MemoryTrimmingService 可能激进驱逐,不能假设笔记仍在内存。具体实现细节以官方资料为准,部分内容暂未提供。