dsh-countdown-days

倒数日 / Countdown Days

中文 · English · 截图 / Screenshots

中文

在 DSH 里记住生日、纪念日和还款日。支持公历、农历（含闰月）、重复日期、分类、置顶和提醒，无云同步。

安装

市场安装（待收录）：尚未确认进入插件市场，不能视为已上线；收录后可在市场搜索本插件。当前备用方案为 GitHub Release tgz（v1.0.1），不是 npm 包安装。

Desktop 远程安装：在应用内插件管理中使用上述完整 URL，或请当前 Desktop 的 DSH agent 调用 plugin_manager（工具调用，不是终端命令）：

{"action":"install_bundle","target":"https://github.com/Veagau/dsh-countdown-days/releases/download/v1.0.1/dsh-countdown-days.tgz"}

Web / CLI：将 <profile> 换成实际运行 Web 的 profile，不要误装进 Desktop：

dsh plugin --profile <profile> add https://github.com/Veagau/dsh-countdown-days/releases/download/v1.0.1/dsh-countdown-days.tgz

也可请目标 Web 实例中的 agent 调用上述工具。

本地开发安装：克隆仓库并保留目录，请 agent 用 plugin_manager 安装绝对路径：

{"action":"install_bundle","target":"<countdown-days 目录的绝对路径>"}

安装影响当前 profile 的所有会话。检查返回的 application 和 warnings，按提示刷新，再从侧边栏打开「倒数日」。Windows JSON 路径中的反斜杠写成 \\；本地链接安装后不要删除源码目录。需要支持 bundle 的 Harness。资产若尚不存在，请勿改用来源不明的下载；参见分发与发布指南。

添加日子

1. 点击「新建倒数日」，填写名称和分类。
2. 选择公历或农历日期，设置重复方式。
3. 选择提前提醒天数和时间，保存。

公历支持每周、每月或每年重复；农历支持每年重复，换算依赖浏览器 ICU 中国历法。列表支持搜索、编辑、删除和置顶。

开启提醒

1. 在设置中打开「桌面通知」，启用定时提醒检查。
2. 允许浏览器通知，并检查系统通知权限。
3. 点击「发送测试提醒」确认通知能显示。

页面需要持续加载；关页、休眠或后台限制可能漏报。当天提示条不受通知开关影响。重要事项请保留其他提醒方式。

备份与恢复

1. 在设置中导出 JSON 备份。
2. 恢复前先备份当前记录，再导入文件。
3. 确认替换：导入会覆盖全部现有记录，不会合并。

数据和备份未加密。清除站点数据、更换浏览器或来源地址可能丢失记录；通知可能出现在锁屏上，请勿填写敏感内容。

详细说明 · 反馈问题

开发

npm run check
npm test

包含农历、存储、备份和设置回归测试，不代表完整浏览器兼容性测试。

English

Track birthdays, anniversaries and payment dates in DSH. Supports Gregorian and Chinese lunar dates (including leap months), recurrence, categories, pinning and reminders. No cloud sync.

Install

Marketplace (pending inclusion): listing has not been confirmed; this is not a claim of availability. Once listed, search for this plugin in the market. The current fallback is the GitHub Release tgz (v1.0.1), not an npm registry installation.

Desktop remote installation: use the full URL above in the application's plugin management, or ask the agent in the intended Desktop instance to call plugin_manager (a tool, not a shell command):

{"action":"install_bundle","target":"https://github.com/Veagau/dsh-countdown-days/releases/download/v1.0.1/dsh-countdown-days.tgz"}

Web / CLI: replace <profile> with the profile actually serving your Web instance, not the Desktop profile:

dsh plugin --profile <profile> add https://github.com/Veagau/dsh-countdown-days/releases/download/v1.0.1/dsh-countdown-days.tgz

Alternatively, ask the agent in the target Web instance to call the tool above.

Local development installation: clone and keep the repository, then ask the agent to install its absolute path:

{"action":"install_bundle","target":"<absolute path to countdown-days>"}

Installation affects all sessions in the current profile. Check application and warnings, follow refresh instructions, then open Countdown Days from the sidebar. Escape Windows path backslashes as \\ in JSON; keep the source directory for local linked installs. Requires a bundle-capable Harness. If the asset is not available yet, do not substitute an untrusted download; see the distribution guide.

Add an event

1. Select Add countdown and enter a name and category.
2. Choose a Gregorian or lunar date and recurrence.
3. Set reminder days and time, then save.

Gregorian dates repeat weekly, monthly or yearly; lunar dates repeat yearly and require the browser's ICU Chinese calendar. Search, edit, delete and pin events from the list.

Enable reminders

1. Turn on Desktop notifications in Settings to enable scheduled checks.
2. Allow browser notifications and check system notification permissions.
3. Send a test reminder to check that notifications appear.

The page must stay loaded. Closing it, device sleep or background restrictions can cause missed reminders. The today banner works independently of the notification switch. Keep another reminder for important events.

Back up and restore

1. Export a JSON backup from Settings.
2. Back up current events before importing a file.
3. Confirm replacement: import replaces all existing events; it does not merge them.

Data and backups are unencrypted. Clearing site data or changing browser or origin can lose records. Notifications may appear on the lock screen; avoid sensitive content.

Full guide · Report an issue

Development

npm run check
npm test

Includes lunar, storage, backup and settings regressions, not complete browser compatibility testing.

License

MIT