dsh-thrum

Readme

# dsh-thrum

<div align="center">

<img src="assets/cover.svg" alt="dsh-thrum 封面" width="100%" />

</div>

DeepSeek Harness (DSH) 输入氛围插件：在输入框上方展示一块 87 键 TKL 键盘 + 鼠标并实时高亮按键与鼠标操作，打字时喷火焰粒子、输入框轻震，AI 回答完成时播放提示音并整页轻震。

<div align="center">

![License](https://img.shields.io/github/license/lhf6623/dsh-thrum)
![version](https://img.shields.io/github/package-json/v/lhf6623/dsh-thrum)
![last commit](https://img.shields.io/github/last-commit/lhf6623/dsh-thrum)
![stars](https://img.shields.io/github/stars/lhf6623/dsh-thrum)
![Harness plugin](https://img.shields.io/badge/Harness--plugin-orange)

</div>

## ✨ 功能

- **键盘可视化**：87 键 TKL 布局，按键按下时翻面露出随机动物（与小动物共用动物池，池满顶掉最老一只），带平滑翻面动画。
- **小动物**：按频率自动翻出随机动物并驻留，同时最多显示 10 只，池满时新动物顶掉最老的一只；按下按键即刻在按下的键上翻出（加速一次自动翻）。翻出频率可选「关」：空闲不自动翻，按键翻出的动物 1.5 秒后自动翻回。
- **鼠标可视化**：左 / 中 / 右键与滚轮实时高亮，与方向键对齐布局。
- **打字火焰**：在输入框文字光标处按所选样式（关 / 火星 / 蓝焰 / 花火）喷出火焰粒子；选「关」则不显示（新增、删除、粘贴、中文输入都会触发；系统开启「减弱动态效果」时自动关闭）。
- **输入抖动**：每次输入给输入框一个轻微的水平震动，强度分「关 / 轻 / 中 / 强」。
- **回答反馈**：AI 回答完成时按所选样式（关 / 叮 / 风铃 / 泡泡）播放提示音；选「关」则不播放，并按独立的强度档位给整页一个轻微震动。

## 📦 安装

```bash
dsh plugin add github:lhf6623/dsh-thrum
```

## ⚙️ 配置

### 设置面板（推荐）

在 **设置 → 氛围** 中调整，改动即时生效并保存到本地：

| 分组     | 设置项                                                  |
| -------- | ------------------------------------------------------- |
| 键盘外观 | 显示键盘 · 透明度 · 小动物（翻出频率）                  |
| 打字反馈 | 打字火焰（关/火星/蓝焰/花火） · 输入抖动（关/轻/中/强） |
| 回答反馈 | 整页抖动强度 · 回答提示音（关/叮/风铃/泡泡）            |

### cordis.yml（部署级默认）

也可在 profile 的 `cordis.patch.yml` 中为插件配置默认值（作为设置面板之下的组装层）：

```yaml
- id: thrum
  name: "dsh-thrum"
  config:
    enabled: true # 键盘外观组总开关
    opacity: 0.5 # 键盘透明度
    moleFrequency: medium # 翻出频率（off / low / medium / high）；off=空闲不自动翻、按键翻出后自动翻回
    feedback: true # 打字反馈组总开关
    flame: ember # 打字火焰（off / ember / blue / spark）；off=不显示
    shake: off # 输入抖动（off / light / medium / strong）
    response: true # 回答反馈组总开关
    pageShakeLevel: off # 整页抖动强度（含 off=关闭，独立于输入抖动）
    sound: ding # 回答提示音（off / ding / chime / pop）；off=不播放
```

## 📝 版本记录

- 0.2.1 键盘宽度随输入框自适应（足够显示全部 / 只显键盘 / 过窄隐藏）；修复右侧插件占用时键盘定位偏移；抽取共享配置契约、修复输入抖动误依赖 flame、优化 caret 镜像节点、键盘翻面样式 class 化
- 0.2.0 设置面板数据驱动（下拉 / 滑杆 / 勾选）、配置精简（删除 pageShake 与 molePoolSize、动物池固定 10 只）、中英文界面跟随 DSH 系统语言；改用 clsx 拼接 class，样式尽量 class 化
- 0.1.36 新增「翻出频率：关」+ 动物池重做：自动翻动物驻留到池满被顶掉（「同时显示数量」真正生效）；「关」下按键翻出的动物 1.5 秒后自动翻回
- 0.1.35 全部样式改用 UnoCSS 原子类
- 0.1.34 设置迁移到 DSH settings 服务
- 0.1.33 TypeScript 源码拆分重构
- 0.1.28 更名为 dsh-vibe（本插件现名 dsh-thrum）
- 0.1.27 新增回答完成提示音 + 整页抖动
- 0.1.26 新增输入抖动
- 0.1.21 新增打字火焰效果
- 0.1.20 新增设置面板
- 0.1.15 内容区水平居中

## 📄 License

[MIT](./LICENSE)