Files
quality_analyse/docs/DeepSeekHarness正式接入.md
T

60 lines
6.1 KiB
Markdown

# DeepSeek Harness 正式接入
更新日期:2026年11月12日。
本文件按当前 Java 引擎约束、独立应用构建入口及最新交付说明整理;项目现状和待办见 [当前进度](当前进度.md)。11月10日的双引擎切换、额外模型审阅和早期报告缺项属于历史阶段,不能作为当前运行说明。
## 当前入口
质量智能分析固定使用 DSH。Java 提供身份、授权、正式指标、会话、工具与已保存结果;Python 编排当前模型和工具;DSH 执行思考与工具循环。正式入口是 `scripts/quality_analysis_runtime.py`,独立应用通过 `scripts/build_dsh_application.py` 构建。运行时应用不包含 nao 服务、客户端或执行器。保留的 `nao_*.py` 源文件是打包前的共享业务算子,构建时转换为中性模块名。
根目录 `scripts/quality_analysis_runtime.py` 仍保留早期双引擎兼容逻辑;当前 Java 正式分析入口固定 DSH,构建后的独立应用使用自己的运行入口。排查线上行为时先核对守护登记的实际运行包,不把根目录兼容源码当作当前部署。
前端智能分析入口为 `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”已基于保存的真实查询恢复黑片与亮片两张排名图,原始回答和工具调用次数保持不变。测试标签页阻断图表加载文件时,原回答仍正常显示且没有图表故障文案;阻断已解除。这些验证不构成所有未来提问均无故障的保证。
## 2026年11月12日自主查询与报告修复
启动时只提供非阻断的意图提示。规格与参数不明确时由 Agent 查询目录、修正或提问;每次真实取数及缓存复用仍检查当前权限。固定发布版本内的相同查询复用证据,缓存区分指标、阶段、条件和分页,新一轮独立取数。
排名一次返回所选阶段的合格率、投入重量与报废重量;OR/AND 重量条件先作用于完整正式分组,再排序取 Top N。模型只接收必要指标与每页最多100行,完整证据保持原样;运行意外退出可在原轮授权和截止时间内基于已成功结果恢复一次。撤权、用户取消和超时不会自动重启。
工具结果提供本轮真实图表地址,Markdown 图片引用直接渲染为 SVG。趋势纵轴按数据自适应,图表和数据表展示两位小数。总体报告以综合合格率趋势为主图;主图、正文图及补充图统一去重。模型原始正文保持不变。
线上使用原8个问题复测,均产出最终回答;双期对比精简输入后追加两轮,均为1次调用,无重复。TOP100完整核对100行,任一阶段投入大于1000kg的组合筛选完整核对20行。报告预览6张真实图全部加载且没有重复。调用次数和页面验证是本轮观察结果,不保证所有未来问题均无故障。