hyacinth-ai 0.9.12 → 0.9.14

package/dist/gateway/factory.d.ts

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

package/dist/gateway/factory.js

@@ -501,12 +501,18 @@ export async function createAgent(options, supervisor) {
     // 结构化知识库工具（4合1：add/update/delete/list）
     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 ─────────────────────────────────────────────────────
@@ -545,7 +551,7 @@ export async function createAgent(options, supervisor) {
     // ── 旁路Agent 管理器 ──────────────────────────────────────────
     const bypassManager = new (await import('../bypass/manager.js')).BypassManager();
     bypassManager.setModelRouter(modelRouter);
-    // 注册 WorldEngine（陪伴模式旁路Agent）
+    // 注册 WorldEngine（陪伴模式旁路Agent）— 未设置角色时跳过
     const companionCharName = (() => {
         try {
             const last = fs.readFileSync(path.join(os.homedir(), '.agent', 'companion', '.last-character'), 'utf-8').trim();
@@ -555,7 +561,9 @@ export async function createAgent(options, supervisor) {
             return '';
         }
     })();
-    bypassManager.register(new (await import('../bypass/agents/companion/index.js')).WorldEngine(companionCharName));
+    if (companionCharName) {
+        bypassManager.register(new (await import('../bypass/agents/companion/index.js')).WorldEngine(companionCharName));
+    }
     // 注册 Orchestrator（普通模式旁路Agent）— 已暂停（2026-07-10）
     // 待分层过滤策略成熟后重新启用，设计方案见：桌面/旁路Agent重构构想.md
     // bypassManager.register(new (await import('../bypass/agents/orchestrator/index.js')).ContextOrchestrator(memoryFilePath));
@@ -837,7 +845,7 @@ export async function createAgent(options, supervisor) {
         providerConfigLoader,
         knowledgeBase,
         kbState,
-        kbWatcher,
+        kbWatcher: _kbWatcher,
         structuredStore: _structuredStore,
         composeStrategy,
         companionSessionManager,

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/package.json

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