ShadowBrain

SHADOWBRAIN / 開始使用

接入黑影兒大腦

黑影兒大腦(ShadowBrain)是線上知識庫,提供近 2000 期跑步影片內容資料。

MCP 負責查內容,黑影兒大腦 Skill 負責核對與整理判斷。

首次使用:先註冊並驗證電子郵件;已有帳號直接登入。 註冊新帳號 · 登入

WorkBuddy、豆包請使用電腦用戶端(Windows / macOS)。兩者的網頁版和手機版目前不支援自訂 MCP,無法依本指引連接知識庫。

  1. 依下方與你用戶端對應的指南完成連線。
  2. 依用戶端支援的方式安裝 Skill,完成登入與啟用。
  3. 開啟新對話驗證,確認 Skill 和知識庫都可用。

首次安裝:讓助手一次完成

複製這一段即可,包含連接 MCP 及安裝 Skill。完成後無需再複製下方的「只安裝 Skill」。

幫我串接黑影兒大腦(ShadowBrain)線上知識庫:連接 MCP,並安裝黑影兒大腦 Skill(shadowbrain)。
先確認目前用戶端名稱,以及正在使用電腦用戶端、網頁還是手機;只根據執行環境判斷,不根據教學中的品牌名稱猜測。無法確認時先問我。只讀 references/clients.md 中對應分支,不支援自訂 MCP 時提示改用電腦用戶端,不索取 Key 或反覆安裝。
MCP 服務網址:https://knowledge.libo.run/mcp
Skill 安裝包:https://knowledge.libo.run/downloads/shadowbrain-1.3.3.zip
安裝前讀取 https://knowledge.libo.run/downloads/shadowbrain-latest.json;有新版時使用清單中的官方安裝包並核對 SHA-256,讀取失敗可使用上方版本。安裝後依 references/updates.md 每週輕量檢查,不重複下載或自動覆寫。
只檢查目前用戶端的使用者設定和技能目錄;沿用已有可用連線和 Skill,保留自訂修改與其他設定。
1. 連接 MCP:使用 Streamable HTTP,優先 OAuth(knowledge:read);需要登入時開啟官網授權頁,由我完成。只有位址、沒有 Authorization 請求標頭,不代表缺少 Key。
2. 安裝 Skill:下載並完整解壓縮 ZIP,依套件內 references/clients.md 的目前用戶端步驟安裝或更新 shadowbrain,保留全部檔案;已是相同版本就略過。
3. 驗證:在新對話透過原生 get_access_status 確認 OK / AVAILABLE,並確認 Skill 可見且啟用。工具尚未載入時,先完成重新啟動及啟用,不重複安裝。
依目前用戶端對應分支完成重新載入、信任和啟用;需要重新啟動時,將設定和 Skill 一起準備好後再完全結束重開一次。不要套用其他用戶端的選單或設定目錄。
不索取密碼、Key 或 token。無法自動完成的步驟提供介面入口。回覆簡短說明「Skill 狀態、知識庫連線狀態、下一步」,不展開檔案清單、JSON 或其他用戶端教學。

2. 依對應指南連線

只展開你正在使用的用戶端,依說明完成連接後再安裝 Skill。

MCP 服務網址:

https://knowledge.libo.run/mcp

選擇 Streamable HTTP / HTTP 類型。不要改成 /sse,也不要把密碼或 Key 放進網址。

Codex · OAuth

先使用上方的設定 prompt;需要手動操作時,使用以下設定入口。

  1. 開啟 Settings → MCP servers → Add server,名稱填入 shadowbrain。
  2. 類型選 Streamable HTTP,URL 填入上方服務網址,儲存後依用戶端提示重新啟動。
  3. 點選 Authenticate / 登入,在 ShadowBrain 頁面完成 OAuth 授權,再返回對話。

下一步:黑影兒大腦 Skill 安裝。

Codex 官方 MCP 指南 ↗

僅使用 CLI 時
codex mcp add shadowbrain --url https://knowledge.libo.run/mcp
codex mcp login shadowbrain --scopes knowledge:read

如果新增時已完成授權,不必重複登入。連接名稱已存在時先查看原設定,避免覆寫。

ChatGPT · 自訂 MCP

