dsh-salary-cat

Readme

# dsh-salary-cat

[![npm version](https://img.shields.io/npm/v/dsh-salary-cat.svg)](https://www.npmjs.com/package/dsh-salary-cat)
[![npm downloads](https://img.shields.io/npm/dm/dsh-salary-cat.svg)](https://www.npmjs.com/package/dsh-salary-cat)
[![license](https://img.shields.io/npm/l/dsh-salary-cat.svg)](https://www.npmjs.com/package/dsh-salary-cat)

月薪猫 —— DeepSeek Harness Web UI 右下角常驻动画宠物。

A self-contained Cordis plugin that pins an animated mascot GIF to the
bottom-right corner of the DeepSeek Harness web UI.

## 仓库 / Repository

<https://github.com/sorry123maker/dsh-salary-cat>

## 功能 / Features

- 右下角常驻显示动画 GIF（月薪猫），轻微上下浮动
- **长按（450ms）即可拖拽**，松手自动记住位置，无需配置坐标
- 位置按浏览器保存在本地（localStorage），刷新后还在
- 尺寸、显隐、无障碍文案可配置（v1.0.0+）
- 图片加载失败自动隐藏，不影响页面

## 交互 / Interaction

- **长按拖拽**：按住猫 450ms 进入拖拽模式（猫会半透明高亮），拖到任意位置松手即保存
- 点击（短按）无副作用；拖拽中不会触发页面滚动/选择
- 重置位置：清除浏览器 localStorage 中 `dsh-salary-cat:pos` 键即可回到右下角

## 安装 / Install

在 web profile 中安装：

```bash
dsh plugin --profile web add dsh-salary-cat
```

或手动在 `~/.dsh/profiles/web/package.json` 加入依赖并在
`dsh.profile.bundles` 中登记，然后 `pnpm install`，重启 `dsh web` 生效。

## 配置 / Config

组合行 `salary-cat` 支持以下 config：

| 字段 | 默认值 | 说明 |
| --- | --- | --- |
| `gifPath` | 包内 `assets/salary-cat.gif` | 自定义 GIF 的绝对路径 |
| `routePath` | `/salary-cat.gif` | 浏览器加载图片的 URL |
| `configPath` | `/salary-cat.json` | 配置 JSON 端点（一般无需改动） |
| `maxBytes` | 8 MiB | 读取文件大小上限 |
| `size` | 200 | 猫的显示尺寸（px） |
| `hidden` | `false` | `true` 时完全隐藏 |
| `alt` | `月薪猫` | 无障碍图片标签 |

> 位置（right/bottom）**不再配置**：通过长按拖拽调整，位置保存在浏览器本地。

示例：

```yaml
- id: salary-cat
  name: dsh-salary-cat
  inject: [fs, webServer]
  config:
    size: 150
    alt: 打工人猫咪
```

## 换图 / Customizing the GIF

直接替换包内 `assets/salary-cat.gif`（同名即可），刷新页面生效；
或通过 `gifPath` 指向自己的文件。

## 卸载 / Remove

```bash
dsh plugin --profile web remove dsh-salary-cat
```

## License

MIT © [zhuyh](https://github.com/sorry123maker)