dsh-image-picker: DeepSeek Harness Web GUI 附件选择插件

在 DeepSeek Harness Web GUI 的使用中，直接通过浏览器交互添加非图片文件较为困难，且存在路径获取限制。dsh-image-picker 插件在输入框左侧增加了一个文件选择入口，通过系统文件选择器规范了附件的注入流程。

插件介绍¶

该插件由 liujia-io 维护，旨在解决纯前端环境下无法获取文件绝对路径的问题，并提供统一的附件处理能力。它通过在会话输入框左侧添加一个按钮，允许用户通过系统文件选择器添加图片或文本类附件。

核心功能¶

1. 图片处理：图片通过合成 drop 注入官方附件管线，支持缩略图展示、数量与大小校验。
2. 文本处理：文本文件（.txt, .md, .docx）由浏览器读取后 POST 到本地服务端暂存，消息中仅插入包含路径和预览的回执。
3. 文件解析：支持 .docx 文件的解析，通过浏览器内的 ZIP 解析提取正文内容。
4. 安全护栏：单文件容量限制为 25MB，超出返回 413 错误；自动清洗文件名并加时间戳前缀。
5. 容错机制：若暂存接口不可用，自动回退为全文内联（单文件 3 万字符截断）。

安装与启用¶

使用官方安装命令添加插件：

dsh plugin --profile web add github:liujia-io/dsh-image-picker

安装后需重启 DSH Web 进程以生效。

使用方法¶

1. 点击输入框左侧的按钮，调用系统文件选择器。
2. 选中文件后，文件会被自动处理：
   - 图片：自动注入官方 ComposerAttachments 接口，随消息上传。
   - 文本：落盘至 ~/.dsh/picker-attachments/ 目录，输入框插入回执信息（包含保存路径、字符数和预览）。
3. Agent 可以通过读取工具按需访问本地暂存的文本文件。

注意事项¶

• 浏览器安全策略限制无法直接获取文件绝对路径，因此文本文件采用服务端暂存方式。
• 单文件容量上限为 25MB，超出会返回 413 错误。
• 文本类附件的正文内容不进入会话上下文，Agent 需使用工具读取。
• 插件依赖官方 ComposerAttachments 接口和 host 壳环境。
• 暂存目录固定为 ~/.dsh/picker-attachments/。

结尾¶

该插件通过本地暂存和官方管线复用，解决了 DSH Web 环境下的文件输入限制问题，提升了附件交互的稳定性。更多信息请参考插件目录或源码仓库。