hyacinth-ai 0.9.11 → 0.9.13

package/dist/gateway/factory.d.ts

@@ -61,8 +61,9 @@ export interface AgentComponents {
     kbState: {
         lastQuery: string;
     };
-    kbWatcher: KnowledgeWatcher;
-    structuredStore: StructuredStore;
+    kbWatcher: KnowledgeWatcher | null;
+    /** 知识库结构化存储（懒加载，只在知识库启用时才创建） */
+    structuredStore: StructuredStore | null;
     composeStrategy: ComposeStrategy;
     companionSessionManager: CompanionSessionManager;
     backgroundRegistry: BackgroundProcessRegistry;

package/dist/gateway/factory.js

@@ -458,8 +458,14 @@ export async function createAgent(options, supervisor) {
     // ── 知识库（Zone 4，默认关闭）───────────────────────────────────────
     const kbDir = path.join(os.homedir(), '.agent', 'knowledge');
     const kbStorePath = path.join(kbDir, 'kb.sqlite');
-    // 结构化存储（主）
-    const structuredStore = new StructuredStore(kbStorePath);
+    // 结构化存储 — 懒加载（不启用知识库时不创建，避免缺少 better-sqlite3 时报错）
+    let _structuredStore = null;
+    function getStructuredStore() {
+        if (!_structuredStore) {
+            _structuredStore = new StructuredStore(kbStorePath);
+        }
+        return _structuredStore;
+    }
     // 旧版文件索引（保留兼容）
     const kbFilesDir = path.join(kbDir, 'files');
     fs.mkdirSync(kbFilesDir, { recursive: true });
@@ -488,19 +494,25 @@ export async function createAgent(options, supervisor) {
             const maxTotal = configCenter.get('kb.maxTotal') ?? 5;
             const maxMain = configCenter.get('kb.maxMain') ?? 3;
             const maxRefs = configCenter.get('kb.maxRefs') ?? 2;
-            return structuredStore.formatResults(structuredStore.search(q, maxTotal), maxMain, maxRefs);
+            return getStructuredStore().formatResults(getStructuredStore().search(q, maxTotal), maxMain, maxRefs);
         },
     });
     toolRegistry.register(createKbToggleTool(knowledgeBase, contextComposer));
     // 结构化知识库工具（4合1：add/update/delete/list）
-    toolRegistry.register(createStructuredTool(structuredStore, () => knowledgeBase.enabled));
+    toolRegistry.register(createStructuredTool(getStructuredStore, () => knowledgeBase.enabled));
     // ── 知识库文件监控（后台自动索引 files/ 目录变更）─────────────────
-    const kbWatcher = new KnowledgeWatcher({
-        filesDir: kbFilesDir,
-        retriever: knowledgeBase.retriever,
-    });
-    // 异步启动，不阻塞 Agent 主流程
-    kbWatcher.start().catch(() => { });
+    // 懒创建 — 只在知识库启用后才启动
+    let _kbWatcher = null;
+    function getWatcher() {
+        if (!_kbWatcher) {
+            _kbWatcher = new KnowledgeWatcher({
+                filesDir: kbFilesDir,
+                retriever: knowledgeBase.retriever,
+            });
+            _kbWatcher.start().catch(() => { });
+        }
+        return _kbWatcher;
+    }
     // ── Command Registry（斜杠命令外部配置化，支持模型修改 + 热重载） ──
     CommandRegistry.getInstance(cwd);
     // ── AgentLoop ─────────────────────────────────────────────────────
@@ -831,8 +843,8 @@ export async function createAgent(options, supervisor) {
         providerConfigLoader,
         knowledgeBase,
         kbState,
-        kbWatcher,
-        structuredStore,
+        kbWatcher: _kbWatcher,
+        structuredStore: _structuredStore,
         composeStrategy,
         companionSessionManager,
         backgroundRegistry,

package/dist/knowledge/store.d.ts

@@ -7,10 +7,13 @@
 import type { Retriever, KbDocument, KbSearchResult } from './retriever.js';
 export type { KbDocument as KbDoc, KbSearchResult as KbResult } from './retriever.js';
 export declare class KnowledgeBase {
-    readonly retriever: Retriever;
+    private _retriever;
+    private _dbPath;
     private _enabled;
     private _zone4Enabled;
     constructor(dbPathOrRetriever: string | Retriever);
+    /** 懒加载 retriever，仅在首次访问时创建 Fts5Retriever */
+    get retriever(): Retriever;
     get enabled(): boolean;
     enable(): void;
     disable(): void;

package/dist/knowledge/store.js

@@ -6,17 +6,25 @@
  */
 import { Fts5Retriever } from './fts5-retriever.js';
 export class KnowledgeBase {
-    retriever;
+    _retriever = null;
+    _dbPath;
     _enabled = false;
     _zone4Enabled = true; // Zone 4 默认开启
     constructor(dbPathOrRetriever) {
         if (typeof dbPathOrRetriever === 'string') {
-            this.retriever = new Fts5Retriever(dbPathOrRetriever);
+            this._dbPath = dbPathOrRetriever;
         }
         else {
-            this.retriever = dbPathOrRetriever;
+            this._retriever = dbPathOrRetriever;
         }
     }
+    /** 懒加载 retriever，仅在首次访问时创建 Fts5Retriever */
+    get retriever() {
+        if (!this._retriever) {
+            this._retriever = new Fts5Retriever(this._dbPath);
+        }
+        return this._retriever;
+    }
     // ── 状态管理 ──────────────────────────────────────────────────────
     get enabled() {
         return this._enabled && this._zone4Enabled;

package/dist/knowledge/structured-tools.d.ts

@@ -8,5 +8,5 @@
  */
 import type { Tool } from '../tools/interface.js';
 import type { StructuredStore } from './structured-store.js';
-export declare function createStructuredTool(store: StructuredStore, enabled: () => boolean): Tool;
+export declare function createStructuredTool(getStore: () => StructuredStore, enabled: () => boolean): Tool;
 //# sourceMappingURL=structured-tools.d.ts.map

package/dist/knowledge/structured-tools.js

@@ -11,7 +11,7 @@ function guard(store, enabled) {
         return '知识库未开启。请执行 /kb on。';
     return null;
 }
-export function createStructuredTool(store, enabled) {
+export function createStructuredTool(getStore, enabled) {
     return {
         name: 'kb_structured',
         description: 'Manage structured knowledge entries. Supports 4 actions:\n' +
@@ -63,20 +63,20 @@ export function createStructuredTool(store, enabled) {
             required: ['action'],
         },
         async execute(args) {
-            const blocked = guard(store, enabled);
+            const blocked = guard(getStore, enabled);
             if (blocked)
                 return blocked;
             const action = args.action;
             try {
                 switch (action) {
                     case 'add':
-                        return handleAdd(store, args);
+                        return handleAdd(getStore(), args);
                     case 'update':
-                        return handleUpdate(store, args);
+                        return handleUpdate(getStore(), args);
                     case 'delete':
-                        return handleDelete(store, args);
+                        return handleDelete(getStore(), args);
                     case 'list':
-                        return handleList(store, args);
+                        return handleList(getStore(), args);
                     default:
                         return `Unknown action: "${action}". Supported: add, update, delete, list.`;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyacinth-ai",
-  "version": "0.9.11",
+  "version": "0.9.13",
   "description": "Hyacinth 🪻 — multi-provider AI agent with tool system and context management",
   "type": "module",
   "main": "dist/index.js",