# DSH助手 ## 在工具中使用 主工具顶部固定显示左右两个入口:左侧 **任务中心**,右侧 **DSH助手**,单击直接切换,无需展开菜单。助手也可按 `Ctrl+Shift+D` 打开;切回任务中心再进入助手时保留同一个网页、会话和未发送草稿。右侧“任务监管”读取主工具当前选中的任务。 这里直接运行 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的官方前端与运行时,通过 Qt WebEngine 嵌入主窗口。当前 npm 版本以 `integration/dsh/package.json` 为准。官方三栏框架、原生 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 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 ``` 源码工作区可从 npm 更新 DSH。先退出任务中心,运行更新命令,再重新打开任务中心。 ```powershell powershell -ExecutionPolicy Bypass -File tools/Install-DshRuntime.ps1 -Version latest ``` 将 `latest` 换成 `0.2.2-rc.5` 这样的完整版本号即可安装指定版本。脚本先在临时目录启动候选运行时并验证任务插件,通过后更新依赖声明、锁文件和实际依赖。更新成功时会打印 `build/dsh-update-…` 路径,其中 `previous` 保存旧运行时,`verification/report.json` 记录验收结果。便携版随应用打包 DSH,通过重新构建的应用发行包更新。 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。 七项监管能力、重启恢复、用量与真实只读工单的验证范围见 [DSH 监管与排期验证记录](../testing/2026-10-30-dsh-operations.md)。其中执行验收使用隔离 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 '<模型配置目录>'`。