dsh-gotofile

dsh-GotoFile

对话结尾列出本轮产出 / 修改的文件，双击路径直接在资源管理器里定位。 A DSH plugin that prints the files a turn produced or changed — double-click a path to reveal it in your OS file manager.

DSH 的官方「改动文件」卡片只活在浏览器里：要离开 GUI 读一份清单、要整段复制路径、要在资源管理器里打开文件，都得再手动翻一遍。这个插件把同一份「本轮改动」数据渲染成纯文本行放进对话结尾，并让每一行路径都能双击落到系统文件管理器。

本轮产出 / 修改 3 个文件（双击路径在文件管理器中定位）        [复制全部]
● 新  report.md      — E:\workspace\project\docs\report.md          📂
● 改  index.js       — E:\workspace\project\src\index.js            📂
● 改  old-config.yml — E:\workspace\project\old-config.yml （已不存在）

真实运行效果（结尾的文本块：「已编辑 3 个文件」卡片是 DSH 自带的，下面一行才是本插件）：

特性

• 文本，不是卡片：整段可选中、可复制（右上角「复制全部」一键拷走全部绝对路径），粘贴到哪里都好用。
• 双击即定位：双击路径文本 → Windows 资源管理器（explorer /select,）与 macOS Finder（open -R）会打开并选中该文件；Linux 没有统一的「在文件管理器中选中」接口，xdg-open 只能打开文件本身（目录则打开该目录）。
• 正文里的路径也能双击：`src/index.js` 这种裸路径、或手动选中的一段路径，双击同样生效——不用回到报告里找。
• 只记真的写成功的：登记 write / edit / str_replace_editor / ops_replace 的成功调用，失败的、只读的调用一律不出现。
• 新 / 改 有区分：本轮首次写入该路径 = 新；改动一个已存在的文件 = 改。
• 失效文件自动置灰：文件被外部删掉的行显示「（已不存在）」并禁用双击。
• 零依赖、无构建：两个源文件（宿主半 + 浏览器半），node --test 直接跑单测。
• 默认就安全：所有路由先过本机同源校验（Origin 的端口必须与请求 Host 的端口一致，本地别的开发端口一律拒绝），请求体只收 application/json；只有会话工作目录 / 家目录（凭据类目录除外）/ 用户显式声明的白名单根里的路径才能被系统打开。

安装

已发布到 npm：https://www.npmjs.com/package/dsh-gotofile（包名只能小写，仓库与插件显示名仍写作 dsh-GotoFile）。

方式一：官方 CLI（推荐）

# 先退出桌面端客户端：desktop profile 在桌面端运行时被独占，plugin 命令会被拒绝
dsh plugin --profile desktop add dsh-gotofile

方式二：手动装进 profile

cd "$DSH_HOME/profiles/desktop"     # Windows 下类似 E:\...\2-DSH运行数据\profiles\desktop
pnpm add dsh-gotofile               # 或 npm i dsh-gotofile

装完 package.json 里应该有 "dsh-gotofile": "^1.0.4"（dependencies）与 dsh.profile.bundles 里的一项 —— 后者是它出现在插件管理列表里的前提（只把目录塞进 node_modules 而不写依赖，宿主侧能挂载，但插件管理里看不到它）。

然后在同一个 profile 的 cordis.patch.yml 末尾登记（DSH 的插件市场/插件管理安装时也会自动写入这一行）：

- insert:
    - id: goto-file
      name: dsh-gotofile

手动安装也行——把整包放进 profile 的 node_modules：

<profile>/node_modules/dsh-gotofile/
<profile>/cordis.patch.yml

改完 cordis.patch.yml 需要重启桌面端（或重新加载 profile）才会挂载。挂载成功可以在插件管理里看到 goto-file / dsh-gotofile / 状态 active。

配置：外置盘 / 网络盘白名单

设置 → GotoFile，每行一个根目录（支持 ~/ 与 ~\），保存立即生效，不用重启、不用改 YAML。

