Skip to main content
ErisPulse Reminder

ErisPulse Reminder

提醒模块 —— 聊天中设置定时提醒,重启自动恢复。

基于 ErisPulse 2.10 归属化调度(spawn_later)与内置 ORM 的轻量提醒模块,支持声明式时长参数与多轮恢复。

PyPI Python License Stars Downloads ErisPulse

简体中文 | English


简介

Reminder 是基于 ErisPulse 架构开发的轻量提醒模块:

  • /提醒 30m 喝水:声明式时长参数(90s / 1h30m / 1d 等自动折算秒)
  • 到期经适配器发送到原会话(私聊/群聊均可)
  • 提醒记录内置 ORM 持久化,重启自动恢复:未到期重新调度,已过期立即补发
  • 调度任务归属化(spawn_later owner),模块卸载时自动取消
  • 每用户挂起上限、单条时长上限、内容长度约束
  • 列表经 Takumi 渲染为卡片,不可用时降级文本

要求 ErisPulse >= 2.10.0。


效果展示

/提醒 列表
list


安装

epsdk install ErisPulse-Reminder

命令

命令 说明
/提醒 <时长> <内容> 设置提醒,如 /提醒 30m 喝水、/提醒 1h30m 下线休息
/提醒 列表 查看本人的待触发提醒
/提醒 取消 <编号> 取消一条提醒

时长语法:90s(秒)、30m(分)、2h(时)、1d(天),可组合如 1h30m。


配置说明

[Reminder]
max_reminders_per_user = 20     # 单用户同时挂起的提醒上限
max_duration = "30d"            # 单条提醒最大时长
reminder_prefix = "提醒:"       # 到期消息前缀
list_max = 10                   # 列表单次展示条数
render_card = true              # 列表用 Takumi 渲染为卡片
theme = "auto"                  # 卡片配色 (auto/light/dark)
配置项 类型 默认值 说明
max_reminders_per_user int 20 每用户挂起上限
max_duration str 30d 单条最大时长
reminder_prefix str 提醒: 到期消息前缀
list_max int 10 列表条数
render_card bool true 卡片渲染
theme str auto 卡片配色

注意事项

  1. 到期发送失败时提醒仍标记完成(避免无限重试),失败记录在日志
  2. 提醒发送到设置时的原会话(群聊则发回群)
  3. 记录存储于框架存储后端,随数据一起备份迁移

参考链接

Metadata

Release files for ErisPulse-Reminder 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ErisPulse-Reminder 0.1.0
File Size Uploaded Provenance Actions
erispulse_reminder-0.1.0.tar.gz 13.5 kB With provenance Details for erispulse_reminder-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ErisPulse-Reminder 0.1.0
File Interpreter ABI Platform Actions
erispulse_reminder-0.1.0-py3-none-any.whl Python 3 none any Details for erispulse_reminder-0.1.0-py3-none-any.whl

Total release size: 27.8 kB

Release files / erispulse_reminder-0.1.0.tar.gz

Download URL erispulse_reminder-0.1.0.tar.gz
Size 13.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a01064903cc4efa8d96996f1624dbe24b92082bb9e21507ae8898e91a922cad7
BLAKE2b-256 checksum
How to use checksums
ab58a99a51a29b101000017676161ed76369cf5e4222efc3ea41965f7b06018c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.

Transparency log

Release files / erispulse_reminder-0.1.0-py3-none-any.whl

Download URL erispulse_reminder-0.1.0-py3-none-any.whl
Size 14.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
27cc70e669cd038c70199dd6a5ed6260eac94a37c199c899d0e90b8c87558937
BLAKE2b-256 checksum
How to use checksums
1f68dfd3f2732258190affb6c144c268409c8d0aac0f9144d5c811eadb72ab26
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.

Transparency log

Security for ErisPulse-Reminder 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for erispulse_reminder-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page