dsh-consult

跨供应商第二意见服务：dsh 自身 agent 获得跨供应商咨询工具，外部 harness （ZCode 等）获得轻量本地 OpenAI 兼容顾问 API。

v2 现状（2.4.1，简约重构后）

设计原则：默认官方、单次调用、唯一权威超时、可视化配置。

• 默认路由 = 官方 DeepSeek（deepseek-official/deepseek-v4-flash）；想换供应商在

dsh web 设置页「顾问 / 第二意见」面板选（供应商→模型→推理档位三级联动，档位词表 来自所选模型的实际支持列表），或 settings.yaml advisor.route，或请求显式带 model

• model 参数全线可选：端点/工具/消费端缺省即默认路由
• 多模态：端点接受 image_url（data URL，png/jpeg/webp/gif，可多张）；

图片走官方视觉直连，默认路由自动升级视觉模型（显式指定的模型不偷换，直接报错）； bash ask_advisor.sh "问题" "上下文" 图1.png 图2.png

• 唯一权威超时：服务端模型调用 30 分钟（DSH_CONSULT_TIMEOUT_MS 可调，超时回 504），

客户端单次调用收下它——无重试梯子

• scout 调查模式：官方 + 实时 web_search（8 轮），用于你与人类用户都无法解决的问题
• 审计：每次咨询一行 JSONL（含图片数量、实际路由、耗时）
• 安全边界：仅回环 + Bearer + POST；配置 API 加 Origin 同源校验

> 下表 F1–F9 是 v1 时代的功能史料；其中 F3 的"自动异源路由"与"思维等级中转盲区" > 段落描述的 XQAPI 默认路由已在 v2 移除（默认即官方，等级透传有保障）。

能力（对照需求 F1–F6）

| # | 能力 | 说明 | |---|------|------| | F1 | DSH_MODEL=provider/model 直选 | 经 agent/request waterfall 改道主代理请求，不受 settings.yaml agent-default-model 用户层压制（旧 --patch 方案会被压过而静默走错模型）；改道动作写日志、实际路由写入会话 request/header；headless profile 的 patch 层另含 !!js 条目让 --dump-config 与选择一致 | | F2 | OpenAI 兼容端点 | POST http://127.0.0.1:3080/v1/chat/completions，复用现有 web 端口（不另起端口）；Bearer token（settings.yaml 的 advisor.token，首启自动生成）；SSE 流式 + 非流式；仅回环、无 CORS；model 字段接受 provider/model | | F3 | consult 工具 | 注册给所有 agent；默认自动路由到与当前模型异源的供应商（优先用户在 llm-pi-ai settings 里配置过凭证的网关，如 XQAPI），可显式传 model="provider/model"；绝不静默换模型——无解时显式报错并列出可用 provider | | F4 | 结构化输出 | consult 默认要求 JSON {recommendation, reasons, confidence, risks, alternatives}（宽松解析，失败降级纯文本并标注）；HTTP 端点支持 response_format: json_schema / json_object（提示级约束 + 解析） | | F5 | 上游溯源 | HTTP 响应头 x-model-upstream: provider/model；consult 返回 backend: dsh-advisor(model@provider)。注意：中转商自报身份不可验证的部分与需求 G3 相同，此为网关侧尽力而为 | | F6 | 咨询审计 | $DSH_HOME/storages/advisor/audit.jsonl：时间 / 来源(tool\|http) / sessionId / 问题摘要 / 路由 / 思维等级 / 耗时 / 是否结构化；adopted 字段留待回填 | | F9 | 思维等级（reasoning effort） | consult 参数 reasoning / HTTP 字段 reasoning_effort / settings advisor.reasoningEffort，词表 off/minimal/low/medium/high/xhigh/max；逐模型校验（resolveModelInfo），不支持时显式报错列出支持项；默认不传 = provider 默认（自适应思考） |

思维等级：默认为什么不是 max（实测依据）

