用途:Bookstrap 的 /bookstrap-query 命令用于对 Bookstrap 数据库执行即席查询,便于交互式探索书稿知识库,例如了解数据库对某主题的记录、核验论断的来源覆盖、探索人物关系与出场、检查时间线一致性、查找相关内容与实体、排查知识缺口。
主要能力:接受关于书稿内容、实体或来源的自然语言问题,并分析问题判断查询类型,译为相应 SurrealDB 查询,包括语义搜索(向量相似度)、图遍历(人物关系与出场、来源支持链)、时间线(按 sequence 排序的事件)、来源引用(查找支持某论断的来源)以及混合查询(语义+图+时间线组合)。结果会分组展示实体、来源引用、相似度分数,并按时间顺序呈现时间线、突出关键关系。
使用方式:命令形式如 /bookstrap-query "What do we know about Anna's time in Lyon?"。执行流程为先解析自然语言问题,识别查询类型、实体引用、时间约束与关系类型;语义或混合查询需生成嵌入:python scripts/generate-embedding.py --text "$user_question" --config bookstrap.config.json;然后依据 bookstrap.config.json 构造并执行 SurrealDB 查询,例如:surreal sql --conn http://localhost:2665 --user root --pass root --ns $NAMESPACE --db $DB_NAME --query "$CONSTRUCTED_QUERY"。查询设置从 bookstrap.config.json 读取(surrealdb 的 host、port、namespace、database,embeddings 的 provider、model、dimensions)。
适用场景:人物探索、来源核验、时间线提问、内容搜索、知识缺口检查以及混合查询。
限制:需数据库运行、schema 已初始化、内容已导入,语义搜索还需配置嵌入;默认结果上限 10 条、超时 30 秒;错误处理涵盖数据库不可访问、无结果、实体无效、嵌入失败、查询超时与查询歧义等情况。相关命令有 /bookstrap-status、/bookstrap-ingest、/bookstrap-research、/bookstrap-write。