---
## ✨ Features
| Capability | Description |
| --- | --- |
| 🔀 **Vision auto-routing** | Attach an image in a text-only session with no manual switching — requests with images are auto-dispatched to the official vision model `deepseek-v4-flash-vision-exp`; text requests stay on the text model at zero cost |
| 📎 **Generic file attachments** | Stock DSH only accepts images; this plugin lets you drop/paste **any file** (docx/xlsx/pdf/txt/zip…) → attachment card → persisted → agent reads by path |
| 🗂️ **File-type icons** | Cards show a colored type tile per extension (Word blue W / Excel green X / PDF red P…) |
| 💾 **Durable storage** | Files saved under `~/.dsh/attachments/v1/files/`; history keeps the block and the absolute path |
| 🛡️ **Crash fix** | Fixes `Cannot read properties of undefined (reading 'startsWith')` when sending/removing file drafts |
| 🧩 **Shipped core patches** | Replacement manifest for 6 core files + a one-click in-place repacker that modifies the DSH Desktop core |
---
## ⚠️ Toggle explained: two features, two mechanisms (important)
People often wonder why the slider in DSH's plugin list doesn't control file attachments. That's because the two features live on **two completely different layers**:
| Feature | Lives on | How it's enabled | Does the plugin-list toggle control it? |
| --- | --- | --- | --- |
| 🔀 **Vision routing** | the `dsh-periscope` plugin **bundle** | loaded at startup via the plugin list | ✅ **Yes** — the toggle switches exactly this |
| 📎 **File attachments** | DSH's **6 core packages** (inside `app.asar`) | `install.ps1` in-place patches `app.asar`; **fixed once packaged** | ❌ **No** |
**Why?**
- **Vision routing is a plugin**: it's loaded at runtime through DSH's plugin system. The plugin-list slider controls whether the `dsh-periscope` bundle is loaded, so it only affects vision routing.
- **File attachments are a core patch**: DSH core's `session.prompt` wire schema is a **module-internal constant** in `dsh-host-apiproxy` that a third-party plugin **cannot extend at runtime**. Giving DSH an "any file" capability requires **directly modifying the core**, and `app.asar` is packed once — it's **outside the plugin's runtime toggle**.
**What this means in practice**:
- Whether file attachments work depends only on whether `app.asar` **has been patched** (whether `install.ps1` was run). It has **nothing to do with the slider**: patched → turning the slider off leaves file attachments working; not patched → the slider can't help.
- The slider's visible effect is limited to the **vision-routing** half.
> ✅ So the slider isn't pointless — it just governs **vision routing**. **File attachments need `install.ps1` to patch `app.asar`.** Treat the two separately.
---
## 🚀 One-click install (recommended)
> **Only works with the [DSH Desktop client](https://www.dshdesktop.cn/)** (the form where the core is packed into a single `app.asar`). Operate on **Windows**, and **re-do this after every DSH upgrade**.
Published to npm: [`dsh-periscope@0.3.4`](https://www.npmjs.com/package/dsh-periscope). The repo ships a one-click `install.ps1` that does "install the bundle + fix the version + repack `app.asar`" in a single step.
### A. From GitHub (zip / clone)
```powershell
# 1) Fully quit DSH Desktop
# 2) In the repo dir, run:
Set-ExecutionPolicy -Scope Process Bypass -Force
.\install.ps1
```
### B. From npm
```powershell
npm install dsh-periscope
npx dsh-periscope-install
```
Or use the DSH plugin entry directly:
```bash
dsh plugin add dsh-periscope@0.3.4 # exact version -> plugin list shows the right version
```
**The script does**: quit check → back up `app.asar` → install/update the bundle at the exact version via `dsh plugin add dsh-periscope@
