dsh-plugin-type

为 DSH 打字过程添加主题特效、萌宠陪伴、连击动画和打字音效。支持中文输入法、浅色与深色界面，以及中英文切换。

主题

主题	底部效果	打字效果	连击	音效
奶油手帐	猫狗萌宠	骨头饼干	手帐贴纸	连贯钢琴旋律
DeepSeek	蓝鲸	气泡	鲸鱼水花	气泡音
极光流星	流光	小光晕烟花	青紫热力	biu 激光音
点阵节奏	LED 点阵	蓝绿粒子	像素进度条	真实青轴键盘录音
大肥鱼（默认）	快速追键、转向和到位小跳	低密度红色爱心	无背景小尺寸表情轮换	轻柔铃音

打字、底部、全屏、连击与音效均可独立开关。主题卡片单排展示；音效开关在左下角，语言切换在右下角。音效默认关闭，开启或点击预览可试听。

使用

在 DSH「插件 → 添加插件」中输入完整 npm 包名：

dsh-plugin-type

此输入框按包名或地址解析，不是模糊搜索。包名为 dsh-plugin-type，直接输入该名称安装。镜像若尚未同步新版本，可切换 npm 官方源重试。

也可让 DSH 的插件管理工具安装到当前 profile：

plugin_manager  action: install_bundle  target: "dsh-plugin-type"

也可以把此目录作为本地插件加载（plugin_manager 的 install_bundle，target 传绝对路径）。入口配置见 package.json 与 cordis.patch.yml。刷新 DSH 后，可从输入框旁的键盘图标选择主题并设置特效。

此项目依赖 DSH 提供的 ModuleLoader、React 和 UI slots，不能作为独立网页直接运行。运行资源均随 client.js 内嵌，无需构建，也不依赖运行时外部资源下载。

首次使用默认大肥鱼，语言自动跟随系统；手动选择中文或 EN 后保存。配置仅保存在当前浏览器的 dsh.want-to-type.config.v1。

更新后无法启动

若日志出现 @moonkingdom/want-to-type: import failed 和 duplicate factory registration for "@local/want-to-type"，说明旧客户端仍使用开发期模块名。当前版本的 client.js 注册 ID、package.json 的 name 和 cordis.patch.yml 的模块名统一为 dsh-plugin-type。

从旧包迁移时，先卸载 @moonkingdom/want-to-type（本地开发环境还可能有 @local/want-to-type），再安装 dsh-plugin-type，避免同时加载两份插件。完成后重启 DSH，并在插件页启用「打字特效」。存储键和界面挂载 ID 延续旧值，原有主题和音效配置可以保留。

新包从 dsh-plugin-type@1.4.1 开始，包含模块注册修复与五个主题。旧包的安装不会自动切换到新包名，请按上述步骤迁移。

动效与音效规则

• 全屏光晕：最近一秒超过 4 次有效按键，并持续 1 秒后触发一次约 0.9 秒的光晕，随后自动淡出。持续高速输入不会常亮或重复触发；降速后再次达到条件才重新触发。奶油手帐为暖色，DeepSeek 和大肥鱼为浅蓝色，极光与点阵为彩虹色。
• 连击：沿用 1 秒计数窗口。热力画面整体缩放为原设计的 30%；手帐和鲸鱼背景保持稳定，仅数字和内部细节运动。
• 萌宠与鲸鱼：跟随物理键位，停止输入后消退；鲸鱼肚子、眼睛及眼睛外框均为不透明白色。
• 大肥鱼：像猫狗一样跟随物理键位快速移动、转向，到位后轻轻一跳，停打 3 秒后消失。连击采用小尺寸无背景 UI，挥手、害羞、开心和庆祝每 0.6 秒轮换。打字每次最多一颗红色爱心，触发间隔至少 160 毫秒，不随连击增加密度。减少动态效果时使用静态形象。
• 钢琴：三段原创八小节乐句，按谱面节奏随输入推进；停打后暂停，30 秒内续奏，超过 30 秒随机换另一段从头开始。预览不改变实际乐句进度。
• 键盘：内嵌真实 Cherry MX Blue ABS 采样；不同键位采用不同录音，空格与退格使用独立采样。
• 长按重复、快捷键与输入法提交不重复计速或发声；输入法组词期间的物理按键可正常触发。
• 尊重系统减少动态效果设置；切换后台、窗口失焦、关闭开关或卸载时清理对应效果。

仅在 DSH 的 textarea/contenteditable 内响应输入，不申请操作系统输入监控或辅助功能权限，不新增运行时网络请求。

开发与检查

无需安装依赖，使用支持 Node.js 内置测试运行器的版本：

node --check client.js
npm test

测试使用 DOM、Canvas 与 Web Audio 替身，覆盖主题、配置、输入法、连击、速度触发、音效、乐句续奏与资源清理。最终视觉和声音以 DSH 实际运行效果为准。

目录

• client.js：客户端逻辑及内嵌素材。
• icon.png：C2 无嘴巴蓝鲸插件图标（256 × 256）。
• index.js：DSH 宿主入口。
• cordis.patch.yml：插件挂载配置。
• locale/：插件元数据翻译。
• tests/：无依赖测试。

第三方素材

素材来源、修改说明与版权许可见 THIRD_PARTY_NOTICES.md 和 LICENSE-*.txt。原作者的署名与许可随项目保留。

鲸鱼娘动画复用自 PC2005-cloud/dsh-pet。形象原型「溟月」来自 @上善无形，DeepSeek 女仆鲸鱼娘设计来自 @ZipZipPipe，属于社区二创，非 DeepSeek 官方形象。该主题素材及其改编遵循 CC BY-NC-SA 4.0，仅限非商业使用，改编素材须以相同许可共享；代码的 MIT 声明不覆盖这些素材。

发布

目标 npm 包名：dsh-plugin-type。改名后需要以新名称发布，旧包的既有版本不会自动迁移。版本号遵循 SemVer，engines.dsh 限制最低 DSH 版本；发布前执行 npm pack --dry-run 核对文件清单，再用 npm publish --access public 上传。

GitHub 仓库的可见性由仓库设置单独控制。