用途:让 Claude Science 查询自身会话数据库,实现自省。核心入口是 repl 工具中的 host.query(sql, params=[], limit=None, df=False),对自身元数据 SQLite 库执行只读 SQL,结果自动限定在当前项目(memories 限定当前用户)。
主要能力:可查询会话帧(frames,含 token、成本、状态、context_data)、压缩归档、通知、项目、笔记、工件与版本、依赖、执行日志(execution_log)、host 调用日志、远程计算用量、声明与验证检查、记忆等。支持 PRAGMA/EXPLAIN 做模式自省。
用法要点:仅 SELECT/WITH/PRAGMA/EXPLAIN,单条语句,用 ? 占位符配 params。时间戳为毫秒(created_at > strftime('%s','now','-1 day')*1000),布尔为 0/1,JSON 列用 json_extract。默认 200 行、最大 1000 行,单元格超 2000 字符截断,总输出约 10 万字符上限,5 秒超时。repl 仅标准库,df=True 返回原始 dict,需 pandas 时写入 handoff/q.json 再在 python 单元加载。
限制:schema 限定名(main./temp.)被拒;secrets、agent/skill/connector 配置、host_grants、compute_providers 等表被拒,需改用对应 SDK 访问器;拒绝名单按词边界匹配,别名或字符串字面量同名也会被拒。host 身份信息不在此库暴露。repl 与 python 是独立进程,仅共享工作区,数据需经 ./handoff/*.json 传递。