dsh-cursor-theme

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-cursor-theme

> 🖱️ Per-state mouse cursor customization for DeepSeek Harness — give every UI state (default, pointer, text, wait, not-allowed, …) its own PNG/CUR cursor, applied live and persisted across restarts.

[中文文档](README.zh.md) · [Requirements](docs/requirements.md) · [Feasibility](docs/feasibility.md) · Published on [npm](https://www.npmjs.com/package/dsh-cursor-theme) · Listed on [DSH 1024Store](https://github.com/imsai-sh/awesome-deepseek-harness-plugins/blob/main/catalog/plugins/auki-zy--dsh-cursor-theme.json)

---

## ✨ Features

- 🎯 **Per-UI-state overrides** — 14 mouse states (default, pointer, text, wait, help, not-allowed, grab, grabbing, progress, cell, copy, move, resize-ew, resize-ns), each with its own image, hotspot and size
- 🎨 **18 original preset themes** — every theme covers **all 14 states** with baked PNGs:
  - 6 color palettes: Aurora, Honey, Mint, Sunset, Graphite, High Contrast
  - 12 creative themes: **Paw 🐾 · Energy ⚡ · Neon 🌃 · Emoji 😀 · Pixel 👾 · Weather ⛅ · Origami 📐 · Astro 🧑🚀 · Candy 🍬 · Ghost 👻 · Hi-Vis XL 🔍 (48px) · Pop 🎈**
  - One click to apply; every theme is also downloadable as a ZIP image pack
- 🖼️ **Built-in SVG template library** (25 hand-drawn shapes) + upload your own PNG/CUR (≤128×128, ≤512 KB validated)
- 📦 **Image pack import/export** — one ZIP (a PNG per state + `manifest.json`), inspect/edit/share real image files, or generate with an AI
- 🪟 **Apply to system (Windows)** — one click writes the theme into the OS cursor scheme (registry + `SPI_SETCURSORS`), visible in Explorer and every app; macOS: experimental Swift overlay + Accessibility guidance
- 📍 **Hotspot editor** (X/Y) for pixel-accurate clicks · 🔍 size steps 16/24/32/48
- 👁️ Per-row finished-cursor preview (right) + system-default icon (left) so you always know what you are replacing
- ♿ **Accessibility** — every rule carries a fallback keyword; failed images degrade to the system cursor, never `none`
- 💾 Persisted to the profile (dsh-settings), survives restarts
- 🌐 Bilingual (locale-driven zh/en)

## 📦 Install

```sh
# DSH Desktop (the GUI runs the `desktop` profile) — also installable from the Community Market (1024Store)
dsh plugin --profile desktop add dsh-cursor-theme

# Plain dsh web / browser (optional)
dsh plugin --profile web add dsh-cursor-theme
```

Restart DSH Desktop (or reload `dsh web`), then open **Settings → Cursor Theme**.

## 🎯 Usage

| Action | How |
|---|---|
| Apply a preset theme | Settings → Cursor Theme → click a theme pill |
| Download a theme as ZIP | Click the download icon next to a theme |
| Customize one state | Edit next to a state row → upload PNG/CUR or pick a built-in shape → set hotspot/size |
| Import a ZIP pack | Image pack → Import (e.g. a pack generated by an AI) |
| Apply to the whole OS (Windows) | Apply to system → one click |
| Reset everything | Restore system default |

## 🛠️ Development

```sh
npm install
npm run check    # typecheck + build + test
npm run build    # host lib/ + client client/client.js
```

### Asset pipeline

- `scripts/theme-art.mjs` — original hand-drawn art for the 12 creative themes (per-state SVG + decorators: glow / gloss / dots)
- `scripts/generate-theme-packs.mjs` — renders every theme into 32×32 (or 48×48) PNGs via `@resvg/resvg-js`, emits `data/theme-packs/.zip` (image packs) + `data/themes-.json`
- `scripts/generate-assets.mjs` — merges packs into `data/assets.json` (built-in preset catalog)
- Client is bundled by esbuild into a single file (`client/client.js`), with react and `@deepseek-ai/*` kept external (injected by the host `__ModuleLoader__`)

### Market catalog

- `docs/catalog/manifest.json` + `docs/catalog/v1/plugins.json` — standard DSH Community Market catalog source (v1 contract), deployable to any host that serves JSON with the right content-type (e.g. Cloudflare Pages / Vercel)
- npm publishing: `npm publish` (requires a public npm token with *bypass 2FA* for publishing)

## 📁 Layout

```
├── package.json            # dsh.bundle + dsh.client declarations
├── cordis.patch.yml        # layer insertion patch
├── docs/
│   ├── feasibility.md      # feasibility analysis
│   ├── requirements.md     # requirements (draft)
│   └── catalog/            # standard market catalog source
├── src/
│   ├── index.ts            # host entry (settings namespace registration)
│   ├── schema.ts           # config schema (dsh-settings)
│   ├── system.ts           # Windows registry apply / macOS Swift overlay
│   ├── cur.ts              # PNG → .cur encoding
│   └── client/             # client (esbuild → single-file client/client.js)
│       ├── index.ts        # client entry (style injection + settings.section)
│       ├── section.tsx     # settings UI (states/assets/themes/hotspot/size/preview/reset)
│       ├── style.ts        # cursor CSS generator
│       ├── states.ts       # state → CSS selector mapping
│       ├── assets.ts       # built-in asset catalog
│       ├── themes.ts       # built-in theme catalog
│       ├── pack.ts         # theme pack export/import + validation
│       ├── locales.ts      # zh/en dictionaries
│       └── types.ts        # client-local structural types
├── scripts/
│   ├── build-client.mjs    # esbuild bundle + __ModuleLoader__ banner
│   ├── theme-art.mjs       # original creative theme art
│   ├── generate-theme-packs.mjs # PNG rendering → packs + built-in data
│   └── generate-assets.mjs # merge packs into data/assets.json
├── data/                   # generated assets (theme packs, built-in catalog)
└── tests/                  # unit tests (34)
```

## 📄 License

MIT