用途:查询 Electric Agent Runtime 的实体流(entity streams)与 manifest 状态,读取内置实体集合。使用前应先阅读 packages/state/skills/stream-db/SKILL.md 了解 StreamDB 与查询基础。
主要能力与用法:对 db.collections.* 使用直接的类型化查询。一次性读取优先用 queryOnce(...);响应式 UI 用 useLiveQuery(...) 或共享的 live query 集合。不要为显而易见的查询新增导出的便捷读取辅助函数,查询本身就是 API。仅对真正的不变量保留代码辅助,例如 manifest key 构建器、类型化事件/写入辅助、面向产品的共享投影(如实体时间线查询)。在运行时、测试、示例和 CLI 代码中,当读取天然是查询形态时,优先使用直接查询而非原始 toArray 扫描。不要对 db.collections.* 做类型转换,行类型来自 schema。
参考文档:references/collections.md 列出内置实体集合与 manifest 行类型;references/common-queries.md 给出常见查询模式。写入实体流或共享状态流时,使用类型化事件辅助函数/服务端 API,不要手工构建流事件信封。
限制:资料未提供具体安装命令、版本要求、平台支持或收费信息。