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

3.9 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_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 用户环境变量。

任务操作与能力边界

  • 模型唯一注册工具为 dx_task_snapshot,返回任务状态、规则数量、进度、异常摘要和监管记录。Shell、工程文件访问、通用插件安装、子智能体及 CAD 写入工具均未注册;额外工具即使被意外注册也会被全局执行 guard 阻断。
  • 刷新任务上下文重新发布当前任务快照。
  • 准备失败项重试须在任务中心确认,并通过现有重试按钮的状态检查;只准备重试,不直接开始替换。
  • 安全暂停须确认且当前确有执行控制器,使用原队列的安全边界暂停。
  • 跨任务、过期版本、未知参数、未知动作及同一版本的重复动作请求均拒绝。网页请求必须经过本机 Harness 的登录与 Origin 校验。
  • 规则修改、工程写入和不确定状态恢复仍从任务中心原流程进行,不新增模型直接执行入口。UI 显示“已提交”不表示工程已保存或核验成功。

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

安装与验证

源码运行要求 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。