Files
quality_analyse/runtime/dsh/README.md
T
lyun f1a2fbd494 统一:DSH 智能分析、Top100 与图表静默恢复
接入 DSH 专用运行时和对话界面,保留模型原始回答,支持会话分页、连续追问与显式报告。
补齐组合筛选、各维度 Top100、分组查询到排名图的转换,图表故障静默省略并基于保存数据自动恢复。
优化报告风格、图表顺序和表格换行,更新接入说明及构建输入。

验证:独立目录前后端构建通过;118 项 Java、102 项前端、102 项图表、14 项 DSH 应用和 13 项组合筛选检查通过。
仅提交相关源码、锁定依赖与测试;不包含凭据、会话、业务数据或本地产物。
2026-11-12 11:57:41 +08:00

67 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 质量分析 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 隔离,不代表模型业务分析质量验收。