前言¶

DeepSeek Harness（DSH）主代理通常在同一对话里承担工具调用、Skill 执行和交付。遇到代码审查、根因假设、设计权衡或长推导时，若全部堆在主上下文里，容易互相污染，也不利于并行：一边查证据、一边做独立分析会更顺手。常见做法是再开一个子代理或外部聊天窗口，但那样往往带上 DSH 工具链、Skill 目录或主会话历史，边界并不清晰。

下面介绍社区插件 dsh-tabbit-brain（维护者 wbdxy）：主代理通过本地 OpenAI 兼容网关调用 Tabbit 侧模型，在 DSH 内完成「私有文字推理会话」，不创建 DSH 子 agent，不继承主对话工具与 Skill 目录，也不额外弹出 UI 窗口。

这是什么¶

dsh-tabbit-brain 是 DSH 的 subagent provider 类插件，分类为模型推理。它把推理请求发到本机 Tabbit 网关（默认 http://127.0.0.1:8787），由网关反代 Tabbit 服务；插件自管 prompt 与会话历史，与 DSH 主会话隔离。当前版本 0.12.0（MIT 许可证），依赖 Node.js ^22.19.0 || >=24.0.0 与 Cordis 4+。

SkillHub 目录页：wbdxy/dsh-tabbit-brain。源码与详细协议见 GitHub 仓库 及 SETUP.zh.md、REVERSE-PROXY.zh.md。

核心功能¶

独立推理伙伴（delegation guidance）¶

插件会注入引导，说明主代理何时宜咨询 Brain：独立代码审查、候选原因与反例、设计权衡、难推导、文稿起草与完成度审查等。独立分析可与主代理的证据收集并行；主代理提供有边界的 brief，收集结果并自行核验，仍对交付负责——委托不保证更高准确率或更快完成。

delegationStyle 可选：

• standard（默认）：在合适时机主动使用独立推理，不必等用户点名工具。
• aggressive：能力与核验规则相同，对小任务触发阈值更低。
• off：关闭注入引导；简单事实与短编辑可留在本地。

单次请求可通过 model 指定网关暴露的模型 id；未指定时使用配置的 agentModel。插件不根据模型名称假设专长。

工具与会话¶

主代理与普通子代理（各自 owner）可使用 README 列出的 Brain 相关工具，典型包括：

• tabbit_brain：必填 description、prompt；可选 conversation、model、run_in_background（默认后台）。省略 model 则用 agentModel，或传网关 /v1/models 中的 id 做单次覆盖。Harness 的 jobId 与 brainJobId 分离：用 job_output / job_kill 管理 harness 任务，用 tabbit_brain_status 查看 Brain 任务。
• tabbit_brain_list / tabbit_brain_read：列出会话、按消息 seq 分页阅读；翻页时对更旧一页设置 before 为当前页最小 seq。
• tabbit_brain_archive / tabbit_brain_delete：归档或删除本地记录（不保证删除远端账号记忆）。
• tabbit_brain_reset：仅清空闲标签的本地历史，保留远端上下文。

要点：

• 请求不含 tools / tool_choice；网关返回的 model id 须与请求一致，否则报错（拒绝静默换模）。
• 历史按调用者 owner 与 conversation 标签隔离；同标签串行，不同标签独立。持久化在 ~/.dsh/plugins/dsh-tabbit-brain/state/brain.sqlite。
• 每次请求快照配置；须 fit contextBudgetChars，较早的完整轮次会被丢弃以腾出空间，不会静默截断当前任务。失败轮次不入历史。

能力边界¶

tabbit_brain 是对本地网关的纯文字 OpenAI 兼容请求。它不继承主 DSH 对话、本机 DSH skill-catalog、工作区文件、附件、浏览器标签或 DSH 工具。若任务依赖某 DSH Skill，须由主代理先执行，再把结果或忠实摘录写入 prompt。

上游 Tabbit（经反代）可能具备搜索、网页抓取、Tabbit 自有 Skill/妙招检索、读图等服务端能力；与本机 DSH Skill 目录无关，返回事实仍需主代理核验。当前桥接未验收为可验证的浏览器控制通道；browser_control 等可能仅以文字返回。tabbit_brain 工具本身仅接受文字，通用文件附件未接通。

安装与启用¶

