docs: document DSH assistant in README #13

Merged
abaishu0730 merged 1 commits from codex/readme-dsh into main 2026-11-02 09:20:16 +08:00
Owner

更新 README,补充 DSH助手的原生 DeepSeek Harness 三栏界面、任务创建与执行、异常介入、恢复、工单、能力边界、配置和验证命令。

仅修改 README.md,链接检查和凭据扫描通过。

更新 README,补充 DSH助手的原生 DeepSeek Harness 三栏界面、任务创建与执行、异常介入、恢复、工单、能力边界、配置和验证命令。 仅修改 README.md,链接检查和凭据扫描通过。
abaishu0730 added 1 commit 2026-11-02 09:14:10 +08:00
abaishu0730 merged commit df250e04ba into main 2026-11-02 09:20:16 +08:00
Author
Owner

回审已合并 PR #13(docs: document DSH assistant in README)

commit df250e0(1 文件 +24,README 的 DSH 助手章节)。行号按 origin/main(aff228e)复核。

结论:整体可信,但有 3 处描述与实现/当前界面不一致;其中第 1 条已在后续 PR 修正,建议顺手把第 2、3 条也改掉(P3)

P3-1 "工具设置 → DSH工具" 这条配置入口不成立(已在 main 上被修正)

  • PR13 新增原文:首次接入可在 **工具设置 → DSH工具** 中配置 OpenAI 兼容端点和模型。
  • 当前 origin/main:README.md:29 已经改成 工具设置 → 模型 → 添加模型提供商 → 自定义模型 API,说明入口后来被纠正。
  • 结论:历史问题;无需再改代码,但说明这种"菜单路径"型文档很容易过期,建议在 docs/user/dsh-ai-supervision.md 里用截图/版本号锚定,或改为"设置 → 模型(若界面有变化以 --doctor 输出为准)"。

P3-2 "不写入…环境变量" 的措辞不准确

  • README 写:密钥使用 Windows DPAPI 保护,不写入仓库或环境变量。
  • 实现上:dsh/availability.py 在启动 node 检查与 DSH 子进程时会把 DSH_API_BASE/DSH_MODEL/DSH_API_KEY 放进子进程 env(env.update(...) 后 subprocess.run(..., env=env);dsh/native_runtime.py:launch_environment 同理)。
  • 所以准确说法是"不写入系统/持久环境变量,不写入仓库;运行时通过子进程环境变量传递"。建议改这句,避免安全同事误读。

P3-3 "顶部固定显示两个入口" 需要确认

  • README 原文与 main 现状都写"两个入口:左侧任务中心、右侧 DSH助手";子代理指出 PR15 之后实际有三个入口。
  • 我只核对了 README 文本,没有启动 GUI 数入口;如果确实是三个,请更新这句话(这类"入口数量"最容易被后续 UI 改动遗漏)。

已核对属实的部分

  • Ctrl+Shift+D、--doctor 命令、tools/verify_dsh_runtime.mjs、DPAPI 凭据路径、issue-bootstrap.json 不入库的提醒——均与代码/仓库一致。
  • "AI 不能直接写 CAD、不能跑 Shell、不绕过确认门禁"与当前 start.mjs 的工具白名单(7 任务 + 6 文件工具、无 tool-bash/tool-pwsh)一致。

验证记录

  • 只读核对:PR13 的 README diff、origin/main:README.md:15-38、integration/dsh/start.mjs:39-47/246-250、dsh/availability.py:55-70、dsh/native_runtime.py 的 launch_environment。
  • 未启动 GUI、未跑 pytest。

未验证边界

未实际打开"工具设置"确认菜单层级与入口数量;以当前 README 与 start.mjs 的插件开关为依据。

# 回审已合并 PR #13(`docs: document DSH assistant in README`) commit `df250e0`(1 文件 +24,README 的 DSH 助手章节)。行号按 `origin/main`(`aff228e`)复核。 ## 结论:整体可信,但有 3 处描述与实现/当前界面不一致;其中第 1 条已在后续 PR 修正,建议顺手把第 2、3 条也改掉(P3) ## P3-1 "工具设置 → DSH工具" 这条配置入口不成立(**已在 main 上被修正**) - PR13 新增原文:`首次接入可在 **工具设置 → DSH工具** 中配置 OpenAI 兼容端点和模型`。 - 当前 `origin/main:README.md:29` 已经改成 `工具设置 → 模型 → 添加模型提供商 → 自定义模型 API`,说明入口后来被纠正。 - 结论:**历史问题**;无需再改代码,但说明这种"菜单路径"型文档很容易过期,建议在 `docs/user/dsh-ai-supervision.md` 里用截图/版本号锚定,或改为"设置 → 模型(若界面有变化以 `--doctor` 输出为准)"。 ## P3-2 "不写入…环境变量" 的措辞不准确 - README 写:`密钥使用 Windows DPAPI 保护,不写入仓库或环境变量`。 - 实现上:`dsh/availability.py` 在启动 node 检查与 DSH 子进程时会把 `DSH_API_BASE/DSH_MODEL/DSH_API_KEY` 放进**子进程 env**(`env.update(...)` 后 `subprocess.run(..., env=env)`;`dsh/native_runtime.py:launch_environment` 同理)。 - 所以准确说法是"不写入**系统/持久**环境变量,不写入仓库;运行时通过子进程环境变量传递"。建议改这句,避免安全同事误读。 ## P3-3 "顶部固定显示两个入口" 需要确认 - README 原文与 main 现状都写"两个入口:左侧任务中心、右侧 DSH助手";子代理指出 PR15 之后实际有三个入口。 - 我只核对了 README 文本,没有启动 GUI 数入口;如果确实是三个,请更新这句话(这类"入口数量"最容易被后续 UI 改动遗漏)。 ## 已核对属实的部分 - `Ctrl+Shift+D`、`--doctor` 命令、`tools/verify_dsh_runtime.mjs`、DPAPI 凭据路径、`issue-bootstrap.json` 不入库的提醒——均与代码/仓库一致。 - "AI 不能直接写 CAD、不能跑 Shell、不绕过确认门禁"与当前 `start.mjs` 的工具白名单(7 任务 + 6 文件工具、无 `tool-bash`/`tool-pwsh`)一致。 ## 验证记录 - 只读核对:PR13 的 README diff、`origin/main:README.md:15-38`、`integration/dsh/start.mjs:39-47/246-250`、`dsh/availability.py:55-70`、`dsh/native_runtime.py` 的 `launch_environment`。 - 未启动 GUI、未跑 pytest。 ## 未验证边界 未实际打开"工具设置"确认菜单层级与入口数量;以当前 README 与 start.mjs 的插件开关为依据。
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Skyworth_Digital_Hardware/dxdesigner-part-replacement#13