dsh-client-open-in-vscode

DeepSeek Harness（DSH）Web 界面的插件：点击聊天 UI 里的文件路径，在已打开的、工作区匹配的 VS Code 窗口中打开该文件。

功能

捕获阶段拦截以下元素的点击：

UI 元素	识别方式
工具卡片路径（Write/Edit/Read 等）	`button.*_fileLink`，文本即路径（可为工作区相对路径，按当前会话 cwd 补全）
「产物」chips	`[data-produced-files-row] button[title]`
正文里的文件提及链接	`title` 为绝对路径的 a/button/[role=link]

命中后 POST /plugin-open-in-vscode → 宿主执行 code --goto --reuse-window ，VS Code 内部按工作区归属路由窗口并提到前台。

Edit/Write 行为（v0.5）：点击文件变更行（Edit/Write 等）的路径时，打开 diff 窗口。已完成的改动优先走全文件 diff——与 VS Code 自带 agent 变更审查（Open Changes / SCM）同语义：git 提供 HEAD 版本（左临时文件），磁盘真实文件作右侧，即社区标准的 git difftool $LOCAL/$REMOTE 配方（语义同 VS Code 官方 agent 变更审查）。未跟踪的新文件与空左侧对比（整文件显示为新增）。行数据里的 hunk 片段（改动 ± 上下文行）只作两种回退：运行中/失败的调用（意图预览，改动尚未落盘）与非 git 目录。临时文件 10 分钟后清理；没有 diff 数据的行（Read/Bash 等）仍为直接打开。

多窗口时 diff 的左侧是临时文件（不属任何工作区），窗口路由回落到同 authority 的最近活跃窗口；右侧是真实文件，diff 标题会显示真实路径。

多窗口时的路由规则（VS Code 窗口管理器行为）：先按 remote authority 过滤候选窗口（只考虑连接到同一主机/本地的窗口），再看文件的绝对路径落在哪个已打开工作区文件夹内——多根 workspace 按根目录声明顺序取第一个命中，多个单文件夹窗口都包含该文件时取路径最深的那个；都不命中时回退到同 authority 的最近活跃窗口。会话 cwd 只用于把相对路径补全成绝对路径，不参与窗口匹配。

Alt+点击：绕过拦截，走产品原逻辑
操作后页面底部有 toast 反馈（成功/失败）

安全

路由与框架 /api 同款信任闸门：Host 必须是 loopback（防 DNS rebinding）、Sec-Fetch-Site: cross-site 拒绝、携带 Origin 时必须与 Host 一致（防网页 drive-by POST）。也就是说其它网站无法借你的浏览器触发本机 VS Code 打开文件；路径仅接受绝对路径且不经 shell（execFile 参数数组）。

为什么不用 `vscode://file/...`

v0.1 用锚点跳转 vscode:// 协议 —— 在真实浏览器里没问题，但 DSH GUI 常跑在 VS Code webview 里，webview 导航到该协议会直接黑屏。v0.2 起改为宿主侧 code --goto，webview 安全。

安装

假设 DSH_HOME 为 ~/.dsh（默认值）：

复制包到 web profile 的 node_modules：

cp -r dsh-client-open-in-vscode ~/.dsh/profiles/web/node_modules/

编辑 ~/.dsh/profiles/web/cordis.patch.yml，加入：

- insert:
    - id: ui-open-in-vscode
      name: dsh-client-open-in-vscode

重启 dsh web（本插件的 Host 半需要在启动时注册 HTTP 路由，仅刷新页面不够）。

验证组合（可选）：

dsh --profile web --dump-config | grep ui-open-in-vscode

要求

系统 PATH 里有 code CLI（VS Code 标准安装自带）
桌面会话（X11/Wayland），宿主进程能拉起 GUI 窗口

卸载

从 cordis.patch.yml 删除该 - insert: 段；
删除 ~/.dsh/profiles/web/node_modules/dsh-client-open-in-vscode；
重启 dsh web。

文件说明

文件	说明
`index.js`	Host 半：注册 `POST /plugin-open-in-vscode` 路由（loopback/Origin 信任闸门），`execFile('code', ['--goto','--reuse-window', path])`
`client.js`	浏览器半：点击拦截 + fetch POST + toast（`window.__ModuleLoader__` 格式）
`cordis.patch.yml`	插件插入配置（`dsh plugin add` / 市场安装所需）
`package.json`	包清单，含 `dsh.bundle` + `dsh.client.platform: "web"` 声明

兼容性：随 @deepseek-ai/dsh 0.1.0-rc.6 的 web profile 测试通过。产品 DOM 的 class/hash 若在新版本变动，client.js 里 targetPath() 的选择器需要跟进调整。

安装

说明文档

dsh-client-open-in-vscode

功能

安全

为什么不用 vscode://file/...

安装

要求

卸载

文件说明

为什么不用 `vscode://file/...`