前置条件（来自官方 SETUP）：Windows、Node.js 22.19+、已安装的 DSH，以及已安装并登录的 Tabbit。网关部署与反代协议见仓库 REVERSE-PROXY.zh.md。

1. 部署网关¶

理解协议后，在插件目录执行（PowerShell 示例）：

node gateway-patch/install.mjs --dry-run
node gateway-patch/install.mjs --api-key <YOUR_KEY> --base-url https://web.tabbit.com

<YOUR_KEY> 与网关 .env 的 API_KEY 一致，并应通过环境变量 TABBIT_API_KEY（或你在插件里配置的 apiKeyEnv）供 DSH 使用。国际版 Tabbit 基址为 https://web.tabbit.ai。

验证：

Invoke-RestMethod 'http://127.0.0.1:8787/healthz' -Headers @{Authorization="Bearer <YOUR_KEY>"}
Invoke-RestMethod 'http://127.0.0.1:8787/v1/models' -Headers @{Authorization="Bearer <YOUR_KEY>"}

2. 安装插件¶

按 SETUP 获取源码、安装依赖后，用 link 方式装入指定 profile：

git clone https://github.com/wbdxy/dsh-tabbit-brain.git
cd dsh-tabbit-brain
npm install --ignore-scripts --legacy-peer-deps
dsh plugin --profile <PROFILE> add link:<ABSOLUTE_PLUGIN_DIR>

将 <PROFILE> 换为实际 DSH profile，<ABSOLUTE_PLUGIN_DIR> 换为本插件目录的绝对路径。无需额外子代理 preset 或手工挂载 tool-subagent-tabbit。

3. 配置与检查¶

常用配置项（默认值见仓库 README 配置表）包括：agentModel（默认 'DeepSeek-V4.1-Flash'，须与 /v1/models 返回 id 一致）、gatewayUrl（默认 http://127.0.0.1:8787）、apiKeyEnv（默认 TABBIT_API_KEY）、contextBudgetChars（16000）、requestTimeoutMs（120000）、delegationStyle 等。密钥只放在环境变量，不要写入源码或文档。

只读 setup 检查（不启动网关、不改 settings）：

node scripts/setup.mjs --help
node scripts/setup.mjs --base-url http://127.0.0.1:8787 --api-key-env TABBIT_API_KEY --models DeepSeek-V4.1-Flash --check-gateway --yes

4. 重启 DSH¶

重启后在普通主对话中确认工具列表含 tabbit_brain。使用渐进式 preset 时须先按正常流程调用 phase_begin，不要用 phase_advance 伪造阶段完成。

典型用法¶

后台委托推理（SETUP 验收示例）：

请把下面这段纯推理任务交给 tabbit_brain，使用 run_in_background: true。发起后继续做自己的工具工作，收到 job_output 后核验结果。

DSH Skill 结果转交 Brain 时，应粘贴内容而非本机路径：

主代理已执行 DSH Skill <SKILL_NAME>。以下是相关完整结果：
<粘贴结果或提取的证据>
现在请基于这些内容分析/设计/总结。不要声称自己执行过该 Skill 或读取过原始文件。

验收时可对照：返回的是 job ID（非 DSH 子 agent ID）；网关收到 /v1/chat/completions；receipt 含 model 与 endpoint；同一 conversation 串行。

适用场景与注意¶

适合：希望在 DSH 主流程内增加与 Tabbit 模型对齐的、上下文隔离的文字推理；需要后台 job、多 conversation 标签并行、或与主代理工具链解耦的审查/分析任务。

注意：

• 插件以当前 DSH 进程权限运行；安装前请阅读源码与 MIT 许可证，自行评估网关与 Tabbit 账号边界（SETUP 对 Cookie、远端会话绑定与 fail-closed 恢复有专门说明）。
• 禁用本插件即可关闭 Brain 工具注册；own-layer 注册不受继承的 DSH allow/deny 过滤约束。
• DSH 生态强调「一切皆插件」；SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-tabbit-brain 把 Tabbit 侧模型接到 DSH 主代理的手边：本地网关、独立历史、七个 Brain 工具与可调的委托策略，主代理仍掌控证据与交付。进一步安装细节与能力分层验收见仓库 SETUP.zh.md。

• 目录页：https://www.skillhub.cn/plugins/wbdxy/dsh-tabbit-brain
• GitHub：https://github.com/wbdxy/dsh-tabbit-brain