Files
dxdesigner-part-replacement/docs/user/dsh-ai-supervision.md
T
阿白叔 705c15eb93
Core regression / Python core and release configuration (push) Successful in 20s
Core regression / JavaScript syntax (push) Successful in 3s
Core regression / Python core and release configuration (pull_request) Successful in 15s
Core regression / JavaScript syntax (pull_request) Successful in 3s
fix(dsh): restore native file tools and official loading UI
2026-11-04 19:05:21 +08:00

26 KiB
Raw Blame History

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 中填写 Provider ID、API 地址、协议及可选密钥,点击 获取可用模型,勾选后点 添加所选,最后 创建提供商。也可手动添加模型 ID。获取失败会保留表单,便于修正地址或手动填写。已有提供方点击 编辑 可修改其模型目录;保存后即时生效。

模型页面使用官方 Harness 设置与凭据服务:用户设置保存在 dsh/harness-home/profiles/dx-task/cordis.patch.yml,新增的密钥通过官方本地凭据服务保存在 dsh/harness-home/.credentials.yaml;此文件不使用主工具的 DPAPI 格式。主工具预配置的 provider.json 和 DPAPI 密钥仍可加载。应用固定策略作为独立 bundle 提供;应用管理的 dx 提供方随主工具配置完整更新,自定义提供方及其独立凭据保留。旧版生成的 dx 默认模型在迁移时回到当前主工具默认值;原生用户选定且仍有效的模型及自定义提供方默认选择保留。改写配置前逐字节备份,重复启动不重复改写。

在原生模型页为现有 dx 保存密钥后,该提供方作为用户覆盖保留其地址、模型和本地密钥,不再随主工具自动切换。如果当前启用了主工具模型,但旧数据中存在本地 DSH_API_KEY 密钥、却没有对应的有效 dx 配置,DSH 会明确拒绝启动,避免把未知来源的密钥发到当前地址。恢复时先备份整个数据目录,将密钥配置为具有独立凭据引用的自定义提供方;不要只搬运密钥文件。主工具模型未启用时,无关的孤立引用不会阻断独立提供方。不要将凭据文件分发或提交到仓库。

DSH 使用独立原生子窗口承载 WebEngine,切回任务中心后保留原有 Acrylic 玻璃材质;“减少透明度”与系统高对比度等回退规则继续生效。

启动时直接展示官方前端的 HARNESS 加载动画,不再绘制额外的 Qt 加载页面;运行时就绪后进入官方对话界面。

文件、文件夹与 ZIP

点击输入框 + → 文件,在文件选择框中选取文件。上传卡片显示进度,失败可重试;上传成功后可连同问题发送。文本由助手实际读取,图片还需要所选模型支持图片输入。

侧栏的官方工作区入口可选择本机文件夹;也可以在对话中直接提供绝对路径,或用 @ 引用文件。助手可以读取 UTF-8 文本、查看目录中的文件、搜索内容,并切换会话的当前目录。选择文件夹不会自动执行 CAD 或修改工程。

例如:“读取这个文件夹里的说明,搜索失败原因”;或上传 ZIP 后说:“解压附件,读取其中说明文件并告诉我内容”。ZIP 解压到当前目录下新建的 dsh-extracted-* 文件夹,也可指定一个已有输出父目录;返回绝对目录与文件清单,重复解压会创建新目录。解压前校验路径、大小和 CRC,失败不会留下可误认为成功的输出。本轮支持普通 ZIP,不支持加密、多卷及 ZIP64;压缩文件上限 64 MiB、解压总量 256 MiB、最多 10000 项。上传其他格式不等于模型已经能够解析其内容。

模型由本机保存的主工具配置加载;也支持启动进程的 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 加密保存在该配置引用的 provider-key-<版本号>.dpapi 中,启动时自动加载;不写入仓库或 Windows 用户环境变量。旧版无版本号的 JSON 与固定 provider-key.dpapi 组合仍可读取,下次保存时使用新格式。

新格式以 provider.json 的原子替换作为唯一发布点:新密钥先写入独立的不可变版本文件,完整落盘后才发布对应的服务器、模型和密钥引用。保存失败时继续读取完整旧版本,不能将旧服务器地址与新密钥混用。读取到的版本文件缺失、引用不合法或解密失败时明确报错,不回退到其他密钥。已发布的旧密钥版本保留,以便正在读取旧配置的进程完成读取;中断留下的无引用文件不会被自动加载。此格式应由更新后的客户端读取,不支持旧客户端读取新版本配置。

