前言¶
DeepSeek Harness (DSH) 是一个以插件为核心的智能体开发平台，编写器是其核心交互组件。原生的 + 按钮功能较为单一，难以满足在对话中快速引用文件、管理附件或使用斜杠命令的需求。dsh-add-assets 插件旨在扩展编写器的交互能力，通过菜单化和可视化界面，提供更丰富的文件操作入口。
介绍¶
该插件是 DeepSeek Harness Web 客户端的扩展，由 navid-kianfar 维护。它将编写器工具栏开头的 + 按钮替换为一个选项菜单，允许用户直接添加文件、文件夹、上传本地图片或触发斜杠命令。选中的路径会以内联引用芯片的形式进入草稿，支持全屏图片预览和文件卡片展示。
核心功能¶
- 菜单集成：提供四个主要选项：添加文件、添加文件夹、上传设备图片和斜杠命令。这些选项由对应的键盘快捷键触发。
- 路径选择器：支持 Project（工作区）和 This machine（主机）两个作用域。
- Project 作用域通过 Harness 的文件引用服务浏览项目文件。
- This machine 作用域通过插件提供的接口浏览主机文件系统，支持路径搜索和导航。
- 内联引用芯片：选中的路径会被转换为内联芯片。其隐藏值为
@path提及格式，便于模型识别。若缺少触发管道，则退化为纯文本。 - 附件预览：接管编写器的附件展示区域。图片支持点击全屏查看，其他文件显示为带有缩略图和元数据的卡片。
- 设置卡片：在插件设置页面集中管理所有配置项，支持保存和丢弃修改。
典型用法¶
- 快捷键操作：
- 按
⌘U或Ctrl+U打开文件选择器。 - 按
⇧⌘U或Ctrl+Shift+U打开文件夹选择器。 - 按
⌘/或Ctrl+/打开斜杠命令菜单。
- 按
- 选择器交互：
- 在搜索框输入路径（如
~/Down）可过滤目录。 - 使用
↑/↓键移动高亮，Enter选中，Esc关闭。 - 选中项目后，按
Cmd+Enter或Ctrl+Enter一次性添加所有选中的项目。
- 在搜索框输入路径（如
环境与依赖¶
- DeepSeek Harness：需要版本 0.1.5-rc.2，且必须使用 Web 客户端 (
dsh web)。 - 运行环境：Node.js 版本需为
^22.19或>=24。 - 包管理器：PATH 环境变量中需包含
pnpm。 - 依赖服务：插件依赖 Harness 的以下服务（若缺失将导致对应功能不可用）：
dsh-file-reference服务：Project 标签页不可用，仅显示 This machine。inputTriggers服务：斜杠命令行不可用，且选中路径将作为纯文本追加。
注意事项¶
- 在 IME（输入法）组合输入期间，快捷键可能会被拦截。
- 如果没有触发管道，被选中的芯片会被追加为纯文本而非芯片形式。
- 路径中包含双引号或控制字符时，无法写入为提及文本，此类选择会被跳过。
结语¶
该插件通过菜单化和可视化预览，优化了在 DSH 编写器中管理文件和附件的流程。对于需要在对话中频繁引用本地文件或项目资源的场景，提供了直接的操作入口。
