安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install jishudb-search
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 jishudb-search。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

JishuDB 知识库搜索可帮助 AI 代理从内部知识库和文档中检索事实、核对准确的文件清单、读取文档文本、检查元数据并验证导入任务状态。它会将每个请求路由到适当的 JishuDB 工具，并依据返回的证据（包括来源文件名）提供事实性答案。
此 Openclaw Skills 集成是只读的：不会导入资料，也不会搜索公开网络。它不会将搜索摘要视为完整文档或完整清单；如果证据或所需工具不可用，也会明确说明。

应用场景

回答有关现有 JishuDB 知识库所含事实的问题，并引用来源文件名。
列出知识库或获取准确的文档清单；如果存在分页，则获取所有页面。
读取特定文档的完整文本，或检查其当前元数据和状态。
检查导入任务当前观察到的状态，而不重新提交任务。
/kb
请求，或诸如“搜索知识库”和“这个集合中有哪些文件？”之类的请求。

工作原理

判断请求涉及知识库发现、文档清单、文档文本或元数据、语义事实，还是导入状态。
使用经过身份验证的主机 MCP 连接器，并将请求路由到相应工具：kb_list、kb_list_documents、kb_get_document、kb_read_document_text、kb_search、kb_list_jobs 或 kb_get_job。
对于事实性问题，执行一次有针对性的搜索；如果缺少证据，最多优化查询两次。获得证据支持后停止，否则说明证据缺口。
对于准确清单，持续跟进 nextCursor，直到获取所有文档页。不要根据搜索片段或任务记录推断文件名或数量。
对于导入状态问题，报告当前观察到的任务状态。只有在用户要求等待时才轮询，最长不超过两分钟，并遵循服务器提供的延迟提示；如果任务仍未完成，则返回待处理任务 ID。
根据检索结果撰写答案，引用来源文件名，并清楚说明不确定性或工具故障，不要猜测。

配置指南

将此技能连接到经过授权的 JishuDB 环境。建议使用主机经过身份验证的 MCP 连接器；文档清单、全文、元数据和任务状态操作需要使用主机上相应的 MCP 工具。/kb 元数据是旧版发现提示，不是可移植的命令注册方式，因此请使用主机支持的 Skill 加载器。
随附的只读 HTTP 辅助程序仅支持列出知识库和搜索片段。它需要 Bash、curl 以及可访问的 JishuDB 端点。设置 JISHUDB_URL；启用身份验证时，还要设置 JISHUDB_TOKEN。旧版辅助程序的默认值为 http://host.docker.internal:18089；仅在适用于已配置环境时使用。JISHUDB_DEFAULT_KB 可提供默认知识库 ID。

为端点配置环境（请为你的环境设置这些值）

export JISHUDB_URL="http://host.docker.internal:18089"
export JISHUDB_TOKEN="your-token" # 仅在启用身份验证时设置

列出知识库

bash skills/jishudb-search/kb-search.sh list

搜索指定的知识库

bash skills/jishudb-search/kb-search.sh search "your question or keywords"

或者，使用已配置的默认知识库进行搜索

bash skills/jishudb-search/kb-search.sh "your question or keywords"
JishuDB 知识库搜索 数据架构与分类体系
此技能为只读，不会创建或导入知识库文档。它使用 JishuDB 实时结果和以下资源类型：
资源或结果 用途
知识库 kb_list 返回实时知识库详情，例如 ID、名称和数量；HTTP 辅助程序可列出知识库。
文档 kb_list_documents 提供权威的文档清单，并支持基于游标的分页。准确获取文件名和数量时请使用此工具。
文档记录 kb_get_document 获取已确认文档的当前元数据或状态。
文档文本 kb_read_document_text 获取文档内容；搜索片段不能替代全文。
搜索片段 kb_search 或 HTTP 辅助程序返回相关片段，通常包含来源文件名和相关性信息。请引用文件名，不要将片段视为完整清单。
导入任务 kb_list_jobs 和 kb_get_job 提供已观察到的任务状态。任务代表一次处理尝试，不代表文档数量。
未指定本地输出文件或持久化元数据分类体系。随附的 kb-search.sh 辅助程序是此技能文档中说明的资源；它支持列出知识库和搜索片段，其他操作则依赖主机 MCP 工具。

高级特性

将请求路由到不同工具，以执行知识库发现、分页文档清单查询、全文读取、元数据查询、语义搜索和任务状态查询。
在可用时使用经过身份验证的主机 MCP 访问；HTTP 辅助程序是用于列出知识库和搜索片段的有限替代方案。
支持为片段搜索设置可选的
topK
，默认值为 6；也支持可选的
JISHUDB_DEFAULT_KB
，以便从搜索命令中省略知识库 ID。
限定查询优化次数：先进行一次有针对性的搜索；缺少证据时最多再优化两次。
通过跟进分页游标处理准确清单；请求轮询任务的时长最长限制为两分钟，且不会重新提交任务。
保持辅助程序只读；遇到证据缺失、工具不可用、连接故障或相关性较低的结果时，会如实报告，不会猜测。

name: jishudb-search description: >- 查询 JishuDB 知识库和内部资料，适用于“查知识库”、/kb、
“有哪些文件”“这份文档讲了什么”“导入完成了吗”，基于真实结果作答并标注来源。 /
Search existing JishuDB knowledge bases and internal documents, list files,
read document contents, and check import status. Use for knowledge-base
questions or /kb requests; answer from retrieved evidence with citations,
not public-web research or document imports.
compatibility: >-
Requires an authorized JishuDB connection. Document inventory, text, metadata,
and job status need the corresponding host MCP tools. The bundled HTTP helper
only lists knowledge bases and searches passages; it requires Bash, curl, and
a reachable JISHUDB_URL, with JISHUDB_TOKEN when authentication is enabled.