前言¶
在 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 狀態資源，讓每個狀態都能獨立配置、預覽、導出和持久化。
