Communitygithub.com

dafnamannish442/knowledge-inbox

将链接、视频、PDF 和文件转换为结构化的 Markdown 知识卡片,专为 Obsidian 打造,通过 MCP 实现。

knowledge-inbox 是什么?

该技能为 AI 代理提供了一套标准化的工具,用于将各种外部内容(如网页链接、YouTube 视频、PDF 文档、本地文件或纯文本)直接摄取并转换为 Obsidian 可用的结构化 Markdown 笔记。它通过 MCP 协议与知识库服务通信,自动处理内容的抓取、AI 分析、标签生成、链接整理以及 Markdown 格式化,最终将生成的笔记保存到用户指定的 Obsidian 库或 Markdown 文件夹中。技能支持异步长任务(如音频/视频转录,最长可达 1800 秒),并能够处理特殊平台(如微信视频号)的内容,在连接断开时自动进行准备和重试。用户无需手动总结或整理,服务端会完成所有智能化处理,最终返回笔记的保存路径。该技能适用于 Cursor、Claude Code 等支持 MCP 的 AI 代理平台,能够将转发的内容、文件或链接无缝转化为个人知识管理的一部分。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add dafnamannish442/knowledge-inbox

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

知识摄取

使用精确的 URL、绝对本地路径或原始文本来调用 knowledge_ingest。

  • 将独立转发的链接、文件或内容消息(不附带问题)视为摄取请求;无需询问用户单独的“保存此内容”命令。

  • 如果转发的文本包含一个受支持的 URL 以及分享文字,则将该 URL 作为 content 传入,以便服务抓取原始源内容,而不是仅归档外层包裹文本。

  • 当内容作为问题的上下文或另一任务的输入时,回答该任务,除非用户也要求保存,否则不要静默地摄取该内容。

  • 仅在用户提供了标题或为纯文本笔记有用时才传入自定义标题。

  • 仅当本地文件来自已知 URL 时,才传入 source_url。

  • 对于较长的音频或视频,最多可使用 1800 秒的超时。

  • 成功时,报告返回的 note_path。

  • 失败时,报告准确且可操作的错误信息。切勿声称笔记已保存。

  • 如果存储未配置,引导用户一次性访问 http://127.0.0.1:8787/ 以选择 Obsidian 库或 Markdown 文件夹,然后重试原始内容。

  • 不要单独进行总结;服务会处理 AI 分析、标签、链接和 Markdown 格式化。

  • 仅在不确定源支持情况时使用 knowledge_list_capabilities。

  • 使用 knowledge_get_job 来检查已知的异步作业状态。

对于微信视频号内容,首先调用 knowledge_ingest。如果返回客户端断开连接的错误,则调用 knowledge_wechat_prepare 并重试一次。切勿要求用户打开或播放提供的视频 URL。仅当准备操作失败时,可以要求用户一次性关闭并重新打开任何视频号窗口。服务会在 Obsidian 和 SQLite 写入都成功完成后,才恢复系统代理并删除原始视频源文件。

相关技能