Files
dxdesigner-part-replacement/docs/user/dsh-ai-supervision.md
阿白叔 cffef93b37
Core regression / Python core, intervention UI and release configuration (push) Successful in 4m35s
Core regression / JavaScript syntax (push) Successful in 6s
Core regression / Python core, intervention UI and release configuration (pull_request) Successful in 3m54s
Core regression / JavaScript syntax (pull_request) Successful in 4s
fix: persist incident isolation and atomically publish netlist evidence
2026-11-13 17:28:05 +08:00

30 KiB
Raw Permalink 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 策略,然后打开原生工程选择窗口。确认的是窗口里展示的配置草稿;不会复制执行证据。新工程已有未完成任务时保持原配置。“归档这个任务”只把所选任务移入回收站,保留规则和证据,不永久删除。切换任务只改变任务中心选择,不操作工程。

可要求“为当前任务导入 BOM”:确认后打开任务中心原生 Excel 多文件选择,随后由原工具校验和暂存预览。助手仅报告已交由导入流程,不宣称已经导入或保存;请核对报告并手动保存计划。请求必须指向当前已选中并加载的任务,模型不能代选文件或跳过原生流程。任务详情和影响预览按已保存的逐项 Value 策略显示,包含继承、保留、Part Label、料号及自定义值。

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

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

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

自动异常介入

顶部常驻 AI 自动介入 滑动开关,绿色为开启、灰色为关闭,支持鼠标点击和空格键切换,默认开启,重启后保留设置。关闭后不再接收新的自动异常介入,并清空尚未处理的队列;当前诊断继续保存证据,但不再发起自动重试。已经开始的工程执行继续遵循原来的暂停和强制结束按钮,关闭 AI 开关不会停止工程。

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

以下返回结果或状态也会自动介入,无需等待抛出异常:BOM 校验未通过、无法生成计划;后台资源未确认释放、清理后仍有残留、资源状态读取失败;执行预检不通过;任务创建、对话任务操作和监管记录读取失败。BOM 会携带失败行、原因及计数,预检会携带具体任务和阻断项,资源事件会携带自有资源记录。trigger.json 保存对应的脱敏证据。

后台操作及任务/资源查询超过约两分钟没有可观察进展,会自动创建只读诊断。它使用触发时缓存的任务快照和独立工作线程,避免再次等待被阻塞的服务;原操作仍可继续或按原按钮暂停。正常进展恢复后结束本轮停滞事件,再次停滞可重新介入。等待用户确认、用户正常取消和正常执行中占用的 CAD 资源不作为故障。该检测针对后台工作,不能在主界面事件循环或整个进程完全冻结时保证弹出对话。

同一来源、任务和错误的持续阻塞只报告一次,恢复正常后解除去重。关闭开关会撤销待处理介入;重新开启时检查仍存在的阻塞。BOM 已完成或阻塞已消失时,会取消尚未启动的旧事件。全局资源事件的证据与工单按钮不受当前选中任务影响。

模型等待、复盘、工单上报、配置检查和监管读取使用独立工作通道,不占普通任务执行通道。实际重试或清理前才申请执行权,并在核验完成后释放;新任务已启动、原任务证据改变或存在未保存计划时,旧建议不执行、不等待抢占、不自动重新排队,证据仍保留。旧诊断结束不会暂停或清掉后来任务的控制状态。只读查询晚到的预览也会再次检查当前执行状态,避免在任务运行中弹出确认窗口。

资源释放故障允许 AI 建议一次 清理后台资源:通过原资源服务检查空闲队列、租约及进程身份,清理后独立重新读取待释放记录。只有记录为空且无核验错误才显示已解决;清理失败或仍有残留,继续复盘、保存证据并转工单。资源清理不代表工程执行成功,也不会自动接续 CAD 队列;原运行的暂停和强停意图保留。

没有关联任务的应用异常也会创建诊断对话、保留日志证据,但不会自动执行工程操作。用户取消和助手自身启动失败不触发自动介入,避免取消被误判或启动错误循环。不同事件使用独立会话,同一事件的诊断和复盘沿用该会话。

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

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

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

  • 普通对话保留官方 Standard 的文件读写/编辑、PowerShell/Shell、goal、jobs、子智能体、技能及上下文压缩能力,另有七项任务工具与 ZIP 解压;附件、文件引用、文件夹选择使用官方界面。普通默认 workspace-write,启动前设 DSH_PERMISSION_MODE=read-only 并重启可切换为官方只读策略。任务工具的修改/执行继续经过原生确认;普通 Shell 的实际本机能力不由这套任务门禁隔离。
  • 自动异常诊断与复盘仅可执行绑定事件的 dx_task_snapshot,通过运行时工具 guard 拒绝其他工具,不依赖提示词约定。快照不是任意文件读取入口。关闭 AI 自动介入 控制自动诊断;普通会话的工具权限继续由 Harness 策略控制。
  • 新建诊断使用持久会话身份,重启后限制仍有效;快照缺失或损坏时明确报错,不读取另一个当前任务。旧诊断仅在程序事件记录保留 session_id 时可可靠迁移;未留身份、记录不可读的旧历史不保证迁移,不从用户标题或对话文字猜测权限。单个坏旧记录不会阻断普通 Harness 启动。
  • 插件管理服务和官方设置界面可用;官方 Standard 的模型插件安装工具仍默认禁用。没有把普通会话锁回旧的 13 项固定工具集合,也不宣称模型默认拥有插件安装工具。
  • 刷新任务上下文重新发布当前任务快照。
  • 手动点击 准备失败项重试须在任务中心确认,并通过现有重试按钮的状态检查;该按钮只准备重试。自动介入使用上文限定的一次重试闭环。
  • 安全暂停须确认且当前确有执行控制器,使用原队列的安全边界暂停。
  • 跨任务、过期版本、未知参数、未知动作及同一版本的重复动作请求均拒绝。网页请求必须经过本机 Harness 的登录与 Origin 校验。
  • 规则修改与工程写入通过上述原生确认和现有任务中心服务;不确定状态恢复仍从任务中心原流程进行。模型不能提供“已确认”参数来跳过确认,UI 显示“已提交”不表示工程已保存或核验成功。

Harness 使用任务中心数据目录下独立的 dsh/harness-home 保存会话和设置,浏览器偏好在 dsh/browser;不加载个人 Harness profile 或 Codex 凭据。服务只监听回环地址,遥测关闭;关闭主工具时先结束所属运行时。自动诊断的工具限制由应用 guard 执行;普通文件/Shell 沿用官方 Harness 权限策略与实际运行后端。

右侧任务监管

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

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

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

运行与重启恢复

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

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

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

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

原生任务中心的当前任务和分组批次均写入统一执行记录;任务数量不再决定使用另一套生命周期。影响预览可截断显示,冻结范围、检查点与恢复核对仍包含完整任务集合。

影响范围

影响页只读取保存的计划,不连接 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,历史生成耗时无法重建时保持未知。

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

模型上下文默认 0(使用原生自动压缩),可显式设置 2,000–128,000 Token 阈值。这是触发 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 '<模型配置目录>'。