知识库管理

知识/材料存储统一入口（路由器）。一个入口管你所有笔记/网盘/知识库，说人话就能存，自动留痕索引，跨多端秒找回。

--- name: 知识库管理 slug: knowledge-base-manager description: "知识/材料存储统一入口（路由器）。当用户要把内容存到某个存储工具，或从存储工具取内容时，由本技能识别意图并分发到对应子技能执行，本身不读写内容。支持多后端可插拔：Obsidian、百度网盘、夸克网盘、印象笔记、腾讯 ima、Get 笔记、GitHub、飞书文档、飞书知识库，并可扩展腾讯文档、语雀、我来 wolai、flomo、幕布、WPS 等。触发词：存到笔记/记一下/保存到笔记/网盘/百度网盘/夸克网盘/印象笔记/ima/知识库/Get笔记/剪藏/转存/上传到网盘/下载/备份到网盘/本地目录归档/飞书文档/飞书知识库/私有仓库/代码仓库。其他技能涉及存储时也应统一调用本编排技能路由，不要直接调用各存储子技能。" version: 2.0.6 agent_created: true metadata: openclaw: emoji: 🗄️ --- # 知识库管理（单一入口路由器） > 本技能**只做意图识别与路由分发，不读写任何内容**。目标是消灭"各存储工具各自为战、缺统一留痕层"的混乱，让所有技能/对话都通过同一个入口存取知识材料。 > > 本技能为**分享版（v2.0.6）**：已做运行时解耦、可选后端探测、路径可配置、剥离私有业务上下文，并自带数据安全规则，可托管于圆点工具站 Skills 广场或独立安装。 ## 1. 定位与边界 - **本层干什么**：识别"存到哪 / 取什么 / 干什么操作"，选对后端子技能，加载它并按其 SKILL.md 执行。 - **本层不干什么**：不亲自调 API、不写文件、不做内容转换。所有实际操作都委托给对应的子技能。 - **强制路由规则（🔒）**：任何其他技能或对话需要存取存储后端时，**必须**经本技能路由，**禁止**直接调用各存储子技能。这样可保证每次存取都有统一的本地留痕（见 §5）。 - **路由范围（🔒）**：本技能只路由「存储后端」——把文件/笔记/知识存到某处（Obsidian/网盘/笔记/知识库/GitHub/飞书等）；不涉及对话归档等其他动作。 ## 2. 后端矩阵（可插拔 · 探测驱动） 后端分两类： - **已装可启用**：你的环境已装对应子技能，首次运行自动识别为可用。 - **可选需安装**：未装，但本技能保留路由入口；探测到未装时优雅提示如何安装，不崩。 完整矩阵、各后端认证方式、安装命令见 `references/后端矩阵.md`。摘要： | 获取方式 | 后端 | 市场搜索词 | 类型 | |------|------|-----------|------| | 市场可装 | Obsidian | Obsidian / obsidian | 本地 Markdown 知识库 | | 市场可装 | 百度网盘 | 百度网盘 / baidu-drive | 云端文件盘 | | 市场可装 | 印象笔记 | 印象笔记 / yinxiang | 云端笔记 | | 市场可装 | 腾讯 ima | ima / ima-skills | 云端笔记 + 知识库 | | 市场可装 | Get 笔记 | Get笔记 / getnote | 云端笔记 + 知识库 | | 市场可装 | GitHub | github | 仓库型知识库 | | 市场可装 | 飞书文档 | 飞书 / lark-doc | 云端协作文档 | | 市场可装 | 飞书知识库 | 飞书知识库 / lark-wiki | 云端知识库 | | 市场可装 | 腾讯文档 | 腾讯文档 / tencent-docs | 云端协作文档 | | 市场可装 | 语雀 | 语雀 / yuque | 结构化知识库 | | 市场可装 | 我来 wolai | wolai / 我来 | 双链块编辑器知识库 | | 市场可装 | flomo | flomo | 极简卡片速记 | | 市场可装 | 幕布 | 幕布 / mubu | 大纲笔记/思维导图 | | 市场可装 | 夸克网盘 | 夸克网盘 / quark | 云端文件盘 | | 市场可装 | WPS | WPS | 办公文档协作 | > 所有后端均从 SkillHub / ClawHub / 虾评 / WorkBuddy 市场搜"市场搜索词"安装子技能，本技能**不绑定特定包名**——装完在首启配置登记即可（见 §3）。路由探测时以登记名 + 标准名为候选。夸克网盘无官方 API，依赖第三方市场子技能，仅在你已装对应子技能时可用。 > 各子技能的命令、参数、安全约束以**它们自己的 SKILL.md 为准**，本技能不重复定义。路由后务必完整遵循子技能规则（尤其是认证、删除确认、路径 allowlist）。 > 数据安全规则见本技能自带 `SECURITY.md`，必须严格遵守。 ## 3. 首启配置（仅一次） 首次使用（或检测到无 `.storage-config.json`）时，**先展示「新人引导卡」（§3.0），再按 `references/路径引导流程.md` 执行后续配置步骤**： ### 3.0 新人引导卡（首启必读，仅展示一次，不阻塞） 用一段说明让用户理解本技能能做什么、怎么用、说什么话。纯展示，用户看完自动进入步骤 1，不强制确认。 **本技能是什么** 你所有「存资料 / 取资料」的统一入口（路由器）。你不必记每个工具怎么调，只要说"存到哪 / 取什么"，本技能自动选对后端执行，并帮你记一笔"存了什么·存哪了"，事后能搜。 **解决什么问题（痛点）** - 资料散在网盘、笔记、知识库、GitHub 各处，各工具各自为战，事后想找要挨个翻 - 缺一份统一索引，经常忘了"那篇资料到底存哪了" - 换工具就得记一套调用方式，学习成本高 **它的优势** - 一个入口管所有：说人话就能存/取，不用记每个工具怎么调 - 跨后端可检索索引：每次自动记"文件名+渠道"，日后先查清单再跳对应工具，秒级定位 - 装多少用多少：按你已装的后端路由，没装的不强求，不绑架你 - 安全可控：删除前确认、覆盖前展示差异，遵循自带数据安全规则 **什么时候用（场景）** - 看到好文章 / 资料想保存 → 存到 ima / 印象笔记 / Get笔记 / Obsidian - 大文件 / 课程视频想归档 → 存到百度网盘 - 代码 / 文档当知识资产 → 存到 GitHub - 团队协作文档 → 写到飞书文档 / 腾讯文档 - 想翻以前存过的东西 → 先问本技能"我之前存的 XX 在哪" **怎么互动（使用方式）** - 直接说人话：「把这篇存到 ima」「从百度网盘取 XX」「记到印象笔记」 - 没说清存哪个 → 本技能会问你选，照选即可 - 想中止 → 说「算了」「不要了」，立即停下，什么都不动 - 首启会问两件事：留痕文件放哪、你装了哪些后端（装多少勾多少） **说什么关键词 → 走哪个后端（速查）** | 你说 | 路由到 | |------|--------| | 存到 ima / 知识库 | 腾讯 ima | | 存到百度网盘 / 网盘 | 百度网盘 | | 记到印象笔记 / 剪藏 | 印象笔记 | | 记到 Get / biji | Get笔记 | | 存到 Obsidian / 本地笔记 | Obsidian | | 存到 github / 代码仓库 | GitHub | | 写到飞书 / 腾讯文档 | 飞书文档 / 腾讯文档 | > 更多后端关键词见 §2 后端矩阵；未装的后端本技能会提示你去市场装，不会崩。 ### 后续配置步骤 1. **扫描候选落盘路径**：检查 workspace 根目录、`~/Documents`、本技能目录等，列出适合存放留痕清单的路径。 2. **引导用户选择**：用 AskUserQuestion 让用户选一个作为留痕清单（存储清单）的落盘点。 3. **引导登记已装后端**：列出全部后端（见 §2），用 AskUserQuestion 让用户**勾选自己已安装的后端**（装多少勾多少，不强制全装）。若某后端用户装的子技能名非标准名，允许填写实际技能名（默认用标准名探测）。不在登记名单中的后端不纳入路由。 4. **介绍可选库（含优劣势）**：对已装数量为 0 或用户想扩展时，列出未装的可选后端（腾讯文档/语雀/wolai/flomo/幕布/WPS），给出各自**优势 + 劣势 + 适合场景**及"去哪个市场搜什么词"（见 `references/国内知识库清单.md` 与 `references/后端矩阵.md`），由用户决定是否补装（不阻塞）。 5. **写入配置**：把「落盘路径 + 启用的后端列表」写入本技能目录下的 `.storage-config.json`，后续免重复询问。 > 用户可随时删除 `.storage-config.json` 重新触发首启配置。 ## 4. 路由决策表 路由优先级：先判**操作**（存/取/管理），再判**目标后端**（用户指定 or 内容类型推断）。 ### 4.1 按"目标后端"明确指定 | 用户说 | 路由到 | |--------|--------| | Obsidian / 保存到 Obsidian / 记到本地笔记库 | `obsidian` | | 百度网盘 / bdpan / 存到网盘（特指百度） | `baidu-drive` | | 夸克网盘 / quark / 转存夸克分享 | `夸克网盘管理` | | 印象笔记 / 记到印象笔记 / 剪藏 | `印象笔记管理` | | ima / 知识库 / ima 笔记 / 传到知识库 | `ima-skills` | | Get 笔记 / 记到 Get / biji | `Get笔记` | | github / 完整仓库 / 代码仓库 / 把代码当知识库 | `github管理` | | 飞书文档 / 飞书云文档 / 写到飞书 doc | `lark-doc` | | 飞书知识库 / 飞书知识空间 / 知识库节点 | `lark-wiki` | | 腾讯文档 / 腾讯 doc | `tencent-docs`（需先安装） | | 语雀 / wolai / flomo / 幕布 / WPS | 对应子技能（需先安装） | ### 4.2 按"内容类型"推断（用户未指定后端时） | 内容形态 | 首选后端 | 路由到 | 备注 | |---------|---------|--------|------| | 本地 Markdown 笔记 / 要双链 / 本机知识库 | Obsidian | `obsidian` | 用户在意本地 ownership 时 | | 大文件（视频/压缩包/课程）/ 分享链接 | 百度网盘或夸克网盘 | `baidu-drive` 或 `夸克网盘管理` | 二选一不明确时**询问用户**（见 §6） | | 一条速记 / 网页剪藏 / 跨设备随手记 | 印象笔记 或 Get 笔记 | `印象笔记管理` 或 `Get笔记` | 二选一不明确时**询问用户** | | 结构化知识库 / 文件入库检索 | 腾讯 ima | `ima-skills` | — | | 代码 / 需版本化的结构化知识资产 | github | `github管理` | — | | 团队协作文档 / 在线协作文档 | 飞书文档 | `lark-doc` | — | | 团队知识空间 / 结构化知识库节点 | 飞书知识库 | `lark-wiki` | — | ### 4.3 歧义处理（🔒） - 说"存到笔记"但未指定哪个笔记工具 → 在 {印象笔记, Get 笔记, ima 笔记} 中**询问用户**选哪个。 - 说"存到网盘"但未指定百度/夸克 → 在 {百度网盘, 夸克网盘} 中**询问用户**选哪个。 - 说"存到知识库"但未指定 ima/飞书知识库 → 在 {ima, 飞书知识库} 中**询问用户**选哪个。 - 说"存一下"完全无上下文 → 用 AskUserQuestion 列出已启用的后端让用户选。 - 用户取消意图（"算了""不要了"）→ 立即中止，不路由、不执行任何命令。 ## 5. 统一留痕（🔒 强制，每次存取后必做） **痛点**：各子技能各自执行后，本地没有统一的"我存了什么、存哪了"记录，事后找不到。本编排层补上这一环。 每次路由执行完成（无论存/取/转存/上传/下载），**必须**把本次操作追加到本地存储清单。 **清单路径**：首启配置阶段确定，默认存于本技能目录下的 `storage-log.md`（见 `references/存储清单模板.md`）。路径可在 `.storage-config.json` 中修改，禁止硬编码个人绝对路径。 **追加格式**：见 `references/存储清单模板.md`。 **规则**： - 仅追加（append），禁止覆盖或删除历史行（遵守 `SECURITY.md`）。 - 若清单文件不存在，先创建（写入一级标题 + 表头说明），再追加。 - 简短即可，目标是"事后能搜到"，不是写报告。 - **检索用法（🔒）**：本清单即一份可检索索引。日后要找某资料，**先 grep 本文件**——按"内容/对象"里的文件名/关键词，或"目标位置"里的渠道定位，确认存在哪个后端后，再跳对应子技能取。不要直接去各后端盲目翻找。 ## 6. 分发执行流程 1. **首启检查**：若无 `.storage-config.json`，先走 §3 首启配置。 2. **识别意图**：从用户消息拆出 [操作] × [目标后端/内容类型]。 3. **消解歧义**：命中 §4.3 歧义时，用 AskUserQuestion 确认后端。 4. **探测后端（🔒）**：按首启登记的已装后端 + 候选名，检查目标子技能是否已安装、凭证是否配置。 - 已装且已配 → 进入下一步。 - 未装 / 未配 / 未在登记名单 → **优雅提示**：说明缺什么、去哪个市场搜什么词安装、如何配置凭证（见 `reference

收录自：baidu