安装

在 DeepSeek Harness 里通过 dsh-market 安装

dsh plugin --profile web add dshmarket

或使用命令行

dsh plugin --profile web add github:yumm007/dsh-reveal-files

装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络。请先审阅源码，并尽量锁定 commit（github:owner/repo#sha）。

README

English | 简体中文

DeepSeek Harness 双面插件:把「产物」行(产出文件行)里的每个文件 chip 改成点击弹出下拉菜单,菜单提供按文件操作:打开文件、拷贝路径、在文件浏览器中定位、以及在终端中进入该文件所在目录。

功能特性

每个产物文件 chip 点击后弹出下拉菜单,按文件独立操作,不再是点击直接打开:
- 📂 打开 —— 用默认应用打开(原有行为)。
- 📋 拷贝文件路径 —— 将绝对路径复制到系统剪贴板。
- 📁 在文件浏览器中显示 —— macOS Finder(open -R,会选中文件)、 Linux 文件管理器(xdg-open 打开所在目录)、Windows Explorer (explorer /select,)。
- ⌨️ 在终端中打开所在目录 —— 打开一个系统终端窗口并置顶激活, 已 cd 进入文件所在目录,可直接继续操作:macOS Terminal.app、Linux (x-terminal-emulator / gnome-terminal / konsole) 与 Windows (cmd)。每次触发都打开一个新窗口(每个动作独立终端,无需额外权限)。
菜单标签跟随界面语言(简体中文 / 英文);菜单项带 role="menuitem", chip 暴露 aria-haspopup / aria-expanded。
相对路径按会话工作目录解析。
出错时(如沙箱拒绝、平台不支持)错误显示在打开的菜单内;动作执行期间菜单保持打开、菜单项禁用。
除 Harness 自身外零运行时依赖:Host 仅用 node:child_process, Client 仅用平台的 react 种子。

环境要求

DeepSeek Harness Web(web profile),即 dsh web。
Node.js >= 22.6.0。
桌面环境可被系统打开器触达(macOS 与 Windows 始终可以;Linux 需要显示服务器或 WSL)。

安装

# 从 GitHub 安装(pnpm 的 git spec;#main 固定主分支):
dsh plugin --profile web add github:yumm007/dsh-reveal-files#main

从源码构建。 GitHub 安装会在安装时构建包;pnpm 会请求一次 allowBuilds 授权,批准后继续。若构建被阻止,把包加入 profile pnpm-workspace.yaml 的 allowBuilds 后重新执行命令;发布 npm 预构建包则可完全跳过这一步。

dsh plugin 会在 profile 目录内把参数转发给 pnpm,随后自动对账 dsh.profile.bundles。因为包声明了 dsh.bundle.patch,它会自动加入 profile 层栈——无需手动编辑 cordis.yml。

安装后重启 web profile:

dsh web

插件作为 bundle 在启动时加载:Host 半部注册 POST /api/reveal-files 与 POST /api/show-in-terminal 路由,Client 半部在产物文件行挂载下拉菜单。

使用方法

让助手在一个回合内产出若干文件(任意 write / edit / 变更类工具结果)。
在该消息下方找到带文件 chips 的「产物」行。
点击某个文件 chip——弹出小菜单:打开 / 拷贝文件路径 / 在文件浏览器中显示 / 在终端中打开所在目录,选择其一;点击菜单外任意处或完成选择后菜单关闭。
若操作失败,错误以红色显示在菜单内;动作执行期间菜单项保持禁用。

配置

cordis.patch.yml 中的插件行可配置:

- insert:
    - id: dsh-reveal-files
      name: 'dsh-reveal-files'
      config:
        enabled: true          # 是否注册 reveal 路由(默认 true)
        revealTimeoutMs: 10000 # 单条系统命令超时(毫秒,默认 10000)

如需覆盖,可在 profile 自己的 cordis.patch.yml 中修改。

工作原理

层	文件	说明
Host	`lib/index.js`	Cordis 插件行 `dsh-reveal-files`(注入 `webServer` 与 `sessions`),注册 `POST /api/reveal-files`(文件浏览器定位)与 `POST /api/show-in-terminal`(置顶终端并 cd)。按平台执行 `open -R` / `xdg-open` / `explorer /select,` 与 `osascript` / 终端模拟器,相对路径按会话 cwd 解析,返回 JSON 结果。
Client	`client/client.js`	web 模块(`window.__ModuleLoader__.load`),由 Harness 客户端模块系统注册。以 `priority: -1` 认领 `conversation.chat.turnTail` 链条,`select` 读取回合的 `deliverables` 数据(与内置行同一数据源),渲染 chips 行与两个图标按钮。

为什么用 `priority: -1`?

turn-tail 插槽是一条链条:条目按 priority 升序尝试,第一个 select 返回非 null 的胜出。内置的「产物」行注册在 priority: 0。注册为 -1 使本插件的条目排在最前,从而渲染出定位图标,同时文件检测行为与内置完全一致。若不显式指定 priority,两条目同为 0 并列,内置行会静默胜出。

卸载

dsh plugin --profile web remove dsh-reveal-files

对账步骤也会将该包从 dsh.profile.bundles 移除;随后重启 web profile。

开发

本地开发时直接从磁盘安装,每次编辑后重新执行 add 即可——profile 依赖是硬链接,已安装代码会跟随你的工作区:

dsh plugin --profile web add file:/绝对路径/dsh-reveal-files
# 编辑后:         dsh plugin --profile web add file:/绝对路径/dsh-reveal-files
# 或强制重装:     pnpm --dir ~/.dsh/profiles/web install --force

webServer 以 rev 哈希 URL 从磁盘提供 client bundle,刷新即可看到 Client 改动;Host 路由改动需要重启。