前言¶
DeepSeek Harness (DSH) 中的 DSV4.1 模型有时能在最小模式下解决问题，但在全智能体的工具和项目上下文中会遗漏条件。dsh-reasoning-support 插件旨在填补这一差距，通过精简的分析流程、多模态上下文支持以及有限的接受/修复循环，在保留全智能体工具链的同时，尽可能接近最小模式的推理效果。
核心功能¶
该插件提供以下核心能力：
- 精简分析管道：在最终响应前，增加预分析和评审阶段，通过额外的模型调用来校验结果。
- 多模态上下文支持：支持图片和附件进入辅助管道，用于截图驱动的创建和工程任务。
- 自适应工具上下文：默认限制工具列表，仅保留原生工具和按需发现的工具，防止工具过多干扰推理。
- 有界的接受与修复：设置修复和证据收集的轮次上限，防止无限循环。
安装与启用¶
安装前请确保环境满足以下要求：
* Node.js >= 24
* DSH 版本 0.1.7-rc.2 至 0.2.0（0.3.1 使用新的声明式预设 API）
执行以下命令安装插件：
dsh plugin --profile web add dsh-reasoning-support
安装后需重启 DSH 以使新插件生效。在新建会话时选择 Reasoning Support 预设。
若希望将其设为新会话的默认预设，可在 agent-preset-registry 设置条目中添加：
selectedDefault: reasoning-support
配置与典型用法¶
使用该插件前，需在 DSV4.1 模型配置中声明图片输入支持。以 llm-pi-ai 为例，需在现有条目中增加 input 字段：
input: [text, image]
该插件适用于日常问答、截图驱动的创建任务，以及需要处理文档或源文件的工程任务。
限制与注意事项¶
插件在运行过程中存在以下限制：
- 修复轮次：最多允许 2 轮修复/证据收集，随后必须进入评审阶段。
- 辅助调用限制：单个辅助调用超时时间为 150 秒。一旦报告的辅助使用达到 2，将不再启动新的辅助调用。
- 图片数量：每个辅助请求最多支持 16 张图片。
- 文件处理：扫描的 PDF 需要页面图片或 OCR 处理才能被验证。默认支持读取 UTF-8 编码的文本文件，大小限制为 2 MiB。
- 工具发现：按需发现工具时，每次
tool_search最多返回 5 个结果；保留最近 12 个额外工具（配置范围 5-100）。
生态背景¶
DeepSeek Harness 的一切皆插件。dsh-reasoning-support 是一个 DSH profile bundle，安装后无需手动放置配置文件，插件会自动加载。更多细节可查看 GitHub 仓库 或 社区目录。
