SHADOWBRAIN / 開始使用
接入黑影兒大腦
黑影兒大腦(ShadowBrain)是線上知識庫,提供近 2000 期跑步影片內容資料。
MCP 負責查內容,黑影兒大腦 Skill 負責核對與整理判斷。
首次使用:先註冊並驗證電子郵件;已有帳號直接登入。 註冊新帳號 · 登入
1. 選擇你的用戶端和裝置
選好後,只顯示與你相關的連線步驟;不會修改用戶端設定。
WorkBuddy、豆包請使用電腦用戶端(Windows / macOS)。兩者的網頁版和手機版目前不支援自訂 MCP,無法依本指引連接知識庫。
WorkBuddy、豆包請使用電腦用戶端(Windows / macOS)。兩者的網頁版和手機版目前不支援自訂 MCP,無法依本指引連接知識庫。
- 依下方與你用戶端對應的指南完成連線。
- 依用戶端支援的方式安裝 Skill,完成登入與啟用。
- 開啟新對話驗證,確認 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;需要手動操作時,使用以下設定入口。
- 開啟 Settings → MCP servers → Add server,名稱填入 shadowbrain。
- 類型選 Streamable HTTP,URL 填入上方服務網址,儲存後依用戶端提示重新啟動。
- 點選 Authenticate / 登入,在 ShadowBrain 頁面完成 OAuth 授權,再返回對話。
下一步:黑影兒大腦 Skill 安裝。
僅使用 CLI 時
codex mcp add shadowbrain --url https://knowledge.libo.run/mcp codex mcp login shadowbrain --scopes knowledge:read
如果新增時已完成授權,不必重複登入。連接名稱已存在時先查看原設定,避免覆寫。
ChatGPT · 自訂 MCP
ShadowBrain 尚未上架 ChatGPT 公開目錄。請建立自己的 MCP 連線,無需在目錄中搜尋 ShadowBrain。
- 在 ChatGPT 網頁開啟 Plugins,點選 + → Add custom MCP server。
- 名稱填 ShadowBrain,Server URL 填入上方服務網址,認證選 OAuth。
- 如出現用戶端登記選項,選 DCR / 動態登記;Client ID 和 Client Secret 留空。
- 依平台提示確認,點選 Create as a plugin,安裝你建立的連線,再登入 ShadowBrain 並允許連接。
- 返回新對話,輸入 @ 並選擇你建立的 ShadowBrain,然後提問。
若介面要求開發者模式,依平台提示啟用;工作區可能需要管理員允許新增自訂 MCP。沒有新增入口時,先確認帳號與工作區權限。
下一步:黑影兒大腦 Skill 安裝;不支援 Skills 時,只能透過 MCP 檢索,無法啟用本 Skill 的回答流程。
Claude · Claude Code
Claude 網頁與桌面版
- 開啟 Customize → Connectors,點選 + Add → Add custom connector,名稱填 ShadowBrain,網址填上方 MCP 服務位址。團隊帳號需先由管理員新增。
- 驗證選擇 Sign in now;OAuth client 選擇 Register automatically(自動登記)。本服務支援 DCR,暫不支援 Claude 預設建議的 published identity / CIMD;Client Secret 留空。
- 點選連接,在 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/
Claude 官方 MCP 指南 ↗ · Claude 官方 Skill 指南 ↗ · Claude Code MCP ↗
豆包 / 豆包工作(電腦用戶端) · 手動設定
僅支援電腦用戶端;網頁版和手機版目前不支援自訂 MCP。請先在電腦上安裝並開啟用戶端。
- 開啟豆包桌面版的「插件 · 技能 · 伙伴」,點選「添加 → 新建自定义连接器」。舊版入口可能叫「技能 · 连接器 · 伙伴」,按鈕可能叫「新建」。
- 伺服器名稱填 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
在用戶端介面新增遠端 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。請先在電腦上安裝並開啟用戶端。
- 開啟「專家·技能·連接器 → 連接器 → 自訂連接器」。其他版本可在 Settings → MCP → Add MCP Server 找到入口。
- 新增遠端服務,填入上方網址,類型選 Streamable HTTP;若使用設定編輯器,type 填 streamableHttp。
- 目前版本提供 OAuth 時,點選連接或認證,在瀏覽器登入 ShadowBrain 並授權。
僅使用 WorkBuddy 電腦用戶端時:儲存 MCP 設定後,完全結束並重新開啟;在「连接器管理 → 自定义连接器」找到 shadowbrain,點選「信任」並啟用,然後開新對話。只開新對話不能代替重新啟動。
WorkBuddy 官方支援 OAuth,但本專案在 5.3.14 的 OAuth 連接遇到相容性問題,建議先升級或聯絡客服。繼續使用這個不相容版本時,可改用個人 Key,Key 路徑已實測。
下一步:黑影兒大腦 Skill 安裝。
僅在不支援或不相容 OAuth 時:個人 Key
- 登入並驗證電子郵件,在帳號頁為這個用戶端單獨建立一枚存取金鑰。
- 在用戶端的認證或自訂請求標頭設定中填入下方的值,儲存並啟用服務。
- 只有 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 時,再使用下方的安裝方式。
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 檢索。
支援此功能的用戶端會每週輕量檢查一次,有新版再提醒;說「更新黑影兒大腦」即可讓助手處理。不支援自動檢查時,可隨時說「檢查黑影兒大腦更新」。
已安裝:更新黑影兒大腦 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 授權條款分別適用。