ShadowBrain 尚未上架 ChatGPT 公開目錄。請建立自己的 MCP 連線,無需在目錄中搜尋 ShadowBrain。

  1. 在 ChatGPT 網頁開啟 Plugins,點選 + → Add custom MCP server。
  2. 名稱填 ShadowBrain,Server URL 填入上方服務網址,認證選 OAuth。
  3. 如出現用戶端登記選項,選 DCR / 動態登記;Client ID 和 Client Secret 留空。
  4. 依平台提示確認,點選 Create as a plugin,安裝你建立的連線,再登入 ShadowBrain 並允許連接。
  5. 返回新對話,輸入 @ 並選擇你建立的 ShadowBrain,然後提問。

若介面要求開發者模式,依平台提示啟用;工作區可能需要管理員允許新增自訂 MCP。沒有新增入口時,先確認帳號與工作區權限。

下一步:黑影兒大腦 Skill 安裝;不支援 Skills 時,只能透過 MCP 檢索,無法啟用本 Skill 的回答流程。

開啟 ChatGPT 連接頁面 ↗ · ChatGPT 官方自訂 MCP 指南 ↗

Claude · Claude Code

Claude 網頁與桌面版

  1. 開啟 Customize → Connectors,點選 + Add → Add custom connector,名稱填 ShadowBrain,網址填上方 MCP 服務位址。團隊帳號需先由管理員新增。
  2. 驗證選擇 Sign in now;OAuth client 選擇 Register automatically(自動登記)。本服務支援 DCR,暫不支援 Claude 預設建議的 published identity / CIMD;Client Secret 留空。
  3. 點選連接,在 ShadowBrain 官網登入並允許授權。回到對話,透過 + → Connectors 啟用 ShadowBrain,再呼叫 get_access_status 驗證。

Claude Code

claude mcp add --transport http shadowbrain https://knowledge.libo.run/mcp
claude mcp login shadowbrain
claude mcp get shadowbrain

同名連線已存在時先核對設定。舊版沒有 mcp login 指令時,在 Claude Code 內執行 /mcp,選擇 shadowbrain 完成瀏覽器授權。

需要 Key 方式時,在用戶端私人驗證設定或 Request headers 中填寫下方個人 Key 請求標頭;建議分別建立並命名為 Claude 或 Claude Code,不將完整 Key 傳到對話或寫進共用專案。

MCP 連線完成後還需安裝 Skill。Claude 網頁與桌面版在 Customize → Skills → + → Create skill → Upload a skill 上傳下方完整 ZIP 並啟用;需開啟 Code execution and file creation,團隊帳號可能需管理員允許。

Claude Code 將完整 shadowbrain 資料夾放入專案 .claude/skills/ 或個人 ~/.claude/skills/,保留 references/ 與授權文件。新工作階段確認技能可見,使用 /shadowbrain 呼叫;Claude 網頁依描述自動選擇技能。

.claude/skills/shadowbrain/
~/.claude/skills/shadowbrain/

下載並安裝黑影兒大腦 Skill

Claude 官方 MCP 指南 ↗ · Claude 官方 Skill 指南 ↗ · Claude Code MCP ↗

豆包 / 豆包工作(電腦用戶端) · 手動設定

僅支援電腦用戶端;網頁版和手機版目前不支援自訂 MCP。請先在電腦上安裝並開啟用戶端。

  1. 開啟豆包桌面版的「插件 · 技能 · 伙伴」,點選「添加 → 新建自定义连接器」。舊版入口可能叫「技能 · 连接器 · 伙伴」,按鈕可能叫「新建」。
  2. 伺服器名稱填 shadowbrain,傳輸類型選 HTTP(Streamable HTTP),伺服器 URL 填下方位址。已有同名連線時先核對設定,不重複新增。
https://knowledge.libo.run/mcp

先將自訂 Headers 留空並儲存。若出現「连接器需要授权」,點選「去授权」,在 ShadowBrain 官網登入並允許連接,再回豆包啟用服務。

沒有 OAuth 入口或授權不相容時

在帳號頁分別建立並命名為「豆包工作」的 Key。回到連接器的「自定义 Headers → 添加」,Header 名稱填 Authorization,Header 值填下方內容。

