From efe7e8c8133ef90cdf79deae1a5fd660f8164069 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=98=BF=E7=99=BD=E5=8F=94?= <11794527+absfan@user.noreply.gitee.com> Date: Mon, 2 Nov 2026 09:08:30 +0800 Subject: [PATCH] docs: document DSH assistant in README --- README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/README.md b/README.md index cd664a9..db1630c 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,30 @@ Beta 4 面向停止与资源收尾复测:普通暂停等待当前项保存核 本版提供[目标封装选择](docs/user/target-cell-selection.md):目标封装可留空,此时工具不主动覆写封装,可后续与中心库同步;需要指定时,在料号规则中读取并选择合法封装。BOM 保持原 11 列。 +## DSH助手:在工具内使用 AI + +本项目已将 **DSH助手** 集成到任务中心主窗口。顶部固定显示两个入口:左侧 **任务中心**、右侧 **DSH助手**,单击即可切换,无需展开菜单;助手保留 DeepSeek Harness 官方三栏界面、SVG 动画、模型选择、会话和未发送草稿。也可以使用 `Ctrl+Shift+D` 打开助手。 + +DSH助手围绕真实任务中心工作,支持: + +- 用自然语言创建任务、修改规则、复制或归档任务;工程选择和提交仍由原生窗口确认。 +- 查询任务快照、执行预检、影响范围和实际执行历史。 +- 在原生确认后按冻结范围执行任务,支持安全暂停、原队列恢复和排期授权。 +- 发生异常时自动介入,收集脱敏证据链、保留诊断记录,并在需要时提交受限 Git 工单。 +- 在右侧任务监管中查看运行、影响、排期、经验、工单和用量;审计损坏、证据缺失和未知计数会明确显示。 + +AI 不能直接写入 CAD、运行 Shell、访问任意文件或绕过确认门禁。自动异常诊断为只读;不确定执行不会自动重放,恢复必须重新核对冻结计划、检查点和业务证据。未配置模型时仍可使用任务监管和本地恢复功能,但不会产生真实模型回复。 + +模型配置保存在本机任务中心数据目录,密钥使用 Windows DPAPI 保护,不写入仓库或环境变量。首次接入可在 **工具设置 → DSH工具** 中配置 OpenAI 兼容端点和模型;开发环境也可通过 `DSH_API_BASE`、`DSH_MODEL`、`DSH_API_KEY` 临时提供配置。不要把 API key、Git 凭据或 `integration/dsh/issue-bootstrap.json` 提交到 Git。 + +详细的能力边界、异常介入、证据链、排期和工单说明见 [DSH助手使用与监管说明](docs/user/dsh-ai-supervision.md)。源码环境可用下面的命令检查运行时门禁: + +```powershell +$env:PYTHONPATH = 'src' +python -X utf8 -m dx_productivity.dsh --doctor +node tools/verify_dsh_runtime.mjs +``` + ## 图文教程 按下面 **13 步**,完成“创建任务 → 填 BOM → 导入校验 → 保存计划 → 替换 → 查看结果”。本例有两个工程 `Audio_D2128`、`Audio_T605A`,各自只替换 `RV05`,保留同料号下的 `RV11`。