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 许可分别适用。