dsh-eyebrain

dsh-eyebrain

为 DeepSeek Harness（dsh）纯文本主模型补上「眼睛」和「思考旋钮」：

• 识图桥：注册模型可见工具 understand_image，把图片交给配置好的小参数多模态模型（OpenAI 兼容 /chat/completions）理解，返回文字证据给主模型。
• 思考档位控制：对自部署 OpenAI 兼容端点注入 reasoning_effort（关闭/低/高/最大），全局默认 + 输入框工具行 chip 会话覆盖，下一轮请求生效。
• 发送接管：粘贴/上传的图片在发给纯文本端点前被改写为文本指针（携带附件只读路径与 understand_image 调用指引），纯文本 API 永远收不到图片。
• Web 全托管：配置存于 settings 命名空间，在 dsh Web 设置 → 插件 → dsh-eyebrain 卡片修改，用户层持久化 settings.yaml 热生效，全程无需手改配置文件。

兼容 dsh 0.1.5-rc.2（基线）/ 0.1.6-alpha.1（适配）。所有宿主接缝均以两版实测源码为锚点（官方 model-selection、image-offload、settings 服务同缝），插件加载失败不影响 dsh 其余部分。

安装

# 1. 构建（或直接使用仓库已提交的 lib/）
pnpm install && pnpm -r run build

# 2. 挂载到 web profile（dsh web 即 --profile web，插件必须挂进该 profile 才会被
#    Web 宿主与浏览器 roster 加载；TUI 使用者把 <profile> 换成对应名字）
dsh plugin --profile web add /path/to/packages/dsh-eyebrain
dsh plugin --profile web add /path/to/packages/dsh-eyebrain-client   # Web 设置卡片 + 思考强度 chip（自挂载层，add 即激活）

# 3. 重启
dsh web

使用（全部在 dsh Web 内）

设置卡片（设置 → 插件 → dsh-eyebrain）

• 全局思考档位：关闭 / 低 / 高 / 最大，一键切换。
• 识图桥：总开关 + 多模态提供方增删改（接口地址、模型 ID、API Key 引用、图片精度、max_tokens、默认提问模板）。
• 端点接管清单：每个自部署端点选择「纯文本（剥图）/ 多模态（直发）」与「是否接管思考」。

对话输入区

• 粘贴/上传图片：纯文本端点的请求里图片自动变为文本指针（带只读路径与工具指引），主模型可调用 understand_image 深析。
• 思考强度 chip：输入框工具行（「完全权限」旁）点击弹出四档官方菜单，写入当前会话覆盖，下一轮请求生效；有覆盖时显示「会话」徽标，菜单可一键清除覆盖恢复全局。

出站行为语义

思考接管是清单开启制，与官方控制互补：dsh 内置提供方（DeepSeek 等）不碰， 走官方 model-selection 的档位选择；自定义提供方加入清单并勾选「接管思考」后， 全局/会话档位才注入该端点。图片处理保持安全侧默认。

模型能力护栏：注入前插件经 llm.resolveModelInfo 探测目标模型——未声明 思考能力（reasoningEfforts）的模型一律跳过注入（注入会被 dsh-llm 以 UNSUPPORTED_REASONING_EFFORT 拒绝、整轮对话失败；跳过则对话不受影响，档位 旋钮在该模型上静默失效）；已声明的模型把四档钳制到其声明集合。自定义 GLM 提供方（bigmodel 等）需在模型条目上声明 reasoningEfforts 旋钮才生效，例如：

llm-pi-ai:
  providers:
    my-glm:
      models:
        - id: glm-4.5-air
          reasoningEfforts:
            off:          # 留空 = 关闭思考（zai 格式发 thinking.disabled）
            low: low
            high: high

架构与宿主接缝

dsh web
├─ dsh-eyebrain（后台插件，bundle；inject: tools/settings/attachments/credentials/llm）
│  ├─ config.ts        schemastery Config（三总开关）+ 命名空间文档 schema + 归一化
│  ├─ state.ts         运行时文档状态：档位解析、端点判定、识图提供方
│  ├─ takeover.ts      图片块→文本指针纯改写（dsh 会话消息形状）
│  ├─ pipeline.ts      agent/request 档位注入（prepend 最外层，注入前能力探测+钳制）+ agent/pre-step 指针改写
│  ├─ vision-tool.ts   understand_image（defineTool；路径/URL/附件引用 sha256:）
│  └─ vision-client.ts OpenAI 兼容多模态调用（超时/凭证/数组 content 兼容）
└─ dsh-eyebrain-client（Web 客户端，window.__ModuleLoader__ 工厂格式）
   ├─ index.ts         后台入口（命名空间由主包注册，此处无逻辑）
   └─ client.tsx       可折叠设置卡片（官方 PluginCard 同构）+ composer 工具行思考强度 chip（官方 Menu/Switch/设计令牌）；settingsScope.bind 读写

档位值域 off|low|high|max 与 dsh 适配器 reasoningEffort 完全一致；线上格式（reasoning_effort/thinking.type）由 dsh 适配器自行转换，插件不碰请求体。

离线打包（配合 dsh-plugin-offline-packager）

两个子包均零生产依赖（peer 由 dsh 宿主提供），打包产物天然自包含，可直接进 dsh-admin 插件市场分发：

# 在 DSH Web 中对 AI 说（本地来源，逐包执行）：
请把 F:\project\dsh-eyebrain\packages\dsh-eyebrain 打包为离线安装包
请把 F:\project\dsh-eyebrain\packages\dsh-eyebrain-client 打包为离线安装包

子包 files 白名单齐全（lib / cordis.patch.yml / README.md / LICENSE），仓库已提交 lib/，packager 不会在 stage 内触发重建。离线安装端注意 pnpm ≥ 11 minimumReleaseAge 与 Windows 路径空格问题，见 packager README《离线安装必读》。

验证

pnpm install && pnpm -r run typecheck && pnpm -r run test   # 冒烟测试 25 用例

冒烟锚点全部来自真实 dsh 源码：瀑布改写（reasoningEffort 注入 / prepend 语义 / 图片指针）、defineTool 注册与参数校验、settings 命名空间注册、bundle 契约、离线打包前提。实机双版本矩阵步骤见 packages/dsh-eyebrain/P7-INTEGRATION.md。

License

MIT