7分鐘閱讀

tKB 知識庫管理指南

用於按專案(csn)建立、檢視、編輯、刪除知識庫(tKB)項目的管理員畫面。tKB 用於按專案累積伺服器故障排除經驗、設定資訊、分析結果等,同時也是 Graphify(知識圖譜)畫面的資料來源。

🗂️ 前往tKB管理頁面 →

📋 概觀

tKB 管理 頁面列出目前所選專案(csn)下的知識庫項目,並可建立新項目或編輯/刪除現有項目。項目依參照對象(伺服器 lssn、資料庫 mdb_id 或一般 GENERAL)分類,由標題、內文與標籤組成。

⚠️ 本畫面僅限管理員使用。 存取需要管理員等級 uLevel >= 70(頁面中硬編碼的 prop 模式 minLevel={70})。等級不足的使用者會被重新導向至首頁。

🔍 畫面組成

1. 列表畫面(`/admin/tkb`)

元素	說明
Refresh 按鈕	重新載入目前頁面的資料
+ New tKB 按鈕	跳轉至新增畫面(`/admin/tkb/new`)
Per page 選擇	變更每頁顯示筆數(25/50/100)
列表項目	一列顯示標題、`refType` 徽章、`#kbSn`、註冊日期(`regDt`)與標籤。點擊標題或 [Details] 可跳轉至詳情畫面
分頁	若伺服器回傳 `totalCount` 則採用伺服器端分頁,否則回退為前端切片顯示

若未選擇專案,會顯示 "No Project Selected" 提示 — 請先於頂部導覽列選擇專案。列表依登入工作階段的 csn 取得,切換 csn 時會自動重設至第 1 頁。

2. 新增畫面(`/admin/tkb/new`)

欄位	必填	說明
CSN	✅	專案編號,自動帶入工作階段的 csn(可修改)
Reference Type	✅	從 `GENERAL` / `MANUAL` / `ERROR` / `ANALYSIS` / `GUIDE` 中選擇
Title	✅	標題,亦作為圖譜節點的標籤使用
Tags	-	以逗號分隔的標籤(例如 `backend, deploy, fix`)
Content	-	內文(Markdown 文字)
LSSN	-	關聯特定伺服器時的伺服器編號
MDB_ID	-	關聯特定資料庫時的資料庫編號

點擊 "Create tKB" 會送出 POST /api/giipKb,成功後返回列表畫面。

3. 詳情/編輯畫面(`/admin/tkb/[kbsn]`)

除與新增畫面相同的欄位外,底部還以唯讀方式顯示建立時間/建立者/修改時間/修改者(regDt/regBy/modDt/modBy)。右上角的 Delete Entry 按鈕在確認對話框後刪除該項目並返回列表。"Save Changes" 按鈕透過 PUT /api/giipKb 儲存修改內容。

🛠️ tKB 的建立、編輯與刪除方法

