dsh-consult
跨供应商第二意见服务：dsh 自身 agent 获得跨供应商咨询工具，外部 harness
（ZCode 等）获得轻量本地 OpenAI 兼容顾问 API。
v2 现状（2.4.1，简约重构后）
设计原则：默认官方、单次调用、唯一权威超时、可视化配置。
- 默认路由 = 官方 DeepSeek（
deepseek-official/deepseek-v4-flash）；想换供应商在
dsh web 设置页「顾问 / 第二意见」面板选（供应商→模型→推理档位三级联动，档位词表
来自所选模型的实际支持列表），或 settings.yamladvisor.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；要全局固定用 settingsadvisor.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_MODELheadless：日志显示改道 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）：未实现，留待后续
--modelCLI 旗标本体需改 dsh 源码（路径 A 提 issue）；本插件以DSH_MODELenvagent/request改道达成同等效果且更稳- consult 的
adopted回填目前靠主模型在回复中标注「已采纳/未采纳」（审计字段已预留）
