dsh-warm-reminder

Readme

<h1 align="center">DSH Warm Reminder · 温馨提醒助手</h1>

<p align="center">
  <strong>为 <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> 打造的右上角半透明提醒插件。</strong><br>
  喝水、护眼、休息提醒 + 深夜关怀 + 节日祝福 + 峰谷梗 + 热门网络梗，仅在触发时出现，装完即忘。
</p>

<p align="center">
  <a href="https://github.com/tianhanly/dsh-warm-reminder"><img src="https://img.shields.io/github/stars/tianhanly/dsh-warm-reminder?style=flat&label=Star&color=4D6BFE" alt="Stars"></a>
  <a href="https://github.com/tianhanly/dsh-warm-reminder/releases"><img src="https://img.shields.io/github/v/release/tianhanly/dsh-warm-reminder?style=flat&label=release&color=08C" alt="Latest release"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2EA44F?style=flat" alt="MIT License"></a>
</p>

<p align="center">
  <b>如果它有用，一个 Star 就是最好的鼓励</b> ⭐
</p>

## 预览

<p align="center">
  <img src="preview.png" alt="温馨提醒助手：右上角半透明提醒通知" width="100%">
</p>

## 它会做什么

| 触发条件 | 通知内容 |
|---|---|
| 活跃累计 **30 分钟** | 💧 喝水提醒（5 条文案随机） |
| 活跃累计 **1 小时** | 👀 护眼提醒（5 条随机） |
| 活跃累计 **3 小时** | 🧘 强制休息（4 条随机） |
| 活跃累计 **5 小时+** | 🔋 劳逸结合（5 条随机） |
| 打开窗口，**0-2 点 / 3-4 点 / 5-6 点** | 🌙 深夜关怀 / 🦉 "你真是个耐熬王" / 🌅 "阎王请你吃早饭" |
| 节日当天首次打开 | 🎉 元旦、春节、元宵、情人节、妇女节、愚人节、劳动节、母亲节、儿童节、父亲节、教师节、国庆、程序员节、双十一、圣诞节、中秋节 |
| 打开窗口（仅检测一次，非轮询） | 📈 工作日 9-12 / 14-18 点 →「梁文峰时期」；其余 →「梁文谷时期」 |
| 活跃 **>3 小时** 且 **凌晨 4-6 点** | 🍜 "你真是个耐熬王！阎王应该请你吃个饭！" |
| 每活跃满 **30 分钟** | 🔥 80+ 条热门网络梗随机一条（含 2026 梗百科新梗） |
| 打开窗口 6% 概率 | 🎲 随机彩蛋（token 梗、工作区梗等 14 条加权随机） |
| 特殊时刻 | ⏰ 11:11 许愿 / 🍚 12:00 干饭 / 💝 13:14 / 💗 17:20 / 🍜 18:30 / 🔮 22:22 / 🎉 周五 17:00 |

**设计细节**

- 时长按**页面可见时间**累计：切走/最小化暂停计时，关页面重开从零开始
- 通知框：右上角半透明毛玻璃卡片，滑入动画 + 进度条，8 秒自动消失，点击关闭，最多 3 条排队
- 纯客户端插件：不访问网络、不读写文件，全部本地 `Date` 计算；农历节日用内置公历对照表（2024-2035）

## Install

```sh
dsh plugin --profile web add -w github:tianhanly/dsh-warm-reminder
```

Restart dsh once, and the reminders start watching you:

```sh
dsh --profile web
```

> **`-w` is not optional.** The profile directory ships a `pnpm-workspace.yaml`, so pnpm reads it as a workspace root and refuses to install (`ERR_PNPM_ADDING_TO_ROOT`). `-w` is the "yes, install into the root" declaration, and `dsh plugin` forwards it to pnpm verbatim.

The repository ships its source as plain JavaScript (`lib/`) and has no `prepare` script, so pnpm runs no build script when installing from a git source and you never have to grant `allowBuilds`.

If you run harness from source, replace `dsh` above with `pnpm dsh` inside the harness directory.

### Uninstall

```sh
dsh plugin --profile web remove dsh-warm-reminder
```

## Requirements

| 依赖 | 要求 | 说明 |
|---|---|---|
| **DeepSeek Harness** | 支持 `shell.overlay` 与 `dsh.bundle` 机制的版本 | 插件挂在全局浮层插槽上，由 bundle patch 自动挂载 |
| **profile** | 必须是 **web** profile | headless / tui 没有浏览器客户端，插件不会激活 |
| **其他** | 无 | 零外部运行时依赖：不联网、不装额外包、无配置项 |

## Configuration

无需任何配置。想改文案或梗池：直接编辑 `lib/client.js` 顶部的常量区（`MILESTONES` / `DEEP_NIGHT` / `HOLIDAY` / `HOT_MEMES` / `MEMES` / `TIME_EGGS`），保存后重启 dsh 生效。

## Development

```sh
# 本包为纯 JavaScript，无构建步骤：
#   lib/index.js  — Host 半（空壳，客户端插件只需占位）
#   lib/client.js — Client 半（全部逻辑）
```

用 `link:` 方式安装到 profile 后，改完 `lib/client.js` 只需重启 dsh，无需重新 `add`：

```sh
dsh plugin --profile web add -w link:C:/Users/14638/Desktop/code/harness/项目/dsh-warm-reminder
```

`lib/client.js` 是 CJS closure-factory 形式（`window.__ModuleLoader__.load({ id, factory })`），React 来自模块表注入的 `require`，不打包任何外部依赖——这是 dsh 模块表规定的形态。

## License

[MIT](LICENSE) © 2026 tianhanly

---

<p align="center">
  <sub>如果它有用，一个 Star 就是最好的鼓励 ⭐</sub>
</p>