• 等级是「上限」不是「下限」：混合思考模型（deepseek-v4-flash 等）按问题难度自适应思考，

实测一句话问题上 max 与 high 推理量无差别；off 才是确定性开关（官方路由 0 推理、896ms）

• 延迟：官方路由 off≈0.9s，思考态 1.2~5s（波动来自问题难度，不是等级档位）
• 中转盲区（G3 又一实证）：XQAPI 中转不透传 effort 参数（off 请求仍返回 195~421 字符推理，

与等级完全不相关）——经 deepseek（XQAPI）路由时设置等级是无效 placebo； deepseek-official 路由才保证生效。想让等级真正生效可配 advisor.route: deepseek-official/deepseek-v4-flash

• 结论：缺省不传（provider 默认，官方 flash 默认即 high 且自适应）；难题在 consult 时

显式传 reasoning: high/max；要全局固定用 settings advisor.reasoningEffort

安装

• 克隆本仓库到插件目录：git clone <本仓库地址> ~/.dsh/local-plugins/dsh-advisor
• ~/.dsh/profiles/web/package.json 与 ~/.dsh/profiles/headless/package.json：

dependencies 加 link: 依赖 + dsh.profile.bundles 加 dsh-advisor

• 两个 profile 目录各跑一次 pnpm install（link 包的依赖装在插件目录自身）
• headless 的 cordis.patch.yml 含 F1 的 !!js 条目

web profile 需重启 dsh web 后生效（bundle 列表在启动时读取）； headless 每次运行都是新进程，即时生效。

配置

组合层（bundle patch 的 config）：

- id: dsh-advisor
  name: 'dsh-advisor'
  config:
    httpEnabled: true   # false 可关掉 HTTP 端点（consult 工具不受影响）

用户层（~/.dsh/settings.yaml，优先）：

advisor:
  token: dsha_...            # 首次启动自动生成；换 token 直接改这里
  route:                     # 可选：固定 consult 的默认顾问路由
    provider: deepseek
    model: deepseek-v4-flash

使用示例

# F1：headless 直选模型（替代旧 --patch hack，不粘住、不会被 settings 压过）
DSH_MODEL=deepseek/deepseek-v4-flash dsh --profile headless "问题"

# F1 验收：dump-config 与选择一致
DSH_MODEL=deepseek/deepseek-v4-flash dsh --profile headless --dump-config

# F2：标准 OpenAI 客户端直调（token 见 settings.yaml 的 advisor.token）
curl -X POST http://127.0.0.1:3080/v1/chat/completions \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer dsha_...' \
  -d '{"model":"deepseek/deepseek-v4-flash","messages":[{"role":"user","content":"…"}]}'
# 流式加 "stream":true；结构化加 response_format json_schema

# F3：会话内 agent 自动可用 consult 工具（无需配置）

实测记录（2026-08-21）

• 401（无/错 token）、405（GET，带 Allow: POST）、400（裸模型名，列出可用 provider）✓
• 非流式 fib(10)=55，SSE 分片 + usage + [DONE]，json_schema 结构化输出 ✓
• DSH_MODEL headless：日志显示 改道 zai-coding-cn/glm-5.3 → deepseek/deepseek-v4-flash，

会话 request/header 记录 deepseek 路由 ✓

• GLM agent 会话内调 consult → 自动路由 deepseek（XQAPI 中转），结构化意见 + 审计落盘 ✓
• P50：HTTP 化后 5–9s（旧 headless CLI ~7s + 冷启动）✓

未做 / 边界

• F7（配额限速）、F8（并发 quorum）：未实现，留待后续
• --model CLI 旗标本体需改 dsh 源码（路径 A 提 issue）；本插件以 DSH_MODEL env

+ agent/request 改道达成同等效果且更稳

• consult 的 adopted 回填目前靠主模型在回复中标注「已采纳/未采纳」（审计字段已预留）