feat: embed native Harness assistant and verify live task model
This commit is contained in:
1 parent
9c508333bb
commit
96227eed2e
29 files changed
+11110
-582
No files matched your search
@@ -0,0 +1,25 @@
|
||||
# DSH助手原生接入
|
||||
|
||||
用户已明确要求复用 DeepSeek Harness 原生桌面前端、SVG 和动画,并从现有工具菜单进入;此前 Qt 重画版本被替代。
|
||||
|
||||
## 组合
|
||||
|
||||
固定 `@deepseek-ai/dsh@0.2.1-rc.5`,保留官方前端产物不变。主窗口增加工具菜单和 `QStackedWidget`,按需创建 `QWebEngineView`;任务页保持原有控件、任务选择和执行状态。由所属 `QProcess` 启动独立 profile,提供只监听回环地址的 Harness 服务。只有所属进程输出的、同一回环 origin 的启动地址可进入嵌入页面。
|
||||
|
||||
任务专用插件通过官方 slot API 改产品名称,并注册官方右侧停靠栏 tab。官方会话、编辑器、主题、SVG、悬停动画、模型面板及布局直接使用上游实现。任务上下文由 Python 白名单快照原子写入应用数据目录;Host 插件的固定读取工具和登录校验后的 HTTP 路由读取该文件。文件路径由启动器决定,不接受模型提供路径。
|
||||
|
||||
## 能力
|
||||
|
||||
只启用 `dx-task` preset,模型只注册 `dx_task_snapshot`。通用工具、终端、文件浏览、插件管理、Agent 配方编辑等相关界面与工具条目禁用。全局单调 guard 拒绝其他工具,避免配置意外扩大执行能力。
|
||||
|
||||
人点击刷新、准备重试或安全暂停时,Host 校验当前任务、版本、动作白名单、参数字段和幂等键,通过进程事件交给 Qt。Qt 再检查任务身份、版本和执行门禁;变更请求须人工确认,并调用已有任务中心方法。任何取消、跨任务或不允许的状态都不触碰 CAD。
|
||||
|
||||
## 生命周期与交付
|
||||
|
||||
应用关闭时等待所属 Harness 退出;超时只结束自己的进程。浏览器页面先于 profile 销毁,避免退出期间信号访问已经释放的控件。源码安装脚本使用 lockfile;打包配置保留 WebEngine 所需 Quick/QML DLL,并可随包携带 Node 和固定依赖。此次源码验证与发布 EXE 构建分开记录。
|
||||
|
||||
## 验收
|
||||
|
||||
Python UI/协议回归;真实 CLI 工具执行与拒绝探针;真实主窗口菜单鼠标事件;原生网页鼠标/键盘事件;官方 SVG/CSS 动画运行证据;上下文刷新、取消确认、切页保留草稿和正常退出。验收数据独立保存,不把未配置模型的界面验证宣称为外部模型调用成功。
|
||||
|
||||
本机测试 API 的两个模型已通过实际运行时模型目录验证,默认 `skyworth-deepseek-v4.1-flash`。密钥仅由 Windows DPAPI 加密存储并通过子进程环境注入,模型目录保存在独立的非密配置中。真实桌面验收已经完成默认模型工具调用、完整流式回复、取消动作确认与正常关闭;具体证据和未覆盖范围见 `docs/testing/2026-10-30-dsh-native-integration.md`。
|
||||
@@ -0,0 +1,53 @@
|
||||
# DSH 原生接入验证记录
|
||||
|
||||
日期:2026-10-30。分支:`codex/dsh`。官方 Harness 固定版本:`0.2.1-rc.5`。
|
||||
|
||||
## 模型与配置
|
||||
|
||||
测试 API:`https://wecom-test.skyworth-cloud.cn/v1/`。已拉取并在真实 Harness 模型目录中验证:
|
||||
|
||||
- `skyworth-deepseek-v4-flash-0731`
|
||||
- `skyworth-deepseek-v4.1-flash`(默认)
|
||||
|
||||
密钥通过 Windows DPAPI 加密保存于本机任务中心数据目录,运行时通过子进程环境读取;文档、测试报告及仓库不保存明文密钥。
|
||||
|
||||
提交前使用真实密钥进行不输出密钥的匹配检查:Git 暂存区与 112 个 DSH 生成配置、日志和报告文件均无匹配,明文临时密钥文件不存在。
|
||||
|
||||
## Python 回归
|
||||
|
||||
```powershell
|
||||
pytest -q tests/dsh tests/ui tests/packaging/test_dx_part_replace_build.py tests/trial_task_center/test_application.py
|
||||
```
|
||||
|
||||
覆盖 DSH 策略、配置加密、快照脱敏、原生菜单及现有 UI/启动/打包配置检查。最终执行结果:`49 passed in 35.83s`。
|
||||
|
||||
源码布局下设置 `$env:PYTHONPATH = 'src'` 后执行 `python -m dx_productivity.dsh --doctor`,结果 `status: ready`、`frontend: official`,Node.js `v24.11.1`。
|
||||
|
||||
## 真实 CLI
|
||||
|
||||
运行 `node tools/verify_dsh_runtime.mjs`,通过子进程环境加载本机配置。结果 `status: passed`:工具仅有 `dx_task_snapshot`,preset 仅有 `dx-task`,模型目录包含上述两个模型;真实快照执行成功;额外工具在执行体运行前被拒绝;未登录请求返回 401;已登录请求读取成功;未知、跨任务和过期动作返回 409。
|
||||
|
||||
报告:`build/dsh-native-cli-verification/report.json`(本机生成,未入库)。
|
||||
|
||||
## 主工具实际点击与真实 API
|
||||
|
||||
```powershell
|
||||
python tools/accept_dsh_desktop.py --output '<验收目录>' --provider-config "$env:LOCALAPPDATA/DxProductivity/trial-task-center/dsh" --live-model
|
||||
```
|
||||
|
||||
使用独立测试数据启动真实任务中心,Qt QTest 鼠标事件点击任务、工具菜单、确认框和返回导航;在嵌入 Chromium 中通过 CDP Input 鼠标/键盘事件操作官方页面。
|
||||
|
||||
通过项目:原生三栏及任务监管停靠页、任务上下文刷新、新会话、模型选择器、输入并发送、真实 API 回复、等待完整流式回合结束、真实模型 `dx_task_snapshot` 成功审计记录、点击“准备失败项重试”后在 Qt 确认框选择“否”、切回任务中心后保留同页及输入草稿、正常退出且无未捕获异常。
|
||||
|
||||
动画证据:页面有 22 个 SVG,悬停时检测到 1 个运行中的 CSS 动画和 1 个 SVG 动画;保存 8 帧悬停截图。侧栏折叠/展开另在此前不调用模型的桌面验收中通过。
|
||||
|
||||
本机证据目录:`C:/Users/ABS_Windows/.codex/visualizations/2026/10/30/01a18a4c-fe37-7e12-b79d-be24a38dba29/dsh-native-live/`。
|
||||
|
||||
- `desktop-report.json`:`status: passed`、`cleanShutdown: true`、`uncaughtErrors: false`、`modelToolSucceeded: true`。
|
||||
- `report.json`:`liveModelReplyTested: true`、`liveTurnCompleted: true`。
|
||||
- `dsh-in-tool.png`:真实主工具中的完整界面与模型回复。
|
||||
- `dsh-native-final.png`、`hover-0.png` 至 `hover-7.png`:原生页面与动画截图。
|
||||
|
||||
## 范围
|
||||
|
||||
真实 API 的完整对话使用默认 V4.1 模型;另一模型验证了目录注册。验收任务处于草稿状态,不启动 CAD、不修改工程,不把该结果解释为实际工程修复成功。此次完成源码运行验证与打包配置回归,未构建发布 EXE。
|
||||
@@ -1,17 +1,44 @@
|
||||
# DSH助手
|
||||
|
||||
## Desktop 界面
|
||||
## 在工具中使用
|
||||
|
||||
界面按 [DeepSeek Harness 官方 desktop 共用 UI](https://github.com/deepseek-ai/deepseek-harness) 的三栏布局与浅色主题适配到 Qt:左侧工作区和会话,中间对话与圆角输入卡片,右侧任务上下文、建议动作、监管记录和能力边界。三栏宽度可拖动调整。
|
||||
在主工具选择 **工具 → DSH助手**,或按 `Ctrl+Shift+D`。选择 **工具 → 任务中心** 返回原任务列表;再次进入助手时保留同一个网页、会话和未发送草稿。右侧“任务监管”读取主工具当前选中的任务。
|
||||
|
||||
左侧可新建、搜索、切换对话;会话仅保留在本次窗口内。对话请求在后台运行,切换会话不会混入其他回复。“停止接收”会丢弃本次后续回复,底层 HTTP 请求仍等待完成或超时。右侧动作卡在确认后委托已有任务服务处理,提交不等于执行成功。
|
||||
这里直接运行 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的官方前端与运行时,固定 npm 版本 `0.2.1-rc.5`,通过 Qt WebEngine 嵌入主窗口。官方三栏框架、原生 SVG、鲸鱼悬停动画、输入编辑器、模型选择、侧栏与停靠交互均由上游代码提供。项目增加任务监管插件和“DSH助手”名称,不再使用 Qt 控件重画聊天页面。上游许可见 `licenses/DeepSeek-Harness-MIT.txt`。
|
||||
|
||||
可运行 `python tools/preview_dsh_desktop.py` 单独预览真实界面;该预览不连接任务数据库、不启动 CAD。任务中心的“DSH助手”入口会带入当前任务快照和本窗口监管记录。
|
||||
模型可通过官方界面的模型设置配置;也支持启动进程的 `DSH_API_BASE`、`DSH_MODEL`、`DSH_API_KEY`。未配置模型时可查看任务上下文和操作面板,不能获得真实模型回复。
|
||||
|
||||
模型配置沿用进程环境变量 `DSH_API_BASE`、`DSH_MODEL`、`DSH_API_KEY`。本次适配只复用布局与视觉样式,不加载官方 Harness 的插件或系统工具。上游 MIT 许可保留在 `licenses/DeepSeek-Harness-MIT.txt`。
|
||||
本机已接入测试端点 `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 用户环境变量。
|
||||
|
||||
## 现有处理边界
|
||||
## 任务操作与能力边界
|
||||
|
||||
DSH 是任务中心内的工具型监管入口。它先使用本地规则识别失败、超时和不确定状态;明确失败可生成一次性的重试动作。模型只负责解释和提出结构化建议,不能直接调用 CAD、Shell、文件系统或任意网络工具。
|
||||
- 模型唯一注册工具为 `dx_task_snapshot`,返回任务状态、规则数量、进度、异常摘要和监管记录。Shell、工程文件访问、通用插件安装、子智能体及 CAD 写入工具均未注册;额外工具即使被意外注册也会被全局执行 guard 阻断。
|
||||
- **刷新任务上下文**重新发布当前任务快照。
|
||||
- **准备失败项重试**须在任务中心确认,并通过现有重试按钮的状态检查;只准备重试,不直接开始替换。
|
||||
- **安全暂停**须确认且当前确有执行控制器,使用原队列的安全边界暂停。
|
||||
- 跨任务、过期版本、未知参数、未知动作及同一版本的重复动作请求均拒绝。网页请求必须经过本机 Harness 的登录与 Origin 校验。
|
||||
- 规则修改、工程写入和不确定状态恢复仍从任务中心原流程进行,不新增模型直接执行入口。UI 显示“已提交”不表示工程已保存或核验成功。
|
||||
|
||||
打开任务中心的“DSH助手”后,可以查看当前任务状态并进行人工对话。未配置 DeepSeek/OpenAI 兼容接口时,对话会明确提示,但本地监管和固定动作仍然可用。模型动作最多 3 个,必须绑定当前任务;未知动作、跨任务参数和非法 JSON 会被拒绝。工程写入、规则修改和不确定状态恢复始终需要人工确认。
|
||||
Harness 使用任务中心数据目录下独立的 `dsh/harness-home` 保存会话和设置,浏览器偏好在 `dsh/browser`;不加载个人 Harness profile 或 Codex 凭据。服务只监听回环地址,遥测关闭;关闭主工具时先结束所属运行时。上述限制由应用的插件组合和 guard 实现,不是操作系统沙箱。
|
||||
|
||||
## 安装与验证
|
||||
|
||||
源码运行要求 Node.js 24.9+。安装固定依赖后再打开菜单:
|
||||
|
||||
```powershell
|
||||
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 桌面验收:
|
||||
|
||||
```powershell
|
||||
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。
|
||||
Reference in new issue
Block a user