hyacinth-ai 0.9.11 → 0.9.12

package/dist/gateway/factory.d.ts

@@ -62,7 +62,8 @@ export interface AgentComponents {
         lastQuery: string;
     };
     kbWatcher: KnowledgeWatcher;
-    structuredStore: StructuredStore;
+    /** 知识库结构化存储（懒加载，只在知识库启用时才创建） */
+    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,12 +494,12 @@ 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,
@@ -832,7 +838,7 @@ export async function createAgent(options, supervisor) {
         knowledgeBase,
         kbState,
         kbWatcher,
-        structuredStore,
+        structuredStore: _structuredStore,
         composeStrategy,
         companionSessionManager,
         backgroundRegistry,

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.12",
   "description": "Hyacinth 🪻 — multi-provider AI agent with tool system and context management",
   "type": "module",
   "main": "dist/index.js",