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

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

46 lines
4.2 KiB
Markdown

# DeepSeek Harness 正式接入
更新日期:2026年11月12日。
## 当前入口
质量智能分析固定使用 DSH。Java 提供身份、授权、正式指标、会话、工具与已保存结果;Python 编排当前模型和工具;DSH 执行思考与工具循环。正式入口是 `scripts/quality_analysis_runtime.py`,独立应用通过 `scripts/build_dsh_application.py` 构建。运行时应用不包含 nao 服务、客户端或执行器。保留的 `nao_*.py` 源文件是打包前的共享业务算子,构建时转换为中性模块名。
前端智能分析入口为 `web/src/agent/AgentWorkspace.tsx`。仅保留对话界面,工具调用在对话内展开;会话先加载最近一页,再按需读取历史,通过会话事件流更新。删除会话只操作当前账号拥有的记录。
## 模型回答与报告
直接保存和展示模型原始回答,不通过额外模型审阅、格式修复或固定结论模板替换正文。任务需要明确口径时,在对话中提问并允许续接;不以规划核查阻止普通提问。API 配置继续管理模型、端点和思考设置,引擎固定为 DSH。当前工具执行阶段关闭模型思考,正文保持原始模型输出。
普通提问直接回答;只有用户明确要求时生成报告,续答保留原始报告需求。报告采用已选的第二种风格,图表在前,明细表在后;正常说明文本允许换行,数字、百分比和规格尽量保持单行。导出支持 HTML 和清晰长图,图表使用原生 SVG。
## 查询与图表
排名支持 Top1 至 Top100。投入重量与报废重量采用明确的阶段口径;跨阶段投入筛选明确区分黑片、亮片、任一阶段、两个阶段均满足。产品组合条件先按正式汇总值筛选,再排名;正式合格率直接引用,不平均月率或重新计算正式指标。
普通指标查询、专用排名、期间对比、趋势、正式类别和来源缺陷结果经过同一图表发布出口。普通产业部、业务分组与产品汇总可复用专用排名转换,避免取到数据却无法画图。各范围与系列独立处理,单张图出错不会清除其他正常图。
图表是可选呈现,不改变 Agent 回答或任务执行状态。生成或加载失败时,对话和报告静默省略对应图表,不显示错误提示、异常图框或重试入口。后台保留图表诊断。历史结果可从已保存的查询响应自动恢复一次图表,不重新调用模型或发起业务数据查询。空结果正常显示原回答,不补造图表。
身份、权限、数据发布范围与来源绑定继续由服务器执行;它们不属于额外模型核查。模型配置和业务原始数据不得随源码提交。
## 安装与构建
DSH CLI 固定为 `0.2.2-rc.1`;官方 Python SDK 固定版本及校验记录在 `runtime/dsh/vendor/python-sdk/source-lock.json`,许可证随源码提供。要求项目 Python 环境和 Node 24.9+。
```sh
python3 scripts/setup_dsh_runtime.py --node /path/to/node24
python3 scripts/setup_dsh_runtime.py --check
python3 scripts/build_dsh_application.py --help
```
安装器使用项目运行目录,不替换全局 Node;`--check` 不调用模型。配置通过私有文件或环境变量提供,运行目录、凭据、会话、业务数据与验收产物不进入 Git。
当前系统隔离与正式服务在 macOS 验证。Linux/Windows 等效隔离与进程回收未经验证时明确拒绝 DSH 启动;依赖声明支持某系统不等于完成该系统的业务验收。源码同步不触发部署或数据库迁移。
## 验证范围
覆盖会话分页与续接、取消、授权变化、原始回答保留、报告显式生成、阶段重量、综合率筛选、Top100、空结果、期间变化、图表协议与故障静默。独立接口测试使用随机租约数据库与合成数据,不能借用业务主库作为测试库。
2026年11月12日线上验证中,原“工业电机各业务分组不合格重量 top”已基于保存的真实查询恢复黑片与亮片两张排名图,原始回答和工具调用次数保持不变。测试标签页阻断图表加载文件时,原回答仍正常显示且没有图表故障文案;阻断已解除。这些验证不构成所有未来提问均无故障的保证。