对话文件操作 nico-zhuang/dsh-chat-file-actions

对话文件操作 · DSH Chat File Actions

一个 DeepSeek Harness 插件：在已完成的回复下按需显示「本轮资源」，集中操作本轮明确引用的本地文件、网页链接和已编辑文件。不覆盖右键菜单，也不修改 DSH 本体。

0.4.1 面向 DeepSeek Harness 0.2.1-rc.2：修复设置表单因 DSH 不再提供 state.mode 而无法保存的问题。自动化测试通过；系统应用与文件管理器操作发生在 DSH Host 所在电脑，侧栏查看发生在 DSH 页面。Windows 桌面尚未实测。

效果预览

紧凑的文件列表：按文件类型显示名称，可直接定位或展开更多操作。

本轮文件列表：PDF、PPTX 与 JPG 文件的紧凑布局

按需显示复制操作：展开「更多」后，可复制路径、文件名或 Markdown 链接。

文件的复制操作：路径、文件名和 Markdown 链接

在插件管理页调整设置：选择文件名的打开方式，勾选并排列「更多操作」中的复制按钮。

插件管理页：文件名打开方式与复制按钮的显示和顺序

这些截图展示已发布 0.3.0 的布局；0.4.x 的网页链接沿用同样的紧凑单行样式，仅增加链接图标与淡色真实域名。前两张截图只保留插件弹层，已裁去对话和费用信息；设置页截图演示将「复制文件名」排在首位。

使用

本轮提问或回复含明确的本地 Markdown 文件链接（包括图片）、@path、@"path with spaces"、Markdown http(s) 网页链接，或本轮有成功的结构化 edit／write 文件结果时，回复操作栏才显示回形针图标和候选数。它们在同一紧凑列表中显示，不另分两套界面。点击图标后：

- 点击本地文件名：默认请求系统应用打开；也可在插件管理页设为「在 DSH 侧栏打开」。成功编辑的文件以淡色「已编辑」标注。
- 点击文件夹图标：请求 Host 的文件管理器定位已验证的本地文件。
- 文件的「更多」：复制绝对路径、文件名或 Markdown 链接；可在插件管理页调整这三项的显示与顺序。侧栏模式下始终提供「用系统应用打开」备选。
- 点击网页链接名：在浏览器打开；同一行显示实际目标域名，而非只相信链接标题。「更多」可复制网址或 Markdown 链接；网页链接没有本地文件定位操作，文件打开方式配置也不影响它。

进入插件管理器的「对话文件操作」配置页，选择本地文件名的打开方式，勾选并用上下按钮排列本地文件的复制操作，然后保存。默认设置与 0.2.1 一致；如果三个文件复制项都隐藏，系统打开模式的文件行不显示「更多」按钮；网页链接行仍可复制网址或 Markdown 链接。设置保存在 DSH Host 的 Profile 配置中；若 DSH 判定当前连接不是 loopback，设置页不可持久保存，也不会退而使用浏览器本地存储。

语言跟随 DSH 全局设置：切换「中文／English」后，插件管理器中的名称、简介、设置摘要和表单，以及已经展开的本轮资源弹窗、菜单、读屏标签和操作反馈都会切换；无须给插件另设语言，也不会改变已保存的打开方式和复制顺序。

列表默认只显示文件名；同名文件会补充父目录，悬停可查看完整路径。标题固定，文件列表独立滚动。界面使用 DSH 日夜主题色、线性图标和文件类型图标，支持键盘操作。

安装

从 v0.4.1 Release 下载 dsh-chat-file-actions-0.4.1.tgz；v0.4.0 Release 和 v0.3.0 Release 继续保留。

1. 在 DSH 插件管理器中安装下载的本地包并启用 对话文件操作。
2. 若提示 restart-required，保存其他任务后手动重启 DSH；只刷新页面可能不够。

从源码构建：

npm ci --ignore-scripts --no-audit --no-fund
npm test
npm pack --ignore-scripts

本仓库未发布到 npm registry。package.json 保留 private: true，以防误发布；GitHub Release 中的 .tgz 才是对应版本的安装包。禁用或移除插件会撤销操作栏插槽和样式，不会修改会话文件。

实现与边界

