前言¶
在 DeepSeek Harness(dsh)的 Web 界面里,每一轮对话结束时会展示本轮「交付文件」卡片。卡片自带 Open 和 ⋯ 菜单,其中已有「在默认应用中打开」「在文件资源管理器中显示」等项。若要把路径贴进终端、脚本或文档,往往还要手动从资源管理器或日志里找路径。dsh-copy-file-path 由社区维护者 Meowrium 发布,属于客户端类插件:在交付文件卡片的 ⋯ 菜单里追加「复制相对路径」与「复制绝对路径」,点击后写入剪贴板并显示简短确认提示。仓库地址:GitHub;目录页:SkillHub。
这是什么¶
dsh 的交付文件菜单项写在 @deepseek-ai/dsh-client-ui-deliverables 里,没有预留扩展槽或注册钩子,单靠 shadow 插件很难只改菜单而不重写整张卡片。本插件采用与 dsh-mermaid 类似的做法:在浏览器端对 DOM 做后处理——监听 primitives 菜单 portal,在卡片 chevron 展开时克隆最后一行、改文案与图标并接管点击,不 patch 核心、也不 monkey-patch React。
核心功能¶
交付文件卡片 ⋯ 菜单在 dsh 自带项之下增加两行(中英文标签随 locale):
| 菜单项 | 复制内容 |
|---|---|
| 复制相对路径 / Copy relative path | 相对当前会话工作区的路径 |
| 复制绝对路径 / Copy absolute path | 主机上的绝对路径 |
路径值不猜测、不重写,均来自 dsh 已有数据:
- 绝对路径:取自卡片预览按钮的
title,与 dsh 解析打开时使用的resolveWorkspacePath(cwd, file.path)一致,分隔符保持原样。 - 相对路径:从卡片
aria-label(如{path} 的更多文件操作)还原本轮present工具声明的路径;若声明为绝对路径,则相对工作区根重新计算。 - 工作区根:由上述绝对路径与声明路径对推导;仅在 label 无声明路径时,才回退到客户端 session store(
sessions.list)。
若某一项无法可靠得到,对应菜单行不会出现,避免复制无效路径。插件仅复制文本,不读文件、不传文件;host 侧 inject 为空,无主机访问。
范围与限制:仅覆盖交付文件卡片菜单;「Files changed」芯片与侧边栏文件树无同类菜单,不受影响。未来 dsh 若改卡片 markup,插件可能需要跟进;检测失败时会静默不注入,而不是误改其它菜单。
安装与启用¶
安装命令(来自仓库 README):
dsh plugin --profile web add github:Meowrium/dsh-copy-file-path
安装后需重启 dsh web,并在浏览器中对页面做硬刷新(Ctrl+Shift+R):宿主在启动时挂载 bundle,浏览器 shell 会重建客户端模块。
卸载:
dsh plugin --profile web remove dsh-copy-file-path
当前 package 版本为 0.1.0,许可证 MIT。作者在 0.1.6-alpha.1 的 Windows 环境下做过验证;更旧版本线未在此仓库中测试。插件无额外运行时依赖;缺少 locale 或 sessions 服务时仍可加载,标签为英文,工作区根主要来自卡片数据。
典型用法¶
1、在 Web profile 下安装插件并重启 dsh web,硬刷新页面。
2、完成一轮会产生交付文件的对话,在交付文件卡片上点开 ⋯。
3、选择「复制相对路径」或「复制绝对路径」;剪贴板得到对应字符串,界面会出现简短确认 pill。
菜单结构示意(⋯ 展开后):
⋯ ┌──────────────────────────┐
│ ↗ Open in default app │ ← dsh 自带
│ ▤ Show in File Explorer │
│ ⧉ Copy relative path │ ← 本插件
│ ⧉ Copy absolute path │ ← 本插件
└──────────────────────────┘
适用场景与注意¶
适合经常在 dsh Web UI 里把 Agent 产出文件的路径贴到 shell、CI 配置或说明文档中的开发者。插件以当前 dsh 进程及浏览器页面的权限运行;安装前建议阅读 源码与 LICENSE,自行评估是否与团队安全策略一致。
DeepSeek Harness 生态强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,本文介绍的是社区插件而非官方应用商店条目。
小结¶
dsh-copy-file-path 在不改 dsh 核心的前提下,为交付文件 ⋯ 菜单补上相对路径与绝对路径的一键复制,路径来源与 dsh 自身解析保持一致。需要时在 Web profile 安装、重启并硬刷新即可使用。
- 目录页:https://www.skillhub.cn/plugins/Meowrium/dsh-copy-file-path
- GitHub:https://github.com/Meowrium/dsh-copy-file-path