# Knowledge Base

> 本地知识资料索引与 Wiki 编译

- Skill: `shetengteng/knowledge-base` (Agent Skill, multi-file: 33 files)
- Install (CLI): `npx skillmds@latest add shetengteng/knowledge-base`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shetengteng/knowledge-base/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: shetengteng (https://skillmd.com/u/shetengteng)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/shetengteng/knowledge-base

---


# Knowledge Base Skill

管理本地的设计资料、文档、数据集、代码仓库的位置索引，并通过 LLM 编译成结构化 Wiki（含反向链接、概念归类、知识图谱）。支持任意文件类型。

## 快速开始

```bash
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 条）
```

## 编译流程

1. `kb compile --dry-run` — 预览待编译清单
2. `kb compile` — 生成 prompt，Agent 分析内容、提取概念、写入 wiki/concepts/
3. `kb compile --finalize` — 构建知识图谱、知识地图、分类索引