Bearer YOUR_KNOWLEDGE_KEY

以完整 Key 取代 YOUR_KNOWLEDGE_KEY,Bearer 後保留一個空格;Header 值不包含 Authorization:。只填入私人設定,不傳到對話。

到帳號頁管理存取金鑰

儲存並啟用後,開啟新的工作任務,在輸入框的「插件」(舊版為「连接器」)中選擇 shadowbrain,透過原生工具呼叫 get_access_status 驗證。自訂連接器僅在這台電腦使用;手機或網頁版不能據此視為已串接。

Skill 需另外安裝:下載完整 Skill ZIP,回到「插件 · 技能 · 伙伴 → 添加 → 上传技能」,選擇完整壓縮檔或解壓縮後的 shadowbrain 資料夾。確認技能可見且啟用,再開新任務使用;已有同名 Skill 時先核對並保留自訂改動。

入口與欄位已於 2026 年 10 月 8 日在豆包 2.31.4 核對;實際 OAuth / Key 連線、Skill 匯入及自動觸發未驗收。

豆包 OAuth 串接參考(草料文件)↗ · 豆包 Header 串接參考(flomo 文件)↗

其他用戶端 · 優先 OAuth

在用戶端介面新增遠端 HTTP MCP,填入服務網址,先不填寫 Authorization 請求標頭;出現登入或認證按鈕時,優先在瀏覽器完成 OAuth。

  • Cherry Studio:設定 → MCP → MCP 伺服器 → 新增,選遠端 HTTP 並填入 URL,授權後啟用並綁定助手。 官方指南 ↗
  • DeepChat:設定 → MCP → 新增,選 HTTP 並填入 URL;保留互動式認證,點選伺服器卡片上的 Authenticate 完成登入。 官方認證說明 ↗
  • TRAE / TraeCode:右上設定 → MCP → 新增 → 手動新增,在介面內填寫伺服器設定,儲存後使用出現的 OAuth 授權入口。 官方指南 ↗
  • CodeBuddy:對話側欄右上 CodeBuddy 設定 → MCP → Add MCP,在設定介面新增網址;目前版本出現認證入口時,使用瀏覽器登入。 官方指南 ↗
  • Qoder:桌面版 Extensions → Connectors → Add Connector → Form,填入遠端 HTTP 網址;IDE 版在 Settings → MCP → My Servers → Add。出現 OAuth 入口時優先授權。 桌面指南 ↗ · IDE 指南 ↗
  • Dify:Integrations → Tools → MCP,新增網址、名稱和服務識別碼;保持 Dynamic Client Registration 開啟,再依提示完成瀏覽器授權。 官方指南 ↗
介面只有 JSON 設定框時

TRAE、CodeBuddy 等設定編輯器可新增下方的服務項目,不要覆寫已有連線;欄位以目前產品的官方說明為準。

{
  "mcpServers": {
    "shadowbrain": {
      "type": "http",
      "url": "https://knowledge.libo.run/mcp"
    }
  }
}

同一品牌的桌面版、IDE 和 CLI 能力可能不同,先核對目前版本的 OAuth 入口。沒有此能力或已確認不相容時,再使用下方的個人 Key 方式。

下一步:黑影兒大腦 Skill 安裝;不支援 Skills 時,只能透過 MCP 檢索,無法啟用本 Skill 的回答流程。

WorkBuddy · 電腦用戶端 · 優先 OAuth

僅支援電腦用戶端;網頁版和手機版目前不支援自訂 MCP。請先在電腦上安裝並開啟用戶端。

  1. 開啟「專家·技能·連接器 → 連接器 → 自訂連接器」。其他版本可在 Settings → MCP → Add MCP Server 找到入口。
  2. 新增遠端服務,填入上方網址,類型選 Streamable HTTP;若使用設定編輯器,type 填 streamableHttp。
  3. 目前版本提供 OAuth 時,點選連接或認證,在瀏覽器登入 ShadowBrain 並授權。

僅使用 WorkBuddy 電腦用戶端時:儲存 MCP 設定後,完全結束並重新開啟;在「连接器管理 → 自定义连接器」找到 shadowbrain,點選「信任」並啟用,然後開新對話。只開新對話不能代替重新啟動。

