任意打开 xl0223/dsh-open-any

dsh-open-any

给 DeepSeek Harness（DSH）的对话界面加「文件右键 → 打开方式」：对话里出现的文件，右键就能用本机任意应用打开。

┌──────────────────────────────┐
右键 a.ts │ a.ts │ ──────▶ │ 用 VS Code 打开 │ │ 在文件资源管理器中打开 │ ← 一级菜单，不用展开 │ 打开方式 ▸ │──▶ VS Code / Cursor / Windows Terminal │ ───────────────────────── │ │ 其他应用…（系统对话框） │ ← 本插件独有：可选出未注册关联的应用 │ ───────────────────────── │ │ 复制路径 │ └──────────────────────────────┘

它能做什么

| 菜单项 | 行为 |
| 用 <默认应用> 打开 | 用系统默认关联程序打开文件 |
| 在文件资源管理器中打开 | 一级菜单项；在文件管理器中定位该文件（Windows 用此措辞，macOS 为「在访达中显示」） |
| 打开方式 ▸ | 列出本机为该文件类型注册过关联的编辑器 / 终端（带真实图标与「（默认）」标记） |
| 其他应用…（系统对话框） | 唤起 Windows 原生「打开方式」对话框，可选未注册文件关联的应用（例如 Visual Studio） |
| 复制路径 | 复制绝对路径 |

识别范围：

| 元素 | DOM 特征 | 路径来源 |
| Markdown 文件链接 | button.fileLink | title 属性 |
| 输入框 / 消息里的 @文件 引用 | [data-ref-chip="file"] | title（@路径） |
| 路径标签（PathLabel） | [data-path-label] | title |
| 其它带 title 的元素（兜底） | 任意祖先的 title | title，仅当它「看着就是路径」时命中 |

相对路径会按当前正在查看的会话的工作目录补全成绝对路径（Host 侧只用进程 cwd 解析相对路径，所以必须在浏览器侧补全）。非文件位置右键仍弹浏览器原生菜单。

与同类插件的区别（诚实说明）

DSH 插件市场里已有几个同类插件（dsh-file-link-menu、dsh-right-click-menu、dsh-file-menu 等），本插件不是能力最全的那个。它只主张两件事：

1. 「其他应用…（系统对话框）」：走 rundll32 shell32.dll,OpenAs_RunDLL，能选没有注册文件类型关联的应用。只列 workspacePathApplications 的插件永远够不到这类程序（例如 Visual Studio 不在 DSH 的应用目录里时）。
2. 不拖垮启动的工程约束：client 插件在 apply 阶段绝不抛异常、绝不等待服务就绪，factory 外层还有一个永不抛错的兜底 apply。DSH 的 web boot 把任何非 active 的条目当致命错误（web boot: N entry did not activate），实测会让整个 GUI 打不开——本插件为此付出的是「服务全部延迟到事件发生时惰性解析」的设计。

如果你需要超链接右键、另存为、复制文件内容、文件树右键等能力，请直接用上表里更全的插件，不要重复造这个轮子。

安装

从 GitHub 安装（推荐）

在 DSH 的「设置 → 插件」或插件管理器的添加框里填：

github:xl0223/dsh-open-any

或用 DSH 自带命令行（把 <profile> 换成你的配置档名，例如 desktop）：

dsh plugin --profile <profile> add github:xl0223/dsh-open-any

装完重启 DSH：client bundle 按文件 mtime 生成 rev 并版本化缓存，不重启不会重载。

本地源码调试

dsh plugin --profile <profile> add link:C:\path\to\dsh-open-any

改完 src/ 必须重新 node scripts/build.mjs（DSH 加载的是 lib/）；改 lib/client.js 刷新页面即可，改 host 半侧要重启。

卸载

dsh plugin --profile <profile> remove dsh-open-any

或手工从配置档的 package.json 里删掉 dsh.profile.bundles 与 dependencies 中的 dsh-open-any，重启。

兼容性

| 项 | 状态 |
| DSH 版本 | 0.2.0-rc.2 上完成真机验证（菜单、应用列表、打开、文案） |
| DSH 0.2.1-rc.2 | 已静态确认：外壳冻结的模块基座表里仍有 @deepseek-ai/dsh-client-ui-primitives（它被打包进外壳，不再有独立包目录）；未做真机重验 |
| 平台 | Host 侧用 rundll32 / explorer / open / xdg-open，三平台都有实现，但只在 Windows 11 上实测过 |
| Node | 构建需要 Node ≥ 20；运行时只用 DSH 自带能力 |

开发

node scripts/build.mjs # 语法 + 契约校验 → lib/
node --test scripts/verify-client.test.mjs scripts/verify-host.test.mjs # 离线单测
node tools/check-host-contract.mjs # 与真实 app.asar 的模块/路由契约
node tools/probe-open-in-app.mjs # 真机探测：本机会列出哪些应用

一条命令跑全部：npm run check。

验证报告（真实执行）

平台：Windows 11；DSH D:\Ai_Agent\DeepSeek Harness（0.2.0-rc.2 真机 / 0.2.1-rc.2 静态）。
以下命令与数字均为实际执行结果。