• 默认留空 = 只放行会话工作目录与家目录内的路径；其他位置的路径双击会被拒绝，报告里仍会列出但打开请求返回 404。
• 盘根可以直接填：D:\、F:\ 都行（也接受只写 D:，会补成盘根；带不带尾斜杠、盘符大小写都不影响）。
• 家目录里有一批凭据类目录默认不放行（AppData、Library、.ssh、.aws、.gnupg、.kube、.docker、.npmrc、.netrc、.git-credentials）——这些位置的文件一旦被系统默认程序打开，等于把本机账号交出去。确实需要时把它们写进白名单即可（写进去 = 显式授权）。
• 系统盘特征目录（C:\ 之类，即根下存在 Windows / System / etc）会被自动拒绝，避免一条白名单把整台机器敞开口。
• 白名单根还会做 realpath 逃逸检查（symlink 不能溜出根）。

权限：它会碰什么

• 会话：只监听 session/event 里的 tool/call 与 tool/result，读取工具名和路径参数并配对；不读对话正文，不改会话数据，不落盘。
• 文件：只对报告里的路径做存在性检查（existsSync / statSync）；「打开」交给系统文件管理器（Windows explorer、macOS open -R、Linux xdg-open），经 execFile 直传参数、不经 shell，不会执行文件内容。
• 路径范围：会话工作目录、家目录（AppData / .ssh / .npmrc 等凭据类目录默认拒绝）、你显式声明的白名单根。
• 网络：不联网。没有遥测、没有外部请求；三条路由只服务本机，且校验同源与端口。

What it touches: session tool events (names + path arguments only, message text is not read), file existence checks, the OS file manager for reveal/open, and no network at all.

工作原理（一图）

一轮对话
  │ 工具调用 write / edit / str_replace_editor / ops_replace
  ▼
宿主半 lib/index.js
  ctx.on('session/event')
    tool/call   ──► pending.set(callId, {turn, 路径, 是否新建})
    tool/result ──► 只有成功（isError !== true）才计入登记簿
                     ├ op = 新建且首次收录 ? 'new' : 'edit'
                     └ 子代理会话（origin==='subagent'）不参与
  (可选补漏) ctx.get('workspaceChanges').summary(...) → 官方含 git 快照的权威清单
  POST /api/goto-file/check  → 本轮文件清单
  POST /api/goto-file/open   → 系统打开 / 定位（同源校验 + 路径安全口径）
  ▼
浏览器半 lib/client.js
  turnTail 槽：渲染纯文本行，双击判 event.detail === 2 → /open reveal
  正文双击委托：document dblclick 抓裸 <code> / 选中文本 → /open reveal

源码级查证过的坑（八条，含 explorer.exe 把 / 当开关、turnTail 槽在 0.1.7 前后的双模签名、webServer 必须动态注入等）都记在 docs/architecture.md。

源码结构

开发

node --test        # 30 个单测，零依赖、无需 npm install

宿主半对 @deepseek-ai/schemastery 的依赖是懒加载的（挂载时才解析真包，解析不到就退回恒等形态）， 所以这个仓库可以被单独克隆出来直接跑测试，不必放在 DSH profile 里。

已知边界

• PTC / 单一 run_code 模式：工具面被收拢成一个 run_code 之后，写文件不再是独立的 write / edit 调用， 而是脚本里的 tools.write({ file_path: "..." }) / tools.edit({ file_path: "..." })。本插件会解析脚本提取这些字面量路径 （变量路径、含 ${...} 的模板串跳过——宁可漏报也不猜）。脚本里用 pwsh 重定向写出的文件仍然只能靠官方快照补漏。
• 外部命令产生的文件（> out.txt、git checkout 等）不在登记簿里，只能靠官方 workspaceChanges 的 git 快照补漏；非 git 目录下这类改动不会出现。
• ops_replace 的 glob 参数是模式不是路径（src/*.ts、**/*.js），不会被展开成具体文件；那一轮登记的是它的 path 参数，glob 命中的文件靠官方快照补漏。
• 单轮文件数上限 maxFilesPerTurn（默认 200），防止病态轮次撑爆登记簿。
• Linux 上双击是「打开」不是「定位选中」：xdg-open 没有选中参数，双击会用默认程序打开该文件（目录则打开目录）。Windows / macOS 才是资源管理器 / Finder 里定位选中。
• 双击是浏览器手势，纯键盘用户可按 Enter（行有 tabIndex）触发定位。

License

MIT

---

打赏

本项目为个人爱好驱动的开源插件，如果帮助到了您，欢迎各位大老板顺手请我喝杯咖啡，非常感谢打赏！