WorkBuddy 官方支援 OAuth,但本專案在 5.3.14 的 OAuth 連接遇到相容性問題,建議先升級或聯絡客服。繼續使用這個不相容版本時,可改用個人 Key,Key 路徑已實測。

下一步:黑影兒大腦 Skill 安裝。

WorkBuddy 官方 MCP 指南 ↗

僅在不支援或不相容 OAuth 時:個人 Key
  1. 登入並驗證電子郵件,在帳號頁為這個用戶端單獨建立一枚存取金鑰。
  2. 在用戶端的認證或自訂請求標頭設定中填入下方的值,儲存並啟用服務。
  3. 只有 JSON 編輯器時,將 Authorization 放入這個服務的 headers 中;WorkBuddy 的 type 使用 streamableHttp,其他欄位依對應平台說明填寫。
Authorization: Bearer YOUR_KNOWLEDGE_KEY

將 YOUR_KNOWLEDGE_KEY 替換為剛建立的完整 Key。只存到用戶端的私有憑證設定,不放入共用專案、聊天或螢幕截圖。多個用戶端共用同一帳號額度。

僅使用 WorkBuddy 電腦用戶端時:儲存 MCP 設定後,完全結束並重新開啟;在「连接器管理 → 自定义连接器」找到 shadowbrain,點選「信任」並啟用,然後開新對話。只開新對話不能代替重新啟動。

停止使用某個用戶端時,在帳號頁撤銷對應 Key;外洩後立即撤銷或輪換。

到帳號頁管理存取金鑰

使用 Key 只完成 MCP 認證,仍需完成黑影兒大腦 Skill 安裝;不支援 Skills 時,只能透過 MCP 檢索,無法啟用本 Skill 的回答流程。

安裝黑影兒大腦 Skill

MCP 已連接、只缺 Skill 時,再使用下方的安裝方式。

下載 Skill 1.3.3

https://knowledge.libo.run/downloads/shadowbrain-1.3.3.zip
只安裝 Skill:複製給助手
幫我安裝或更新黑影兒大腦 Skill(shadowbrain)。
先確認目前用戶端名稱,以及正在使用電腦用戶端、網頁還是手機;只根據執行環境判斷,不根據教學中的品牌名稱猜測。無法確認時先問我。只讀 references/clients.md 中對應分支,不支援自訂 MCP 時提示改用電腦用戶端,不索取 Key 或反覆安裝。
Skill 安裝包:https://knowledge.libo.run/downloads/shadowbrain-1.3.3.zip
安裝前讀取 https://knowledge.libo.run/downloads/shadowbrain-latest.json;有新版時使用清單中的官方安裝包並核對 SHA-256,讀取失敗可使用上方版本。安裝後依 references/updates.md 每週輕量檢查,不重複下載或自動覆寫。
1. 檢查目前用戶端已有的 shadowbrain;已是相同版本且可用就略過,保留自訂修改,不改 MCP 連線及其他設定。
2. 安裝 Skill:下載並完整解壓縮 ZIP,依套件內 references/clients.md 的目前用戶端步驟安裝或更新 shadowbrain,保留全部檔案;已是相同版本就略過。
3. 只依目前用戶端要求重新載入,在新對話確認 Skill 可見且啟用,並告訴我如何呼叫。不要套用其他用戶端的重新啟動或信任步驟。
若已安裝但知識庫未連接,說明連線待完成並提供下一步,不要重裝 Skill。
手動安裝:下載後選擇對應用戶端

安裝完整 shadowbrain 資料夾,保留 SKILL.md、references/、LICENSE 和 NOTICE 等全部檔案。

  • Codex:放入目前專案的 .agents/skills/。
  • Claude Code:放入目前專案的 .claude/skills/。
  • Claude 網頁與桌面版:Customize → Skills → + → Create skill → Upload a skill,上傳完整 ZIP 並啟用。
  • WorkBuddy 電腦用戶端:「专家·技能·连接器 → 技能 → 添加技能 → 上传技能」,選擇完整 ZIP。安裝後完全結束並重新開啟,再確認 shadowbrain 已啟用。
  • 豆包桌面版:「插件 · 技能 · 伙伴 → 添加 → 上传技能」,選擇完整 ZIP 或 shadowbrain 資料夾,啟用後開啟新任務。