於頂部導覽列選擇目標專案(未選擇時列表為空)。
點擊 + New tKB,填寫 CSN、Reference Type、Title(Content/Tags/LSSN/MDB_ID 為選填),然後點擊 Create tKB。
於列表中點擊項目標題或 Details 進入詳情畫面。
編輯內容後點擊 Save Changes,修改會立即生效並顯示 "Successfully updated." 訊息。
不再需要的項目可於詳情畫面用 Delete Entry 刪除(無法復原,需確認)。
建立、編輯或刪除後不會自動反映到圖譜。 若要在知識圖譜中檢視變更,需前往 /graphify 頁面並點擊 [Rebuild] 按鈕(需登入,giip #2099)。詳見下方與 Graphify 的關係章節。

🌐 與 Graphify 的關係(必讀)

tKB 是 /graphify(知識圖譜)畫面的唯一資料來源(經 giip #2099 實測確認)。後端預存程序(pApiGraphifyRebuildbyAk)依 tKB WHERE csn=@csn 的項目產生圖譜的文件(DOC)節點與標籤(TAG)節點。

不會自動反映: 於本畫面建立、編輯或刪除 tKB 項目不會立即改變圖譜。
反映方法: 於 /graphify 頁面標頭點擊 [Rebuild] 按鈕(需登入),即可依最新的 tKB 內容重新產生圖譜。重建完成後圖譜會自動重新整理。
giip issue 等其他資料不會自動納入: graphify 不會自動收集 giip issue、伺服器資訊等資料。若專案中有 issue 但 tKB 尚未登記任何內容,圖譜將為空 — 這是正常現象。
自動化指令碼(如 giipAgentWin)可不使用本畫面,而是直接呼叫 giipKb API 來寫入 tKB(見下方 API 參考)。

🤖 K-Layer Wiki 每日自動寫入

若你發現 tKB 列表中出現自己從未建立過的項目且每天持續累積,那很可能是帶有 k-layer-wiki 標籤的自動產生項目。

是什麼: 一個名為 GIIP_Daily_KLayerWiki 的 Windows 工作排程器工作(依 giip #2096 實作,giipdb/mgmt/run_klayer_daily_wiki.ps1)每天執行一次,收集每個 csn 於「昨天」新登記的 giip issue(標題+內文+留言),以 MiniMax AI 進行摘要,並將摘要自動寫入為一筆新的 tKB 項目。
識別方法(本畫面尚無專用篩選器): 本畫面目前沒有依標籤/類型篩選的 UI。可透過列表每一列的以下內容來區分自動產生的項目:
- Reference Type 徽章: k-layer-daily
- Tags: k-layer-wiki,daily
- Title 格式: K-Layer Wiki <csn> - <yyyy-MM-dd>(例如 K-Layer Wiki 47 - 2026-09-06)
涵蓋範圍: 只要某個 csn 有至少一筆 giip issue 就會被處理(與專案白名單無關)。當天新增 issue 為 0 的 csn 會被完全略過(不呼叫 AI,也不寫入 tKB)。
敏感資訊遮罩: issue/留言內文會透過 giipdb/mgmt/lib/Mask-SensitiveInfo.ps1 進行兩次遮罩 — (1)傳送給 MiniMax 之前,(2)寫入 tKB 之前。
累積方式: 指令碼會讀取同一 csn 現有的 K-Layer Wiki(最新的 k-layer-wiki 標籤項目)作為檢查點,僅以 CLAIM 格式新增/更新當天 issue 中發現的真正新內容,然後重新儲存整份文件 — 既有內容不會被刪除,而是維持為一份累積文件。

⚠️ 注意不要與另一個指令碼混淆: giipdb/mgmt/sync_klayer_to_tkb.ps1 是另一個也會寫入 tKB 的指令碼,但其資料來源不是 giip issue,而是本機知識筆記檔案(.agent/k_layer/notes/*.md,預設僅針對 csn=47),並以 refType='KNOWLEDGE'、tags='sync, k-layer, ai-memory' 儲存。兩個指令碼都使用「K-Layer」這個名稱,但資料來源與目標 csn 範圍完全不同 — 可依 Tags 值(k-layer-wiki,daily 與 sync, k-layer, ai-memory)加以區分。

💡 備註

Tags 為自由格式字串,沒有強制的清單或結構。以逗號分隔輸入的內容會原樣儲存。
Reference Type 只能從 GENERAL/MANUAL/ERROR/ANALYSIS/GUIDE 五種中選擇(以畫面 select 選項為準)。
列表一律使用登入工作階段的 csn — 若要檢視其他專案的 tKB,請先於頂部切換專案。
刪除操作無法復原。若需保留內容,請事先自行備份。

API 參考

本畫面呼叫的 giipKb API 的端點、酬載與驗證方式已在另一份 API 指南中自成體系地說明。

📘 KB Management API User Guide

對於 giipAgentWin 等無需互動式登入工作階段即可註冊/查詢 tKB 的外部指令碼,請參考上述指南中以 SK 為基礎(giipApiSk3)的呼叫方式。

疑難排解

症狀	原因	解決方法
一進入就被重新導向至首頁	`uLevel` 低於 70	請使用管理員帳號(等級 70 以上)登入。
只顯示 "No Project Selected"	工作階段中未選擇專案(csn)	請於頂部導覽列選擇專案。
"Please login to continue" / 401 錯誤	沒有登入工作階段或工作階段已過期	請重新登入後重新整理頁面。
建立/編輯了項目,但 `/graphify` 的圖譜沒有變化	尚未執行 Rebuild — tKB 的變更不會自動反映到圖譜	於 `/graphify` 頁面登入後點擊 [Rebuild](giip #2099)。
`CSN, Title, and RefType are required.` 錯誤	新增畫面缺少必填欄位	請填寫 CSN、Title 與 Reference Type 後重新送出。
點擊刪除按鈕沒有反應	於確認對話框中點擊了取消,或驗證權杖已過期	於確認對話框中點擊確定;若為 401,請重新登入後再試。

版本: 1.0 最後更新: 2026-09-07(giip #2122: 新增 admin/tkb 使用者指南) 來源檔案: giipv3/public/help/tkb.zh-TW.md