截止脉搏 wjw0419/-deadline-pulse

Deadline Pulse · 截止脉搏

DSH 会话标题栏右侧的倒计时胶囊——离截止日期越近，胶囊越醒目。 v1.1 新增：多 Deadline 冲突检测 + AI 协商调度。

✨ Features · 功能

| Feature | Description |
| 🕐 Countdown pill | Persistent in the header, ticking every second with monospace digits |
| 🔴 ≤1 day | Breathing glow + swing animation (includes overdue) |
| 🟡 ≤3 days | Pulse animation |
| 🟢 ≤7 days | Only visible in the expanded panel |
| ⚪ >7 days | Only visible in the expanded panel |
| 📊 Ring progress | Each pill shows a ring indicating life consumed |
| 📋 Expand panel | Click a pill to see all deadlines: color dot, tag, note, effort, progress bar, completed section |
| 🔔 Threshold toast | When a deadline crosses the 3-day or 24-hour line, a toast slides down (auto-dismiss 5s) |
| ⚡ Conflict Detection | Detect overlapping preparation windows between deadlines; severity levels: high/medium/low |
| 📅 Reschedule | One-click reschedule from the panel or conflict results; supports effort adjustment |
| ⏱️ Effort Tracking | Optional estimated effort (hours) per deadline; used for conflict window calculation |
| 🗣️ Natural language | Say "帮我记个截止日期" or "检查一下冲突" and the agent handles it via deadline_tool |
| 🔄 Hot reload | Edit deadlines.json manually → UI syncs within 15s (or instantly on window focus) |

🆕 v1.1 What's New · 更新内容

⚡ Conflict Detection · 冲突检测

- New conflicts action: scans all active deadlines for time conflicts
- Three severity levels:
- 🔴 High: Same-day due + preparation windows overlap
- 🟡 Medium: Preparation windows overlap (different days)
- 🟢 Low: Same-day due but no window overlap
- Preparation window = [due - effort, due]; defaults to 2h if effort not set
- Panel button "⚡ 冲突检测" triggers detection; results show inline with reschedule shortcuts

📅 Reschedule · 重新调度

- New reschedule action: change any deadline's due time (and optionally effort)
- Available from: panel item row (📅 button), conflict result cards, or natural language
- After reschedule, conflict detection auto-refreshes if previously run

⏱️ Effort Field · 预估工时

- New optional effort field (hours) when adding deadlines
- Displayed as a colored chip in the panel item row
- Used by conflict detection to calculate preparation windows
- Default assumption: 2 hours when effort is not specified

📦 Install · 安装

Via DSH Agent · 通过代理安装

In any DSH session, say:

用 plugin_manager 的 install_bundle 安装本地插件 <absolute-path-to>/deadline-pulse

Or equivalently, the agent calls:

plugin_manager { action: "install_bundle", target: "<absolute-path-to>\\deadline-pulse" }

After install returns application: applied, refresh the browser page (F5) to load the client module.

Via CLI · 命令行安装

bash
dsh plugin --profile <your-profile> add @wjw0419/deadline-pulse

或者在 npm 发布前，从本地目录安装： bash
dsh plugin --profile <your-profile> add "file:<absolute-path-to>/deadline-pulse"

📖 Usage · 使用

Method 1: Talk to the Agent · 方式一：对智能体说话（推荐）

"帮我记一个截止日期：周五 18:00 交插件作业，标签'课程'，预估 4 小时" "看看我现在有哪些截止日期" "检查一下我的截止日期有没有冲突" "把英语演讲比赛调整到下周一" "英语演讲比赛那个截止日完成了" "把'坏数据测试'那条删掉"

智能体调用 deadline_tool（支持 add / list / done / remove / conflicts / reschedule），写入 deadlines.json。

Method 2: Manual Edit · 方式二：手动编辑文件

创建或编辑 ~/.dsh/deadline-pulse/deadlines.json： json {
"deadlines": [
{ "title": "提交插件作业", "due": "2026-02-10 18:00", "tag": "课程", "note": "含演示视频", "effort": 4, "done": false }, { "title": "英语演讲比赛", "due": "2026-02-10 15:00", "tag": "社团", "effort": 3, "done": false } ] }

- due 接受 "2026-02-10 18:00"、"2026-02-10"（按 23:59 处理）或 ISO 格式。
- tag、note、effort、done、created 都是可选项。
- 保存后，界面 15 秒内同步；切换窗口焦点会立即刷新。

⚠️ Notes · 注意事项

1. 数据全局存放在 ~/.dsh/deadline-pulse/deadlines.json，所有会话共用。
2. JSON 格式出错不会让插件崩溃：面板会显示红色的「parse failed」提示，并保留上一次成功读取的数据。
3. 已经进入紧急状态的事项不会在页面加载时弹 toast（只有页面打开期间跨过阈值才会弹）。
4. 开启「prefers-reduced-motion」后，脉冲和摆动动画会关闭，只保留颜色状态。
5. 冲突检测至少需要 2 条活跃（未完成）的截止日期。
6. 卸载：说「用 plugin_manager 移除 @local/deadline-pulse」。你的 deadlines.json 会保留。

📄 License · 许可证

MIT © 王小九之父