# 质量分析 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 隔离,不代表模型业务分析质量验收。