7分钟阅读

私有知识库管理指南

用于创建、查询、编辑和删除按项目(csn)划分的私有知识库(tPrivateKB)条目的管理员页面。它按项目积累服务器故障处理经验、配置信息和分析结果，同时也是 Graphify(知识图谱)页面的数据来源。

这与公开知识库不同。 此页面的内容是仅限该组织(csn)查看的私有资料。任何人都能查看的公开技术资料位于 /kb，存储位置也不同(代码中的文章文件)。两者不会混在一起。

🗂️ 前往私有知识库管理页面 →

📋 概述

tPrivateKB 管理 页面列出当前所选项目(csn)下的知识库条目,并可创建新条目或编辑/删除现有条目。条目按引用对象(服务器 lssn、数据库 mdb_id 或通用 GENERAL)分类,由标题、正文和标签组成。

⚠️ 本界面仅限管理员使用。 访问需要管理员级别 uLevel >= 70(页面中硬编码的 prop 模式 minLevel={70})。级别不足的用户会被重定向到首页。

🔍 界面组成

1. 列表界面(`/admin/privatekb`)

元素	说明
Refresh 按钮	重新加载当前页数据
+ New tPrivateKB 按钮	跳转到新建界面(`/admin/privatekb/new`)
Per page 选择	更改每页显示条数(25/50/100)
列表项	一行显示标题、`refType` 徽章、`#kbSn`、注册日期(`regDt`)和标签。点击标题或 [Details] 可跳转到详情界面
分页	若服务器返回 `totalCount` 则采用服务器端分页,否则回退为客户端切片显示

若未选择项目,会显示 "No Project Selected" 提示 — 请先在顶部导航栏选择项目。列表基于登录会话的 csn 获取,切换 csn 时会自动重置到第 1 页。

2. 新建界面(`/admin/privatekb/new`)

字段	必填	说明
CSN	✅	项目编号,自动填入会话的 csn(可修改)
Reference Type	✅	从 `GENERAL` / `MANUAL` / `ERROR` / `ANALYSIS` / `GUIDE` 中选择
Title	✅	标题,也作为图谱节点的标签使用
Tags	-	逗号分隔的标签(例如 `backend, deploy, fix`)
Content	-	正文(Markdown 文本)
LSSN	-	关联特定服务器时的服务器编号
MDB_ID	-	关联特定数据库时的数据库编号

点击 "Create tPrivateKB" 会提交 POST /api/giipKb,成功后返回列表界面。

3. 详情/编辑界面(`/admin/privatekb/[kbsn]`)

除与新建界面相同的字段外,底部还以只读方式显示创建时间/创建人/修改时间/修改人(regDt/regBy/modDt/modBy)。右上角的 Delete Entry 按钮在确认弹窗后删除该条目并返回列表。"Save Changes" 按钮通过 PUT /api/giipKb 保存修改内容。

🛠️ tPrivateKB 的创建、编辑与删除方法

