Files
dxdesigner-part-replacement/docs/user/dsh-ai-supervision.md
T

9.6 KiB

DSH助手

在工具中使用

主工具顶部固定显示左右两个入口:左侧 任务中心,右侧 DSH助手,单击直接切换,无需展开菜单。助手也可按 Ctrl+Shift+D 打开;切回任务中心再进入助手时保留同一个网页、会话和未发送草稿。右侧“任务监管”读取主工具当前选中的任务。

这里直接运行 DeepSeek Harness 的官方前端与运行时,固定 npm 版本 0.2.1-rc.5,通过 Qt WebEngine 嵌入主窗口。官方三栏框架、原生 SVG、鲸鱼悬停动画、输入编辑器、模型选择、侧栏与停靠交互均由上游代码提供。项目增加任务监管插件和“DSH助手”名称,不再使用 Qt 控件重画聊天页面。上游许可见 licenses/DeepSeek-Harness-MIT.txt。

不显示上游账户登录、注册、充值和首次产品引导,也不注册其账户模型提供方。左下角 工具设置 单击打开原生设置页中的“DSH工具”说明;首页提示和任务监管面板围绕器件替换任务。输入框下方仍可选择主工具已经配置的模型。

模型由本机保存的主工具配置加载;也支持启动进程的 DSH_API_BASE、DSH_MODEL、DSH_API_KEY。未配置模型时可查看任务上下文和操作面板,不能获得真实模型回复。

本机已接入测试端点 https://wecom-test.skyworth-cloud.cn/v1/,注册 skyworth-deepseek-v4-flash-0731 和 skyworth-deepseek-v4.1-flash,默认使用后者。本机配置位于任务中心数据目录的 dsh/provider.json,密钥以 Windows DPAPI 加密保存为 dsh/provider-key.dpapi,启动时自动加载;不写入仓库或 Windows 用户环境变量。

任务操作与能力边界

在对话中创建任务

可以直接输入:“创建一个电源板换料任务,OLD123 换成 NEW456,把料号复制到 Value,工程我来选。”DSH 根据意图打开主工具原生“创建任务”窗口,预填任务名、备注和规则;你读取目录、勾选工程并确认后,一个工程创建一个真实任务。无需先在任务中心新建任务,空列表也可开始对话。

对话无需说明工具名或调用顺序。系统提示只保留业务身份和真实性要求;后台向模型提供能力说明与参数,由模型根据意图选择,权限及确认门禁仍由程序执行。也可以直接问“这个任务现在怎么样了”或“帮我看看哪里出错了”。

创建成功后,助手显示真实任务 ID 和数量,任务立即出现在左侧原任务列表;切回任务中心即可继续采集位号、编辑规则和执行。创建只写配置,不采集、不执行替换,也不保存 CAD 工程。未说明的可选策略保留原默认值,确认窗口会展示 Value 与 NC 策略;没有规则时可先创建待配置任务,随后在任务中心补齐。

目录提示只预填窗口,不由模型自动扫描;工程范围以原生窗口勾选为准。确认前取消窗口或中止对话不会创建任务;确认后已提交的事务以真实回执为准。一个请求内的新任务、规则和回执事务提交,失败全部回滚;同一请求重放不重复创建,已有未完成任务的工程不被改名或改规则。创建上限为 100 个工程、30 条规则;活动执行时不创建。

任务操作报错、单任务收尾有失败项,或批次包含失败/阻断任务时,会自动切入 DSH助手并创建专属诊断会话,不需要手动提问。原执行收尾后,AI 读取出错任务绑定的快照和脱敏事件;即使切换任务,诊断也不会串到另一个任务。

已经由用户确认执行的任务,遇到已知可重试错误且现有服务确认“可重试、没有待核验结果”时,AI 可建议一次自动重试。程序通过原服务准备失败项、执行并重新读取真实进度;只有队列完成、失败为零且没有中断标记,才显示处理通过。模型建议或重试准备成功都不算解决;暂停请求会阻止继续重试。

未解决时,AI 再做一轮复盘,保存结论、依据、未知项和后续验证方法,并尝试提交 Git 工单。事件以任务、原执行轮次和错误码去重;同一任务同一原执行轮次的不同错误码共享一次重试额度,执行前持久记录,重启不重置。未知错误、未授权执行和未核验状态仅诊断取证,不自动重放工程写入。

  • 普通对话注册 dx_task_snapshot(快照)和 dx_task_create(原生确认后创建任务);自动异常诊断会话只允许快照,创建调用在工具执行前被拒绝。Shell、通用文件访问、插件安装、子智能体及模型直接 CAD 写入工具均未注册;额外工具会被 guard 阻断。
  • 刷新任务上下文重新发布当前任务快照。
  • 手动点击 准备失败项重试须在任务中心确认,并通过现有重试按钮的状态检查;该按钮只准备重试。自动介入使用上文限定的一次重试闭环。
  • 安全暂停须确认且当前确有执行控制器,使用原队列的安全边界暂停。
  • 跨任务、过期版本、未知参数、未知动作及同一版本的重复动作请求均拒绝。网页请求必须经过本机 Harness 的登录与 Origin 校验。
  • 规则修改、工程写入和不确定状态恢复仍从任务中心原流程进行,不新增模型直接执行入口。UI 显示“已提交”不表示工程已保存或核验成功。

