@jungtz/wiki-router 1.3.0 → 1.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungtz/wiki-router",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "LLM Wiki 知識庫路由引擎 - 將結構化知識轉為 Markdown 維基，智慧路由查詢",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -34,6 +34,7 @@
     "dev": "rollup -c -w",
     "test": "node --test",
     "preview": "node scripts/preview.js",
+    "preview:multi": "node scripts/preview-multi.js",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
     "format": "prettier --write src/",

package/src/types.d.ts

@@ -17,11 +17,13 @@
 
 /**
  * @typedef {Object} Store
- * @property {() => Promise<string[]>} list - 列出已生成的 wiki 檔名（含副檔名）
+ * @property {() => Promise<string[]>} list - 列出已生成的 wiki 檔名（含副檔名）；應排除非路由用的衍生檔（例如以底線開頭者）
  * @property {(filename: string) => Promise<string|null>} read - 讀取 wiki 檔；不存在回 null
  * @property {(filename: string, content: string) => Promise<void>} write - 寫入 wiki 檔
  * @property {() => Promise<Record<string, string>|null>} [readManifest] - 選用；讀取上次 build 的來源指紋；不存在回 null
  * @property {(manifest: Record<string, string>) => Promise<void>} [writeManifest] - 選用；寫入本次 build 的來源指紋
+ * @property {() => Promise<string|null>} [readPersona] - 選用；讀取自動產生的角色設定；不存在回 null
+ * @property {(persona: string) => Promise<void>} [writePersona] - 選用；寫入自動產生的角色設定
  */
 
 /**
@@ -37,17 +39,22 @@
  * @property {string} [splitPrompt] - 自訂 Split prompt 字串，未提供時使用內建預設
  * @property {string} [mergePrompt] - 自訂 Merge prompt 字串，未提供時使用內建預設
  * @property {string} [routerPrompt] - 自訂 Router prompt 字串，未提供時使用內建預設
+ * @property {string} [personaPrompt] - 自訂 Persona prompt 字串，未提供時使用內建預設
+ * @property {number} [personaSampleSize=4000] - 產 persona 時，從非 Index 檔抽取的內容總長度上限（字元）
  */
 
 /**
  * @typedef {Object} BuildOptions
  * @property {boolean} [force=false] - 為 true 時跳過 fingerprint 比對，無條件重建
+ * @property {boolean} [skipPersona=false] - 為 true 時 build 完不順帶產 persona
  */
 
 /**
  * @typedef {Object} WikiRouterInstance
  * @property {(options?: BuildOptions) => Promise<boolean>} build - 建構或更新 Wiki 知識庫
  * @property {(prompt: string) => Promise<string>} getContext - 根據問題取得相關 Wiki 上下文
+ * @property {(options?: { force?: boolean }) => Promise<boolean>} buildPersona - 依 Index.md + 內容樣本產出角色設定，寫入 store.writePersona()
+ * @property {() => Promise<string|null>} getPersona - 取得目前儲存的角色設定；store 不支援或尚未生成則回 null
  */
 
 /**
@@ -62,6 +69,7 @@
  * @property {string} tenantId - 多租戶識別字串
  * @property {string} [filesTable='wiki_files'] - 自訂 files 表名
  * @property {string} [manifestsTable='wiki_manifests'] - 自訂 manifests 表名
+ * @property {string} [personasTable='wiki_personas'] - 自訂 personas 表名
  */
 
 /**
@@ -79,6 +87,8 @@
  * @property {string} [splitPrompt] - 同 WikiRouterConfig.splitPrompt
  * @property {string} [mergePrompt] - 同 WikiRouterConfig.mergePrompt
  * @property {string} [routerPrompt] - 同 WikiRouterConfig.routerPrompt
+ * @property {string} [personaPrompt] - 同 WikiRouterConfig.personaPrompt
+ * @property {number} [personaSampleSize] - 同 WikiRouterConfig.personaSampleSize
  */
 
 /**
@@ -86,6 +96,8 @@
  * @property {(tenantId: string, options?: BuildOptions) => Promise<boolean>} build - 為單一租戶建構 wiki
  * @property {() => Promise<PromiseSettledResult<boolean>[]>} buildAll - 並行建構所有租戶（需設定 listTenants）
  * @property {(prompt: string, tenantId: string) => Promise<string>} getContext - 取得指定租戶的 wiki 上下文
+ * @property {(tenantId: string) => Promise<string|null>} getPersona - 取得指定租戶的 persona
+ * @property {(tenantId: string, options?: { force?: boolean }) => Promise<boolean>} buildPersona - 為指定租戶單獨重建 persona
  * @property {(tenantId: string) => boolean} isBuilt - 該租戶是否已成功 build 過
  * @property {() => string[]} listBuilt - 已成功 build 過的租戶清單
  */