鼠标光标主题 auki-zy/dsh-cursor-theme

dsh-cursor-theme

🖱️ 为 DeepSeek Harness 自定义鼠标各种状态的图案 —— 每个 UI 状态（默认、点击、文本、等待、禁止……）都可以换成你喜欢的 PNG/CUR 光标，实时生效、跨会话保存。

English · 需求文档 · 可行性分析 · 已发布到 npm · 已收录于 DSH 1024Store · 已收录于 dshfind · 发布流程

上面每个格子展示一套主题的全部 14 种鼠标状态。除预设主题外，你导入的 personal 主题 也会出现在这里——见下方「个人主题」章节。

✨ 功能

- 🎯 按 UI 状态独立配置 —— 14 种鼠标状态（default、pointer、text、wait、help、not-allowed、grab、grabbing、progress、cell、copy、move、resize-ew、resize-ns），每个状态可单独设置图案、热区与尺寸
- 🎨 18 套原创预设主题 —— 每套完整覆盖全部 14 状态（内置烘焙 PNG）：
- 6 套配色：极光、蜜糖、薄荷、晚霞、石墨、高对比
- 12 套创意主题：猫爪 🐾 · 能量充能 ⚡ · 霓虹夜城 🌃 · 表情包 😀 · 像素 8-bit 👾 · 天气 ⛅ · 折纸 📐 · 太空人 🧑🚀 · 糖果玻璃 🍬 · 幽灵小镇 👻 · 高可见放大 🔍（48px）· 波普圆点 🎈
- 一键应用；每套主题还可一键下载为 ZIP 图片包
- 🖼️ 内置 SVG 模板库（25 个原创形状）+ 上传自己的 PNG/CUR（≤128×128、≤5MB 校验）
- 📦 图片包导入/导出 —— 一个 ZIP（每状态一张 PNG + manifest.json），可直接查看、修改、分享真实图片文件，或用 AI 生成后导入
- 🪟 应用到系统（Windows） —— 一键把主题写入系统光标方案（注册表 + SPI_SETCURSORS），Explorer 与所有应用立即生效；macOS 实验性 Swift 覆盖层 + 辅助功能权限引导
- 📍 热区编辑（X/Y）点击精确 · 🔍 尺寸档位 16/24/32/48
- 👁️ 每行右侧成品光标预览 + 左侧系统默认图标 —— 始终清楚自己正在替换什么
- ♿ 无障碍 —— 每项规则必带 fallback 关键字，图案失效自动回退系统光标，永不隐藏
- 💾 配置持久化到 profile（dsh-settings），重启保留
- 🌐 中英双语（locale 机制）

📦 安装

DSH Desktop（GUI 运行的是 desktop profile）—— 也可从插件市场（1024Store）安装
dsh plugin --profile desktop add dsh-cursor-theme

纯 dsh web / 浏览器（可选）
dsh plugin --profile web add dsh-cursor-theme

重启 DSH Desktop（或刷新 dsh web），打开 设置 → 光标主题。

🎯 使用

| 操作 | 方法 |
| 套用预设主题 | 设置 → 光标主题 → 点击主题 |
| 下载主题 ZIP | 点击主题旁的下载图标 |
| 自定义单个状态 | 状态行点「编辑」→ 上传 PNG/CUR 或选内置形状 → 设置热区/尺寸 |
| 导入 ZIP 图片包 | 图片包 → 导入（例如 AI 生成的图片包） |
| 应用到整个系统（Windows） | 应用到系统 → 一键生效 |
| 全部还原 | 恢复系统默认 |

🎨 个人主题（Personal）—— Fork 自己的主题

宣传图上带 Personal 徽章、虚线边框、排在最后的那个格子，就是你自己的主题（示例：cat-sitiao）。两种方式让你的主题永久化：

方式 A —— ZIP 图片包（无需写代码）
1. 在 DSH 中：设置 → 光标主题 → 导入任意 ZIP 图片包（每状态 PNG + manifest.json——可先导出一套内置主题作为模板，或用内置 AI 提示词生成一套）
2. 把 ZIP 存在自己的笔记/仓库里，随处可重新导入

方式 B —— Fork 仓库（推荐给贡献者）
1. Fork 本仓库（Fork 就是你的独立副本，自行管理）
2. 在 scripts/theme-art.mjs 里添加你的主题条目（复制一个现有的改配色/图案即可），或把自己的图片包放到 data/themes-personal.json（格式 { "schema": 1, "name": "...", "states": { ... } }）
3. 运行 node scripts/generate-theme-packs.mjs && node scripts/generate-assets.mjs 烘焙
4. 在 设置 → 光标主题 中应用，或发布你的 Fork / 提 PR 分享

你的 Fork 完全属于你——自由定制配色与图标，不用担心上游改动影响（Fork 相互独立）。

🛠️ 开发

npm install
npm run check # typecheck + build + test
npm run build # 构建宿主端 lib/ 与客户端 client/client.js

素材管线

- scripts/theme-art.mjs —— 12 套创意主题的原创手绘矢量素材（逐状态 SVG + 装饰器：发光 / 高光 / 圆点）
- scripts/generate-theme-packs.mjs —— 用 @resvg/resvg-js 把每套主题渲染成 32×32（或 48×48）PNG，产出 data/theme-packs/<id>.zip（图片包）+ data/themes-<id>.json
- scripts/generate-assets.mjs —— 把主题包合并进 data/assets.json（内置预设目录）
- 客户端经 esbuild 打包为单文件 client/client.js（external 仅 react 与 @deepseek-ai/，由宿主 __ModuleLoader__ 注入）

插件市场

- docs/catalog/manifest.json + docs/catalog/v1/plugins.json —— DSH Community Market 标准目录源（v1 合约），可部署到任何能正确返回 JSON content-type 的托管平台（如 Cloudflare Pages / Vercel）
- npm 发布：npm publish（需要带 bypass 2FA* 的公共 npm 发布 token）

📁 目录结构

├── package.json # dsh.bundle + dsh.client 声明 ├── cordis.patch.yml # 层插入补丁 ├── docs/ │ ├── feasibility.md # 可行性分析 │ ├── requirements.md # 需求文档 │ └── catalog/ # 标准市场目录源 ├── src/ │ ├── index.ts # 宿主端入口（settings 命名空间注册） │ ├── schema.ts # 配置 schema（dsh-settings） │ ├── system.ts # Windows 注册表应用 / macOS Swift 覆盖层 │ ├── cur.ts # PNG → .cur 编码 │ └── client/ # 客户端（esbuild 打包为单文件 client/client.js） │ ├── index.ts # 客户端入口（样式注入 + settings.section 注册） │ ├── section.tsx # 设置界面（状态/素材/主题/热区/尺寸/预览/还原） │ ├── style.ts # cursor CSS 生成器 │ ├── states.ts # 状态 → CSS 选择器映射表 │ ├── assets.ts # 内置素材目录 │ ├── themes.ts # 内置主题目录 │ ├── pack.ts # 主题包导出/导入与校验 │ ├── locales.ts # 中英文案 │ └── types.ts # 客户端结构类型 ├── scripts/ │ ├── build-client.mjs # esbuild 打包 + __ModuleLoader__ banner │ ├── theme-art.mjs # 原创创意主题素材 │ ├── generate-theme-packs.mjs # PNG 渲染 → 图片包 + 内置数据 │ └── generate-assets.mjs # 合并主题包到 data/assets.json ├── data/ # 生成产物（主题图片包、内置目录） └── tests/ # 单元测试（34 个）

📄 License

MIT