Struct KnowledgeBase 

pub struct KnowledgeBase { /* private fields */ }

Clone shares one process-local engine. Close invalidates all its handles.

Implementations

impl KnowledgeBase

pub fn open(directory: impl AsRef<Path>) -> Result<Self>

pub fn directory(&self) -> &Path

pub fn close(&self) -> Result<()>

pub fn memories(&self) -> MemoryStore

pub fn graph(&self) -> GraphStore

pub fn notes(&self) -> NoteStore

pub fn embeddings(&self) -> EmbeddingStore

pub fn reconcile_index(&self) -> Result<HealthReport>

显式对账：把索引里实际存在的记录 id 与主库现存的记录 id 求差集对齐—— 索引里多出来的按 key 摘掉，缺的就地补上。只由下游主动调用：停电标记恢复 覆盖不了的残余（例如绕过 API 直改主库）由这里一次收敛。稳态下差集为空， 连一次提交都不发生。

pub fn update_index(&self) -> Result<HealthReport>

提交写入攒下的增删（索引提交是写入路径的职责），并把已提交的「正在写入」标记清干净。 只清写入标记：删除标记（status=2）代表「删除没做完」，得留给下次开机或人工处理， 在这里抹掉就等于把恢复线索删了。没有对账、没有自愈——派生与权威的对齐由写路径当场保证， 差集对齐只留给显式调用。

pub fn register_event_sink<F: Fn(&LogEvent) + Send + Sync + 'static>( &self, sink: F, )

注册事件接收回调。库在检索线程里同步调用它，所以回调必须非阻塞—— 在里面做同步 IO 或网络上报，会把检索拖住，和慢的重排回调一样。 回调抛错只丢这一条事件，不影响检索。不注册就完全不产出事件。

pub fn unregister_event_sink(&self) -> bool

注销事件接收回调，返回此前是否有注册。

pub fn event_sink_registered(&self) -> bool

当前是否注册了事件接收回调。

pub fn health(&self) -> Result<HealthReport>

pub fn backup(&self, target: impl AsRef<Path>) -> Result<()>

Consistent SQLite snapshot, including embeddings. Refuses to overwrite a file.

pub fn restore( snapshot: impl AsRef<Path>, directory: impl AsRef<Path>, ) -> Result<Self>

Restores to a new directory; search indexes are rebuilt from the snapshot.

impl KnowledgeBase

pub fn register_reranker<F: Reranker + 'static>( &self, reranker: F, ) -> Result<()>

注册重排回调。调用前按声明的定长约束强制截断，宿主不自己重排。

pub fn register_reranker_with<F: Reranker + 'static>( &self, reranker: F, options: RerankerOptions, ) -> Result<()>

pub fn unregister_reranker(&self) -> bool

pub fn reranker_registered(&self) -> bool

pub fn search(&self, request: &SearchRequest) -> Result<SearchResult>

pub fn search_with_context( &self, request: &SearchRequest, limit: usize, ) -> Result<Vec<ContextualHit>>

先按 request 检索，再给每条命中挂上它在图上所在实体的邻域（实体 + 关系）。

「挂载」靠标签文本：命中的记录所带的 tag，与同一 namespace / scope 内某实体的名字或别名 文本相同，就认为该记录挂在这个实体上（两者都落在 strings 表，同一套归一化）。 limit 是每个实体邻域的规模上限。命中记录若没有命中任何实体，返回空邻域。

impl KnowledgeBase

pub fn search_preset(&self, request: &PresetRequest) -> Result<PresetResult>

按预设检索。三个字段各自独立排序，互不挤占。

Trait Implementations

impl Clone for KnowledgeBase

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.