DSH for VS Code

项目地址：https://github.com/zwb8926/deepseek-harness-vscode

在 VS Code 中使用 DeepSeek Harness。

本扩展自行启动并管理 dsh web 服务，并把 GUI 拆成两块嵌入 VS Code

本次更新（版本 2026.9.30）：

内嵌 dsh 升级到 @deepseek-ai/dsh@0.2.0-rc.2（自 0.1.7-rc.1，跨到 0.2.0 线；该版本同时是 registry 的 latest 与 next。依赖树 277 → 288 个包，前端拆分补丁随包重建；本扩展不联网自动更新，内置哪份就用哪份）
0.2.0 兼容性复核：无需改代码。适配器依赖的挂点全部健在（_sidebarCol / _centerCol / _rightbarCol / _settingsArea / _railMark / _navCell / _navTitle / _sessionRow / _rowActions / _overlay / dockkit 条带，AppFrame 样式模块前缀仍是 pI_x6G_，dsh.sessions.current 键与载荷不变）
验证：npm run smoke 与 npm run verify（7 个离线套件 + 3 个实时套件）对内置的 0.2.0-rc.2 全绿 —— 单标签页切换、设置反复开关、外壳执行与握手、接管未打补丁的服务、工作区/会话/主题等一整套 API、设置写入链路与内测声明确认、打包产物校验并从解压树启动、两种分屏不变式（真浏览器）、每标签页会话固定、56 条冷投影会话下不再出现「未命名会话」

已知问题 / 排查

「预览版说明 / 内测声明」弹窗点了没反应、GUI 里改设置不生效 —— 同一个根因：GUI 的设置写入被 dsh 拒绝，而声明只能靠写入来确认。

症状：打开就弹「预览版说明」（0.1.7 叫「内测声明」），点「继续」只出现「暂时无法保存确认状态，请重试」；同时设置面板里的任何改动都不落盘。
服务端返回：settings/update → ok=false，settings/rejected: "dsh: profile reload requires the root Include entry"。
根因：dsh 0.1.7 把根级 settings.yaml 迁移成 profiles/web/ 这套 profile 布局（旧文件被改名为 settings.yaml.imported），服务没能注册新布局需要的 root Include entry，于是设置写入被拒（能读不能写）。
扩展已直接屏蔽该声明：适配器识别 预览版说明 / Preview Notice / 内测声明（按 aria-label 或正文开头，中英双语）后把它隐藏，并顺带点击一次「继续」以便正常部署记录确认；用 MutationObserver + 轮询兜底，重新渲染也会再隐藏。只认这一个对话框 —— 设置弹窗等真实对话框不受影响（npm run verify -- --only notice 会同时验证"声明被隐藏"和"设置弹窗照常打开"）。
想在服务端也记下确认（可选）：把下面这条写进 ~/.dsh/profiles/web/cordis.patch.yml 再重启服务。注意版本号必须与 dsh 期望的一致（0.2.0 期望 2026-09-28.1，0.1.7 是 2026-08-13.1；升级 dsh 后旧值会失效、声明会再次出现）。
处理：先重启一次 dsh 服务（重载 VS Code 窗口，或状态栏/命令里的「重启服务」）。多数情况下新进程会正常注册，之后设置可写、声明点一次即关。
若重启后仍被拒：扩展会自己给出判定 —— 输出面板里会出现 settings: the running server REJECTS settings writes 与 settings-probe: a FRESH sibling …。兄弟进程接受同一写入 ⇒ 是那个进程启坏了（再重启）；兄弟进程也拒绝 ⇒ 问题在 home/CLI 侧，而不是某个进程的状态，此时可按下面的方式手动落设置。
手动落设置（推荐的兜底）：把要改的项写成 ~/.dsh/profiles/web/cordis.patch.yml 里的一条补丁，然后重启服务即生效。文件本身是一行 []（空数组）时，用这个整份内容替换：
```
# 一条补丁 = id 指向某个插件，config 覆盖它的设置命名空间
- id: ui-theme
  name: "@deepseek-ai/dsh-client-ui-theme"
  config:
    preference: dark          # light | dark | system —— 就是设置面板里的主题
- id: ui-settings-general
  name: "@deepseek-ai/dsh-client-ui-settings-general"
  config:
    welcomeNoticeVersion: 2026-09-28.1   # dsh 0.2.0 期望的值；让「预览版说明」不再出现
```
- id / name 用插件 id 与其包名。已核实的两个：ui-theme → @deepseek-ai/dsh-client-ui-theme、ui-settings-general → @deepseek-ai/dsh-client-ui-settings-general；config 下的键就是设置面板里的字段名。
- 全部 id ↔ 包名对照可从随包发布的 node_modules/@deepseek-ai/dsh-web-app/cordis.patch.yml 里查到（每条 - id: … / name: …）；现成的命名空间与字段可从 ~/.dsh/settings.yaml.imported 看到（0.1.7 迁移前的旧设置文件，结构就是 命名空间: { 字段: 值 }）。
- 改完记得重启服务（补丁在启动时读取）。
- 值不要加引号也可以；中文/特殊字符请使用引号。
上游问题：这条链路在 dsh 侧（profile reload 状态），本仓库已整理了一份最小复现报告，见 docs/upstream-profile-reload.md。
附带说明：这个确认字段的命名空间与版本号都随 dsh 版本变过（ui-onboarding → ui-settings-general；2026-08-13.1 → 2026-09-28.1），所以每次升级 dsh 后声明都可能再弹一次，这属于正常现象（点一次即可，或交给上面的屏蔽）。
与分栏适配无关：不带 ?dshPanel 参数的原生 GUI 表现完全相同（npm run verify -- --only notice 会跑这条链路的对照与验收）。

降级说明

若 dsh 安装在扩展无法写入的位置（或前端结构在后续版本再次变化、补丁探测不到稳定挂点），扩展会：

状态栏与侧栏保持可用（侧栏是原生列表，不依赖 GUI 分栏）；
编辑器标签页改为嵌入完整 GUI（不传 ?dshPanel），GUI 自带侧栏在窄于 1024px 时会自动收成图标栏；
「Open in Browser」随时可用。

DeepSeekHarness for VS Code

zwb8926

DSH for VS Code

已知问题 / 排查

降级说明