在顶部导航栏选择目标项目(未选择时列表为空)。
点击 + New tPrivateKB,填写 CSN、Reference Type、Title(Content/Tags/LSSN/MDB_ID 为可选项),然后点击 Create tPrivateKB。
在列表中点击条目标题或 Details 进入详情界面。
编辑内容后点击 Save Changes,修改会立即生效并显示 "Successfully updated." 提示。
不再需要的条目可在详情界面用 Delete Entry 删除(不可恢复,需确认)。
创建、编辑或删除后不会自动反映到图谱。 要在知识图谱中查看变更,需前往 /graphify 页面并点击 [Rebuild] 按钮(需登录,giip #2099)。详见下方与 Graphify 的关系章节。

🌐 与 Graphify 的关系(必读)

tPrivateKB 是 /graphify(知识图谱)界面的唯一数据来源(经 giip #2099 实测确认)。后端存储过程(pApiGraphifyRebuildbyAk)基于 tPrivateKB WHERE csn=@csn 的条目生成图谱的文档(DOC)节点和标签(TAG)节点。

不会自动反映: 在本界面创建、编辑或删除 tPrivateKB 条目不会立即改变图谱。
反映方法: 在 /graphify 页面头部点击 [Rebuild] 按钮(需登录),即可根据最新的 tPrivateKB 内容重新生成图谱。重建完成后图谱会自动刷新。
giip issue 等其他数据不会自动包含: graphify 不会自动收集 giip issue、服务器信息等数据。若项目中有 issue 但 tPrivateKB 中尚未登记任何内容,图谱将为空 — 这是正常现象。
自动化脚本(如 giipAgentWin)可以不使用本界面,而是直接调用 giipKb API 来写入 tPrivateKB(见下方 API 参考)。

🤖 K-Layer Wiki 每日自动写入

如果你发现 tPrivateKB 列表中出现了自己从未创建过的条目且每天持续累积,那很可能是带有 k-layer-wiki 标签的自动生成条目。

是什么: 一个名为 GIIP_Daily_KLayerWiki 的 Windows 任务计划程序任务(依 giip #2096 实现,giipdb/mgmt/run_klayer_daily_wiki.ps1)每天运行一次,收集每个 csn 在"昨天"新登记的 giip issue(标题+正文+评论),用 MiniMax AI 进行摘要,并将摘要自动写入为一条新的 tPrivateKB 条目。
识别方法(本界面尚无专用过滤器): 本界面目前没有按标签/类型过滤的 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,也不写入 tPrivateKB)。
敏感信息脱敏: issue/评论正文会通过 giipdb/mgmt/lib/Mask-SensitiveInfo.ps1 进行两次脱敏 — (1)发送给 MiniMax 之前,(2)写入 tPrivateKB 之前。
累积方式: 脚本会读取同一 csn 现有的 K-Layer Wiki(最新的 k-layer-wiki 标签条目)作为检查点,仅以 CLAIM 格式新增/更新当天 issue 中发现的真正新内容,然后重新保存整份文档 — 已有内容不会被删除,而是维持为一份累积文档。

⚠️ 注意不要与另一个脚本混淆: giipdb/mgmt/sync_klayer_to_tkb.ps1 是另一个也会写入 tPrivateKB 的脚本,但它的数据来源不是 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 — 如需查看其他项目的 tPrivateKB,请先在顶部切换项目。
删除操作不可撤销。如需保留内容,请提前自行备份。

API 参考

本界面调用的 giipKb API 的端点、载荷和认证方式已在另一份 API 指南中自成体系地说明。

📘 KB Management API User Guide

对于 giipAgentWin 等无需交互式登录会话即可注册/查询 tPrivateKB 的外部脚本,请参考上述指南中基于 SK 的(giipApiSk3)调用方式。

故障排查

症状	原因	解决方法
一进入就被重定向到首页	`uLevel` 低于 70	请使用管理员账号(等级 70 以上)登录。
只显示 "No Project Selected"	会话中未选择项目(csn)	请在顶部导航栏选择项目。
"Please login to continue" / 401 错误	没有登录会话或会话已过期	请重新登录后刷新页面。
创建/编辑了条目,但 `/graphify` 的图谱没有变化	尚未执行 Rebuild — tPrivateKB 的变更不会自动反映到图谱	在 `/graphify` 页面登录后点击 [Rebuild](giip #2099)。
`CSN, Title, and RefType are required.` 错误	新建界面缺少必填字段	请填写 CSN、Title 和 Reference Type 后重新提交。
点击删除按钮没有反应	在确认弹窗中点击了取消,或认证令牌已过期	在确认弹窗中点击确定;若为 401,请重新登录后再试。

版本: 1.0 最后更新: 2026-09-07(giip #2122: 新增 admin/privatekb 用户指南) 源文件: giipv3/public/help/tkb.zh-CN.md