# Knowledge Base

使用 Yuxi 知识库进行检索、打开文档、文档内定位。当用户需要基于已配置知识库回答问题、核验资料或引用文档内容时使用此技能。

- Repository: https://github.com/xerrors/Yuxi (7566 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add xerrors/Yuxi --skill knowledge-base -g -a claude-code -y`
Codex: `npx skills add xerrors/Yuxi --skill knowledge-base -g -a codex -y`
Cursor: `npx skills add xerrors/Yuxi --skill knowledge-base -g -a cursor -y`
Gemini CLI: `npx skills add xerrors/Yuxi --skill knowledge-base -g -a gemini-cli -y`

## Description

使用 Yuxi 知识库进行检索、打开文档、文档内定位。当用户需要基于已配置知识库回答问题、核验资料或引用文档内容时使用此技能。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 知识库技能

当用户要求基于项目知识库、内部资料、上传入库文档或知识图谱相关内容回答问题时，使用此技能。

## 可用工具

- `list_kbs`：列出当前会话可访问且已启用的知识库。
- `query_kb`：按 `kb_id` 在指定知识库中检索内容，返回 `file_id` 和相关片段。
- `open_kb_document`：按 `kb_id` 和 `file_id` 打开文档原文窗口，适合查看更完整上下文。
- `find_kb_document`：在已知文档内用关键词或正则定位段落。
- `search_file`：按文件名关键词搜索知识库中的文件，支持指定知识库或跨知识库，返回文件列表与分页信息。

## 操作流程

1. 需要先确认当前会话有哪些知识库可用；不确定时调用 `list_kbs`。
2. 针对用户问题选择最相关的知识库，使用 `query_kb` 检索。
3. 检索结果的 `metadata.chunk_count == 1` 表示文件只有一个分片；除非需要原文行号或额外上下文，否则无需打开。大于 1 且当前片段不足以回答时，使用返回的 `file_id` 调用 `open_kb_document` 查看上下文。字段缺失或为 0 表示未知，不据此判断文档完整。
4. 如果用户要求定位术语、指标、章节或原文证据，使用 `find_kb_document` 在候选文档内查找。

## 关键约束

- 只能访问当前会话配置和用户权限允许的知识库。
- 不要编造 `kb_id` 或 `file_id`；优先从 `list_kbs` 和 `query_kb` 的返回结果中获取。
- 回答需要可追溯时，应说明依据来自哪个知识库、文件或检索片段。
- Dify 等外部只读知识库可能只支持检索，不一定支持打开全文或文档内查找；遇到工具返回限制说明时，应如实告知用户。