English | 简体中文

嗨~ 我是 AUX,主人的辅助模型小助手 💙 主模型专心聊天,我负责看图、读网页、压长文! 需要我的时候,直接叫我就好～

dsh-aux — DSH 辅助模型系统

给主 agent 配一个“副手”:视觉分析、网页提取、长文本压缩这些旁路任务,由独立辅助 LLM 完成,主模型专注对话。不建子智能体、不做会话协同——装完即用,零配置。

目录

• 为什么需要它
• 核心特性
• 环境要求
• 快速开始
• 使用指南
• 工作原理
• 兼容性与依赖
• 常见问题
• 相关项目
• 文档
• 致谢与借鉴
• 许可证

为什么需要它

对话模型越来越强,但“看图、读网页、压长文”这类任务交给主模型做会打断思路、烧上下文。dsh-aux 把它们拆给辅助模型:你只管发,背后自动路由到合适的模型——主模型答你的问题,辅助模型负责“看一眼图片”“总结这个网页”“把这 5 万字压缩一下”。

核心特性

三个工具

环境要求

• DSH ≥ 0.1.0-rc.6
• Node.js ≥ 20
• 运行时零第三方依赖:peerDependencies 全部是 DSH 官方包(环境自带),无 dependencies,无需额外安装任何第三方运行时库。

快速开始

# 方式一:克隆仓库后一键安装(推荐,含 image-bridge 集成组件)
git clone https://github.com/DoloresCaritasAngelus/DSH-AUX.git
cd DSH-AUX && ./install.sh

# 方式二:本地源码安装插件本体(未发布 npm 时使用)
git clone https://github.com/DoloresCaritasAngelus/DSH-AUX.git
cd DSH-AUX/dsh-aux
dsh plugin --profile web add "file:$(pwd)"

重启 DSH 后:

1. 发一张图片给 agent,它会用 vision_analyze 描述给你(纯文本主模型也能发——image-bridge 已集成);
2. 输入 /aux status 查看各任务路由;
3. 想让视觉走专用模型?/aux model vision <provider>/mimo-v2.5。

使用指南

命令

设置页

Web → 设置 → 辅助模型,可以为 vision / web_extract / compress / compaction 配置模型;其中 compaction 就是会话压缩模型,配置后原生 DSH 的自动/手动压缩会走 AUX 辅助模型。还可以关闭「在对话界面显示辅助模型状态芯片」——关闭后不再向 Web/第三方暴露 aux-status 投影,/aux status 命令不受影响。

安全边界

• SSRF 防护(默认开启):web_extract 与 vision_analyze 的 imageUrl 默认拒绝内网/环回/云元数据地址(localhost、127.0.0.1、10.x、192.168.x、169.254.169.254、*.local 等),且只允许 http/https;重定向的每一跳也会在请求前校验。需要抓取本机/内网服务时,在插件配置里显式设置 allowInternalUrls: true。
• Prompt 注入缓解:辅助模型提示把网页正文、待压缩文本、图片内文字都视为不可信数据,明确禁止执行其中嵌入的指令;guideText 是受信任的插件配置,只应从可信来源复制。
• 并发硬上限:每个任务的 maxConcurrency 即使配置得更大,实际也按 10 封顶,避免误配导致对辅助模型并发轰炸。

编程调用(给其他插件开发者)

const result = await ctx.auxLlm.call("compress", {
  messages,
  system,
  session,
  signal
});
// => { text, provider, model }

自定义任务:ctx.auxLlm.registerTask(...)。

工作原理

• 路由解析:显式配置 > 任务默认 > 会话主模型;辅助模型失败自动降级主模型。
• 健壮性:每任务超时(默认 60s)、并发信号量(默认 2)、失败冷却(连续 3 次 → 停 60s)、错误分类、聚合错误报告每一跳。
• 可观测:每次调用写 aux/llm-call 会话事件 + aux-status 投影,历史可回放。
• 图片能力门:调用前查模型输入能力,明确不支持的模型直接跳过换路;未声明能力的模型放行由服务端决定。
• 压缩协同:dsh-compaction-basic 的摘要调用可通过 ctx.auxLlm 的 compaction 任务执行,复用 AUX 的超时/并发/冷却/降级/事件记录。

