Files
阿白叔 488bf027cc
Core regression / Python core, intervention UI and release configuration (push) Successful in 16m20s
Core regression / JavaScript syntax (push) Successful in 11s
Core regression / Python core, intervention UI and release configuration (pull_request) Failing after 11m11s
Core regression / JavaScript syntax (pull_request) Successful in 7s
feat: update DeepSeek Harness and support runtime upgrades
2026-11-20 15:43:58 +08:00

202 lines
31 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 '<模型配置目录>'`。