TimeMark - 智能事件提醒系统

关于 TimeMark

TimeMark 是一款面向个人与家庭的智能事件提醒系统，专注于管理生日、纪念日等您在意的重要日期。无论您需要记住父母的生日、结婚纪念日，还是定期检查事项，TimeMark 都能准时通过您偏好的方式通知您。

系统内置 35 余种通知渠道，全面覆盖国内外主流通讯平台——从 Email、Telegram、Discord 到微信、钉钉，确保每个提醒都能触达。支持完整的中国农历转换（含闰月自动处理），让传统节日提醒不再遗漏。

采用单容器架构，SQLite 内置存储，运行时零外部依赖。面向 NAS 平台深度优化，闲置内存占用仅约 256 MB，在 J4125 等低功耗设备上也能流畅运行。当前版本 v2.1.0。

DSOS English Summary for Reviewers

TimeMark is a full-featured smart reminder system designed for birthdays, anniversaries, and other important dates. It supports 35+ notification channels spanning both global platforms (Email, Telegram, Discord, Slack) and Chinese ecosystems (WeChat, DingTalk, Feishu), with unified management through a clean web dashboard.

Key technical highlights include built-in Chinese lunar calendar conversion with automatic leap month handling, AES-256-GCM encryption for all notification credentials, smart relationship mapping for adaptive family-salutation rendering, and a single-container architecture with zero external dependencies—powered by SQLite, running smoothly on any Docker-capable NAS or VPS with only ~256 MB of RAM.

核心功能

为重要时刻，提供全方位的提醒保障

🔔

35+ 通知渠道

覆盖 Email · Telegram · Discord · Slack · 微信 · 钉钉等国内外主流平台，一处配置，全部可达。

🌙

农历日历支持

完整农历公历双向转换，含闰月自动处理。春节、中秋等传统节日日期不再需要手动查算。

👨‍👩‍👧

智能关系映射

称呼智能适配，输入"我爸"自动识别为"父亲"，通知内容根据亲属关系动态生成个性化称呼。

📦

单容器部署

零外部依赖，SQLite 内置存储。一个 docker compose up -d 即可运行。

🔒

AES-256 加密

所有通知凭证经 AES-256-GCM 加密存储，密钥独立管理，确保敏感信息在静态存储中的安全性。

⚡

低资源占用

闲置内存仅约 256 MB，J4125 等入门级 NAS 流畅运行，为 7×24 小时长时间运行而生。

Docker 镜像

选择您偏好的镜像源

Docker Hub

GHCR

备用

GitHub Container Registry，中国大陆访问更稳定

            # docker pull

            docker pull ghcr.io/wfffff666/timemark:latest

快速开始

三分钟完成部署

1

创建项目目录

mkdir timemark && cd timemark
2

下载 docker-compose 配置文件

curl -sSL https://raw.githubusercontent.com/WXFffff666/timemark-docker/master/docker-compose.dockerhub.yml -o docker-compose.yml
3

启动容器

docker compose up -d

服务将在 http://localhost:3000 启动

更多部署配置请查看 GitHub 仓库