@jungtz/wiki-router 1.4.0 → 1.5.0

package/README.md

@@ -1,12 +1,14 @@
 # @jungtz/wiki-router
 
-把結構化知識（JSON / Markdown）丟給 LLM 拆成 wiki，再依使用者問題自動挑相關 .md 當上下文回傳。
+把結構化知識（JSON / Markdown）丟給 LLM 拆成 wiki，再依使用者問題自動挑相關 .md 當上下文回傳。Build 完還會順便產一段「角色設定（persona）」給上層 chat 用。
 
 [![npm version](https://badge.fury.io/js/@jungtz%2Fwiki-router.svg)](https://badge.fury.io/js/@jungtz%2Fwiki-router)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ```
-知識來源 → build() → LLM 拆成多個 .md → getContext(prompt) → LLM 路由 → 相關 .md
+                  ┌─→ getContext(prompt) → LLM 路由 → 相關 .md
+知識來源 → build() ─┤
+                  └─→ getPersona()       → 自動產出的角色設定字串
 ```
 
 ## 安裝
@@ -45,7 +47,8 @@ const wiki = createWikiRouter({
 ;(async () => {
   await wiki.build()                            // 啟動時建構（指紋未變動會自動跳過）
   const ctx = await wiki.getContext('住宿規定？')
-  console.log(ctx)
+  const persona = await wiki.getPersona()       // build 完自動產出的角色設定
+  console.log(persona)
 })()
 ```
 
@@ -58,6 +61,7 @@ your-project/
 └── wiki-output/               ← 自動產生
     ├── Index.md
     ├── About.md
+    ├── _persona.md            ← build 完自動產出（底線前綴排除於路由）
     └── .manifest.json         ← 來源指紋（自動寫入）
 ```
 
@@ -104,6 +108,7 @@ const wiki = createTenantManager({
 ;(async () => {
   await wiki.buildAll()                                  // 並行 build 所有 tenant
   const ctx = await wiki.getContext('問題', 'hotel-001') // 依 tenantId 取上下文
+  const persona = await wiki.getPersona('hotel-001')     // 自動產出的角色設定
 })()
 ```
 
@@ -112,7 +117,7 @@ const wiki = createTenantManager({
 your-project/
 ├── server.js
 ├── data/
-│   └── wiki.db                ← 自動建立（含 wiki_files / wiki_manifests 兩張表）
+│   └── wiki.db                ← 自動建立（含 wiki_files / wiki_manifests / wiki_personas 三張表）
 └── knowledge/
     ├── hotel-001/
     │   └── base.json
@@ -140,12 +145,16 @@ app.post('/api/wiki/rebuild', async (req, res) => {
   res.json({ ok })
 })
 
-// 對話：用 wiki context 增強 prompt
+// 對話：用 wiki context 增強 prompt，並用 persona 當系統提示
 app.post('/api/chat', async (req, res) => {
   const { prompt, tenantId } = req.body
-  const ctx = await wiki.getContext(prompt, tenantId)
+  const [ctx, persona] = await Promise.all([
+    wiki.getContext(prompt, tenantId),
+    wiki.getPersona(tenantId),
+  ])
+  const system = persona || '你是一位專業的 AI 助理。'
   const enhanced = ctx ? `${ctx}\n\n問題：${prompt}` : prompt
-  // ... 把 enhanced 餵給你的 LLM
+  // ... 把 system + enhanced 餵給你的 LLM
 })
 ```
 
@@ -196,7 +205,8 @@ createTenantManager({
 | `modelId` | `string` | | Wiki 生成模型，格式 `provider/model` |
 | `routerModelId` | `string` | | 路由選擇模型，預設同 `modelId` |
 | `timeout` | `number` | | LLM 對話逾時毫秒數，預設 `300000` (5 分鐘) |
-| `splitPrompt` / `mergePrompt` / `routerPrompt` | `string` | | 自訂三種內建 prompt |
+| `splitPrompt` / `mergePrompt` / `routerPrompt` / `personaPrompt` | `string` | | 自訂四種內建 prompt |
+| `personaSampleSize` | `number` | | 產 persona 時抽取的內容樣本字元上限，預設 `4000` |
 
 ✱ `source`/`knowledgeDir` 至少擇一；`store`/`outputDir` 至少擇一。
 
@@ -204,8 +214,10 @@ createTenantManager({
 
 | 方法 | 說明 |
 |------|------|
-| `build({ force })` | 建構或增量更新；`force: true` 跳過指紋比對 |
+| `build({ force, skipPersona })` | 建構或增量更新；`force: true` 跳過指紋比對；`skipPersona: true` 跳過自動產 persona |
 | `getContext(prompt)` | 依問題回傳相關 .md 合併內容；無相關回空字串 |
+| `buildPersona({ force })` | 單獨重建 persona（不重建 wiki）；store 不支援時 noop |
+| `getPersona()` | 取出目前儲存的 persona；store 不支援或尚未產出回 `null` |
 
 ### `createTenantManager(config)` — 多租戶協調器
 
@@ -220,15 +232,17 @@ createTenantManager({
 | `autoIndex` | `boolean` | | 預設 `true`；build 後若 store 沒 Index.md，從現有 .md 合成 |
 | `autoIndexHeader` | `string` | | 預設 `# 知識庫目錄` |
 | `logger` | `{ log, warn, error }` | | 預設 `console` |
-| `modelId` / `routerModelId` / `timeout` / `*Prompt` | | | 同 `createWikiRouter`，傳給每個 wiki |
+| `modelId` / `routerModelId` / `timeout` / `*Prompt` / `personaSampleSize` | | | 同 `createWikiRouter`，傳給每個 wiki |
 
 回傳：
 
 | 方法 | 說明 |
 |------|------|
-| `build(tenantId, { force })` | 為單一 tenant build；同 tenant 並行呼叫共用 promise |
+| `build(tenantId, { force, skipPersona })` | 為單一 tenant build；同 tenant 並行呼叫共用 promise |
 | `buildAll()` | 並行 build 所有 tenant，使用 `allSettled` |
 | `getContext(prompt, tenantId)` | 取得指定 tenant 的 wiki 上下文；尚未 build 完成時回空字串 |
+| `getPersona(tenantId)` | 取出指定 tenant 的 persona；尚未產出回 `null` |
+| `buildPersona(tenantId, { force })` | 為指定 tenant 單獨重建 persona |
 | `isBuilt(tenantId)` / `listBuilt()` | build 狀態查詢 |
 
 ### 內建 adapter
@@ -237,13 +251,15 @@ createTenantManager({
 const { fsSource, fsStore, sqliteStore, ensureWikiTables } = require('@jungtz/wiki-router')
 
 fsSource('./knowledge')                          // 讀 .json/.md
-fsStore('./wiki-output')                         // 寫 .md + .manifest.json
+fsStore('./wiki-output')                         // 寫 .md + .manifest.json + _persona.md
 sqliteStore({ db, tenantId: 'x' })               // SQLite Store（多租戶用同一 db）
-ensureWikiTables(db, { filesTable, manifestsTable }) // 一次性建表（idempotent）
+ensureWikiTables(db, { filesTable, manifestsTable, personasTable }) // 一次性建表（idempotent）
 ```
 
 `sqliteStore` 內部會自動 `ensureWikiTables`，但建議啟動時先呼叫一次以避免每個 tenant 都跑 CREATE TABLE。
 
+`fsStore.list()` 會自動排除以底線開頭的檔案（如 `_persona.md`），避免污染路由與 Index 自動生成。
+
 ### Adapter 介面
 
 ```ts
@@ -259,10 +275,17 @@ interface Store {
   write(filename: string, content: string): Promise<void>
   readManifest?(): Promise<Record<string, string> | null> // 選用：啟用快取
   writeManifest?(m: Record<string, string>): Promise<void>// 選用：啟用快取
+  readPersona?(): Promise<string | null>                  // 選用：啟用 persona 自動生成
+  writePersona?(persona: string): Promise<void>           // 選用：啟用 persona 自動生成
 }
 ```
 
-`getFingerprint` + `readManifest` + `writeManifest` **三者同時實作才會啟用快取**；缺其一則每次 build 都重跑 LLM（向下相容）。
+選用方法成對啟用各自的功能；缺其一則該功能 noop，主流程不受影響：
+
+| 功能 | 必要的選用方法 |
+|---|---|
+| Fingerprint 快取 | `getFingerprint` + `readManifest` + `writeManifest` |
+| Persona 自動產出 | `readPersona` + `writePersona` |
 
 ---
 
@@ -280,6 +303,35 @@ interface Store {
 
 ---
 
+## Persona 自動生成
+
+`build()` 成功後若 store 同時實作 `readPersona` / `writePersona`，會自動跑一輪 LLM 產出一段角色設定（給上層 chat 當系統提示用）。流程：
+
+1. 從 store 讀取 `Index.md`（沒有就跳過）
+2. 從非 Index、非底線前綴的 .md 抽樣（合計上限 `personaSampleSize`，預設 4000 字元）
+3. 把目錄 + 樣本餵給 `PERSONA_PROMPT` → LLM 輸出純文字角色描述
+4. 透過 `store.writePersona()` 落地
+
+預設 prompt 要求模型：
+- 120 字內、第二人稱「你是 …」開頭
+- 必須使用知識庫實際出現的單位名稱、業種、語氣
+- 嚴禁編造、嚴禁寫成介紹文／宣傳文
+
+讀取與覆蓋：
+
+```js
+const persona = await wiki.getPersona()                      // 讀目前的
+await wiki.buildPersona({ force: true })                     // 單獨重建（不重建 wiki）
+await wiki.build({ skipPersona: true })                      // build 時不自動產 persona
+const wiki2 = createWikiRouter({ ..., personaPrompt: '...' }) // 換成自己的 prompt
+```
+
+儲存位置：`fsStore` 寫 `_persona.md`（底線前綴自動排除於 `list()` 與路由）；`sqliteStore` 寫 `wiki_personas` 表（`tenant_id` PRIMARY KEY）。
+
+不需要 persona 時：自訂 store 不實作 `readPersona/writePersona`，或每次 `build({ skipPersona: true })`。
+
+---
+
 ## 範例
 
 - [`examples/basic.js`](./examples/basic.js) — 範本 A 完整可跑檔
@@ -307,7 +359,7 @@ npm run preview:multi -- --knowledge ./knowledge --db ./data/wiki-preview.db
 
 ```js
 const { parseWikiOutput } = require('@jungtz/wiki-router/parser')
-const { SPLIT_PROMPT, MERGE_PROMPT, ROUTER_PROMPT } = require('@jungtz/wiki-router/prompts')
+const { SPLIT_PROMPT, MERGE_PROMPT, ROUTER_PROMPT, PERSONA_PROMPT } = require('@jungtz/wiki-router/prompts')
 ```
 
 ## 發布（自動）
@@ -322,7 +374,7 @@ push 到 master 後 CI 掃 commit message 決定 bump：
 
 ## 錯誤處理
 
-採靜默失敗：模型連不上時只 warn 不 throw，`getContext` 回空字串、`build` 回 `false`，主流程不中斷。
+採靜默失敗：模型連不上時只 warn 不 throw，`getContext` / `getPersona` 回 `null` 或空字串、`build` 回 `false`，主流程不中斷。Persona 生成失敗不影響 `build` 主結果（仍回 `true`）。
 
 ## 相依
 

package/dist/index.cjs

@@ -24,6 +24,7 @@ function readPrompt(filename) {
 const SPLIT_PROMPT = "# 角色：專業文件架構師 (Documentation Architect)\n\n## 任務目標\n將提供的 JSON 資料完整解析並轉換為多個獨立的 Markdown `.md` 檔案。\nJSON 可能來自 CMS、API 回應、設定檔或任何結構化資料來源。\n\n## 原始 JSON 資料\n```json\n{{context}}\n```\n\n## 處理規則：\n\n### 1. 結構識別（自動語義分析）\n- 分析 JSON 的頂層結構（object / array / 巢狀）\n- 若為巢狀物件，以**第一層 key** 作為主題分群依據（如 `data.rooms` → 房間主題、`data.location` → 地點主題）\n- 若為頂層陣列，每個元素視為獨立條目，依內容主題分組\n\n### 2. 完整性強制規則（最高優先）\n- **逐項清點**：陣列型資料必須逐一列出所有項目，先數原始 JSON 中有幾筆，輸出後再數確認數量一致\n- **巢狀陣列全收**：若某欄位本身是陣列（如設施清單、標籤列表），必須列出該陣列中的**每一項**\n- **不因長度省略**：資料再多也不能用「等」、「...」、「其他」概括\n\n### 3. 資訊提取（語義識別）\n- **標題欄位**：自動識別代表名稱/標題的欄位（`title`、`name`、`label`、`subject`）\n- **內文欄位**：自動識別長文字欄位（`content`、`description`、`body`、`intro`、`text`）\n- **時間欄位**：自動識別時間相關欄位（`time`、`date`、`checkin`、`checkout`、`created_at`、`published_at`）\n- **數值欄位**：自動識別價格/數量欄位（`price`、`qty`、`user`、`capacity`、`size`）\n- **布林欄位**：自動識別開關欄位（`enable`、`display`、`is_*`），轉為「啟用/停用」\n- **巢狀物件**：遞迴展開，保留層級結構（如 `social.{instagram_url, instagram_display}`）\n- **多語言欄位**：若欄位為 `{zh_tw, en, ja, ...}` 結構，以 `zh_tw` 為主要輸出語言，不存在時依序 fallback\n\n### 4. 格式還原\n- 若內容為 JSON 字串（Quill Delta 等 RTF 格式），解析後還原為純文字\n- 轉義換行 `\\n` → 真實換行、`\\t` → 縮排\n- 內嵌 HTML（`<a href>`, `<img>`, `<br>`）還原為對應 Markdown 語法\n- 內嵌 URL 保留為可點擊連結\n\n### 5. 檔案拆分原則\n- 依照 JSON 的**第一層 key** 或**語義主題**拆分成獨立 `.md` 檔案\n- 每個檔案涵蓋一個獨立主題區塊\n- 檔名使用英文，反映主題（如 `Rooms.md`、`Policies.md`、`Facilities.md`）\n\n### 6. 索引生成 (Index.md)\n- 彙整所有產出的檔案，生成 `Index.md`\n- 格式：`- [顯示名稱](檔名.md)：一句話摘要涵蓋的關鍵主題與具體資訊`\n- 摘要必須具體，禁止只重複檔名\n\n### 7. 輸出約束\n- **輸出順序**：先 `Index.md`，再依序輸出其他檔案\n- **必須標示檔名**：每個程式碼區塊正上方必須有 `### 檔名.md` 標題，不可省略\n- 每個檔案以獨立 ` ```markdown ` 程式碼區塊呈現\n- 所有 JSON 內容一律轉為人類可讀的 Markdown，不可保留原始 JSON 字串\n\n## 輸出格式規範：\n\n### Index.md\n```markdown\n# 知識庫目錄\n- [顯示名稱 A](A.md)：涵蓋的關鍵主題與具體資訊摘要\n- [顯示名稱 B](B.md)：涵蓋的關鍵主題與具體資訊摘要\n```\n\n---\n\n### 檔名.md\n```markdown\n[還原後的 Markdown 內容]\n```\n\n---\n\n(重複上述格式直到所有檔案輸出完畢)\n";
 const MERGE_PROMPT = "# 角色：知識庫合併架構師 (Knowledge Merge Architect)\n\n## 任務目標\n將新的內容合併到既有的知識庫檔案結構中，根據內容類型與主題智能決定「新增頁面」、「合併到既有頁面」或「更新既有頁面」。\n\n## 既有知識庫目錄 (Index.md)\n```markdown\n{{indexContent}}\n```\n\n## 新內容類型：{{fileType}}\n## 新內容\n```{{contentBlock}}\n{{newContent}}\n```\n\n## 處理規則：\n\n### 1. 結構識別（依 fileType）\n\n**json**：\n- 分析 JSON 頂層結構，以第一層 key 或語義主題分群\n- 若為巢狀物件，每個第一層 key 視為一個主題區塊\n- 若為頂層陣列，每個元素視為獨立條目\n\n**markdown**：\n- 依照 `##` 或 `###` 標題拆分成獨立區塊\n- 每個區塊視為一個新知識條目\n\n### 2. 合併策略判斷\n\n對每個條目，檢查是否與既有 Index.md 中的頁面相關：\n\n- **主題全新**（目錄中無相關頁面）→ 建立**新檔案**，Index.md 追加新條目\n- **主題已存在**（標題或關鍵詞與既有頁面重疊）→ 將新內容**合併**到既有檔案，保留既有結構，新增內容作為補充。合併後輸出該檔案的**完整內容**\n- **既有檔案缺少條目**（例如列表型資料漏了某筆）→ 必須**補齊**，將缺漏條目加入對應區塊\n- **內容衝突**（同一主題但資訊不一致，如價格變動、規則修改）→ 以**新內容為準**更新，標記 `> 更新於 YYYY-MM-DD`\n- **內容重複**（完全相同）→ 跳過，不輸出\n\n### 3. 完整性驗證\n- 陣列型資料：比對新內容的項目數與既有檔案收錄數，缺漏必須補齊\n- 巢狀陣列（如設施清單、標籤列表）：逐一檢查是否全數收錄\n- 多語言欄位：以 `zh_tw` 為主要輸出語言，不存在時 fallback 到 `en`\n- JSON 字串內容（Quill Delta 等）：`\\n` → 換行、`\\t` → 縮排、HTML → Markdown\n\n### 4. 輸出約束\n- **輸出順序**：先輸出更新後的 `Index.md`，再依序輸出所有新增或更新過的檔案\n- 每個檔案前必須有 `### 檔名.md` 作為標題，絕對不可省略\n- 每個檔案以獨立 ` ```markdown ` 程式碼區塊呈現\n- **只輸出有變動的檔案**，未修改的既有檔案不需重複輸出\n- 合併的檔案必須包含**完整內容**（既有 + 新增），不可只輸出差異\n\n## 輸出格式規範：\n\n### Index.md\n```markdown\n# 知識庫目錄\n- [顯示名稱 A](A.md)：一句話摘要涵蓋的關鍵主題\n- [顯示名稱 B](B.md)：一句話摘要涵蓋的關鍵主題\n```\n\n---\n\n### 檔名.md\n```markdown\n[完整內容]\n```\n\n---\n\n(重複上述格式直到所有變動檔案輸出完畢)\n";
 const ROUTER_PROMPT = "# 角色設定\n你是一個精準的「知識庫路由助手 (Router)」。\n你的唯一任務是分析使用者的問題，並從提供的目錄清單中，挑選出最可能包含解答的檔案名稱。\n\n# 使用者問題\n{{prompt}}\n\n# 知識庫目錄\n{{indexContent}}\n\n# 挑選原則\n- 從目錄中每個檔案的**摘要**判斷相關性，不只比對檔名\n- 考慮同義詞與相關概念（例如：「運動」「健身」→ Facilities.md；「怎麼去」「交通」→ Location_and_Transport.md）\n- 若問題涉及多個主題（如「房價和退房時間」），選取所有相關檔案\n\n# 輸出嚴格規範\n1. **僅輸出檔名**：從「知識庫目錄」中挑選最相關的完整檔案名稱（必須包含 `.md` 後綴）。\n2. **多檔處理**：若有多個檔案相關，請以半形逗號 `,` 分隔。\n3. **無相關時**：若判斷目錄中的檔案皆不相關，請直接回覆 `NONE`。\n4. **禁止任何廢話**：**絕對禁止**輸出任何解釋文字、問候語、符號，也**禁止**使用 Markdown 標記（如代碼塊 ` ``` ` 或清單 `-`）。\n\n**正確輸出範例：**\nIntroduction.md,Policy_Info.md\n";
+const PERSONA_PROMPT = "你正在依據以下知識庫，為這個業務單位產出一段給 AI 模型使用的「智慧管家／服務窗口」角色設定。\n\n【輸出規則】\n- 120 字以內\n- 使用第二人稱開頭：「你是 …」\n- **必須**使用知識庫中實際出現的單位名稱（含中英文／品牌名／所在地），不得改寫、不得概括成「店家」「飯店」「公司」等通稱\n- 必須點出業種與服務範圍（依資料推斷，例如：精品民宿、商務飯店、餐廳、停車場、診所…）\n- 必須描述語氣（專業、親切、簡明等），可參考品牌調性\n- **嚴禁**編造未在資料中出現的細節\n- **嚴禁**寫成介紹文、宣傳文，必須是給 AI 模型看的角色指令\n- 直接輸出純文字角色描述，**不要**任何前後綴、不要 markdown、不要程式碼框\n\n【知識庫目錄】\n{{indexContent}}\n\n【主要內容摘要】\n{{contentSample}}\n\n【角色設定】\n";
 
 /**
  * LLM 輸出解析器
@@ -95,10 +96,14 @@ function parseWikiOutput(output) {
  *   createWikiRouter({ router, source: fsSource('./knowledge'), store: fsStore('./wiki') })
  *
  * 也可直接傳 knowledgeDir / outputDir 給 createWikiRouter，內部會自動包成這兩個 adapter。
+ *
+ * 註：fsStore.list() 會排除以底線開頭的檔案（如 `_persona.md`），
+ *     因為這類檔案被視為「非路由用」的衍生資料（例如自動產生的角色設定）。
  */
 
 
 const MANIFEST_FILE = '.manifest.json';
+const PERSONA_FILE = '_persona.md';
 
 /**
  * 建立讀取本地檔案的 Source adapter
@@ -148,7 +153,8 @@ function fsStore(dir) {
   return {
     async list() {
       ensure();
-      return fs.readdirSync(resolved).filter(f => f.endsWith('.md'))
+      // 排除以底線開頭的檔案（例如 _persona.md），避免污染路由與 Index 自動生成
+      return fs.readdirSync(resolved).filter(f => f.endsWith('.md') && !f.startsWith('_'))
     },
     async read(filename) {
       const filePath = path.join(resolved, filename);
@@ -176,6 +182,15 @@ function fsStore(dir) {
         'utf-8'
       );
     },
+    async readPersona() {
+      const filePath = path.join(resolved, PERSONA_FILE);
+      if (!fs.existsSync(filePath)) return null
+      return fs.readFileSync(filePath, 'utf-8')
+    },
+    async writePersona(persona) {
+      ensure();
+      fs.writeFileSync(path.join(resolved, PERSONA_FILE), persona, 'utf-8');
+    },
   }
 }
 
@@ -206,11 +221,14 @@ function createWikiRouter(config) {
     splitPrompt,
     mergePrompt,
     routerPrompt,
+    personaPrompt,
+    personaSampleSize = 4000,
   } = config;
 
   const activeSplitPrompt = splitPrompt || SPLIT_PROMPT;
   const activeMergePrompt = mergePrompt || MERGE_PROMPT;
   const activeRouterPrompt = routerPrompt || ROUTER_PROMPT;
+  const activePersonaPrompt = personaPrompt || PERSONA_PROMPT;
 
   if (!router) throw new Error('[wiki-router] router is required')
 
@@ -380,6 +398,15 @@ function createWikiRouter(config) {
       }
 
       console.log(`[Wiki] Build complete — ${totalFiles} file(s), ${formatElapsed(buildStart)}`);
+
+      if (!options.skipPersona && typeof activeStore.writePersona === 'function') {
+        try {
+          await buildPersona({ force: !!force });
+        } catch (err) {
+          console.warn('[Wiki] Persona build failed (non-fatal):', err.message);
+        }
+      }
+
       return true
     } catch (err) {
       console.error(`[Wiki Generation Error] (after ${formatElapsed(buildStart)})`, err);
@@ -387,6 +414,67 @@ function createWikiRouter(config) {
     }
   }
 
+  /**
+   * 依據 Index.md + 其他 .md 樣本，呼叫 LLM 產出一段角色設定，寫入 store.writePersona()
+   * 必須 store 同時實作 readPersona/writePersona 才會有效；否則 noop。
+   * @param {{ force?: boolean }} [options]
+   * @returns {Promise<boolean>}
+   */
+  async function buildPersona(options = {}) {
+    const { force = false } = options;
+    if (typeof activeStore.writePersona !== 'function') {
+      return false
+    }
+
+    if (!force && typeof activeStore.readPersona === 'function') {
+      const existing = await activeStore.readPersona();
+      if (existing && existing.trim().length > 0) return true
+    }
+
+    const indexContent = await activeStore.read('Index.md');
+    if (!indexContent) {
+      console.warn('[Wiki] No Index.md, skip persona generation');
+      return false
+    }
+
+    const allFiles = await activeStore.list();
+    const samples = [];
+    let totalLen = 0;
+    for (const f of allFiles) {
+      if (!f.endsWith('.md') || f === 'Index.md' || f.startsWith('_')) continue
+      if (totalLen >= personaSampleSize) break
+      const c = await activeStore.read(f);
+      if (!c) continue
+      const remaining = personaSampleSize - totalLen;
+      const slice = c.slice(0, remaining);
+      samples.push(`### ${f}\n${slice}`);
+      totalLen += slice.length;
+    }
+
+    const prompt = activePersonaPrompt
+      .replace('{{indexContent}}', indexContent)
+      .replace('{{contentSample}}', samples.join('\n\n') || '(無其他內容)');
+
+    const persona = await chat([{ role: 'user', content: prompt }]);
+    if (!persona || persona.trim().length < 10) {
+      console.warn('[Wiki] Persona LLM returned empty/too-short, skip write');
+      return false
+    }
+
+    await activeStore.writePersona(persona.trim());
+    console.log(`[Wiki] Persona generated (${persona.trim().length} chars)`);
+    return true
+  }
+
+  /**
+   * 取得目前儲存的 persona；若 store 不支援或尚未生成回 null
+   * @returns {Promise<string|null>}
+   */
+  async function getPersona() {
+    if (typeof activeStore.readPersona !== 'function') return null
+    return activeStore.readPersona()
+  }
+
   async function getContext(prompt) {
     try {
       let wikiFiles = await activeStore.list();
@@ -445,7 +533,7 @@ function createWikiRouter(config) {
     return ''
   }
 
-  return { build, getContext }
+  return { build, getContext, buildPersona, getPersona }
 }
 
 /**
@@ -460,15 +548,17 @@ function createWikiRouter(config) {
 
 const DEFAULT_FILES_TABLE = 'wiki_files';
 const DEFAULT_MANIFESTS_TABLE = 'wiki_manifests';
+const DEFAULT_PERSONAS_TABLE = 'wiki_personas';
 
 /**
- * 建立 wiki_files / wiki_manifests 兩個表（CREATE TABLE IF NOT EXISTS，可重複呼叫）
+ * 建立 wiki_files / wiki_manifests / wiki_personas 三個表（CREATE TABLE IF NOT EXISTS，可重複呼叫）
  * @param {*} db - better-sqlite3 相容實例
- * @param {{ filesTable?: string, manifestsTable?: string }} [opts]
+ * @param {{ filesTable?: string, manifestsTable?: string, personasTable?: string }} [opts]
  */
 function ensureWikiTables(db, opts = {}) {
   const filesTable = opts.filesTable || DEFAULT_FILES_TABLE;
   const manifestsTable = opts.manifestsTable || DEFAULT_MANIFESTS_TABLE;
+  const personasTable = opts.personasTable || DEFAULT_PERSONAS_TABLE;
   db.exec(`
     CREATE TABLE IF NOT EXISTS ${filesTable} (
       tenant_id  TEXT NOT NULL,
@@ -482,12 +572,17 @@ function ensureWikiTables(db, opts = {}) {
       manifest   TEXT NOT NULL,
       updated_at TEXT NOT NULL
     );
+    CREATE TABLE IF NOT EXISTS ${personasTable} (
+      tenant_id  TEXT PRIMARY KEY,
+      persona    TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    );
   `);
 }
 
 /**
  * 建立 SQLite-backed Store adapter
- * @param {{ db: *, tenantId: string, filesTable?: string, manifestsTable?: string }} config
+ * @param {{ db: *, tenantId: string, filesTable?: string, manifestsTable?: string, personasTable?: string }} config
  * @returns {import('../types').Store}
  */
 function sqliteStore(config) {
@@ -500,8 +595,9 @@ function sqliteStore(config) {
   const { db, tenantId } = config;
   const filesTable = config.filesTable || DEFAULT_FILES_TABLE;
   const manifestsTable = config.manifestsTable || DEFAULT_MANIFESTS_TABLE;
+  const personasTable = config.personasTable || DEFAULT_PERSONAS_TABLE;
 
-  ensureWikiTables(db, { filesTable, manifestsTable });
+  ensureWikiTables(db, { filesTable, manifestsTable, personasTable });
 
   const stmts = {
     list: db.prepare(`SELECT filename FROM ${filesTable} WHERE tenant_id = ? ORDER BY filename`),
@@ -517,6 +613,12 @@ function sqliteStore(config) {
        VALUES (?, ?, ?)
        ON CONFLICT(tenant_id) DO UPDATE SET manifest = excluded.manifest, updated_at = excluded.updated_at`
     ),
+    readPersona: db.prepare(`SELECT persona FROM ${personasTable} WHERE tenant_id = ?`),
+    writePersona: db.prepare(
+      `INSERT INTO ${personasTable} (tenant_id, persona, updated_at)
+       VALUES (?, ?, ?)
+       ON CONFLICT(tenant_id) DO UPDATE SET persona = excluded.persona, updated_at = excluded.updated_at`
+    ),
   };
 
   return {
@@ -542,6 +644,13 @@ function sqliteStore(config) {
     async writeManifest(manifest) {
       stmts.writeManifest.run(tenantId, JSON.stringify(manifest), new Date().toISOString());
     },
+    async readPersona() {
+      const row = stmts.readPersona.get(tenantId);
+      return row ? row.persona : null
+    },
+    async writePersona(persona) {
+      stmts.writePersona.run(tenantId, persona, new Date().toISOString());
+    },
   }
 }
 
@@ -705,10 +814,20 @@ function createTenantManager(config) {
     return getWiki(tenantId).wiki.getContext(prompt)
   }
 
+  async function getPersona(tenantId) {
+    return getWiki(tenantId).wiki.getPersona()
+  }
+
+  async function buildPersona(tenantId, options = {}) {
+    return getWiki(tenantId).wiki.buildPersona(options)
+  }
+
   return {
     build,
     buildAll,
     getContext,
+    getPersona,
+    buildPersona,
     isBuilt: tenantId => builtTenants.has(tenantId),
     listBuilt: () => Array.from(builtTenants),
   }
@@ -728,6 +847,7 @@ function createTenantManager(config) {
  */
 
 exports.MERGE_PROMPT = MERGE_PROMPT;
+exports.PERSONA_PROMPT = PERSONA_PROMPT;
 exports.ROUTER_PROMPT = ROUTER_PROMPT;
 exports.SPLIT_PROMPT = SPLIT_PROMPT;
 exports.createTenantManager = createTenantManager;

package/dist/index.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 過的租戶清單
  */

package/dist/index.mjs

@@ -22,6 +22,7 @@ function readPrompt(filename) {
 const SPLIT_PROMPT = "# 角色：專業文件架構師 (Documentation Architect)\n\n## 任務目標\n將提供的 JSON 資料完整解析並轉換為多個獨立的 Markdown `.md` 檔案。\nJSON 可能來自 CMS、API 回應、設定檔或任何結構化資料來源。\n\n## 原始 JSON 資料\n```json\n{{context}}\n```\n\n## 處理規則：\n\n### 1. 結構識別（自動語義分析）\n- 分析 JSON 的頂層結構（object / array / 巢狀）\n- 若為巢狀物件，以**第一層 key** 作為主題分群依據（如 `data.rooms` → 房間主題、`data.location` → 地點主題）\n- 若為頂層陣列，每個元素視為獨立條目，依內容主題分組\n\n### 2. 完整性強制規則（最高優先）\n- **逐項清點**：陣列型資料必須逐一列出所有項目，先數原始 JSON 中有幾筆，輸出後再數確認數量一致\n- **巢狀陣列全收**：若某欄位本身是陣列（如設施清單、標籤列表），必須列出該陣列中的**每一項**\n- **不因長度省略**：資料再多也不能用「等」、「...」、「其他」概括\n\n### 3. 資訊提取（語義識別）\n- **標題欄位**：自動識別代表名稱/標題的欄位（`title`、`name`、`label`、`subject`）\n- **內文欄位**：自動識別長文字欄位（`content`、`description`、`body`、`intro`、`text`）\n- **時間欄位**：自動識別時間相關欄位（`time`、`date`、`checkin`、`checkout`、`created_at`、`published_at`）\n- **數值欄位**：自動識別價格/數量欄位（`price`、`qty`、`user`、`capacity`、`size`）\n- **布林欄位**：自動識別開關欄位（`enable`、`display`、`is_*`），轉為「啟用/停用」\n- **巢狀物件**：遞迴展開，保留層級結構（如 `social.{instagram_url, instagram_display}`）\n- **多語言欄位**：若欄位為 `{zh_tw, en, ja, ...}` 結構，以 `zh_tw` 為主要輸出語言，不存在時依序 fallback\n\n### 4. 格式還原\n- 若內容為 JSON 字串（Quill Delta 等 RTF 格式），解析後還原為純文字\n- 轉義換行 `\\n` → 真實換行、`\\t` → 縮排\n- 內嵌 HTML（`<a href>`, `<img>`, `<br>`）還原為對應 Markdown 語法\n- 內嵌 URL 保留為可點擊連結\n\n### 5. 檔案拆分原則\n- 依照 JSON 的**第一層 key** 或**語義主題**拆分成獨立 `.md` 檔案\n- 每個檔案涵蓋一個獨立主題區塊\n- 檔名使用英文，反映主題（如 `Rooms.md`、`Policies.md`、`Facilities.md`）\n\n### 6. 索引生成 (Index.md)\n- 彙整所有產出的檔案，生成 `Index.md`\n- 格式：`- [顯示名稱](檔名.md)：一句話摘要涵蓋的關鍵主題與具體資訊`\n- 摘要必須具體，禁止只重複檔名\n\n### 7. 輸出約束\n- **輸出順序**：先 `Index.md`，再依序輸出其他檔案\n- **必須標示檔名**：每個程式碼區塊正上方必須有 `### 檔名.md` 標題，不可省略\n- 每個檔案以獨立 ` ```markdown ` 程式碼區塊呈現\n- 所有 JSON 內容一律轉為人類可讀的 Markdown，不可保留原始 JSON 字串\n\n## 輸出格式規範：\n\n### Index.md\n```markdown\n# 知識庫目錄\n- [顯示名稱 A](A.md)：涵蓋的關鍵主題與具體資訊摘要\n- [顯示名稱 B](B.md)：涵蓋的關鍵主題與具體資訊摘要\n```\n\n---\n\n### 檔名.md\n```markdown\n[還原後的 Markdown 內容]\n```\n\n---\n\n(重複上述格式直到所有檔案輸出完畢)\n";
 const MERGE_PROMPT = "# 角色：知識庫合併架構師 (Knowledge Merge Architect)\n\n## 任務目標\n將新的內容合併到既有的知識庫檔案結構中，根據內容類型與主題智能決定「新增頁面」、「合併到既有頁面」或「更新既有頁面」。\n\n## 既有知識庫目錄 (Index.md)\n```markdown\n{{indexContent}}\n```\n\n## 新內容類型：{{fileType}}\n## 新內容\n```{{contentBlock}}\n{{newContent}}\n```\n\n## 處理規則：\n\n### 1. 結構識別（依 fileType）\n\n**json**：\n- 分析 JSON 頂層結構，以第一層 key 或語義主題分群\n- 若為巢狀物件，每個第一層 key 視為一個主題區塊\n- 若為頂層陣列，每個元素視為獨立條目\n\n**markdown**：\n- 依照 `##` 或 `###` 標題拆分成獨立區塊\n- 每個區塊視為一個新知識條目\n\n### 2. 合併策略判斷\n\n對每個條目，檢查是否與既有 Index.md 中的頁面相關：\n\n- **主題全新**（目錄中無相關頁面）→ 建立**新檔案**，Index.md 追加新條目\n- **主題已存在**（標題或關鍵詞與既有頁面重疊）→ 將新內容**合併**到既有檔案，保留既有結構，新增內容作為補充。合併後輸出該檔案的**完整內容**\n- **既有檔案缺少條目**（例如列表型資料漏了某筆）→ 必須**補齊**，將缺漏條目加入對應區塊\n- **內容衝突**（同一主題但資訊不一致，如價格變動、規則修改）→ 以**新內容為準**更新，標記 `> 更新於 YYYY-MM-DD`\n- **內容重複**（完全相同）→ 跳過，不輸出\n\n### 3. 完整性驗證\n- 陣列型資料：比對新內容的項目數與既有檔案收錄數，缺漏必須補齊\n- 巢狀陣列（如設施清單、標籤列表）：逐一檢查是否全數收錄\n- 多語言欄位：以 `zh_tw` 為主要輸出語言，不存在時 fallback 到 `en`\n- JSON 字串內容（Quill Delta 等）：`\\n` → 換行、`\\t` → 縮排、HTML → Markdown\n\n### 4. 輸出約束\n- **輸出順序**：先輸出更新後的 `Index.md`，再依序輸出所有新增或更新過的檔案\n- 每個檔案前必須有 `### 檔名.md` 作為標題，絕對不可省略\n- 每個檔案以獨立 ` ```markdown ` 程式碼區塊呈現\n- **只輸出有變動的檔案**，未修改的既有檔案不需重複輸出\n- 合併的檔案必須包含**完整內容**（既有 + 新增），不可只輸出差異\n\n## 輸出格式規範：\n\n### Index.md\n```markdown\n# 知識庫目錄\n- [顯示名稱 A](A.md)：一句話摘要涵蓋的關鍵主題\n- [顯示名稱 B](B.md)：一句話摘要涵蓋的關鍵主題\n```\n\n---\n\n### 檔名.md\n```markdown\n[完整內容]\n```\n\n---\n\n(重複上述格式直到所有變動檔案輸出完畢)\n";
 const ROUTER_PROMPT = "# 角色設定\n你是一個精準的「知識庫路由助手 (Router)」。\n你的唯一任務是分析使用者的問題，並從提供的目錄清單中，挑選出最可能包含解答的檔案名稱。\n\n# 使用者問題\n{{prompt}}\n\n# 知識庫目錄\n{{indexContent}}\n\n# 挑選原則\n- 從目錄中每個檔案的**摘要**判斷相關性，不只比對檔名\n- 考慮同義詞與相關概念（例如：「運動」「健身」→ Facilities.md；「怎麼去」「交通」→ Location_and_Transport.md）\n- 若問題涉及多個主題（如「房價和退房時間」），選取所有相關檔案\n\n# 輸出嚴格規範\n1. **僅輸出檔名**：從「知識庫目錄」中挑選最相關的完整檔案名稱（必須包含 `.md` 後綴）。\n2. **多檔處理**：若有多個檔案相關，請以半形逗號 `,` 分隔。\n3. **無相關時**：若判斷目錄中的檔案皆不相關，請直接回覆 `NONE`。\n4. **禁止任何廢話**：**絕對禁止**輸出任何解釋文字、問候語、符號，也**禁止**使用 Markdown 標記（如代碼塊 ` ``` ` 或清單 `-`）。\n\n**正確輸出範例：**\nIntroduction.md,Policy_Info.md\n";
+const PERSONA_PROMPT = "你正在依據以下知識庫，為這個業務單位產出一段給 AI 模型使用的「智慧管家／服務窗口」角色設定。\n\n【輸出規則】\n- 120 字以內\n- 使用第二人稱開頭：「你是 …」\n- **必須**使用知識庫中實際出現的單位名稱（含中英文／品牌名／所在地），不得改寫、不得概括成「店家」「飯店」「公司」等通稱\n- 必須點出業種與服務範圍（依資料推斷，例如：精品民宿、商務飯店、餐廳、停車場、診所…）\n- 必須描述語氣（專業、親切、簡明等），可參考品牌調性\n- **嚴禁**編造未在資料中出現的細節\n- **嚴禁**寫成介紹文、宣傳文，必須是給 AI 模型看的角色指令\n- 直接輸出純文字角色描述，**不要**任何前後綴、不要 markdown、不要程式碼框\n\n【知識庫目錄】\n{{indexContent}}\n\n【主要內容摘要】\n{{contentSample}}\n\n【角色設定】\n";
 
 /**
  * LLM 輸出解析器
@@ -93,10 +94,14 @@ function parseWikiOutput(output) {
  *   createWikiRouter({ router, source: fsSource('./knowledge'), store: fsStore('./wiki') })
  *
  * 也可直接傳 knowledgeDir / outputDir 給 createWikiRouter，內部會自動包成這兩個 adapter。
+ *
+ * 註：fsStore.list() 會排除以底線開頭的檔案（如 `_persona.md`），
+ *     因為這類檔案被視為「非路由用」的衍生資料（例如自動產生的角色設定）。
  */
 
 
 const MANIFEST_FILE = '.manifest.json';
+const PERSONA_FILE = '_persona.md';
 
 /**
  * 建立讀取本地檔案的 Source adapter
@@ -146,7 +151,8 @@ function fsStore(dir) {
   return {
     async list() {
       ensure();
-      return fs.readdirSync(resolved).filter(f => f.endsWith('.md'))
+      // 排除以底線開頭的檔案（例如 _persona.md），避免污染路由與 Index 自動生成
+      return fs.readdirSync(resolved).filter(f => f.endsWith('.md') && !f.startsWith('_'))
     },
     async read(filename) {
       const filePath = path.join(resolved, filename);
@@ -174,6 +180,15 @@ function fsStore(dir) {
         'utf-8'
       );
     },
+    async readPersona() {
+      const filePath = path.join(resolved, PERSONA_FILE);
+      if (!fs.existsSync(filePath)) return null
+      return fs.readFileSync(filePath, 'utf-8')
+    },
+    async writePersona(persona) {
+      ensure();
+      fs.writeFileSync(path.join(resolved, PERSONA_FILE), persona, 'utf-8');
+    },
   }
 }
 
@@ -204,11 +219,14 @@ function createWikiRouter(config) {
     splitPrompt,
     mergePrompt,
     routerPrompt,
+    personaPrompt,
+    personaSampleSize = 4000,
   } = config;
 
   const activeSplitPrompt = splitPrompt || SPLIT_PROMPT;
   const activeMergePrompt = mergePrompt || MERGE_PROMPT;
   const activeRouterPrompt = routerPrompt || ROUTER_PROMPT;
+  const activePersonaPrompt = personaPrompt || PERSONA_PROMPT;
 
   if (!router) throw new Error('[wiki-router] router is required')
 
@@ -378,6 +396,15 @@ function createWikiRouter(config) {
       }
 
       console.log(`[Wiki] Build complete — ${totalFiles} file(s), ${formatElapsed(buildStart)}`);
+
+      if (!options.skipPersona && typeof activeStore.writePersona === 'function') {
+        try {
+          await buildPersona({ force: !!force });
+        } catch (err) {
+          console.warn('[Wiki] Persona build failed (non-fatal):', err.message);
+        }
+      }
+
       return true
     } catch (err) {
       console.error(`[Wiki Generation Error] (after ${formatElapsed(buildStart)})`, err);
@@ -385,6 +412,67 @@ function createWikiRouter(config) {
     }
   }
 
+  /**
+   * 依據 Index.md + 其他 .md 樣本，呼叫 LLM 產出一段角色設定，寫入 store.writePersona()
+   * 必須 store 同時實作 readPersona/writePersona 才會有效；否則 noop。
+   * @param {{ force?: boolean }} [options]
+   * @returns {Promise<boolean>}
+   */
+  async function buildPersona(options = {}) {
+    const { force = false } = options;
+    if (typeof activeStore.writePersona !== 'function') {
+      return false
+    }
+
+    if (!force && typeof activeStore.readPersona === 'function') {
+      const existing = await activeStore.readPersona();
+      if (existing && existing.trim().length > 0) return true
+    }
+
+    const indexContent = await activeStore.read('Index.md');
+    if (!indexContent) {
+      console.warn('[Wiki] No Index.md, skip persona generation');
+      return false
+    }
+
+    const allFiles = await activeStore.list();
+    const samples = [];
+    let totalLen = 0;
+    for (const f of allFiles) {
+      if (!f.endsWith('.md') || f === 'Index.md' || f.startsWith('_')) continue
+      if (totalLen >= personaSampleSize) break
+      const c = await activeStore.read(f);
+      if (!c) continue
+      const remaining = personaSampleSize - totalLen;
+      const slice = c.slice(0, remaining);
+      samples.push(`### ${f}\n${slice}`);
+      totalLen += slice.length;
+    }
+
+    const prompt = activePersonaPrompt
+      .replace('{{indexContent}}', indexContent)
+      .replace('{{contentSample}}', samples.join('\n\n') || '(無其他內容)');
+
+    const persona = await chat([{ role: 'user', content: prompt }]);
+    if (!persona || persona.trim().length < 10) {
+      console.warn('[Wiki] Persona LLM returned empty/too-short, skip write');
+      return false
+    }
+
+    await activeStore.writePersona(persona.trim());
+    console.log(`[Wiki] Persona generated (${persona.trim().length} chars)`);
+    return true
+  }
+
+  /**
+   * 取得目前儲存的 persona；若 store 不支援或尚未生成回 null
+   * @returns {Promise<string|null>}
+   */
+  async function getPersona() {
+    if (typeof activeStore.readPersona !== 'function') return null
+    return activeStore.readPersona()
+  }
+
   async function getContext(prompt) {
     try {
       let wikiFiles = await activeStore.list();
@@ -443,7 +531,7 @@ function createWikiRouter(config) {
     return ''
   }
 
-  return { build, getContext }
+  return { build, getContext, buildPersona, getPersona }
 }
 
 /**
@@ -458,15 +546,17 @@ function createWikiRouter(config) {
 
 const DEFAULT_FILES_TABLE = 'wiki_files';
 const DEFAULT_MANIFESTS_TABLE = 'wiki_manifests';
+const DEFAULT_PERSONAS_TABLE = 'wiki_personas';
 
 /**
- * 建立 wiki_files / wiki_manifests 兩個表（CREATE TABLE IF NOT EXISTS，可重複呼叫）
+ * 建立 wiki_files / wiki_manifests / wiki_personas 三個表（CREATE TABLE IF NOT EXISTS，可重複呼叫）
  * @param {*} db - better-sqlite3 相容實例
- * @param {{ filesTable?: string, manifestsTable?: string }} [opts]
+ * @param {{ filesTable?: string, manifestsTable?: string, personasTable?: string }} [opts]
  */
 function ensureWikiTables(db, opts = {}) {
   const filesTable = opts.filesTable || DEFAULT_FILES_TABLE;
   const manifestsTable = opts.manifestsTable || DEFAULT_MANIFESTS_TABLE;
+  const personasTable = opts.personasTable || DEFAULT_PERSONAS_TABLE;
   db.exec(`
     CREATE TABLE IF NOT EXISTS ${filesTable} (
       tenant_id  TEXT NOT NULL,
@@ -480,12 +570,17 @@ function ensureWikiTables(db, opts = {}) {
       manifest   TEXT NOT NULL,
       updated_at TEXT NOT NULL
     );
+    CREATE TABLE IF NOT EXISTS ${personasTable} (
+      tenant_id  TEXT PRIMARY KEY,
+      persona    TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    );
   `);
 }
 
 /**
  * 建立 SQLite-backed Store adapter
- * @param {{ db: *, tenantId: string, filesTable?: string, manifestsTable?: string }} config
+ * @param {{ db: *, tenantId: string, filesTable?: string, manifestsTable?: string, personasTable?: string }} config
  * @returns {import('../types').Store}
  */
 function sqliteStore(config) {
@@ -498,8 +593,9 @@ function sqliteStore(config) {
   const { db, tenantId } = config;
   const filesTable = config.filesTable || DEFAULT_FILES_TABLE;
   const manifestsTable = config.manifestsTable || DEFAULT_MANIFESTS_TABLE;
+  const personasTable = config.personasTable || DEFAULT_PERSONAS_TABLE;
 
-  ensureWikiTables(db, { filesTable, manifestsTable });
+  ensureWikiTables(db, { filesTable, manifestsTable, personasTable });
 
   const stmts = {
     list: db.prepare(`SELECT filename FROM ${filesTable} WHERE tenant_id = ? ORDER BY filename`),
@@ -515,6 +611,12 @@ function sqliteStore(config) {
        VALUES (?, ?, ?)
        ON CONFLICT(tenant_id) DO UPDATE SET manifest = excluded.manifest, updated_at = excluded.updated_at`
     ),
+    readPersona: db.prepare(`SELECT persona FROM ${personasTable} WHERE tenant_id = ?`),
+    writePersona: db.prepare(
+      `INSERT INTO ${personasTable} (tenant_id, persona, updated_at)
+       VALUES (?, ?, ?)
+       ON CONFLICT(tenant_id) DO UPDATE SET persona = excluded.persona, updated_at = excluded.updated_at`
+    ),
   };
 
   return {
@@ -540,6 +642,13 @@ function sqliteStore(config) {
     async writeManifest(manifest) {
       stmts.writeManifest.run(tenantId, JSON.stringify(manifest), new Date().toISOString());
     },
+    async readPersona() {
+      const row = stmts.readPersona.get(tenantId);
+      return row ? row.persona : null
+    },
+    async writePersona(persona) {
+      stmts.writePersona.run(tenantId, persona, new Date().toISOString());
+    },
   }
 }
 
@@ -703,10 +812,20 @@ function createTenantManager(config) {
     return getWiki(tenantId).wiki.getContext(prompt)
   }
 
+  async function getPersona(tenantId) {
+    return getWiki(tenantId).wiki.getPersona()
+  }
+
+  async function buildPersona(tenantId, options = {}) {
+    return getWiki(tenantId).wiki.buildPersona(options)
+  }
+
   return {
     build,
     buildAll,
     getContext,
+    getPersona,
+    buildPersona,
     isBuilt: tenantId => builtTenants.has(tenantId),
     listBuilt: () => Array.from(builtTenants),
   }
@@ -725,4 +844,4 @@ function createTenantManager(config) {
  *   const manager = createTenantManager({ router, source, store, listTenants })
  */
 
-export { MERGE_PROMPT, ROUTER_PROMPT, SPLIT_PROMPT, createTenantManager, createWikiRouter, ensureWikiTables, fsSource, fsStore, parseWikiOutput, sqliteStore };
+export { MERGE_PROMPT, PERSONA_PROMPT, ROUTER_PROMPT, SPLIT_PROMPT, createTenantManager, createWikiRouter, ensureWikiTables, fsSource, fsStore, parseWikiOutput, sqliteStore };

package/dist/prompts.cjs

@@ -23,7 +23,9 @@ function readPrompt(filename) {
 const SPLIT_PROMPT = "# 角色：專業文件架構師 (Documentation Architect)\n\n## 任務目標\n將提供的 JSON 資料完整解析並轉換為多個獨立的 Markdown `.md` 檔案。\nJSON 可能來自 CMS、API 回應、設定檔或任何結構化資料來源。\n\n## 原始 JSON 資料\n```json\n{{context}}\n```\n\n## 處理規則：\n\n### 1. 結構識別（自動語義分析）\n- 分析 JSON 的頂層結構（object / array / 巢狀）\n- 若為巢狀物件，以**第一層 key** 作為主題分群依據（如 `data.rooms` → 房間主題、`data.location` → 地點主題）\n- 若為頂層陣列，每個元素視為獨立條目，依內容主題分組\n\n### 2. 完整性強制規則（最高優先）\n- **逐項清點**：陣列型資料必須逐一列出所有項目，先數原始 JSON 中有幾筆，輸出後再數確認數量一致\n- **巢狀陣列全收**：若某欄位本身是陣列（如設施清單、標籤列表），必須列出該陣列中的**每一項**\n- **不因長度省略**：資料再多也不能用「等」、「...」、「其他」概括\n\n### 3. 資訊提取（語義識別）\n- **標題欄位**：自動識別代表名稱/標題的欄位（`title`、`name`、`label`、`subject`）\n- **內文欄位**：自動識別長文字欄位（`content`、`description`、`body`、`intro`、`text`）\n- **時間欄位**：自動識別時間相關欄位（`time`、`date`、`checkin`、`checkout`、`created_at`、`published_at`）\n- **數值欄位**：自動識別價格/數量欄位（`price`、`qty`、`user`、`capacity`、`size`）\n- **布林欄位**：自動識別開關欄位（`enable`、`display`、`is_*`），轉為「啟用/停用」\n- **巢狀物件**：遞迴展開，保留層級結構（如 `social.{instagram_url, instagram_display}`）\n- **多語言欄位**：若欄位為 `{zh_tw, en, ja, ...}` 結構，以 `zh_tw` 為主要輸出語言，不存在時依序 fallback\n\n### 4. 格式還原\n- 若內容為 JSON 字串（Quill Delta 等 RTF 格式），解析後還原為純文字\n- 轉義換行 `\\n` → 真實換行、`\\t` → 縮排\n- 內嵌 HTML（`<a href>`, `<img>`, `<br>`）還原為對應 Markdown 語法\n- 內嵌 URL 保留為可點擊連結\n\n### 5. 檔案拆分原則\n- 依照 JSON 的**第一層 key** 或**語義主題**拆分成獨立 `.md` 檔案\n- 每個檔案涵蓋一個獨立主題區塊\n- 檔名使用英文，反映主題（如 `Rooms.md`、`Policies.md`、`Facilities.md`）\n\n### 6. 索引生成 (Index.md)\n- 彙整所有產出的檔案，生成 `Index.md`\n- 格式：`- [顯示名稱](檔名.md)：一句話摘要涵蓋的關鍵主題與具體資訊`\n- 摘要必須具體，禁止只重複檔名\n\n### 7. 輸出約束\n- **輸出順序**：先 `Index.md`，再依序輸出其他檔案\n- **必須標示檔名**：每個程式碼區塊正上方必須有 `### 檔名.md` 標題，不可省略\n- 每個檔案以獨立 ` ```markdown ` 程式碼區塊呈現\n- 所有 JSON 內容一律轉為人類可讀的 Markdown，不可保留原始 JSON 字串\n\n## 輸出格式規範：\n\n### Index.md\n```markdown\n# 知識庫目錄\n- [顯示名稱 A](A.md)：涵蓋的關鍵主題與具體資訊摘要\n- [顯示名稱 B](B.md)：涵蓋的關鍵主題與具體資訊摘要\n```\n\n---\n\n### 檔名.md\n```markdown\n[還原後的 Markdown 內容]\n```\n\n---\n\n(重複上述格式直到所有檔案輸出完畢)\n";
 const MERGE_PROMPT = "# 角色：知識庫合併架構師 (Knowledge Merge Architect)\n\n## 任務目標\n將新的內容合併到既有的知識庫檔案結構中，根據內容類型與主題智能決定「新增頁面」、「合併到既有頁面」或「更新既有頁面」。\n\n## 既有知識庫目錄 (Index.md)\n```markdown\n{{indexContent}}\n```\n\n## 新內容類型：{{fileType}}\n## 新內容\n```{{contentBlock}}\n{{newContent}}\n```\n\n## 處理規則：\n\n### 1. 結構識別（依 fileType）\n\n**json**：\n- 分析 JSON 頂層結構，以第一層 key 或語義主題分群\n- 若為巢狀物件，每個第一層 key 視為一個主題區塊\n- 若為頂層陣列，每個元素視為獨立條目\n\n**markdown**：\n- 依照 `##` 或 `###` 標題拆分成獨立區塊\n- 每個區塊視為一個新知識條目\n\n### 2. 合併策略判斷\n\n對每個條目，檢查是否與既有 Index.md 中的頁面相關：\n\n- **主題全新**（目錄中無相關頁面）→ 建立**新檔案**，Index.md 追加新條目\n- **主題已存在**（標題或關鍵詞與既有頁面重疊）→ 將新內容**合併**到既有檔案，保留既有結構，新增內容作為補充。合併後輸出該檔案的**完整內容**\n- **既有檔案缺少條目**（例如列表型資料漏了某筆）→ 必須**補齊**，將缺漏條目加入對應區塊\n- **內容衝突**（同一主題但資訊不一致，如價格變動、規則修改）→ 以**新內容為準**更新，標記 `> 更新於 YYYY-MM-DD`\n- **內容重複**（完全相同）→ 跳過，不輸出\n\n### 3. 完整性驗證\n- 陣列型資料：比對新內容的項目數與既有檔案收錄數，缺漏必須補齊\n- 巢狀陣列（如設施清單、標籤列表）：逐一檢查是否全數收錄\n- 多語言欄位：以 `zh_tw` 為主要輸出語言，不存在時 fallback 到 `en`\n- JSON 字串內容（Quill Delta 等）：`\\n` → 換行、`\\t` → 縮排、HTML → Markdown\n\n### 4. 輸出約束\n- **輸出順序**：先輸出更新後的 `Index.md`，再依序輸出所有新增或更新過的檔案\n- 每個檔案前必須有 `### 檔名.md` 作為標題，絕對不可省略\n- 每個檔案以獨立 ` ```markdown ` 程式碼區塊呈現\n- **只輸出有變動的檔案**，未修改的既有檔案不需重複輸出\n- 合併的檔案必須包含**完整內容**（既有 + 新增），不可只輸出差異\n\n## 輸出格式規範：\n\n### Index.md\n```markdown\n# 知識庫目錄\n- [顯示名稱 A](A.md)：一句話摘要涵蓋的關鍵主題\n- [顯示名稱 B](B.md)：一句話摘要涵蓋的關鍵主題\n```\n\n---\n\n### 檔名.md\n```markdown\n[完整內容]\n```\n\n---\n\n(重複上述格式直到所有變動檔案輸出完畢)\n";
 const ROUTER_PROMPT = "# 角色設定\n你是一個精準的「知識庫路由助手 (Router)」。\n你的唯一任務是分析使用者的問題，並從提供的目錄清單中，挑選出最可能包含解答的檔案名稱。\n\n# 使用者問題\n{{prompt}}\n\n# 知識庫目錄\n{{indexContent}}\n\n# 挑選原則\n- 從目錄中每個檔案的**摘要**判斷相關性，不只比對檔名\n- 考慮同義詞與相關概念（例如：「運動」「健身」→ Facilities.md；「怎麼去」「交通」→ Location_and_Transport.md）\n- 若問題涉及多個主題（如「房價和退房時間」），選取所有相關檔案\n\n# 輸出嚴格規範\n1. **僅輸出檔名**：從「知識庫目錄」中挑選最相關的完整檔案名稱（必須包含 `.md` 後綴）。\n2. **多檔處理**：若有多個檔案相關，請以半形逗號 `,` 分隔。\n3. **無相關時**：若判斷目錄中的檔案皆不相關，請直接回覆 `NONE`。\n4. **禁止任何廢話**：**絕對禁止**輸出任何解釋文字、問候語、符號，也**禁止**使用 Markdown 標記（如代碼塊 ` ``` ` 或清單 `-`）。\n\n**正確輸出範例：**\nIntroduction.md,Policy_Info.md\n";
+const PERSONA_PROMPT = "你正在依據以下知識庫，為這個業務單位產出一段給 AI 模型使用的「智慧管家／服務窗口」角色設定。\n\n【輸出規則】\n- 120 字以內\n- 使用第二人稱開頭：「你是 …」\n- **必須**使用知識庫中實際出現的單位名稱（含中英文／品牌名／所在地），不得改寫、不得概括成「店家」「飯店」「公司」等通稱\n- 必須點出業種與服務範圍（依資料推斷，例如：精品民宿、商務飯店、餐廳、停車場、診所…）\n- 必須描述語氣（專業、親切、簡明等），可參考品牌調性\n- **嚴禁**編造未在資料中出現的細節\n- **嚴禁**寫成介紹文、宣傳文，必須是給 AI 模型看的角色指令\n- 直接輸出純文字角色描述，**不要**任何前後綴、不要 markdown、不要程式碼框\n\n【知識庫目錄】\n{{indexContent}}\n\n【主要內容摘要】\n{{contentSample}}\n\n【角色設定】\n";
 
 exports.MERGE_PROMPT = MERGE_PROMPT;
+exports.PERSONA_PROMPT = PERSONA_PROMPT;
 exports.ROUTER_PROMPT = ROUTER_PROMPT;
 exports.SPLIT_PROMPT = SPLIT_PROMPT;

package/dist/prompts.mjs

@@ -21,5 +21,6 @@ function readPrompt(filename) {
 const SPLIT_PROMPT = "# 角色：專業文件架構師 (Documentation Architect)\n\n## 任務目標\n將提供的 JSON 資料完整解析並轉換為多個獨立的 Markdown `.md` 檔案。\nJSON 可能來自 CMS、API 回應、設定檔或任何結構化資料來源。\n\n## 原始 JSON 資料\n```json\n{{context}}\n```\n\n## 處理規則：\n\n### 1. 結構識別（自動語義分析）\n- 分析 JSON 的頂層結構（object / array / 巢狀）\n- 若為巢狀物件，以**第一層 key** 作為主題分群依據（如 `data.rooms` → 房間主題、`data.location` → 地點主題）\n- 若為頂層陣列，每個元素視為獨立條目，依內容主題分組\n\n### 2. 完整性強制規則（最高優先）\n- **逐項清點**：陣列型資料必須逐一列出所有項目，先數原始 JSON 中有幾筆，輸出後再數確認數量一致\n- **巢狀陣列全收**：若某欄位本身是陣列（如設施清單、標籤列表），必須列出該陣列中的**每一項**\n- **不因長度省略**：資料再多也不能用「等」、「...」、「其他」概括\n\n### 3. 資訊提取（語義識別）\n- **標題欄位**：自動識別代表名稱/標題的欄位（`title`、`name`、`label`、`subject`）\n- **內文欄位**：自動識別長文字欄位（`content`、`description`、`body`、`intro`、`text`）\n- **時間欄位**：自動識別時間相關欄位（`time`、`date`、`checkin`、`checkout`、`created_at`、`published_at`）\n- **數值欄位**：自動識別價格/數量欄位（`price`、`qty`、`user`、`capacity`、`size`）\n- **布林欄位**：自動識別開關欄位（`enable`、`display`、`is_*`），轉為「啟用/停用」\n- **巢狀物件**：遞迴展開，保留層級結構（如 `social.{instagram_url, instagram_display}`）\n- **多語言欄位**：若欄位為 `{zh_tw, en, ja, ...}` 結構，以 `zh_tw` 為主要輸出語言，不存在時依序 fallback\n\n### 4. 格式還原\n- 若內容為 JSON 字串（Quill Delta 等 RTF 格式），解析後還原為純文字\n- 轉義換行 `\\n` → 真實換行、`\\t` → 縮排\n- 內嵌 HTML（`<a href>`, `<img>`, `<br>`）還原為對應 Markdown 語法\n- 內嵌 URL 保留為可點擊連結\n\n### 5. 檔案拆分原則\n- 依照 JSON 的**第一層 key** 或**語義主題**拆分成獨立 `.md` 檔案\n- 每個檔案涵蓋一個獨立主題區塊\n- 檔名使用英文，反映主題（如 `Rooms.md`、`Policies.md`、`Facilities.md`）\n\n### 6. 索引生成 (Index.md)\n- 彙整所有產出的檔案，生成 `Index.md`\n- 格式：`- [顯示名稱](檔名.md)：一句話摘要涵蓋的關鍵主題與具體資訊`\n- 摘要必須具體，禁止只重複檔名\n\n### 7. 輸出約束\n- **輸出順序**：先 `Index.md`，再依序輸出其他檔案\n- **必須標示檔名**：每個程式碼區塊正上方必須有 `### 檔名.md` 標題，不可省略\n- 每個檔案以獨立 ` ```markdown ` 程式碼區塊呈現\n- 所有 JSON 內容一律轉為人類可讀的 Markdown，不可保留原始 JSON 字串\n\n## 輸出格式規範：\n\n### Index.md\n```markdown\n# 知識庫目錄\n- [顯示名稱 A](A.md)：涵蓋的關鍵主題與具體資訊摘要\n- [顯示名稱 B](B.md)：涵蓋的關鍵主題與具體資訊摘要\n```\n\n---\n\n### 檔名.md\n```markdown\n[還原後的 Markdown 內容]\n```\n\n---\n\n(重複上述格式直到所有檔案輸出完畢)\n";
 const MERGE_PROMPT = "# 角色：知識庫合併架構師 (Knowledge Merge Architect)\n\n## 任務目標\n將新的內容合併到既有的知識庫檔案結構中，根據內容類型與主題智能決定「新增頁面」、「合併到既有頁面」或「更新既有頁面」。\n\n## 既有知識庫目錄 (Index.md)\n```markdown\n{{indexContent}}\n```\n\n## 新內容類型：{{fileType}}\n## 新內容\n```{{contentBlock}}\n{{newContent}}\n```\n\n## 處理規則：\n\n### 1. 結構識別（依 fileType）\n\n**json**：\n- 分析 JSON 頂層結構，以第一層 key 或語義主題分群\n- 若為巢狀物件，每個第一層 key 視為一個主題區塊\n- 若為頂層陣列，每個元素視為獨立條目\n\n**markdown**：\n- 依照 `##` 或 `###` 標題拆分成獨立區塊\n- 每個區塊視為一個新知識條目\n\n### 2. 合併策略判斷\n\n對每個條目，檢查是否與既有 Index.md 中的頁面相關：\n\n- **主題全新**（目錄中無相關頁面）→ 建立**新檔案**，Index.md 追加新條目\n- **主題已存在**（標題或關鍵詞與既有頁面重疊）→ 將新內容**合併**到既有檔案，保留既有結構，新增內容作為補充。合併後輸出該檔案的**完整內容**\n- **既有檔案缺少條目**（例如列表型資料漏了某筆）→ 必須**補齊**，將缺漏條目加入對應區塊\n- **內容衝突**（同一主題但資訊不一致，如價格變動、規則修改）→ 以**新內容為準**更新，標記 `> 更新於 YYYY-MM-DD`\n- **內容重複**（完全相同）→ 跳過，不輸出\n\n### 3. 完整性驗證\n- 陣列型資料：比對新內容的項目數與既有檔案收錄數，缺漏必須補齊\n- 巢狀陣列（如設施清單、標籤列表）：逐一檢查是否全數收錄\n- 多語言欄位：以 `zh_tw` 為主要輸出語言，不存在時 fallback 到 `en`\n- JSON 字串內容（Quill Delta 等）：`\\n` → 換行、`\\t` → 縮排、HTML → Markdown\n\n### 4. 輸出約束\n- **輸出順序**：先輸出更新後的 `Index.md`，再依序輸出所有新增或更新過的檔案\n- 每個檔案前必須有 `### 檔名.md` 作為標題，絕對不可省略\n- 每個檔案以獨立 ` ```markdown ` 程式碼區塊呈現\n- **只輸出有變動的檔案**，未修改的既有檔案不需重複輸出\n- 合併的檔案必須包含**完整內容**（既有 + 新增），不可只輸出差異\n\n## 輸出格式規範：\n\n### Index.md\n```markdown\n# 知識庫目錄\n- [顯示名稱 A](A.md)：一句話摘要涵蓋的關鍵主題\n- [顯示名稱 B](B.md)：一句話摘要涵蓋的關鍵主題\n```\n\n---\n\n### 檔名.md\n```markdown\n[完整內容]\n```\n\n---\n\n(重複上述格式直到所有變動檔案輸出完畢)\n";
 const ROUTER_PROMPT = "# 角色設定\n你是一個精準的「知識庫路由助手 (Router)」。\n你的唯一任務是分析使用者的問題，並從提供的目錄清單中，挑選出最可能包含解答的檔案名稱。\n\n# 使用者問題\n{{prompt}}\n\n# 知識庫目錄\n{{indexContent}}\n\n# 挑選原則\n- 從目錄中每個檔案的**摘要**判斷相關性，不只比對檔名\n- 考慮同義詞與相關概念（例如：「運動」「健身」→ Facilities.md；「怎麼去」「交通」→ Location_and_Transport.md）\n- 若問題涉及多個主題（如「房價和退房時間」），選取所有相關檔案\n\n# 輸出嚴格規範\n1. **僅輸出檔名**：從「知識庫目錄」中挑選最相關的完整檔案名稱（必須包含 `.md` 後綴）。\n2. **多檔處理**：若有多個檔案相關，請以半形逗號 `,` 分隔。\n3. **無相關時**：若判斷目錄中的檔案皆不相關，請直接回覆 `NONE`。\n4. **禁止任何廢話**：**絕對禁止**輸出任何解釋文字、問候語、符號，也**禁止**使用 Markdown 標記（如代碼塊 ` ``` ` 或清單 `-`）。\n\n**正確輸出範例：**\nIntroduction.md,Policy_Info.md\n";
+const PERSONA_PROMPT = "你正在依據以下知識庫，為這個業務單位產出一段給 AI 模型使用的「智慧管家／服務窗口」角色設定。\n\n【輸出規則】\n- 120 字以內\n- 使用第二人稱開頭：「你是 …」\n- **必須**使用知識庫中實際出現的單位名稱（含中英文／品牌名／所在地），不得改寫、不得概括成「店家」「飯店」「公司」等通稱\n- 必須點出業種與服務範圍（依資料推斷，例如：精品民宿、商務飯店、餐廳、停車場、診所…）\n- 必須描述語氣（專業、親切、簡明等），可參考品牌調性\n- **嚴禁**編造未在資料中出現的細節\n- **嚴禁**寫成介紹文、宣傳文，必須是給 AI 模型看的角色指令\n- 直接輸出純文字角色描述，**不要**任何前後綴、不要 markdown、不要程式碼框\n\n【知識庫目錄】\n{{indexContent}}\n\n【主要內容摘要】\n{{contentSample}}\n\n【角色設定】\n";
 
-export { MERGE_PROMPT, ROUTER_PROMPT, SPLIT_PROMPT };
+export { MERGE_PROMPT, PERSONA_PROMPT, ROUTER_PROMPT, SPLIT_PROMPT };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungtz/wiki-router",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "LLM Wiki 知識庫路由引擎 - 將結構化知識轉為 Markdown 維基，智慧路由查詢",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",

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 過的租戶清單
  */