dsh-screenshot-paste

⚙️ 配置

插件开箱即用，零配置。保存目录按以下优先级解析：

优先级	配置来源	说明
1	设置项 dsh-screenshot-paste.dir	在 DSH 设置页或 ~/.dsh/settings.yaml 中配置，改动即时生效，无需重启
2	环境变量 DSH_SCREENSHOT_DIR	显式指定保存目录
3	默认值	插件目录下的 screenshots/（临时中转文件，已被 .gitignore 排除）；该路径不可用时自动回退至 ~/.dsh/screenshots

设置项（优先级 1）与其他 DSH 插件（如 dsh-ssh）使用同一配置机制。示例：

## 🎯 使用

1. 打开任意会话，在输入框工具区找到 📎 按钮
2. 点击 📎 打开粘贴板面板，粘贴、拖拽或浏览上传文件
3. 文件保存后，输入框上方显示引用芯片（图片芯片可点击预览）
4. 输入消息并发送，消息自动附带文件路径：

[附件引用] \screenshots\shot-142314.png \screenshots\报告-150601.docx

5. 智能体按文件类型处理：文本与 Office 文档可直接读取；图片的识别依赖视觉能力（见下文）

### 更换保存目录

面板底部「保存目录」旁点击**「更改」**，弹出系统原生文件夹选择框，选好后：

- 保存目录立即切换，面板显示新路径
- **旧目录中的文件自动迁移**到新目录（同名文件自动加 `-1`/`-2` 后缀，绝不覆盖）
- 已添加的引用路径同步更新，引用状态保持不变
- 面板提示「已迁移 N 个文件到新目录」

> [!NOTE]
> 保存目录的默认位置是插件目录下的 `screenshots/`（已加入 `.gitignore`，不会上传到 GitHub；首次使用时自动创建）。它是临时中转目录，**重装或更新插件时会被清空**——长期保留的文件请换到其他位置。

> [!NOTE]
> 模型拿到的是文件路径（如 `\screenshots\报告-150601.docx`），需要智能体的文件访问能力能读到该路径。受限沙箱会话可能无法访问保存目录之外的文件——如需使用，请将保存目录配置在会话工作区可达的位置（见「⚙️ 配置」）。

## 👁️ 识图能力（可选，需自行配置）

本插件**不包含**任何视觉模型或识图能力，仅负责文件落地与路径附带。若需要智能体识别图片内容（描述图片、提取图中文字等），必须另行配置。

**推荐：安装 [`claude-vision-skill`](https://github.com/asuojun/claude-vision-skill)** ——让无视觉能力的模型获得识图能力，把图片交给视觉模型识别后用文字返回：

1. 克隆仓库：`git clone https://github.com/asuojun/claude-vision-skill.git`
2. 按仓库 README 配置：将 `vision.js` 放入 DSH 技能目录，填写 API Key 与模型名
3. 默认推荐阿里云百炼千问模型（新用户有免费额度）；也支持 OpenAI 等任何 OpenAI 兼容格式的服务，改 `BASE_URL` 即可

**备选方案**：使用其他支持视觉的 skill，或选择支持图片输入的多模态模型。

两种方式由你的运行环境提供，与本插件完全解耦，配置与否不影响插件本身的功能。

> [!NOTE]
> 未配置视觉能力时：文本、Office 文档等文件照常处理；图片仍会以路径形式附带，但模型无法查看其内容，通常会明确说明这一点——**不会静默失败**。