Communitygithub.com

dafnamannish442/knowledge-inbox

將連結、影片、PDF 和檔案轉換為結構化的 Markdown 知識卡片,並直接存入 Obsidian(透過 MCP 支援)。

knowledge-inbox 是什麼?

這個技能讓 AI 助手能直接將來自各種來源的內容(如網頁連結、影片、PDF 和本地檔案)轉換為結構化的 Markdown 知識卡片,並自動保存至 Obsidian 筆記庫。它主要用於「被動擷取」場景:當使用者轉發一條連結或檔案,且未附帶明確問題時,工具會自動將其視為知識擷取請求。用戶不需輸入任何指令,工具即可辨識內容類型並進行處理。 支援的作業平台包括 Obsidian(透過 Markdown 資料夾或 Vault)以及 MCP 伺服器環境。其運作方式為:呼叫 `knowledge_ingest` 函數,傳入內容 URL、本地路徑或原始文字;工具會利用後端服務進行 AI 分析、標籤生成、內部連結建立與 Markdown 格式化。處理音訊/影片檔時可設定最長 1800 秒;若遇到 WeChat 頻道等特殊來源,工具會自動嘗試 `knowledge_wechat_prepare` 並重試一次。成功時回傳筆記路徑,失敗時報告明確的錯誤訊息,絕不會虛構保存行為。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

知識擷取

呼叫 knowledge_ingest 並傳入確切的 URL、絕對本機路徑或原始文字。

  • 將單獨轉發的連結、檔案或內容訊息(未附帶任何問題)視為擷取請求;無須要求使用者另行輸入「儲存此項目」指令。

  • 若轉發的文字中剛好包含一個支援的 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 寫入皆成功後,才還原系統代理並刪除來源影片。

相關技能