Harness 使用任务中心数据目录下独立的 dsh/harness-home 保存会话和设置,浏览器偏好在 dsh/browser;不加载个人 Harness profile 或 Codex 凭据。服务只监听回环地址,遥测关闭;关闭主工具时先结束所属运行时。上述限制由应用的插件组合和 guard 实现,不是操作系统沙箱。

诊断证据与 Git 工单

每次自动介入在数据目录 dsh/incidents/<事件编号>/ 保存:前后任务快照、脱敏诊断包、事件时间线、规则门禁明细、模型可见会话、尝试动作、实际核验结果、工单草稿和带 SHA256 清单的 evidence.zip。保留可审阅的诊断说明,不要求模型输出隐藏思维过程;“取证”只收集本工具已有的日志与运行记录,不扫描无关网络流量、工程源文件或用户文件。

工单默认提交到 https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement。随客户端预填专用上报账户 dsh-issue-reporter 的 write:issue 令牌,其他电脑无需安装 Git、登录或提供个人凭据。该账户为非管理员受限账户,专用团队仅包含本仓库,只有工单写权限;代码、拉取请求、发布、组织、包和 Actions 权限均未授予。令牌不交给模型或网页。

预填资源为 integration/dsh/issue-bootstrap.json,已加入 Git 忽略;打包时放入 dsh-runtime/issue-bootstrap.json,可跨电脑使用,不依赖开发电脑的 DPAPI。管理员侧的账户密码和令牌恢复资料单独保存在本机 DPAPI 文件,不能随包分发。没有预填资源时,DSH 发布打包会明确报错,避免生成缺少上报身份的安装包。

dsh/issue-config.json 可覆盖启用状态与目标。预填令牌仅用于其绑定的服务器和仓库;自定义其他目标不会携带该令牌,而沿用该目标的本机 Git 凭据。受限共享令牌可在 Git 服务端吊销;吊销后保留证据待补交,并需更新分发资源。

提交前按事件标记查重,成功后上传脱敏证据附件并在任务监管显示工单链接;提交、权限或上传失败时保留为“工单待完整提交”。可以点击 打开证据目录 或 重新提交工单;重试工单不会重新执行 CAD。重启后恢复待提交记录,已中断的处理也不自动重放。附件是提交前封存的证据快照,提交回执另存在 ticket.json 和后续时间线中。

安装与验证

源码运行要求 Node.js 24.9+。安装固定依赖后再打开菜单:

powershell -ExecutionPolicy Bypass -File tools/Install-DshRuntime.ps1
$env:PYTHONPATH = 'src'
python -m dx_productivity.dsh --doctor
node tools/verify_dsh_runtime.mjs
python tools/accept_dsh_desktop.py

CLI 验证启动真实官方内核,检查工具与 preset 名单,实际读取快照、执行禁止工具探针,并测试本机请求认证、跨任务与过期动作边界。桌面验收启动真实主工具,用 Qt 鼠标事件单击左右导航,用 Chromium Input 事件操作官方页面,核对全新数据下无账户或引导弹窗、工具设置、任务刷新、会话、侧栏、SVG 动画、模型选择、草稿保留、取消确认和正常退出。验收只使用独立测试数据,不启动 CAD 或修改用户工程;未配置模型的验收不计为真实模型回复验证。

已配置本机模型时,可执行真实 API 桌面验收:

python tools/accept_dsh_desktop.py --provider-config "$env:LOCALAPPDATA/DxProductivity/trial-task-center/dsh" --live-model

2026-10-30 已完成默认模型的真实对话、dx_task_snapshot 调用和完整流式回复验证,记录见 docs/testing/2026-10-30-dsh-native-integration.md。此验收没有执行 CAD 修改,也不代表已构建发布 EXE。

专用工单身份的权限检查:python tools/verify_dsh_issue_reporter.py。该命令清空进程 PATH,验证无 Git 环境仍使用预填令牌,并要求代码、发布、建仓库与管理接口被拒绝。维护者首次配置使用 tools/provision_dsh_issue_reporter.py;最终用户不运行该脚本。免 Git 的真实桌面验收可运行 tools/accept_dsh_desktop.py --incident --without-git --provider-config '<模型配置目录>'。