1. 构建

$ node scripts/build.mjs
built ...\lib\client.js 34339 bytes sha256=f94b6dc6edee8545…
built ...\lib\index.js 15049 bytes sha256=131c5ddbfd27fb3f…

2. 离线单测：30 / 30 通过

覆盖：路径识别与清理、会话 cwd 补全、菜单模型（加载中 / 有应用 / 失败）、平台措辞、Session Remote 请求体、host 路由回退、词典命中/未命中、host 路由的栅栏与方法/媒体类型边界、假 DOM 端到端（右键 → 菜单 → 选「用 Cursor 打开」→ 断言请求体）、以及一组崩溃回归测试（apply 在六种恶劣上下文下必须不抛错且完成挂载）。

ℹ tests 30 ℹ pass 30 ℹ fail 0

3. 宿主契约（对真实 app.asar）

$ node tools/check-host-contract.mjs
基座模块: react/jsx-runtime, react-dom, react-dom/client, @deepseek-ai/cordis, @tanstack/react-virtual, @deepseek-ai/dsh-client-store, @deepseek-ai/dsh-client-ui-slots, @deepseek-ai/dsh-client-ui-primitives, @deepseek-ai/dsh-client-ui-dockkit, react, zod 契约检查通过：所有 require 与导出名都存在。

4. 真机验证（0.2.0-rc.2）

右键对话里的文件链接 → 菜单弹出 → 应用列表来自本机 → 选应用后文件被打开；「其他应用…（系统对话框）」唤起 Windows 原生选择器（用 rundll32 实测进程出现）。

已知限制

- 0.2.1-rc.2 未真机重验：只确认了模块基座表，没有实际重启安装测试。
- 「其他应用…」仅 Windows 实现（OpenAs_RunDLL）；macOS / Linux 会返回 501。
- 图片类 Markdown 链接（有缩略图浮层、无 title）不命中。
- 只复制绝对路径，没有相对路径 / 文件名 / 文件内容 / 另存为。
- 不处理超链接、不处理文件树（侧边栏）内的右键。
- 未做 canOpenWorkspacePath 预检：文件不在工作区时，菜单仍会弹出、操作会失败并提示。

踩坑记录（给后来者）

1. client 插件的 apply 绝不能抛异常，也不能等任何服务。 DSH 的 web boot 把非 active 条目当致命错误。静态 inject 会让 fiber 永远 pending；apply 里同步调 ctx.effect(...) + locale.register(...) 抛错则让 fiber failed —— 两者都会让整个 GUI 打不开（crash-*-web-boot.log: web boot: 1 entry did not activate / <插件>: failed）。正确姿势：factory 先挂一个 no-op exports.apply，真实实现包在 try 里；apply 只做 DOM/React，服务延迟到事件发生时惰性读取。
2. ctx.inject 要一个一个注。 把 ["slots","remote","sessions","locale"] 一次性交给一个 ctx.inject，只要有一个名字对不上就永远不回调，整条链路静默失效且不报错。改成每个服务一条 ctx.inject([name], cb) 后立刻正常。
3. locale.bind(ns)(key) 未命中时会原样返回 key。 照单全收就会把 open.default 这种裸 key 显示到菜单里。必须判断 返回值 !== key 再采用，否则回退内置字典。
4. GUI 页面的 origin 是 dsh-app://app，不是 http://127.0.0.1:<port>。浏览器侧对相对路径的 fetch 不一定到得了 host 路由，排查时以 host 半侧写盘的证据为准。
5. Host 侧路径必须先是绝对路径（它用 path.resolve 按进程 cwd 解析），相对路径要在浏览器侧按会话 cwd 补全。

文件结构

dsh-open-any/
├── package.json # bundle 清单：dsh.bundle.patch + dsh.client（platform: web） ├── cordis.patch.yml # 组合层：插入 open-any 这一行 ├── icon.svg # 插件卡片图标 ├── src/ │ ├── client.js # 浏览器半侧：右键监听 + 菜单 + Session Remote / host 路由调用 │ └── host.js # host 半侧：4 条带信任围栏的路由 ├── lib/ # 构建产物（DSH 实际加载，随仓库提交） ├── scripts/ │ ├── build.mjs # 构建：语法 + 契约校验 │ ├── verify-client.test.mjs │ └── verify-host.test.mjs ├── tools/ │ ├── check-host-contract.mjs # 对真实 app.asar 校验模块与导出名 │ └── probe-open-in-app.mjs # 真机探测本机应用目录 ├── README.md / PROGRESS.md / AGENTS.md └── LICENSE (MIT)

Host 侧路由（全部先过 connection.requestRejection 信任栅栏，再校验方法、媒体类型、64 KiB 请求体上限与路径存在性）：

| 路由 | 用途 |
| POST /dsh-open-any/open-as | 唤起系统「打开方式」对话框 |
| POST /dsh-open-any/open-file | 用系统默认应用打开（Session Remote 不可用时的后备） |
| POST /dsh-open-any/reveal | 在文件管理器中定位 |
| POST /dsh-open-any/diag | 诊断上报落盘（%TEMP%\dsh-open-any-diag.log） |

License

MIT