前言¶
在 DSH 的插件化思路里，光标定制也可以作为一个独立能力接入。DeepSeek Harness 的界面里，鼠标会出现在很多不同状态中：默认状态、可点击状态、文本选择状态、等待状态、禁止状态等。如果只改系统光标，未必能精确对应 DSH 内部每一种 UI 状态；如果希望每个状态都有独立图案，并且设置保存到自己的 DSH profile、重启后仍然生效，dsh-cursor-theme 提供了一套按状态覆盖光标的方法。
下面介绍这个插件能做什么、如何安装、如何应用预设、如何自定义单个状态，以及 Windows / macOS 下的使用边界。
这是什么¶
auki-zy/dsh-cursor-theme 是面向 DeepSeek Harness 的 DSH 插件，用于按 UI 鼠标状态配置鼠标光标。
它把常见鼠标状态拆开，每个状态都可以单独设置：
- 光标图片；
- hotspot；
- size。
设置可以实时应用，并持久化到 dsh-settings profile，重启后保留。插件许可证为 MIT。
支持的状态¶
该插件覆盖 14 种 UI 鼠标状态：
default,
pointer,
text,
wait,
help,
not-allowed,
grab,
grabbing,
progress,
cell,
copy,
move,
resize-ew,
resize-ns
每种状态都可以独立配置图片、hotspot 和 size。
核心功能¶
下面按能力分节说明。
预设主题¶
插件提供 18 个原创预设主题，每个主题都覆盖全部 14 种状态。
你可以一键应用某个主题，也可以将主题下载为 ZIP 图片包。
自定义图片¶
插件内置 SVG 模板库，包含 25 个手绘图形。
你也可以上传自己的图片文件，支持：
- PNG；
- CUR。
上传限制为：
≤128×128
≤5 MB validated
ZIP 图片包¶
插件支持 ZIP 图片包导入和导出。
一个 ZIP 图片包的结构是：
- 每个状态一个 PNG；
- 一个
manifest.json。
这意味着你可以把一套光标导出为真实图片文件，检查、编辑、分享，再导入到另一个 DSH 环境中。
hotspot 与尺寸¶
插件提供 hotspot editor，可以设置：
X / Y
尺寸步骤为：
16 / 24 / 32 / 48
这样在调整光标时，不只是换图，还能控制点击命中点和显示尺寸。
预览¶
每个状态行会显示：
- 右侧：应用后的成品光标预览；
- 左侧：系统默认图标。
这样可以更清楚地看到当前替换的是哪个默认状态。
可访问性¶
插件的规则带有 fallback keyword。
当图片加载失败或不可用时，会降级为系统光标，不会使用 none。
系统级应用¶
在 Windows 上，插件可以一键写入系统光标方案，具体方式是：
registry + SPI_SETCURSORS
这意味着光标变化可以出现在系统层面。
macOS 侧提供 experimental Swift overlay，并附带 Accessibility guidance。
持久化与语言¶
配置会持久化到 dsh-settings profile，并可在重启后保留。
插件支持中文 / 英文，按 locale 驱动：
zh / en
安装与启用¶
DSH Desktop 使用 desktop profile：
dsh plugin --profile desktop add dsh-cursor-theme
安装后：
Restart DSH Desktop
然后打开：
Settings → Cursor Theme
如果是普通 dsh web / browser 环境，也可以可选安装：
dsh plugin --profile web add dsh-cursor-theme
安装后：
reload dsh web
然后打开：
Settings → Cursor Theme
package.json 声明的 Node engines 为：
^22.19.0 || >=24.0.0
典型用法¶
应用预设主题¶
打开：
Settings → Cursor Theme
然后点击一个 theme pill。
下载主题 ZIP¶
在主题旁边点击 download icon，即可下载该主题的 ZIP 图片包。
自定义单个状态¶
在某个 state row 旁边点击 Edit：
Edit next to a state row
然后可以：
- 上传 PNG / CUR；
- 或选择内置图形；
- 设置 hotspot / size。
导入 ZIP 图片包¶
打开：
Image pack → Import
可以导入一个 ZIP 图片包，例如 AI 生成的 pack。
ZIP 内应包含：
PNGs + manifest.json
Windows 系统级应用¶
在设置中选择：
Apply to system
一键写入系统光标方案。
重置¶
如果希望恢复默认，使用：
Restore system default
创建个人主题¶
有两种方式。
方式一：通过 ZIP 包¶
- 在 DSH 中打开
Settings → Cursor Theme。 - 使用
Image pack → Import导入一个 ZIP 图片包。 - ZIP 中应包含 PNG 文件和
manifest.json。 - 保留这个 ZIP，以便在其他环境再次导入。
这种方式不需要改代码。
方式二：fork 仓库¶
如果你愿意维护自己的主题包，可以 fork 仓库。
- Fork 仓库。
- 在
scripts/theme-art.mjs中添加主题条目，或者在data/themes-personal.json放置自己的 pack。 - 运行生成脚本：
node scripts/generate-theme-packs.mjs && node scripts/generate-assets.mjs
- 在
Settings → Cursor Theme中应用，或发布自己的 fork。
适用场景与注意¶
这个插件适合以下几类场景：
- 希望在 DSH Desktop 中区分不同鼠标状态；
- 希望给
dsh web/ browser 环境配置独立光标； - 希望把一套光标导出为 ZIP，再导入到其他环境；
- 在 Windows 上希望将光标方案写入系统；
- 想通过预设主题、内置图形或自定义图片做统一视觉。
使用前注意以下几点：
- 插件会以当前
dsh进程权限运行；安装前应检查源码与许可证，确认来源可信。 - 上传 PNG / CUR 有限制：
≤128×128、≤5 MB validated。 - 失败图片会降级为系统光标，不会变成
none。 - macOS 系统级能力是 experimental Swift overlay，需要结合 Accessibility guidance 使用。
- Windows 系统级应用会写入 OS cursor scheme，涉及
registry + SPI_SETCURSORS。 - DSH 社区目录属于独立站点，不等同于官方应用商店；它与 DeepSeek / 幻方没有官方从属关系。
获取¶
GitHub：
https://github.com/auki-zy/dsh-cursor-theme
DSH 插件目录条目：
dsh-cursor-theme 的核心价值在于：把鼠标光标从单一系统资源拆成 DSH 内部的 UI 状态资源，让每个状态都能独立配置、预览、导出和持久化。
