Knowledge Base Skill
管理本地的设计资料、文档、数据集、代码仓库的位置索引，并通过 LLM 编译成结构化 Wiki（含反向链接、概念归类、知识图谱）。支持任意文件类型。
快速开始
SKILL_PATH="skills/knowledge-base"
# 添加单个资料
python3 $SKILL_PATH/main.py add /path/to/doc.md --tags "tag1,tag2" --category "分类"
# 导入项目 design/ 目录
python3 $SKILL_PATH/main.py import-project
# 查看索引
python3 $SKILL_PATH/main.py list
# 浏览知识库
python3 $SKILL_PATH/main.py browse
# 搜索
python3 $SKILL_PATH/main.py search "记忆架构"
命令列表
索引管理
| 命令 |
说明 |
add <path> |
添加资料索引（支持 --title, --tags, --type, --category） |
add <dir> --type directory --pattern "*.md" --recursive |
批量添加目录下的文件 |
list [--type X] [--tag X] [--category X] [--pending] |
列出索引，支持过滤 |
remove <id> |
移除索引条目 |
edit <id> [--title X] [--tags X] [--category X] |
更新索引元数据 |
import-project [--dir design] [--pattern "*.md"] |
快捷导入项目目录 |
编译
| 命令 |
说明 |
compile |
增量编译 Wiki（生成 prompt 供 Agent 执行） |
compile --full |
全量重新编译 |
compile --dry-run |
预览待编译清单 |
compile --finalize |
编译后处理（更新反向链接和知识图谱） |
浏览与搜索
| 命令 |
说明 |
browse |
知识地图概览 |
browse <category> |
查看分类下的概念 |
read <concept-id> |
读取概念条目全文 |
source <source-id> |
查看原始资料信息 |
search <query> |
知识导航（输出 Wiki 结构供 Agent 语义定位） |
status |
知识库状态总览（条目统计、编译状态） |
check |
路径有效性检查 |
搜索策略：search 输出完整知识结构（分类 + 概念列表），由你（Agent）根据查询意图自主判断哪些概念相关，然后用 read <concept-id> 读取全文。这比关键词匹配更准确。
知识图谱
| 命令 |
说明 |
graph |
输出知识图谱（JSON） |
graph --format mermaid |
输出 Mermaid 格式图谱 |
graph --center <id> --depth 2 |
以某概念为中心的子图 |
概念管理
| 命令 |
说明 |
concept list |
列出所有概念 |
concept remove <concept-id> |
删除概念 |
concept merge <id1> <id2> |
合并两个概念 |
concept rename <concept-id> "新标题" |
重命名概念 |
分类管理
| 命令 |
说明 |
category list |
列出所有分类 |
category rename <old-name> <new-name> |
重命名分类 |
Skill 管理
| 命令 |
说明 |
install [--target <path>] |
安装初始化（创建数据目录） |
update [--target <path>] |
更新代码 |
uninstall |
卸载 |
支持的资料类型
| 类型 |
扩展名 |
索引行为 |
| markdown |
.md, .mdx, .rst |
读取全文，自动提取标题 |
| code |
.py, .js, .ts, .java, .go, .rs, .vue 等 |
读取全文，返回文件名 |
| config |
.yaml, .toml, .json, .xml, .env 等 |
读取全文，返回文件名 |
| text |
.txt, .log, .tex |
读取全文 |
| dataset |
.csv, .json, .jsonl, .tsv |
读取前 20 行预览 |
| image |
.png, .jpg, .gif, .svg, .webp |
索引路径 + 文件大小 |
| binary |
.pdf, .zip, .exe, .whl 等 |
索引路径 + 文件大小 |
| repo |
含 .git 的目录 |
读取 README + 目录结构 |
| directory |
普通目录 |
目录树（深度 2） |
| link |
外部 URL |
存储 URL + 手动摘要 |
未知扩展名自动通过二进制检测区分文本/二进制，不限制文件类型。
数据目录
运行时数据存储在 skills/knowledge-base-data/：
knowledge-base-data/
├── raw/
│ └── index.jsonl ← 索引清单
├── wiki/
│ ├── index.md ← 知识地图
│ ├── concepts/ ← 概念条目（Markdown + frontmatter）
│ ├── categories/ ← 分类索引
│ └── graph.json ← 知识图谱（含反向链接关系）
├── wiki.bak/ ← 编译前自动备份
└── compile/
└── history.jsonl ← 编译历史（保留最近 50 条）
编译流程
kb compile --dry-run — 预览待编译清单kb compile — 生成 prompt，Agent 分析内容、提取概念、写入 wiki/concepts/kb compile --finalize — 构建知识图谱、知识地图、分类索引
1---2name: knowledge-base3description: 本地知识资料索引与 Wiki 编译4---56# Knowledge Base Skill78管理本地的设计资料、文档、数据集、代码仓库的位置索引，并通过 LLM 编译成结构化 Wiki（含反向链接、概念归类、知识图谱）。支持任意文件类型。910## 快速开始1112```bash13SKILL_PATH="skills/knowledge-base"1415# 添加单个资料16python3 $SKILL_PATH/main.py add /path/to/doc.md --tags "tag1,tag2" --category "分类"1718# 导入项目 design/ 目录19python3 $SKILL_PATH/main.py import-project2021# 查看索引22python3 $SKILL_PATH/main.py list2324# 浏览知识库25python3 $SKILL_PATH/main.py browse2627# 搜索28python3 $SKILL_PATH/main.py search "记忆架构"29```3031## 命令列表3233### 索引管理3435| 命令 | 说明 |36|------|------|37| `add <path>` | 添加资料索引（支持 --title, --tags, --type, --category） |38| `add <dir> --type directory --pattern "*.md" --recursive` | 批量添加目录下的文件 |39| `list [--type X] [--tag X] [--category X] [--pending]` | 列出索引，支持过滤 |40| `remove <id>` | 移除索引条目 |41| `edit <id> [--title X] [--tags X] [--category X]` | 更新索引元数据 |42| `import-project [--dir design] [--pattern "*.md"]` | 快捷导入项目目录 |4344### 编译4546| 命令 | 说明 |47|------|------|48| `compile` | 增量编译 Wiki（生成 prompt 供 Agent 执行） |49| `compile --full` | 全量重新编译 |50| `compile --dry-run` | 预览待编译清单 |51| `compile --finalize` | 编译后处理（更新反向链接和知识图谱） |5253### 浏览与搜索5455| 命令 | 说明 |56|------|------|57| `browse` | 知识地图概览 |58| `browse <category>` | 查看分类下的概念 |59| `read <concept-id>` | 读取概念条目全文 |60| `source <source-id>` | 查看原始资料信息 |61| `search <query>` | 知识导航（输出 Wiki 结构供 Agent 语义定位） |62| `status` | 知识库状态总览（条目统计、编译状态） |63| `check` | 路径有效性检查 |6465**搜索策略**：`search` 输出完整知识结构（分类 + 概念列表），由你（Agent）根据查询意图自主判断哪些概念相关，然后用 `read <concept-id>` 读取全文。这比关键词匹配更准确。6667### 知识图谱6869| 命令 | 说明 |70|------|------|71| `graph` | 输出知识图谱（JSON） |72| `graph --format mermaid` | 输出 Mermaid 格式图谱 |73| `graph --center <id> --depth 2` | 以某概念为中心的子图 |7475### 概念管理7677| 命令 | 说明 |78|------|------|79| `concept list` | 列出所有概念 |80| `concept remove <concept-id>` | 删除概念 |81| `concept merge <id1> <id2>` | 合并两个概念 |82| `concept rename <concept-id> "新标题"` | 重命名概念 |8384### 分类管理8586| 命令 | 说明 |87|------|------|88| `category list` | 列出所有分类 |89| `category rename <old-name> <new-name>` | 重命名分类 |9091### Skill 管理9293| 命令 | 说明 |94|------|------|95| `install [--target <path>]` | 安装初始化（创建数据目录） |96| `update [--target <path>]` | 更新代码 |97| `uninstall` | 卸载 |9899## 支持的资料类型100101| 类型 | 扩展名 | 索引行为 |102|------|--------|---------|103| markdown | .md, .mdx, .rst | 读取全文，自动提取标题 |104| code | .py, .js, .ts, .java, .go, .rs, .vue 等 | 读取全文，返回文件名 |105| config | .yaml, .toml, .json, .xml, .env 等 | 读取全文，返回文件名 |106| text | .txt, .log, .tex | 读取全文 |107| dataset | .csv, .json, .jsonl, .tsv | 读取前 20 行预览 |108| image | .png, .jpg, .gif, .svg, .webp | 索引路径 + 文件大小 |109| binary | .pdf, .zip, .exe, .whl 等 | 索引路径 + 文件大小 |110| repo | 含 .git 的目录 | 读取 README + 目录结构 |111| directory | 普通目录 | 目录树（深度 2） |112| link | 外部 URL | 存储 URL + 手动摘要 |113114未知扩展名自动通过二进制检测区分文本/二进制，**不限制文件类型**。115116## 数据目录117118运行时数据存储在 `skills/knowledge-base-data/`：119120```121knowledge-base-data/122├── raw/123│ └── index.jsonl ← 索引清单124├── wiki/125│ ├── index.md ← 知识地图126│ ├── concepts/ ← 概念条目（Markdown + frontmatter）127│ ├── categories/ ← 分类索引128│ └── graph.json ← 知识图谱（含反向链接关系）129├── wiki.bak/ ← 编译前自动备份130└── compile/131 └── history.jsonl ← 编译历史（保留最近 50 条）132```133134## 编译流程1351361. `kb compile --dry-run` — 预览待编译清单1372. `kb compile` — 生成 prompt，Agent 分析内容、提取概念、写入 wiki/concepts/1383. `kb compile --finalize` — 构建知识图谱、知识地图、分类索引
shetengteng