任务操作与能力边界

在对话中创建任务

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

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

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

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

在对话中管理和执行任务

可以直接说“找到电源板任务,把备注改为本周验证,旧料号 A 对应的新料号改成 B”。助手查找真实记录和规则,展示名称、备注、Value 策略及规则变更;同批规则会列出全部受影响任务。更换料号导致的旧封装选择清空、自定义 Value 开启等连带变化也会出现在预览中。确认时若任务已被其他操作修改,旧预览失效,需重新核对。

“复制这个任务到新工程”会复制规则配置和启用状态、备注及 Value 策略,然后打开原生工程选择窗口。确认的是窗口里展示的配置草稿;不会复制执行证据。新工程已有未完成任务时保持原配置。“归档这个任务”只把所选任务移入回收站,保留规则和证据,不永久删除。切换任务只改变任务中心选择,不操作工程。

“检查这个任务能否执行”会核对保存的配置、工程文件可用性、启用规则或位号、失败/中断证据和待释放后台资源,返回具体阻断原因。预检不连接 CAD,不代表许可、备份、替换或保存已经成功。

“按顺序执行这几个任务”或“继续这个任务未完成的部分”会展示真实任务编号、工程路径、启用范围与执行影响,并等待原生确认。一次最多选择 20 个不同任务;执行计划在进入原队列租约后再次核对。新执行在进入执行器前保存运行回执和队列检查点;恢复原运行时重新核对原顺序、冻结计划和已有证据,复用原检查点,不重复已经收尾的项。未保存的位号编辑、待核验中断和未准备的失败重试会阻断执行。

执行中可请求“安全暂停当前执行”,程序只设置当前运行的 StopControl,等待当前项安全收尾;“已请求暂停”与“已经暂停”分别返回。执行回执包含真实保存、失败、未命中和待核验状态。未命中不是已替换保存;确认后中止模型等待也不会撤销已经提交的配置事务,最终结果以持久回执和任务证据为准。

自动异常介入

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

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

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

用户在原执行轮次请求安全暂停或强制结束后,该停止意图会随轮次传递到自动诊断;即使最后一个失败项已收尾、队列结果显示“已结束”,也不会自动准备或执行重试。诊断和证据上报仍可继续。只有用户重新确认执行新轮次,才会创建新的执行控制对象;原轮次的停止记录不会被清除。

  • 普通对话除七项任务能力外,开放本地文件读取、图片读取、文件发现与内容搜索、切换目录和 ZIP 解压;附件、文件引用、文件夹选择使用官方界面。自动异常诊断会话仍只允许事件快照。通用 Shell、插件安装、子智能体及模型直接 CAD 写入工具未注册;任务修改和工程执行继续走任务中心原有确认。
  • 刷新任务上下文重新发布当前任务快照。
  • 手动点击 准备失败项重试须在任务中心确认,并通过现有重试按钮的状态检查;该按钮只准备重试。自动介入使用上文限定的一次重试闭环。
  • 安全暂停须确认且当前确有执行控制器,使用原队列的安全边界暂停。
  • 跨任务、过期版本、未知参数、未知动作及同一版本的重复动作请求均拒绝。网页请求必须经过本机 Harness 的登录与 Origin 校验。
  • 规则修改与工程写入通过上述原生确认和现有任务中心服务;不确定状态恢复仍从任务中心原流程进行。模型不能提供“已确认”参数来跳过确认,UI 显示“已提交”不表示工程已保存或核验成功。

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

右侧任务监管

右侧保留官方三栏界面,在“任务监管”内部提供 概览、运行、影响、排期、经验、工单、用量 七个页签。默认进入概览。各页按钮直接请求任务中心,原生窗口负责需要确认的操作;不需要发送特定模型提示或记忆工具名。

概览页还显示 DSH 运行健康和最近自动处理决策。健康状态只检查本地配置、任务中心后台工作线程、状态目录、工单缓存和凭据来源,不会为了探活调用模型、CAD 或远端写接口。决策记录包含事件、证据引用、门禁、授权范围、实际结果和人工接管标记,并通过追加式 SHA256 链保存;模型文字、工单关闭和“已解决”描述都不会单独成为修复证明。

审计链损坏或不可读时,概览会明确显示审计错误并清除过期的决策展示,原日志保持不变,严格校验和拒绝向损坏链追加的规则继续生效。历史、健康、工单和排期刷新仍可使用;已授权排期继续经过原有时间、范围、依赖和执行门禁,不由审计读取异常隐式停用。请导出证据后人工核对损坏日志。

