dsh-refpics
Reference-image search for the dsh web GUI: a model-facing search_refs tool that queries Openverse (keyless) or Pexels / Pixabay / Unsplash (API key) for design reference images, plus a browser half that renders the results inside the conversation as a Pinterest-style masonry wall with a lightbox, a dsh-better-sidebar board tab, one-click batch/page controls, proxied downloads, and save-to-Eagle. 适合需要设计参考图检索的用户；Openverse 免密钥，其他图库需自备 API 密钥。
インストール
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Ghz114514/dsh-refpicsドキュメント
README 全文を読む ↗Configuration
Settings → Plugins → Reference pictures (the ref-pics settings section; effective immediately):
| Key | Default | Meaning |
|---|---|---|
pexelsKey | empty | Pexels API key (free at pexels.com/api); empty disables the provider |
pixabayKey | empty | Pixabay API key (free at pixabay.com/api/docs); empty disables the provider |
unsplashKey | empty | Unsplash access key (free at unsplash.com/developers); empty disables the provider |
defaultProvider | auto | Provider preferred when a call passes auto |
defaultCount | 12 | Image count used when a call omits count (1-30) |
eaglePort | 41595 | Eagle local API port; 0 disables the save-to-Eagle routes |
eagleToken | empty | Optional Eagle API token (only when Eagle requires one) |
Keys and the Eagle token are marked secret in the settings schema (masked in the card) and are
never included in logs, tool output, or model-facing text.
The browser half exposes four same-origin host routes: GET /refpics/search (direct board search),
GET /refpics/download (proxied attachment download, 30 MiB cap, image content types only),
POST /refpics/eagle (add one image to the local Eagle app), and GET /refpics/eagle/status
(Eagle health). The Eagle routes only ever talk to 127.0.0.1:.
Tool usage
The model calls search_refs when the user asks for reference pictures, moodboards, or visual
inspiration. Arguments:
| Argument | Type | Default | Meaning |
|---|---|---|---|
query | string | required | Natural-language description (style, subject, mood, colors, medium) |
count | integer | 12 | Images per page (1-30) |
provider | enum | auto | auto | openverse | pexels | pixabay | unsplash |
orientation | enum | any | any | landscape | portrait | square |
page | integer | 1 | Page of the same query (more results) |
Example prompts that trigger it: "帮我找几张极简客厅的参考图", "show me reference images of brutalist poster layouts", "做一个赛博朋克风格的 moodboard".