表格附件拖拽 yybukn/dsh-table-attach

dsh-table-attach

将表格与文档（.xlsx、.csv、.pdf、.zip……）粘贴或拖拽到 DSH Web 编辑器中。文件会被保存到当前会话的工作区，并在光标处插入一个 @reference，这样智能体就能读取真实的文件。

官方 DSH 编辑器在粘贴/拖拽时只接受图片（PNG/JPG/WebP/GIF）。
本插件增加了非图片文件的附件功能。

功能特性

- 粘贴与拖拽：支持文件粘贴（⌘C 复制文件后粘贴）以及拖拽。
- 任意非图片文件：电子表格、CSV、文档、PDF、压缩包、JSON……
- 保存到会话工作区：文件存放在 /attachments/ （名称冲突时自动以 -1/-2……后缀重命名）。
- 插入 @reference：例如 @attachments/report.xlsx（当名称包含空格时写作 @"attachments/my report.xlsx"）——与宿主机的 @ 提及语法一致，以便智能体能够读取该文件。
- 默认安全：50 MiB 大小上限，阻止可执行扩展名（.exe、.dll、.sh、.js……），并且文件名可防止路径遍历。
- 图片不受影响：PNG/JPG/WebP/GIF 的粘贴/拖拽仍走内置的图片处理路径。
- 国际化：中文 / 英文的提示消息与拖拽提示浮层。

安装

目前从 GitHub 分发（npm 发布待定）：

dsh plugin add github:yybukn/dsh-table-attach

用于本地开发：

dsh plugin --profile web add /path/to/dsh-table-attach

使用方法

1. 打开任意会话（它会提供工作区）。
2. 将 .xlsx / .csv / .pdf / .zip……拖拽到编辑器中，或复制一个文件并将其粘贴到编辑器中。
3. 提示消息会报告进度；成功后编辑器中会包含 @attachments/。
4. 发送消息——智能体即可读取所引用的文件。

粘贴表格单元格文本（从 Excel 中复制出来）会被视为普通文本并原样通过；它不会被转换为文件。

工作原理

- 宿主端（lib/index.js）注册了一个 Typert Remote 服务
tableAttach.saveFile(agent, payload)。它会校验载荷，将
路径保持在会话工作区内，对文件名去重，并以 0o644 写入。它作为 cordis 插件运行（无需构建步骤——纯 ESM + zod）。
- 客户端（lib/client.js）是一个 Web 打包产物。它在文档级别于对话插件的处理器之前拦截 paste/dragenter/dragover/drop，将文件进行 base64 编码，调用宿主远程服务，并将 @mention 插入到编辑器中（编辑器是一个 Lexical contenteditable——插入通过
execCommand("insertText") 完成，与编辑器自身使用的
beforeinput 路径相同）。

安全性

- 大于 50 MiB 的文件会在字节传输之前被拒绝。
- 可执行扩展名（.exe、.dll、.app、.sh、.js、.jar……）会被阻止。
- 文件名会被清理（不含目录、控制字符、点文件或遍历），并且目标路径经过验证，确保其始终位于工作区内部。
- 智能体只会看到相对于工作区的引用，而绝不会看到任意的绝对路径。

开发

dsh-table-attach/
├── lib/
│ ├── index.js # 宿主：cordis 插件 + Typert Remote 服务 │ └── client.js # 浏览器：拦截、上传、编辑器插入 ├── cordis.patch.yml # 宿主 bundle 的加载器入口 ├── dsh.plugin.json # 插件清单 └── package.json # 为 Web 平台导出 ./client

宿主运行在 DSH harness（Node）中；客户端运行在 Web GUI 中。从 npm 安装时，宿主的 peer 依赖（@deepseek-ai/cordis、@deepseek-ai/dsh-typert-protocol、zod）会从 profile 的共享依赖闭包中解析。若在 profile 之外进行本地 link: 安装，则需要让这些依赖可被解析（例如将 node_modules 符号链接到应用 bundle 中）——这些不属于包的一部分，且已被 git 忽略。

许可证

MIT