运行与重启恢复

运行页显示实际执行所属任务、运行编号、阶段、耗时、当前进度、已保存/失败/未命中数量及安全暂停请求。即使左侧选中其他任务,活动执行仍显示真实所有者。请求暂停后,执行器在当前项安全收尾后停止;等待期间仍显示执行中。

最近一次执行回执独立保留,随后查看任务列表不会覆盖它。执行历史根据本地持久记录和任务证据判断可否恢复;重启只展示记录,不自动重放。点击 核对并恢复原队列 后仍须原生确认。计划变化、缺少或损坏检查点、未核验中断、失败项等会阻断恢复;待核验结果从任务中心原流程处理。

已结束运行的保存、失败和未命中合计来自持久回执;任一任务缺少某项计数时,该项合计仍显示“未报告”,不会把未知当作零。恢复过程报错时保留上一份任务证据和队列基线。若已产生核验通过的进度,仅在异常收尾时完整核对通过后更新进度基线并留存差异,以便再次确认接续原队列。旧终态变化、失败、未核验结果、计数回退或核对读取失败时不更新基线;停机后新增的证据变化仍会阻断恢复。

恢复执行后若在新回执写入前退出,原队列中新增的已核验进度可继续接续,不会因旧暂停回执的计数较小而重复执行或永久阻断。原先已收尾任务的证据变化、计数回退,以及完成检查点缺少匹配完成证据,仍会阻断。执行后核验只在队列完成且失败为零时报告就绪;未完成或有失败时明确显示待核验,实际保存与未命中数量分别保留。

原生任务中心的当前任务执行,以及不超过 20 个任务的原生批次,也写入这套运行记录。超过 20 个任务的原生分组继续使用原分组检查点,不加入 DSH 合并运行历史;不要把该分组当作可以从本页恢复的合并运行。

影响范围

影响页只读取保存的计划,不连接 CAD 或重新采集。精确位号计划逐行显示工程、图页、RefDes、稳定 UID、新旧料号、旧与拟议 Value、Cell 和 NC 策略;禁用行明确标记,元件数量只统计已启用目标。

仅有料号映射时显示映射范围,匹配元件数量、位号和 UID 均为未知;规则数量不能当作元件数量。“保留 Value”和自定义 Value 展示已知值;“复制元件库标签”需要执行时读取,预览不会把新料号冒充实际 Value。预检和执行确认也包含这个范围说明。

一次报告最多 20 个任务、显示 100 行,超过部分列出省略数量。完整范围指纹和计划哈希仍包含省略行;截断展示不缩小实际执行范围。

排期

排期页可为当前任务打开原生排期窗口,设置优先级、不早于时间、可选截止时间和依赖任务。时间必须带时区,保存为 UTC、界面按本机时区显示;截止时间用于展示计划要求,不表示到时强制中断。依赖须实际完成且无失败、暂停或待核验证据。调度先比较优先级,再比较执行时间。

保存和取消均经原生确认。未勾选未来执行授权的排期等待手动确认;只有在原生窗口明确勾选“授权到时空闲自动执行并保存以上工程”后,才可在主工具打开、执行器空闲时自动执行冻结范围。定时检查不调用模型,也不是关闭应用后的后台服务。

启动前重新检查预检、未保存编辑、冻结计划和资源门禁;忙碌、手动暂停任务、依赖未完成、计划变化或不确定结果都会阻断。排期领取持久且互斥,执行中断或重启后不自动重新领取并重放。需要继续时核对运行历史与原任务证据。

应用退出后仍显示“已领取”的排期,可点击 核对并收尾失联排期。原生确认后检查执行占用与待释放资源,再按已有持久回执收尾;没有完成回执时标记中断。此操作不会执行工程,原运行记录继续保留供人工核验与恢复。仍有活动执行或资源未释放时拒绝收尾。

排期页显示近期审计与归档数量。近期事件以 5000 条为保留目标,累积到 6000 条后,每次刷新最多将 1000 条较早事件完整写入数据目录的 dsh/schedule-audit/,避免每条事件产生一个归档碎片;JSONL 文件名包含 SHA256,数据库保留归档清单。只有文件写入并校验成功后才移出近期表,不会静默丢弃历史事件。归档文件缺失、损坏或访问失败时单独显示降级,并保留其余监管功能;请备份清单和归档文件一起转移。

经验与工单