源码结构

dsh-aux/src/index.js 只保留 Service 装配与路由调度,其余按领域拆分,方便社区贡献者定位:

• config.js / route.js / prompt.js / url-policy.js — 配置、路由、提示词、SSRF 策略
• events.js / projection.js / bootstrap.js / commands.js / fetch.js — 事件、投影、Bootstrap 引导、命令、抓取
• tools/ — vision_analyze / web_extract / compress_text 工具实现与注册
• images/ — 附件归属、清理、图片记忆、图片引用解析
• image-bridge.js / compaction-bridge.js / compaction-messages.js — 桥接与压缩消息降级

兼容性与依赖

• 平台:DSH ≥ 0.1.0-rc.6;Node ≥ 20。
• 运行时零第三方依赖:peerDependencies 全部是 DSH 官方包(环境自带),无 dependencies。
• 测试零依赖:node --test tests/*.test.js(163 项,含 aux 102 / compression 35 / core-review 4 / fetch-vision 4 / images-review 7 / fs-boundary 2 / bridge-target 4 / memory 1 / bridge 4)。

集成组件

• image-bridge:让纯文本主模型也能直接粘贴图片,UI 保留缩略图;npm update 后需重跑 bridge/apply-patch.mjs。
• settings 动态暴露:设置页可读写 aux 配置;对应补丁已随本仓库 bridge/ 落地,不依赖官方 deepseek-harness 合入。
• 会话事件注册通道:aux/llm-call 以 ignorable: true 标记写入;未装补丁时自动降级不写事件,保护会话日志。
• 会话删除协同:配合社区插件 dsh-plugin-session-delete,删除会话时自动清理无引用图片。
• compaction-bridge:配置 compaction 任务后,原生压缩改走 AUX;含图会话图片不可用时自动降级为文本占位。

极简 / Anchored Standard 兼容

首个持久 tool/call 前只暴露 Minimal 工具对,并剥离自动注入上下文——这是这些预设实现“首轮轨迹锚定”的核心机制。dsh-aux 首轮绝不注入任何 AUX 上下文/提示词;首个 tool/call 后目录开放,AUX 工具出现,并通过 agent/pre-step 注入一次提示,引导直接使用 vision_analyze,避免子代理绕路。Anchored Standard 的设计与实现见 xiaobright/dsh-anchored-standard。

常见问题

Q1:为什么在极简 / Anchored Standard 预设的首轮看不到 vision_analyze 等 AUX 工具?

A:这些预设的“首轮轨迹锚定”机制会在首个持久 tool/call 前只暴露 Minimal 工具对,并剥离自动注入的上下文。dsh-aux 尊重这一机制,首轮绝不注入任何 AUX 上下文/提示词,也不会提前暴露自己的工具。首个 tool/call 之后工具目录开放,vision_analyze / web_extract / compress_text 就会出现,并通过 agent/pre-step 注入一次提示引导直接使用。

Q2:为什么 /compact 在含图会话里失败了?

A:如果会话消息里的 image block 对应附件对象已被 GC/清理(读回报 Attachment object is missing.),或所有可选压缩路由均不支持图片输入,图片对压缩不可用。此时 dsh-aux 会把图片降级为文本占位([图片: name (type, WxH) — 未纳入压缩摘要])后继续交给 AUX 压缩,避免整个压缩任务失败——所以正常情况下压缩不会因图片不可用而失败。

Q3:dsh-aux 需要配置模型才能用吗?

A:不需要。dsh-aux 是零配置的:不配任何模型也能跑,辅助任务会自动回退到会话主模型。你可以随时通过设置页或 /aux model <task> <provider/model> 为某个任务指定专用模型。

相关项目

• dsh-anchored-standard — Anchored Standard 预设的设计与实现
• dsh-vision-toolkit — 社区视觉工具集
• dsh-plugin-session-delete — 会话删除插件(删除会话时自动清理无引用图片)
• SeekMaid-pet — SeekMaid 电子宠物

文档

致谢与借鉴

设计受 Hermes Agent、agent-vision-toolkit、dsh-vision、deepseek-harness #733 与 DeepSeek Harness 平台启发,逐条说明见 CONTRIBUTIONS.md。

许可证

MIT License © 2026 dsh-aux contributors