- 通过正式插槽 conversation.chat.assistant-actions，只收集当前 messageId 所属单轮、单会话的候选；没有候选就不显示按钮。文字仅解析明确的本地 Markdown 文件链接、@文件引用和 Markdown http(s) 链接；不猜测普通裸网址、代码块、HTML 注释或工具输出中的裸文件名。暂不支持参考式链接及全部复杂 Markdown 语法，带括号的常见 URL 与嵌套方括号标题受有界扫描支持；文件与网页目标会按 Markdown 规则解释常见实体和转义，无法确定的实体会跳过，以免指向错误目标。
- 同轮成功完成的 DSH edit／write 卡从 Chat snapshot 的结构化 tool-result 和 diff／创建元数据取路径，不解析卡片 DOM 或工具结果散文；失败、隐藏、越过本轮回复、缺少必要元数据的结果均忽略。此 Chat 投影结构已在 DSH 0.2.1-rc.2 核对；该版本实际 edit／write 产出的差异元数据尚未做实机逐项验收。未来 DSH 版本也可能改变。 shell 等其他方式修改的文件不会自动枚举。
- 本地文件展开时以所属 sessionId 调用 DSH 的 workspaceFiles.stat，由 Host 确定会话工作目录及回退目录。工具卡路径也由 Host 重新验证；验证失败时禁用文件操作。文件可能位于工作区外；Host 也可能拒绝最终符号链接。网页链接只接受规范化的 http(s) 绝对地址，拒绝带用户名密码、原始空白／反斜杠、非网页协议；显示真实域名，只有用户点击才由浏览器打开，不走文件 Host API，也不主动抓取网页。
- 每轮最多显示前 200 个资源，优先给成功编辑或创建的文件预留额度；每次展开最多并发 6 个本地文件验证请求。关闭弹层会发出取消信号并忽略过期结果；若旧请求不响应取消，连续展开期间在途请求可能超过 6 个。
- 系统打开和定位调用 DSH 的 session.openWorkspacePath，插件不运行 shell 命令；原生命令被受理也不保证窗口实际出现。侧栏模式调用 DSH 原生 sidebarRight.openResource，使用已验证文件的会话地址，并核对当前显示的 sessionId；侧栏不可用时不自动改为系统打开。文档预览由 DSH 决定：图片、PDF 可在页面查看，Office 需要 Host 转换，均受格式、文件大小与服务可用性限制。只有点击复制按钮才会写入剪贴板。
- 本地文件打开方式和有序复制项由 DSH 的 Host Config／配置表单保存；配置还未读取或不可用时禁用文件名主按钮，保留显式系统打开入口。网页链接不受文件打开方式影响：主动作是带 noopener noreferrer 的浏览器链接，次要动作复制网址或 Markdown 链接。侧栏不依赖 dsh-better-sidebar，也不注册新的预览器。
- 中英文 UI 由 DSH Client 的 locale 服务读取 zh／en 全局选择并订阅切换；插件管理器的名称和简介则由包内 locale/zh.json、locale/en.json 元数据提供。Host Config 仍只保存与语言无关的动作 ID，不增加独立语言偏好。DSH 其他语言若回退到英文，插件文案也跟随服务的回退链。
- Windows Markdown 路径建议使用 /、将反斜杠编码为 %5C，或使用插件生成的「复制链接」。原始 C:\work\.env 等反斜杠紧贴 Markdown 标点的写法有歧义，插件会跳过，以免指向另一个文件；@"C:\work\.env" 引用不经 Markdown 转义。暂不支持 UNC 和 file: 形式的 Markdown 文件链接。
- 自动测试模拟 React 和 Remote，不能代替各操作系统、各 DSH 版本的实机验收。报告兼容问题时，请在 GitHub Issues 提供 DSH 版本和复现步骤，不要公开私人路径、令牌或完整会话记录。

开发

浏览器入口 lib/client.js 使用 DSH locale、configForms 和现有文件 Remote；Host 入口 lib/index.js 仅声明由 DSH 设置服务管理的 Config schema，不增加命令权限或自建路由。插件管理器的翻译元数据位于 locale/zh.json 和 locale/en.json，清单位于 package.json、cordis.patch.yml。测试覆盖语言服务订阅、管理器与弹窗热切换及配置不变性、单轮隔离、带括号外链与真实域名、安全协议过滤、结构化编辑／新建卡、会话路径验证、复制、限流、配置保存与排序、侧栏会话匹配及不可用时的显式备选。

本项目是独立社区插件，与 DeepSeek Harness 官方无隶属关系。许可证见 LICENSE。

DSH Chat File Actions 0.4.1 在已完成的回复下方加一个回形针，用来列出显式引用的本地文件、Markdown http(s) 链接，以及同一轮里成功 edit／write 的文件卡。所有条目共用同一条紧凑的单行列表。本地文件用 Host 默认应用打开（默认值不变），也可按配置在 DSH 原生右侧栏打开；定位和可配置的复制动作仍只对文件生效。网页链接在浏览器中打开，并在同样的 More 样式下提供 Copy URL／Copy Markdown，标签旁显示真实的目标主机名。

插件跟随 DSH 的全局中英文设置：插件管理器标题、简介、设置摘要与表单，以及打开资源弹窗、菜单、无障碍标签和反馈都会实时切换。文件动作偏好保持不变；没有单独的插件语言偏好。
紧凑列表跟随 DSH 主题，独立滚动。最多显示 200 个合并资源，并为已应用的编辑/写入文件预留空间。本地路径（包括从工具卡片元数据中取得的路径）通过所属会话的 workspaceFiles.stat 校验，每次打开最多并发检查六个；取消为尽力而为。网页链接不调用 Host 文件 API，也从不自动加载。打开侧边栏要求目标会话在屏幕上，且 DSH 预览可用；失败时绝不会静默启动 Host 应用。配置档设置归 Host 所有，只有 DSH 视为回环地址的页面才能写入。Chat 工具卡片投影已对照 DSH 0.2.1-rc.2 检查，但编辑/写入生产者的元数据尚未在该运行时上做端到端验证；未来版本可能改变这一点。

0.4.1 版面向 DSH 0.2.1-rc.2，移除了一个过时的 state.mode 门控，该门控会禁用可写设置。从 v0.4.1 Release 下载归档文件，通过 DSH 插件管理器安装；仅当 DSH 报告 restart-required 时才手动重启。v0.4.0 Release 和 v0.3.0 Release 仍可获取。Windows 桌面端运行仍未验证。独立社区插件，并非 DeepSeek 官方产品。