接入 DSH 专用运行时和对话界面,保留模型原始回答,支持会话分页、连续追问与显式报告。 补齐组合筛选、各维度 Top100、分组查询到排名图的转换,图表故障静默省略并基于保存数据自动恢复。 优化报告风格、图表顺序和表格换行,更新接入说明及构建输入。 验证:独立目录前后端构建通过;118 项 Java、102 项前端、102 项图表、14 项 DSH 应用和 13 项组合筛选检查通过。 仅提交相关源码、锁定依赖与测试;不包含凭据、会话、业务数据或本地产物。
67 lines
4.1 KiB
Markdown
67 lines
4.1 KiB
Markdown
# 质量分析 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` 固定。
|
||
|
||
构建独立质量分析应用并检查启动:
|
||
|
||
```sh
|
||
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+:
|
||
|
||
```sh
|
||
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 的平台声明
|
||
视作已完成安装或业务验收。
|
||
|
||
运行模块专属验证:
|
||
|
||
```sh
|
||
python3 -m unittest verification.test_dsh_agent_runtime verification.test_dsh_application -v
|
||
```
|
||
|
||
验证使用本地编写的 SSE provider fixture 驱动真实 DSH,不使用在线模型或正式业务凭据。
|
||
它验证协议、MCP、逐字流、取消、时限、错误、输出截断和 OS 隔离,不代表模型业务分析质量验收。
|