接入 DSH 专用运行时和对话界面,保留模型原始回答,支持会话分页、连续追问与显式报告。 补齐组合筛选、各维度 Top100、分组查询到排名图的转换,图表故障静默省略并基于保存数据自动恢复。 优化报告风格、图表顺序和表格换行,更新接入说明及构建输入。 验证:独立目录前后端构建通过;118 项 Java、102 项前端、102 项图表、14 项 DSH 应用和 13 项组合筛选检查通过。 仅提交相关源码、锁定依赖与测试;不包含凭据、会话、业务数据或本地产物。
4.1 KiB
质量分析 DSH 执行器
固定 CLI @deepseek-ai/dsh@0.2.2-rc.1 与官方 Python SDK commit
fcc0ad462172522aaf5c93a7b2e01f6b9f0b0159。Python SDK 原文件、MIT 许可与文件 SHA256
保存在 vendor/python-sdk/,npm 的完整依赖图和归档完整性由 package-lock.json 固定。
构建独立质量分析应用并检查启动:
python3 scripts/build_dsh_application.py /path/to/dsh-application
python3 /path/to/dsh-application/scripts/setup_dsh_runtime.py --check
后端通过 QUALITY_ANALYSIS_RUNTIME_SCRIPT 选择该目录下的 scripts/quality_analysis_runtime.py。
QUALITY_ANALYSIS_MODEL_CONFIG_FILE 指向 0600 模型设置文件。QUALITY_ANALYSIS_STATE_DIR
指定私有运行目录,未设置时使用应用目录的 .runtime/quality-analysis。构建产物的
application.json 记录 Python 模块校验值。应用链接宿主已固定版本的 DSH 发行目录,宿主依赖需保留。
安装需要 Python 3.10+、Pydantic >=2.12,<3、npm 和 Node 24.9+:
python3 scripts/setup_dsh_runtime.py --node /path/to/node24
python3 scripts/setup_dsh_runtime.py --check
安装器把指定 Node 复制到项目 runtime/dsh/bin/,不会更新全局 Node。以后可直接运行安装器,
其优先复用项目 Node。--offline 只使用 npm 缓存;缺少归档时明确失败。
npm ci --ignore-scripts 安装锁定闭包,当前质量 profile 不使用 PTY、终端或插件安装脚本。
--check 进行版本、SDK 文件 hash、Python 依赖、操作系统隔离及真实 SDK/MCP/流桥启动检查,
不发送模型推理请求、不读取模型配置。
scripts/setup_dsh_runtime.py 提供:
inspect_runtime() -> dict:本地静态检查,ready/errors可用于规划前阻止依赖缺失。check_runtime(*, launch=False) -> dict:launch=True加做无模型真实启动检查。install(node_path=None, *, offline=False) -> dict:安装并执行上述启动检查。
scripts/dsh_agent_runtime.py 提供 run_dsh_agent(...)。授权、正式查询工具及事件输出由调用方
传入;它返回原执行器的 (ConversationAccumulator, status, reason, stop_succeeded)。
它不发布最终 result,不替代 Java 任务确认、范围证明、图表与报告收尾。
每轮新建私有 home、workspace、SDK session。sdk-minimal 经过受控 patch,关闭 shell、
终端、文件工具、工作目录工具、MCP 资源、官方 provider、会话日志上传与插件清单上传。
子进程使用白名单环境,只持有绑定本轮的随机能力;真实业务令牌与模型网关密钥留在父进程。
质量 MCP 和模型请求均经过不可变本轮 relay,摘要、重试也经当前 Java 授权与同一模型网关。
有整轮 monotonic deadline、请求次数、输入/输出字节、工具调用及累计 token 预算。
无用量返回的模型调用按输入 UTF-8 字节数加输出上限保守扣除 token 预留。
自有 stream-bridge.mjs 通过独立有序 HTTP 通道投影真实 DSH stream frame 和 durable event,
DSH stdout 保留 JSON-RPC。失败 attempt 的草稿被撤回,最终文本与已提交消息对账。
子进程能力在 shutdown 前撤销;在途模型响应关闭,随后回收已登记且身份匹配的进程组。
应用 quality_analysis_runtime.py --stop-all 根据私有运行目录登记与进程指纹清理 DSH 组。
当前仅实现并验证 macOS sandbox-exec。OS 策略只允许读取 runtime、本轮目录与必要系统/
Python 库,只允许写入本轮 home/workspace/tmp,只允许连接本轮 loopback relay。
Linux/Windows 明确拒绝无隔离启动;其等效隔离与进程树支持尚待实现,不能以 npm 的平台声明
视作已完成安装或业务验收。
运行模块专属验证:
python3 -m unittest verification.test_dsh_agent_runtime verification.test_dsh_application -v
验证使用本地编写的 SSE provider fixture 驱动真实 DSH,不使用在线模型或正式业务凭据。 它验证协议、MCP、逐字流、取消、时限、错误、输出截断和 OS 隔离,不代表模型业务分析质量验收。