dsh-right-click-menu
适用于 DSH Web GUI 的 Codex 风格右键菜单：文件、聊天中的文件路径和超链接。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:AL1ghtm3ter/dsh-right-click-menu#9976d213318032c6f128e3affa5d1b873cd47871Right Click Menu 以 dsh-right-click-menu 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DSH 网页界面加一个 Codex 风格的右键菜单：文件、对话里的文件路径、超链接。
中文 | English
给 Agent 的一句话
给 DSH 装上文件右键菜单：调用
plugin_manager，action填install_bundle，target填github:AL1ghtm3ter/dsh-right-click-menu；装好以后，我就能在 DSH 里对着文件或链接右键了。具体规格、命令行写法和验证步骤见给 Agent 的说明。
在 DSH 里对着文件、文件路径或链接点右键，弹出的菜单只给这一类对象真正能做的事。
| 在哪右键 | 怎么认出来的 | 菜单里有什么 |
|---|---|---|
| 右侧栏「文件」标签里的一行 | 该行自带的 data-files-path / data-files-entry 标记 | 文件动作 |
| 对话消息里的文件路径（行内代码、正文都行） | 指针下的那段文字，先问过宿主、确认文件真在 | 文件动作 |
| 聊天渲染出来的文件提及 | 提及按钮的 title 属性 | 文件动作 |
| 超链接 | 锚点的 href | 链接动作；链接本身指向文件时，再补上文件动作 |
文件动作
| 菜单项 | 点了会怎样 |
|---|---|
| 在 DSH 中预览 / 在文件树中展开 | 用 DSH 自带的预览打开文件；文件夹则是展开 |
| 在默认应用中打开 | 交给系统默认程序（session.openWorkspacePath） |
| 打开方式 ▸ | 列出宿主查到的关联程序，一个一个点 |
| 在资源管理器中打开 | 在文件管理器里定位到这个文件 |
| 复制路径 | 绝对路径进剪贴板 |
| 复制相对路径 | 相对当前会话工作区的路径 |
| 复制文件名 | 路径最后一段 |
| 复制文件内容 | 读出文件内容进剪贴板（上限 1 MiB，二进制文件会拒绝） |
| 另存为… | 能用浏览器保存对话框就用；否则让你选个目录，再由宿主拷过去 |
链接动作
| 菜单项 | 点了会怎样 |
|---|---|
| 在侧边栏中打开 | 在右侧栏的浏览器标签页里打开 |
| 在外部浏览器中打开 | 交给系统默认浏览器 |
| 复制链接地址 | 复制 href |
| 复制链接文字 | 复制链接显示出来的那段文字 |
| 复制为 Markdown 链接 | 复制成 [文字](href)，可以直接粘进文档或提示词 |
链接指向文件时——dsh-resource://file/…、file://、api/file?path=… 这类地址——同一个菜单里既有链接动作，也有完整的文件动作。
其它位置一律不管。 既不是文件也不是链接的地方点右键，照样弹浏览器原生菜单：选文字、消息操作、代码块、JSON 复制按钮全都照旧。碰到长得像路径、但宿主查不到的内容，会直接告诉你「工作区里没有找到 <路径>」，不会把这次右键悄悄吞掉。
在网页界面里：侧栏 Plugins → Add plugin，粘贴下面任意一条，点 Install。
| 来源 | 粘贴这个 |
|---|---|
| GitHub | github:AL1ghtm3ter/dsh-right-click-menu |
| Release 压缩包 | https://github.com/AL1ghtm3ter/dsh-right-click-menu/releases/latest/download/dsh-right-click-menu.tgz |
| 本地目录 | 该目录的绝对路径，或者打好的 .tgz |
这个包还没发到 npm。dsh-right-click-menu 是它将来用的包名，发布只要两条命令，见发布。
命令行装法（先把 DSH 退干净）：
dsh plugin --profile <profile> add github:AL1ghtm3ter/dsh-right-click-menu
一句话，用户可以直接丢进对话：
给 DSH 装上文件右键菜单：调用
plugin_manager，action填install_bundle，target填github:AL1ghtm3ter/dsh-right-click-menu。
Agent 照着这几步做：
plugin_manager 的 action: install_bundle、target: github:AL1ghtm3ter/dsh-right-click-menu。它会用 profile 自己的 pnpm 装好，并把包名写进 dsh.profile.bundles。看返回值里的 application 字段判断有没有生效：applied 是已经跑起来了，restart-required 要等下次启动应用。http://<主机>/dsh-right-click-menu/ping 会先被信任围栏拦下、根本到不了路由，所以它的状态码不能当作路由测试：按路由拦的部署返回 401，整台服务器都拦的部署一律 403（连不存在的路径也是 403）。cordis_inspect_query 查 client 的 Slots，listSubTree 传 {"root": "shell.overlay"}，占用列表里应该出现 right-click-menu。lib/client.js 要刷新页面（Ctrl+R）；改宿主半要重启应用。装的时候不用构建，也没有安装脚本，所以不会弹 allowBuilds 授权。
消息里的路径——模型写在行内代码里也好，写在正文里也好——都会先按会话工作区核实文件在不在，再决定弹不弹菜单。所以不会对着一个不存在的文件给你一堆操作。
src/index.ts 按会话的工作目录解析成相对路径。D:\projects\app\main.py 按绝对路径解析。production.json 这种只有文件名的，会走输入框补全用的同一套 @file 搜索，所以藏在子目录里的文件也找得到。"C:\My Projects\a b.txt"）会整段当成一个路径来读。要是都没找到，提示里会点名它试过的那个词：工作区里没有找到 <路径>。
任何链接都能右键：模型用 Markdown 写的、工具结果里的、DSH 界面自己的。在侧边栏中打开留在 DSH 里看，在外部浏览器中打开交给系统浏览器。http/https 才会同时给出这两项；其它目标（mailto:、应用内的文件地址）保留一项「打开链接」，指向文件时再补上文件动作。
菜单和提示跟随 DSH 的界面语言（Settings → General → Language，切换后立即生效，不用刷新）。中文界面显示中文，其它语言显示英文——包括装了语言包、但那个语言包还没翻译本插件的情况；不会出现 menu.copyPath 这种原始键。
要给你的语言加翻译（或写语言包），命名空间是 right-click-menu，注册示例和 44 个键的完整键表见 LOCALIZATION.md。
dsh-right-click-menu/
├── package.json name = Loader 行名 = lib/client.js 里的注册 id
├── cordis.patch.yml 这个 bundle 唯一的组成层，用来插入宿主插件那一行
├── lib/index.js 宿主半：/dsh-right-click-menu 下 6 条带信任围栏的路由
├── lib/client.js 浏览器半：手写的 __ModuleLoader__ 包
├── icon.svg Plugin Manager 卡片上显示的图标
└── locale/{en,zh}.json 卡片的标题和描述
宿主半（lib/index.js）：路由挂在 webServer 的 /dsh-right-click-menu 下。每条路由都先问 connection.requestRejection（Host/Origin 围栏加浏览器认证），再校验请求方法、媒体类型、64 KiB 请求体上限和绝对路径。
| 路由 | 用途 |
|---|---|
GET /ping | 看它还活着没有 |
GET /raw?path= | 原始字节，给浏览器侧的「另存为」用 |
POST /stat | { path } → { exists, kind, size, mtimeMs } |
POST /read | { path } → { text, binary, truncated, size }，上限 1 MiB |
POST /save-as | { from, to } 拷贝字节 |
POST /write-text | { path, text } 写入 UTF-8，兜底用 |
它只 import Node 内置模块，不依赖应用自带的 @deepseek-ai/* 依赖图也能跑起来。
浏览器半（lib/client.js）：一个挂在 document 上、捕获阶段的 contextmenu 监听，加一个 shell.overlay 占位。菜单原语画在指针位置，提示条也归它管。它只 require 平台的种子模块（react、react/jsx-runtime、@deepseek-ai/dsh-client-ui-primitives），其它 DSH 能力都通过 scoped injection 拿。
Cordis 把 ctx.remote.workspaceFiles 当成虚拟服务 remote.workspaceFiles。没注入这个点号全名的 fiber，只要碰一下属性就会抛：
cannot get property "remote.workspaceFiles" without inject
所以本插件一个命名空间一条 scoped injection：
ctx.inject(["remote", "remote.workspaceFiles"], (scope) => {
remotes.files = scope.remote.workspaceFiles;
});
一条一条注，而不是把它们全堆进插件的 inject 列表——这样某个命名空间缺失时，只影响对应那几项功能，不会把整个插件 fiber 卡在 pending。普通服务属性不受影响，ctx.get("sessions").list 不需要注入。
| 现象 | 原因和处理 |
|---|---|
| 右键没反应 | 那个位置既不是文件也不是链接，所以按设计弹了原生菜单。如果是文件路径，看提示条——宿主查不到的那个词会被点名。 |
| 文件树能用、对话里不行 | 浏览器半还是旧版本。刷新页面（Ctrl+R）。 |
| 「在 DSH 中预览」说没法预览 | 侧栏文档预览只认会话文件地址；它渲染不了的类型就没有预览，其它项照常能用。 |
| 「在默认应用中打开」是灰的 | 宿主报告这个文件类型没有关联程序。「打开方式 ▸」会列出它实际找到的程序。 |
宿主路由返回 404 | 宿主半没加载。安装或换包之后，新的 JavaScript 模块代要等应用下次启动才载入。 |
| 「另存为…」改不了名字 | 只有浏览器的保存对话框（showSaveFilePicker）能改名；兜底方案是拷进你选的那个目录。 |
用 plugin_manager 的 action: remove_bundle、target: dsh-right-click-menu：取消选择这个 bundle、删掉依赖、卸载掉。
手工做法：去 profile 的 package.json 里，把 dsh.profile.bundles 和 dependencies 中的这个名字删掉，然后重启。DSH 自带的文件一个都不会动。
没有构建步骤：lib/client.js 就是 DSH 直接加载的包，宿主半是普通 ESM。
| 改了什么 | 怎么生效 |
|---|---|
lib/client.js | 刷新页面（包的 URL 带着按 mtime/size 算出来的修订号） |
lib/index.js | 重启应用——Node 的 ESM 缓存会留住旧的模块代 |
package.json 里的展示信息 | 刷新页面，Plugin Manager 会重读清单 |
本地改着玩就用路径安装，改完不用重装：
dsh plugin --profile <profile> add link:/绝对/路径/dsh-right-click-menu
发布就两条命令：
npm login # 第一次，用拥有这个包名的账号
npm publish # 在本目录执行
社区目录（awesome-dsh-plugin）的那条条目，发新版本时不用改：它指向 releases/latest/download/dsh-right-click-menu.tgz，这个资产名不带版本号。