Zenjibad/dsh-any-attachment

dsh-any-attachment

一个 DeepSeek Harness（dsh）插件包，让 Web UI 能够以无路径 @ 提及的方式附加任意类型的文件：输入 @ 选择工作区文件，或拖入文件（或使用 + 按钮）将其标记到消息中——随后 agent 会用自己的工具自行读取该文件。提及只携带名称，从不携带路径。光栅图像仍走内置的图像管线。无需修改 harness 仓库，也不会向你的工作区写入任何内容。

提及的工作方式

- @ 列表：在编辑器中输入 @，菜单会以递归、扁平的方式显示会话工作区的文件（src/main.ts、docs/guide.md……）。继续输入可过滤；选中一个后，草稿中会插入一个无路径的 @name 标签。
- 拖放 / + 按钮：将本地文件拖到编辑器上（或点击 +），文件会被私密存储；草稿中会新增一个 @ 标签——没有路径，没有盘符。
- 照常发送（Enter 或发送按钮）——每个提及标签在发送的消息中都会解析为其确切文件位置（@name (C:\...\absolute\path)），因此 agent 会直接读取该文件，而不是猜测它在哪里。
- 光栅图像（png/jpeg/webp/gif）仍走内置的图像管线（视觉模型可以看到它们）。
- 文件存放在 $DSH_HOME/attachments-any/ 下——私密，绝不会倾倒入工作区。

安装

dsh plugin --profile web add https://github.com/Zenjibad/dsh-any-attachment

重启 dsh web，然后强制刷新页面。

限制

| 防护项 | 值 |
| --- | --- |
| 单文件最大字节数 | 25 MB |
| @ 列表深度 | 工作区根目录下 4 层 |
| @ 列表条目数 | 500（已排序，以 / 分隔的相对路径） |
| @ 列表排除项 | 隐藏（以 . 开头）条目和 node_modules |
| 名称 | 仅限 basename；拒绝路径穿越、分隔符、盘符 |
| 存储 | $DSH_HOME/attachments-any 下的私密存储，绝不在工作区中 |

工作原理

- Host（lib/）：注册一个 RPC 通道 /attachments-any（权限 trusted-host，与 /api 相同的局域网围栏）。list { sessionId } 递归遍历会话工作区并返回相对路径；upload 校验 base64/大小/名称，写入私密存储，并返回存储后的名称（用 -2 后缀去重）。一段系统提示词会告知 agent，被引用的 @name 位于其工作目录下的 ./，否则位于私密存储中。
- Client（client/）：编辑器 + 按钮（conversation.input.left）、捕获阶段的拖放处理器，以及一个 @file 输入触发源（工作区自动补全、无路径选择）。光栅图像走 createDraftImages/addImages；其他所有内容通过该通道上传，并通过 inputActions.setDraft 将提及 @ 追加到编辑器草稿中。

agent 会用自己的工具读取解析路径处的文件——无需提取、无需下载 UI、无需特殊发送流程。

测试

node --test
许可证

MIT