knowledge-base

Name: knowledge-base
Author: nexus-research-lab

78stars7forks

How to install knowledge-base?

nexus-research-lab/nexus/knowledge-base

$npx -y skills add nexus-research-lab/nexus --skill knowledge-base

Installs into the current project.

Summary

API base path: openapi/wiki/v1 — 完整数据结构和接口参数详见 references/api.md。

Files · 1

View on GitHub

SKILL.md

1	# Knowledge Base (知识库)
2
3	API base path: `openapi/wiki/v1` — 完整数据结构和接口参数详见 `references/api.md`。
4
5	## 接口决策表
6
7	\| 用户意图 \| 调用接口 \| 关键参数 \|
8	\| --------------------------------------------- \| ---------------------------------------------------------------------- \| -------------------------------------------------------------------------------------------------- \|
9	\| 上传文件到知识库 \| `check_repeated_names` → `create_media` → COS Upload → `add_knowledge` \| `media_type`（按扩展名），`knowledge_base_id`，`file_name`，`file_size` \|
10	\| 上传文件到知识库的某个文件夹 \| 先定位文件夹 → 同上（`folder_id` 传入目标文件夹 ID） \| 见「文件夹操作」章节 \|
11	\| 添加网页/微信文章到知识库 \| `import_urls` \| `urls`（1-10 个），`knowledge_base_id`，可选 `folder_id`（省略则根目录） \|
12	\| 添加笔记到知识库 \| `add_knowledge` \| `media_type=11`，`note_info.content_id=<note_id>`，`knowledge_base_id` \|
13	\| 添加 URL（文件型）到知识库 \| `check_repeated_names` → 下载文件 → 走"上传文件"流程 \| URL 指向 PDF/Word/PPT 等文件时，按文件方式处理 \|
14	\| 检查文件名是否重复 \| `check_repeated_names` \| `params[].name`，`params[].media_type`，`knowledge_base_id`，`folder_id` \|
15	\| 获取知识库信息 \| `get_knowledge_base` \| `ids`（1-20 个，不重复） \|
16	\| 浏览知识库内容列表 / 浏览文件夹 \| `get_knowledge_list` \| `knowledge_base_id`，`cursor`，`limit`(1~50)，可选 `folder_id` \|
17	\| 在知识库中搜索（含文件和文件夹） \| `search_knowledge` \| `query`，`knowledge_base_id`，`cursor` \|
18	\| 按关键词查找知识库（用户知道名字但不知道 ID） \| `search_knowledge_base` \| `query`，`cursor`，`limit`(1~20) \|
19	\| 查看/了解自己有哪些知识库 \| `search_knowledge_base`（`query` 传空字符串） \| `query: ""`，`cursor`，`limit`(1~20) \|
20	\| 添加内容但未指定目标知识库 \| `get_addable_knowledge_base_list` → 展示列表让用户选择 \| `cursor`，`limit`(1~50) \|
21	\| 查看原文、分析原文、导出原文 \| `get_media_info` \| `media_id`；导出/下载时在 URL 后追加 `response-content-type` + `response-content-disposition` 参数 \|
22
23	### `search_knowledge_base` vs `get_addable_knowledge_base_list`
24
25	\| 场景 \| 使用接口 \| 原因 \|
26	\| ------------------------------------------------ \| ---------------------------------------------- \| ---------------------------------- \|
27	\| 用户说了知识库名称（如"添加到产品文档库"） \| `search_knowledge_base` \| 按名称搜索，找到 ID 后继续操作 \|
28	\| 用户想浏览/了解某个知识库 \| `search_knowledge_base` → `get_knowledge_base` \| 先搜到 ID，再获取详情 \|
29	\| 用户想查看自己有哪些知识库（无具体关键词） \| `search_knowledge_base`（`query: ""`） \| 空 query 返回用户的所有知识库列表 \|
30	\| 用户要添加内容但没说添加到哪个知识库 \| `get_addable_knowledge_base_list` \| 列出有权限添加的知识库，让用户选择 \|
31	\| 用户说"添加到知识库"但上下文中无法确定哪个知识库 \| `get_addable_knowledge_base_list` \| 同上，不要猜测，让用户选择 \|
32
33	绝不要在用户已明确指定知识库名称时调用 `get_addable_knowledge_base_list`。
34
35	---
36
37	## 写入类工作流
38
39	### ⛔ 文件上传安全门（仅适用于文件上传 → `add_knowledge` 流程）
40
41	以下 4 条规则仅在上传文件到知识库时适用。搜索、浏览、获取信息等读取操作不受影响。
42
43	```
44	GATE 1 [TYPE CHECK]
45	Run preflight-check.cjs FIRST. pass=false → reject immediately.
46	NEVER ask "do you still want to try?" for unsupported types.
47	Video files, Bilibili/YouTube URLs, file:// URLs → tell user to use IMA desktop client.
48
49	GATE 2 [NAMING]
50	add_knowledge title MUST equal file_name (with extension).
51	NEVER rename, shorten, translate, or modify the original filename.
52	Example: file is "音频.mp3" → title="音频.mp3", file_name="音频.mp3"
53
54	GATE 3 [DUPLICATES]
55	Call check_repeated_names BEFORE create_media for ALL file uploads.
56	is_repeated=true → ask user: keep both (append timestamp) or cancel.
57	"Replace" is NOT supported.
58	Timestamp format: {name}_YYYYMMDDHHmmss.{ext}
59
60	GATE 4 [UPLOAD EXIT]
61	cos-upload.cjs non-zero exit → STOP immediately.
62	Do NOT call add_knowle

People who liked this also viewed

6 picks

Type

azure-aiUse for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector searSkillsJul 2026472k1.3k
just-scrapeSearch, scrape, crawl, extract structured data, and monitor web pages via the ScrapeGraph AI CLI. Use when the user asks to search the web, scrape a webpage, grab content from a URL, extract JSON fromSkillsJul 2026245k37
firecrawlCLI and Agent Skill for Firecrawl - Add scrape, search, and browsing capabilities to your AI agentsSkillsJul 202694k531
firecrawl-searchWeb search with full page content extraction. Use this skill whenever the user asks to search the web, find articles, research a topic, look something up, find recent news, discover sources, or says "SkillsJul 202676k531
firecrawl-agentAI-powered autonomous data extraction that navigates complex sites and returns structured JSON. Use this skill when the user wants structured data from websites, needs to extract pricing tiers, producSkillsJul 202674k531
firecrawl-mapDiscover and list all URLs on a website, with optional search filtering. Use this skill when the user wants to find a specific page on a large site, list all URLs, see the site structure, find where sSkillsJul 202674k531

knowledge-base

78stars7forks

View on GitHub

How to install knowledge-base?

nexus-research-lab/nexus/knowledge-base

$npx -y skills add nexus-research-lab/nexus --skill knowledge-base

Installs into the current project.

Summary

API base path: openapi/wiki/v1 — 完整数据结构和接口参数详见 references/api.md。

Files · 1

View on GitHub

SKILL.md

1	# Knowledge Base (知识库)
2
3	API base path: `openapi/wiki/v1` — 完整数据结构和接口参数详见 `references/api.md`。
4
5	## 接口决策表
6
7	\| 用户意图 \| 调用接口 \| 关键参数 \|
8	\| --------------------------------------------- \| ---------------------------------------------------------------------- \| -------------------------------------------------------------------------------------------------- \|
9	\| 上传文件到知识库 \| `check_repeated_names` → `create_media` → COS Upload → `add_knowledge` \| `media_type`（按扩展名），`knowledge_base_id`，`file_name`，`file_size` \|
10	\| 上传文件到知识库的某个文件夹 \| 先定位文件夹 → 同上（`folder_id` 传入目标文件夹 ID） \| 见「文件夹操作」章节 \|
11	\| 添加网页/微信文章到知识库 \| `import_urls` \| `urls`（1-10 个），`knowledge_base_id`，可选 `folder_id`（省略则根目录） \|
12	\| 添加笔记到知识库 \| `add_knowledge` \| `media_type=11`，`note_info.content_id=<note_id>`，`knowledge_base_id` \|
13	\| 添加 URL（文件型）到知识库 \| `check_repeated_names` → 下载文件 → 走"上传文件"流程 \| URL 指向 PDF/Word/PPT 等文件时，按文件方式处理 \|
14	\| 检查文件名是否重复 \| `check_repeated_names` \| `params[].name`，`params[].media_type`，`knowledge_base_id`，`folder_id` \|
15	\| 获取知识库信息 \| `get_knowledge_base` \| `ids`（1-20 个，不重复） \|
16	\| 浏览知识库内容列表 / 浏览文件夹 \| `get_knowledge_list` \| `knowledge_base_id`，`cursor`，`limit`(1~50)，可选 `folder_id` \|
17	\| 在知识库中搜索（含文件和文件夹） \| `search_knowledge` \| `query`，`knowledge_base_id`，`cursor` \|
18	\| 按关键词查找知识库（用户知道名字但不知道 ID） \| `search_knowledge_base` \| `query`，`cursor`，`limit`(1~20) \|
19	\| 查看/了解自己有哪些知识库 \| `search_knowledge_base`（`query` 传空字符串） \| `query: ""`，`cursor`，`limit`(1~20) \|
20	\| 添加内容但未指定目标知识库 \| `get_addable_knowledge_base_list` → 展示列表让用户选择 \| `cursor`，`limit`(1~50) \|
21	\| 查看原文、分析原文、导出原文 \| `get_media_info` \| `media_id`；导出/下载时在 URL 后追加 `response-content-type` + `response-content-disposition` 参数 \|
22
23	### `search_knowledge_base` vs `get_addable_knowledge_base_list`
24
25	\| 场景 \| 使用接口 \| 原因 \|
26	\| ------------------------------------------------ \| ---------------------------------------------- \| ---------------------------------- \|
27	\| 用户说了知识库名称（如"添加到产品文档库"） \| `search_knowledge_base` \| 按名称搜索，找到 ID 后继续操作 \|
28	\| 用户想浏览/了解某个知识库 \| `search_knowledge_base` → `get_knowledge_base` \| 先搜到 ID，再获取详情 \|
29	\| 用户想查看自己有哪些知识库（无具体关键词） \| `search_knowledge_base`（`query: ""`） \| 空 query 返回用户的所有知识库列表 \|
30	\| 用户要添加内容但没说添加到哪个知识库 \| `get_addable_knowledge_base_list` \| 列出有权限添加的知识库，让用户选择 \|
31	\| 用户说"添加到知识库"但上下文中无法确定哪个知识库 \| `get_addable_knowledge_base_list` \| 同上，不要猜测，让用户选择 \|
32
33	绝不要在用户已明确指定知识库名称时调用 `get_addable_knowledge_base_list`。
34
35	---
36
37	## 写入类工作流
38
39	### ⛔ 文件上传安全门（仅适用于文件上传 → `add_knowledge` 流程）
40
41	以下 4 条规则仅在上传文件到知识库时适用。搜索、浏览、获取信息等读取操作不受影响。
42
43	```
44	GATE 1 [TYPE CHECK]
45	Run preflight-check.cjs FIRST. pass=false → reject immediately.
46	NEVER ask "do you still want to try?" for unsupported types.
47	Video files, Bilibili/YouTube URLs, file:// URLs → tell user to use IMA desktop client.
48
49	GATE 2 [NAMING]
50	add_knowledge title MUST equal file_name (with extension).
51	NEVER rename, shorten, translate, or modify the original filename.
52	Example: file is "音频.mp3" → title="音频.mp3", file_name="音频.mp3"
53
54	GATE 3 [DUPLICATES]
55	Call check_repeated_names BEFORE create_media for ALL file uploads.
56	is_repeated=true → ask user: keep both (append timestamp) or cancel.
57	"Replace" is NOT supported.
58	Timestamp format: {name}_YYYYMMDDHHmmss.{ext}
59
60	GATE 4 [UPLOAD EXIT]
61	cos-upload.cjs non-zero exit → STOP immediately.
62	Do NOT call add_knowle

People who liked this also viewed

6 picks

Type