舊版名稱為 shadowrunner-knowledge。保留自訂修改,確認 shadowbrain 可用後再停用舊版;不支援 Skills 的用戶端可僅使用 MCP 檢索。

Codex Skill 安裝官方說明 ↗

支援此功能的用戶端會每週輕量檢查一次,有新版再提醒;說「更新黑影兒大腦」即可讓助手處理。不支援自動檢查時,可隨時說「檢查黑影兒大腦更新」。

已安裝:更新黑影兒大腦 Skill

複製給正在使用的 AI 助手即可。更新 Skill 會保留現有連線;沒有查詢額度也不影響更新。

幫我把黑影兒大腦 Skill(shadowbrain)更新到最新版本。
先確認目前用戶端名稱,以及正在使用電腦用戶端、網頁還是手機;只根據執行環境判斷,不根據教學中的品牌名稱猜測。無法確認時先問我。只讀 references/clients.md 中對應分支,不支援自訂 MCP 時提示改用電腦用戶端,不索取 Key 或反覆安裝。
版本清單:https://knowledge.libo.run/downloads/shadowbrain-latest.json
1. 辨識目前用戶端與已安裝版本,只檢查對應技能目錄,保留自訂修改、MCP 連線和憑證。
2. 這是主動更新,請立即讀取官方版本清單,不受每週檢查間隔限制。依數字比較版本,已是最新就略過,不降級;無法確認新版時保留現有安裝並說明原因。
3. 有新版才下載清單中的 knowledge.libo.run 官方 ZIP,核對 SHA-256,依套件內 references/updates.md 和目前用戶端方式完整更新。先備份,保留或合併自訂修改;託管 Skill 透過其安裝程式更新,不直接修改外掛快取。
4. 更新後只依目前用戶端要求重新載入,再在新對話確認新版可見且啟用。只替換檔案但尚未載入時,說明「待重新載入」。
5. 核對新版包含:額度不足時停止檢索並引導查看帳號;每個影片連結顯示真實標題和時間點,缺標題不編造。不要為驗收消耗查詢額度;沒有額度不等於更新失敗,也不需要重裝或重新授權。
只簡短回覆更新前後版本、Skill 是否已生效及下一步。無法自動操作時提供目前用戶端的介面入口,不索取密碼、Key 或 token。

3. 驗證連線,問第一個問題

完成登入、重新啟動及啟用後,開啟新對話,把下方這一段傳給助手。無需再次執行安裝 prompt。

檢查黑影兒大腦是否可以使用:確認 shadowbrain Skill 可見且啟用,並使用目前對話的原生 get_access_status 確認知識庫回傳 OK / AVAILABLE。只回報兩項結果;未通過時,只告訴我下一步怎麼做,不重新安裝,不索取密碼或 Key。

驗證通過後,複製下方問題,補上自己的背景再傳送。

我最近幾週的訓練是:[填寫訓練組成];關鍵訓練後的恢復感受是:[填寫體感];目前想改善的是:[填寫目標]。請結合黑影兒影片依據,幫我判斷最值得關注的一個問題,區分已有證據與還需要了解的資訊,並附影片出處。
Skill 已安裝,但提示無法檢索?

先確認目前用戶端及平台支援自訂 MCP,再檢查連接器已啟用並在新對話中使用。僅 WorkBuddy 電腦用戶端需先完全結束重開,再到「连接器管理 → 自定义连接器」信任並啟用;出現登入頁時用原帳號授權。

沒有工具不代表缺少 Key,也不需要重裝 Skill。仍無法連接時,將用戶端名稱和錯誤提示交給助手排查;不要傳送密碼、Key 或 token。

Skill 不包含帳號或服務權限;未連接、授權失效或額度不足時,應先恢復相應狀態。一次搜尋和一次上下文讀取各使用 1 次額度,一個問題可能需要多次呼叫。

Skill 依 CC BY-NC-SA 4.0 散布,署名及完整授權條款見安裝套件。知識庫服務權益與 Skill 授權條款分別適用。