经验页按异常代码或诊断关键词检索本地事件,展示诊断/复盘、尝试次数、处理结果、后续建议和证据引用。优先呈现已验证经验,再比较异常代码精确匹配和记录新旧。只有独立持久化核验及证据证明队列完成、失败为零、无中断且无暂停,才显示“已验证”。模型声称修复、工单关闭或无证据建议保持未验证。

相关经验以有界数据提供给诊断,不授予执行权限,也不增加一次重试额度。建议中的下一步仍需核对当前工程和已有门禁。

工单页只读同步既有事件绑定工单的状态和有限评论,显示上次同步、错误和证据入口;无需安装 Git。请求先核对固定服务器、仓库、工单编号及事件标记,再使用对应身份。不提供任意 URL、写评论或修改远端工单操作。工单关闭仅表示服务端反馈,不等于本地 CAD 已修复。定期同步不变时不打扰对话。

模型用量与响应设置

用量页保留官方 Token 显示,并列出各会话由实际提供方事件报告的输入、输出、缓存及总 Token、生成耗时和错误/超时状态。未报告的用量显示“未报告”,未知价格显示“未提供”;不会按零费用估算。重启可从原生会话历史恢复已记录 Token,历史生成耗时无法重建时保持未知。

响应超时可配置为 15–600 秒,默认 90 秒,针对每一次提供方流式响应;等待原生确认或业务工具执行的时间不计入该响应定时器。停止生成使用原生会话取消接口,只停止模型生成,不会假装已撤销确认过的配置事务或工程执行;工程安全暂停仍使用运行页的按钮。

模型上下文设置范围为 2,000–128,000 Token,默认 16,000。这是触发 Harness 原生上下文压缩的阈值,不是请求大小的硬上限;有安全可压缩区间时由原生逻辑压缩,保留任务身份、工具调用配对和可重建的记录。无法安全压缩或缺少原生能力时保留实际状态,不承诺强制截断。当前版本读取可在未变化的修订内复用缓存,完整审计依据仍保留在本地。

诊断证据与 Git 工单

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

工单默认提交到 https://git.simgreek.com/Skyworth_Digital_Hardware/dxdesigner-part-replacement。生产环境可配置固定仓库的中转地址、安装实例标识、实例证明和事件幂等键:参考 broker 分发长期可吊销的 write:issue 凭据,不提供自动到期保证。令牌只在客户端内存中使用,不进入模型、客户端缓存、日志或工单正文。中转缓存默认最多 1024 项、300 秒,缓存到期不会使 Git token 失效,仍需服务端吊销和轮换,健康中心会明确标记降级。未配置中转时可使用本机 Git credential 或预置令牌;已配置中转但不可用时返回错误。预置账户必须是非管理员、仅绑定本仓库的 write:issue 权限。

排期创建时勾选自动启动并经原生窗口确认,才保存将来执行授权。到期后仍检查原任务范围、计划哈希、依赖和执行门禁;未授权排期需要即时确认。每次派发及结果保存在 dsh-state.sqlite3 的 schedule_events,可在排期页查看。派发事件与领取排期在同一事务,写入失败不会启动。此表为持久化运行审计,与异常决策的 SHA256 链分别记录,不声称具备哈希链防篡改能力。

开发/验收预填资源为 integration/dsh/issue-bootstrap.json,已加入 Git 忽略;生产打包不应依赖它,而应配置中转地址和实例注册流程。管理员侧的账户密码和令牌恢复资料单独保存在本机 DPAPI 文件,不能随包分发。没有中转或明确兼容凭据时,工单保留本地证据并显示待提交状态。

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

参考中转服务使用环境变量 DSH_ISSUE_SERVER、DSH_ISSUE_REPOSITORY、DSH_ISSUE_TOKEN、DSH_BROKER_SECRET 启动 python tools/dsh_issue_broker.py,提供 GET /healthz 和 POST /v1/issue-token。这是服务端参考实现,正式部署应放在受控 HTTPS 服务后并配置实例注册、密钥轮换、访问日志脱敏和网络限流。

提交前按事件标记查重,成功后上传脱敏证据附件并在任务监管显示工单链接;提交、权限或上传失败时保留为“工单待完整提交”。可以点击 打开证据目录 或 重新提交工单;重试工单不会重新执行 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。

七项监管能力、重启恢复、用量与真实只读工单的验证范围见 DSH 监管与排期验证记录。其中执行验收使用隔离 fixture 与受控未命中执行器;不据此声称真实用户工程完成替换。

专用工单身份的权限检查: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 '<模型配置目录>'。