Flandern1211/dsh-task-time

dsh-task-time

提醒 + 任务计时 — DeepSeek Harness 插件，主要就做两件事：

• 🔔 提醒 — 按累计运行间隔提醒、超时提醒、需要你决策时的红色常驻提醒；人在 DSH 里走界面提醒卡 + 提示音，不在 DSH 里发系统桌面通知
• ⏳ 任务计时 — 为每个会话设置计划用时，只计模型运行时间，任务结束自动统计实际用时与计划的差距

---

目录

• 功能概览 — 两大主功能：🔔 提醒 · ⏱ 任务计时
• 安装
• 快速开始
• 使用指南
• 功能详解
• 命令
• 配置
• 记录文件
• 项目结构
• 开发
• License

---

功能概览

两个主功能：🔔 提醒 · ⏱ 任务计时。 下面的清单按这两个主功能分组，第三节的配套能力是为了让这两件事更好用、数据不丢。

🔔 提醒（主功能）

⏱ 任务计时（主功能）

🧩 配套能力（辅助）

---

安装

方式一：从 npm 安装（推荐）

dsh plugin add dsh-task-time

方式二：从 GitHub 仓库安装

dsh plugin add https://github.com/Flandern1211/dsh-task-time

方式三：本地安装

git clone https://github.com/Flandern1211/dsh-task-time.git
cd dsh-task-time
dsh plugin add .

安装后重启 DeepSeek Harness，插件自动加载。

---

快速开始

1. 创建新会话 → 自动弹出「设置任务计划」窗口
2. 填写任务信息：
   • 任务名称（如"代码审查"、"文档编写"）
   • 计划用时（分钟，预填 设置 → 任务用时 → 默认配置 里的「默认计划用时」，默认 60）
   • 提醒间隔（分钟，预填默认 10）
3. 点击 开始 保存；只有点 跳过 才会跳过本次设置
   • 点击弹窗外区域不会关闭/跳过（只弹出提示），避免误触把设置吞掉
   • 跳过后想补设置：在输入框下方的计时条点 ⚙ 设置计划 即可重新打开弹窗
4. 任务进行中，输入框下方显示状态条
5. 超时、决策、提醒自动触发，无需手动操作

---

使用指南

任务面板

点击左下角 🗂 按钮打开任务面板，查看全部任务：

• 进行中 — 当前运行的任务，显示状态（运行中 / 已暂停 / 需决策）、已用时间、计划时间
• 已完成 — 已结束的任务，显示实际用时、与计划的差异
• 点击任意任务 → 跳转到对应会话
• 进行中任务可「结束」归档，已完成记录可「删除」

计时规则

• 只计模型运行时间：模型在思考、调用工具时累加计时
• 暂停不计时：等待用户输入、审批时暂停计时
• 恢复后续计：模型再次运行后续计

决策提醒

当以下情况触发时，插件自动发出「需要你决策」提醒：

• approval/request 事件 — 沙箱升级、权限审批等
• ask_user_question 调用 — 模型向用户提问
• 工具执行（ask_user_question / confirm / approve）
• DOM 审批弹窗（[data-approval-key]）—— MutationObserver 兜底检测

决策提醒特征：

• 🔴 红色提醒卡（常驻不自动消散，点 × 关闭）
• 🔴 Windows 系统通知（循环报警音）
• 🔴 浏览器标签页标题闪烁
• 🔴 浏览器通知（不在当前标签页时）

---

功能详解

提醒卡系统

• 提醒卡滞留时长可配置：设置 → 提醒 → 内部通知配置 →「提醒卡滞留时长」，预设 2/3/4/5/8/10/15/30 秒或自定义（1–600 秒），也可选 「常驻（不自动消散）」（= 0，只能点 × 或点击卡片关闭）；默认 4 秒，对齐 DSH 内置 Toast 的保持时长
• 普通提醒卡：右下角堆叠显示，按上面配置的滞留时长自动淡出消散（淡出 1 秒后移除）
• 提醒卡：一个会话最多一张（同一会话反复决策会替换旧卡，不会叠卡）；定时/超时/结束/设置完成类卡片都按配置的滞留时长消散；client 本地生成的提示卡（删除/结束/移除失败、测试通知）同样跟随该配置
• 决策提醒卡：红色常驻，不自动消散（固定 autoMs=0，不受滞留时长配置影响），只能点 × 关闭；决策处理完（host 推「决策已处理」）后自动收掉，标题停止闪烁
• 点击跳转：点击提醒卡 → 跳转到对应会话 → 卡片消失（跳转同时清掉该会话的决策卡）
• 点击 ×：仅关闭卡片，不跳转
• 提醒卡由「提醒 → 内部通知」开关统一控制；关掉后右下角不再出现任何卡片（也不会再走直写 DOM 的渲染路径）

通知：内部 / 外部两条通道

通知按「人是不是正在 DSH 里」自动分流，不会在你看得见界面的时候还弹系统通知：

• client 每 2 秒（以及焦点/可见性变化时）向 host 上报一次 ui-presence（focused / visible）；host 超过 10 秒收不到上报就按「人不在 DSH」处理，保证页面关掉后仍然收得到系统通知
• 判定结果由 host 统一计算并通过 ui-presence 的返回值同步回 client，两边结论一致：响了内部提示音就不会再发系统通知，反之亦然
• 「外部通知时机」可配置：DSH 不在前台时（默认，切走就发）或 只有 DSH 页面不可见时（只要 DSH 还看得见就不发）；设置页「当前状态」实时显示此刻算不算「在 DSH 里」
• 「发送测试通知」按钮不受时机限制，任何时候点都会真发一条，方便验证链路

外部通知（Windows 系统 Toast）

• 默认借用 DSH Desktop 的 AUMID（ai.deepseek.dsh.desktop）发出通知
• 支持自定义 AUMID
• 可一键发送测试通知验证链路
• Windows 11 默认静默丢弃未注册应用身份的通知，插件已做适配
• 只在人不在 DSH 里时才发（见上一节的通道表）
• 点击通知后回到 DSH：通知横幅带 dshjump:<sessionId>，点击会把 DSH 窗口置前；客户端在检测到「窗口重新获得焦点」时，先消费 get-pending-jump 的跳转请求，没有请求就直接跳到「正在等你决策」的会话。之所以不做事件回调：Windows PowerShell 5.1 无法订阅 WinRT 通知事件（见「已知问题」）

外部通知声音

标记状态颜色

持久化与重启恢复

• 记录文件：~/.dsh/dsh-task-time-records.json
• 重启后恢复全部状态：
  • 已完成记录
  • 会话配置（已配置 / 已跳过）
  • 运行中任务（从当前时间续计，停机时间不计入）
  • 会话历史
• 防抖写入（800ms），避免频繁磁盘 I/O
• 退出时同步落盘，确保数据不丢失

孤儿任务清理

插件每 3 秒检查一次存活会话，自动清理：

• 运行中但会话已删除 → 静默收尾计入已完成记录
• 从未启动且会话已删除 → 清除残留条目
• 确保任务面板不显示僵尸任务

---

命令

模型工具：task_plan_set

模型可在运行中通过此工具调整当前任务的计划用时。

{
  "plannedMinutes": 30,
  "note": "任务说明（可选）"
}

• 修改后自动取消超时标记（overdueFired = false）
• 若任务尚未启动，自动设置启动时间
• 返回确认消息含新计划和提醒间隔

此工具已注册到模型 system prompt，会在合适的时机自动调用。

---

模块开关（按需启用）

插件分为 任务用时 与 提醒 两大模块，可在设置中自由开关，两者完全独立。

在 DSH 设置 → 任务用时 → 模块开关与默认配置 中配置：

任务用时
☑ 启用任务用时
  ☑ 计时引擎（运行/暂停连续计时）
  ☑ 计划配置（设置弹窗 / 跳过恢复）
  ☑ 定时提醒（间隔提醒 + 超时提醒）
  ☑ 任务面板（进行中/已完成 + 操作）
  ☑ Dock 状态条（输入框下方实时显示）
  ☑ 孤儿清理（会话已删除的残留清理）
  ─ 默认配置（新会话设置弹窗的预填值）
    默认计划用时   [60 分钟 ▾]（15/30/45/60/90/120/180 或「自定义…」）
    默认提醒间隔（分钟） [10]

提醒
☑ 启用提醒
  ☑ 决策检测（三通道 + 客户端独立检测）
  ☑ 内部通知（在 DSH 里：提醒卡 + 提示音）
  ☑ 外部通知（不在 DSH 里：系统 Toast + AUMID）   ← 外部通知只有这一个开关
  ☑ 标题闪烁（需要决策时）
  Toast 点击跳转（点通知回到 DSH 后自动定位到待决策会话）
  ─ 内部通知配置（在 DSH 里：提醒卡 + 提示音）
    提醒卡滞留时长   [4 秒 ▾]（2/3/4/5/8/10/15/30 秒 / 常驻（不自动消散）/ 自定义…）
  ─ 外部通知配置
    外部通知时机   [DSH 不在前台时 ▾]（或「只有 DSH 页面不可见时」）
    当前状态       [在 DSH 里 → 只发内部通知 / 不在 DSH → 会发系统通知]
    通知应用身份（AUMID） [ai.deepseek.dsh.desktop]
    外部通知链路   [发送测试通知]

外部通知只有一个开关：提醒模块下的「外部通知」。它的时机、应用身份与测试入口在同一个模块的「外部通知配置」里，不再有第二个会互相覆盖的开关。 通知按「人在不在 DSH 里」走两条通道：在 DSH 里只发内部通知（提醒卡 + 界面内提示音），不在 DSH 里才发系统通知 —— 见上方「通知：内部 / 外部两条通道」。

行为说明

配置文件：~/.dsh/dsh-task-time-modules.json

⚠️ 改完开关需要重启 DSH Desktop（或刷新页面）才会生效 —— 客户端 bundle 在应用启动时载入，热更新仅在 pnpm run dev:web 运行时可用。

---

配置

在 DSH 设置 → 任务用时 中可调整（配置就放在对应模块里）：

配置说明

AUMID（AppUserModelId） 是 Windows 通知系统的关键标识：

• 默认借用 DSH Desktop 的已注册身份，横幅可正常弹出
• 留空使用默认值
• 修改后可通过 发送测试通知 验证
• 最近一次通知诊断信息会显示在设置页面下方

---

记录文件

• 位置：~/.dsh/dsh-task-time-records.json
• 容量：上限 500 条，超限自动淘汰旧记录

记录字段

持久化数据结构

{
  "records": [ ... ],       // 已完成记录
  "configs": { ... },       // 会话配置（含 configured 标记）
  "dismissed": [ ... ],     // 跳过设置的会话列表
  "tasks": { ... },         // 进行中任务
  "history": { ... },       // 会话历史
  "rootSessions": [ ... ],  // 根会话 id（用于状态裁剪）
  "defaults": {             // 全局默认配置
    "reminderIntervalMinutes": 10,      // 默认提醒间隔（分钟）
    "plannedMinutes": 60,               // 默认计划用时（分钟）
    "reminderAutoDismissSeconds": 4,    // 提醒卡滞留时长（秒，0 = 常驻不自动消散）
    "toastAppId": "ai.deepseek.dsh.desktop",
    "externalWhen": "unfocused"         // unfocused | hidden
  }
}

configs / dismissed / rootSessions 按会话累积，加载时会裁剪到 200 条（活跃会话优先保留）；只回写上面这些已知字段，历史遗留键不再被写回磁盘。

---

项目结构

dsh-task-time/
├── lib/
│   ├── index.js             # Host 端：计时、提醒、持久化、RPC、工具注册、prompt section
│   ├── index.d.ts           # Host 端类型声明
│   ├── client.js            # Client 端：浏览器 UI（React）、提醒卡、任务面板、设置页
│   ├── client.d.ts          # Client 端类型声明
│   └── toast.ps1            # Windows WinRT Toast 通知脚本（PowerShell 5.1+）
├── scripts/
│   ├── verify.mjs           # Host 全链路：legacy 迁移 / 状态恢复 / 决策提醒 / 写入 / 孤儿清理
│   ├── verify-modules.mjs   # 模块开关 + 默认配置 + 决策检测三通道 + 通知跳转链路
│   ├── verify-channels.mjs  # 内部/外部通知分流（无头实例 + Toast 打桩）
│   ├── verify-timing.mjs    # 计时 / 间隔与超时提醒 / 结束统计 / 配置边界 / 提醒卡滞留时长
│   ├── verify-dom.mjs       # 客户端 UI（mock React + DOM）：提醒卡生命周期、设置弹窗、Dock 状态条
│   └── test-changes.mjs     # 变更合规性检查（源码级断言）
├── cordis.patch.yml         # 插件 bundle patch（插入 host composition）
├── package.json             # npm 包配置
├── README.md                # 本文件
├── LICENSE                  # MIT License
└── .gitignore

架构说明

┌──────────────────────────────────────────────────┐
│                   DSH Desktop                     │
│  ┌─────────────────────────────────────────────┐  │
│  │              Host 进程 (Electron)             │  │
│  │  ┌─────────────────────────────────────────┐ │  │
│  │  │         dsh-task-time (Host)             │ │  │
│  │  │  • 计时 & 提醒 (3s tick)                 │ │  │
│  │  │  • 持久化 (防抖 800ms)                    │ │  │
│  │  │  • 外部通知 (spawn toast.ps1)            │ │  │
│  │  │  • HTTP RPC 服务 (/api/dsh-task-time/rpc)│ │  │
│  │  │  • tool: task_plan_set                    │ │  │
│  │  │  • prompt section 注册                    │ │  │
│  │  │  • 事件监听 (agent/created/status/disposed│ │  │
│  │  │  • 决策提醒 (三通道)                       │ │  │
│  │  │  • 孤儿任务清理                            │ │  │
│  │  └─────────────────────────────────────────┘ │  │
│  │                     │ HTTP RPC                │  │
│  │                     ▼                         │  │
│  │  ┌─────────────────────────────────────────┐ │  │
│  │  │        Renderer 进程 (Browser)           │ │  │
│  │  │  ┌─────────────────────────────────────┐ │ │  │
│  │  │  │    dsh-task-time (Client)            │ │ │  │
│  │  │  │  • 设置弹窗 (shell.overlay)          │ │ │  │
│  │  │  │  • 提醒卡堆叠 (shell.overlay)        │ │ │  │
│  │  │  │  • 任务面板 (shell.overlay)          │ │ │  │
│  │  │  │  • 状态条 (composer.dock)            │ │ │  │
│  │  │  │  • 设置页 (settings.section)         │ │ │  │
│  │  │  │  • 标题闪烁 / 浏览器通知              │ │ │  │
│  │  │  │  • DOM 审批弹窗兜底                   │ │ │  │
│  │  │  │  • 每 2s 轮询 + 上报 ui-presence      │ │ │  │
│  │  │  └─────────────────────────────────────┘ │ │  │
│  │  └─────────────────────────────────────────┘ │  │
│  └─────────────────────────────────────────────┘  │
│                     │ OS                          │
│                     ▼                             │
│  ┌─────────────────────────────────────────────┐  │
│  │  Windows Toast (toast.ps1 via powershell)    │  │
│  │  • WinRT ToastNotificationManager            │  │
│  │  • 点击 → DSH 窗口置前 → client 焦点检测 → 跳到待决策会话 │  │
│  └─────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────┘

---

开发

技术栈

构建

# 构建（如果使用 TypeScript 源码）
npm run build

# 或直接修改 lib/ 下文件（JS 源码无构建步骤）

验证

# 运行全部套件（mock 运行时，无需 DSH Desktop；不会真的弹系统通知）
npm test

# 单独跑某个套件
node scripts/verify.mjs            # Host 全链路
node scripts/verify-modules.mjs    # 模块开关 + 默认配置 + 决策三通道
node scripts/verify-channels.mjs   # 内部/外部通知分流
node scripts/verify-timing.mjs     # 计时 / 提醒 / 配置边界 / 滞留时长
node scripts/verify-dom.mjs        # 客户端 UI（提醒卡生命周期、设置弹窗、Dock 状态条）
node scripts/test-changes.mjs      # 变更合规性检查

npm test 串跑 6 个套件（verify → verify-modules → verify-channels → test-changes → verify-timing → verify-dom），全部通过才返回 0：

1. Legacy 迁移 — 旧格式记录文件迁移
2. 状态恢复 — configs/dismissed/tasks/history/defaults 重启恢复
3. 决策提醒 — 三通道（approval/userQuestions/tools-pre-execute）+ 20s 节流
4. 持久化写入 — 配置写入 + 重加载验证
5. 孤儿任务清理 — 已删除会话的残留任务清理
6. 计时与提醒 — 运行/暂停累加、间隔与超时提醒去重、结束统计、配置边界（含提醒卡滞留时长 0/负数/过大值）
7. 客户端 UI — 提醒卡渲染与生命周期（按配置滞留时长消散、常驻卡不消散）、决策卡去重、设置弹窗校验、Dock 状态条各状态

部署

插件作为 profile bundle 安装，通过 cordis.patch.yml 插入 host composition：

# cordis.patch.yml
- insert:
    - id: dsh-task-time
      name: 'dsh-task-time'

事件钩子

RPC 接口

所有通信通过 HTTP POST POST /api/dsh-task-time/rpc，请求体格式：

{ "method": "methodName", "args": { ... } }

已知问题 / 边界情况

• Windows 11 通知静默丢弃：未注册 AUMID 的通知可调用成功但横幅不显示，默认身份为 DSH Desktop 的已注册身份
• PowerShell 5.1 编码：toast.ps1 保持纯 ASCII，非 ASCII 注释会导致 ANSI/GBK 解码错误
• PowerShell 无法订阅 WinRT 通知事件（2026-09 实测）：Register-ObjectEvent 直接报 "Windows PowerShell cannot subscribe to Windows RT events"；用 TypedEventHandler 委托转换虽然能 add_Activated 成功，但回调永不执行（WinRT 在无 PowerShell runspace 的线程上触发）。因此 toast.ps1 不做点击回调，点击定位改由「窗口重新聚焦 + get-latest-decision-session」实现；get-pending-jump 保留为兼容通道（谁写文件谁生效，TTL 5 分钟）
• 提醒间隔/计划用时的最小值：set-config 会忽略 <=0 的值，过大值夹到 24 小时；set-session-config 缺计划用时直接拒绝（弹窗会在本地先拦一次并给出提示）
• 提醒卡滞留时长：set-config 接受 0（= 常驻）与 1–600 秒，负数/非数忽略；「需要你决策」红卡恒为 autoMs=0，不受该配置影响。上限 600 秒是因为再长实际等同于常驻，直接选「常驻」更清楚
• agents.roots() 不是「用户会话」判据（2026-09 踩坑，v0.2.10 修复）：dsh-agent 的 AgentsRegistry.roots() 只表示「运行时没有 owner 的顶层 agent」，其源码注释明确写了它不反映持久化会话血统，subagent 会话同样在其中。判断"这个会话算不算用户任务"必须用会话头字段 origin === 'subagent' / delegationDepth > 0；也不能改用 parentSession —— 用户 fork 出来的会话同样带 parentSession（另有 seedLength），属真实会话。sessions 服务（dsh-session 的 SessionStore）的 get(id) 返回带 .header 的 Session，可用来读这些字段；已关闭的会话不在 store 里，读不到时按"不排除"处理

---

更新日志

v0.2.10

• 修复 子会话（subagent）被当成用户任务，表现为「任务还没结束却一直报已经结束」：判定"这是不是一个用户任务"用的是 isRoot()（agentsSvc.roots() 成员资格），但 dsh-agent 的 AgentsRegistry.roots() 只按「运行时没有 owner」过滤（源码注释明确写了它不反映持久化会话血统），而 subagent 会话在运行时同样是无 owner 的顶层 agent —— roots() 里照样有它。后果：每个 subagent 都被建了任务、agent/status 一 running 就开始计时，subagent 一收工 agent/disposed 就报一次「✅ 任务结束」（界面卡 + 系统通知）并写一条"已完成"记录（无名、计划 0）。实测一次 fan-out 4 个 subagent 会在约 10 分钟内陆续报 4 次"结束"，而父会话自己的任务一直在跑
• 修复 判据改为会话头的持久化血统字段：origin === 'subagent'（dsh-session 里该字段的唯一合法值）或 delegationDepth > 0（顶层 0、子会话 1、嵌套子会话 2…）。不能改用 parentSession 判定：用户 fork 出来的会话同样带 parentSession（并额外有 seedLength），但那是真实会话，必须照常计时
• 修复 覆盖全部入口：agent/created / agent/status / agent/disposed（优先读 live agent 自带的 agent.session.header，不依赖服务）以及 tick 孤儿清理 / get-task-board / get-status / get-pending-setup / get-pending-sessions（走 sessions 服务 SessionStore.get(id).header，读到的头部会缓存）。读不到任何会话头时保持原行为（不排除），绝不误杀真实任务
• 修复 修复前遗留的幽灵条目、以及 rootSessions 里混入的 subagent id，由 tick 静默清理：不写"已完成"记录、不发提醒（resolveRootSession 也不再因为 rootSessions 里有 subagent id 就把子会话当根会话返回）
• 新增 get-status 返回 lineage 诊断字段（headerRead / headerOrigin / delegationDepth / parentSession / isSubagentSession）：headerRead:false 说明会话头没读到、判定退回了保守行为，可据此确认修复是否真的生效
• 测试 scripts/verify-timing.mjs 新增场景 P（12 项）：子会话不进设置弹窗候选、不开始计时、收工不写记录/不发「任务结束」卡/不发系统通知、遗留幽灵条目被静默清理；并以 fork 会话与真实根会话作对照，防止"一刀切"误杀。脚手架新增可注入的假 sessions 服务。回归强度：把 lib/index.js 回退到修复前，场景 P 精确失败 7 项（含 ✅ 未命名任务 · 任务结束 那条系统通知断言）

v0.2.9

• 文档 简介改为以 提醒 和 任务计时 两大主功能为主线：顶部简介从「任务用时管理与提醒插件」改为两条要点（🔔 提醒 / ⏳ 任务计时），「功能概览」原来一张 17 行的平铺表拆成三组——🔔 提醒（主功能）、⏱ 任务计时（主功能）、🧩 配套能力（辅助），内容未删减，只是把主功能提到前面
• 文档 package.json 的 description 同步改写：先说提醒（定时/超时/需要你决策时的红色常驻提醒 + 内外通知分流 + 卡片可点击跳转），再说任务计时（会话级计划用时、仅模型运行时连续计时、结束统计与计划的差距、本地持久化），与市场条目 data/plugins/Flandern1211__dsh-task-time.yml 的 description.en / description.zh 保持一致
• 无代码改动：lib/ 与 scripts/ 未动，功能与 v0.2.8 完全相同

v0.2.8

• 新增 提醒卡滞留时长可配置：设置 → 提醒 → 内部通知配置 →「提醒卡滞留时长」，预设 2/3/4/5/8/10/15/30 秒、自定义（1–600 秒）或「常驻（不自动消散）」，默认仍是 4 秒（对齐 DSH 内置 Toast 的 HOLD_MS+FADE_MS）。配置存在 defaults.reminderAutoDismissSeconds，host 每条普通提醒卡按它下发 autoMs，重启后从状态文件恢复
• 修复 滞留时长此前是硬编码：host 的 pushReminder 写死 4000，client 本地提示卡（删除/结束/移除失败、测试通知）写死 6000/8000 —— 同一个插件里三种时长且都改不了。现在 host 下发的 autoMs 优先，client 本地卡回落到同一个配置值（启动时 get-config 同步一次，设置页改动即时同步）
• 不变 「需要你决策」红卡恒为常驻（autoMs=0），不受该配置影响——几秒后消散的红卡对离开电脑的用户等于没提醒
• 测试 新增 host 端 12 项（默认值/自定义/负数拒绝/过大夹取/0=常驻/决策卡不受影响/重启恢复）+ 客户端 12 项（10 秒不快消、常驻不消散、本地卡跟随配置、设置页下拉预设与自定义）

v0.2.7

• 修复 决策提醒卡重复渲染：一条「需要你决策」提醒同时走 React 提醒栈与 pushReminder() 里直写 DOM 的旧路径，界面上会叠出两张红卡（一张 bottom:76px、一张 bottom:16px，后者还盖住左下角 🗂 任务面板按钮），而且点一张的 × 另一张不消失。现在只保留 React 一条渲染路径
• 修复 决策处理完不消卡：用户在审批弹窗里做完决策后，host 只推了一条普通的「决策已处理」提醒，没人移除常驻红卡，标题也继续闪 ❓ 需要你决策。现在 client 收到 decision-cleared 会收掉该会话的红卡，host 也会把该会话的 needDecision 提醒从队列里摘掉（否则刷新页面重新拉取时红卡会"复活"，get-latest-decision-session 也会指向过期会话）
• 修复 同一会话两张红卡：客户端本地 approval/request 检测（负 id）与 host 轮询提醒（正 id）没有合并。现在 pushReminder 对同一会话只留最新一条决策卡
• 修复 「内部通知」开关关不住提醒卡：ReminderGate 原来用的是「reminderUI 或 intervalReminder」，定时提醒开着就照样显示卡片；直写 DOM 的决策卡更是完全不看开关。现在提醒卡统一归「内部通知」管，与文档一致
• 修复 end-task 的 diffMs 符号反了（写成 plannedMs - actualMs，与 finishTask 和文档的「正数=超时」相反）
• 修复 delete-task-record 在清理 history 之前落盘，且之后不再落盘 → 磁盘上残留已删除的记录，重启后"复活"
• 修复 计划用时留空时会把 plannedMinutes: null 存下来并标记 configured=true，结果是任务永远不启动（不计时、不提醒、也不再弹设置窗），确认文案还写成"计划用时 null 分钟"。现在 host 拒绝非法计划用时（ok:false + 可读错误），client 在弹窗里先本地拦截并给出提示，弹窗不关闭
• 修复 set-config 不校验提醒间隔：0 / 负数会被存下来，随后 intervalMs <= 0 让定时提醒静默失效（开关显示开着却再也不提醒）。现在非法值直接忽略、过大值夹到 24 小时；状态文件里遗留的非法值在加载时修正为默认值
• 修复 决策外发通知的 20 秒节流把「人在 DSH 里、根本没发出去」的那次也记进节流时间戳 → 用户 20 秒内切出 DSH 会收不到这条决策通知。现在只有真的发出去了才记
• 修复 状态文件无限增长：dismissed / configs / rootSessions 按会话累积、从不清理（实测几十个会话后 dismissed 已有 70 条）。现在加载时裁剪到 200 条（保留活跃会话），并且只回写已知字段，历史遗留键（已移除的 externalAlert、旧版默认值快照）不再被一次次写回磁盘
• 修复 「外部通知时机」默认值与文档/设置页不一致：代码里是 hidden（只有页面不可见才发），注释、README 三处与设置页都写默认 unfocused。按文档与既有落盘配置统一为 unfocused
• 修复 点击系统通知后的会话定位链路实际是断的：get-pending-jump 读的跳转文件已经没有任何写入方（toast.ps1 回退为 fire-and-forget 后没人写），客户端也从不调用 host 的 get-latest-decision-session。现在客户端在「窗口重新获得焦点」时先消费跳转请求，没有再跳到「正在等你决策」的会话；toast.ps1 与 README 里的相关说明同步改写（并记录 PowerShell 订阅不到 WinRT 事件这一实测结论）
• 改进 提醒卡上限溢出时连淡出定时器一起清理；弹窗遮罩提示与「开始」校验共用同一套 hint 逻辑
• 测试 npm test 从 4 个套件扩到 6 个：新增 host 全链路套件（101 项：计时/提醒/记录/工具/决策/边界/瘦身）与客户端 UI 套件（39 项：真实 DOM + mock React 渲染决策卡与设置弹窗）；旧套件补上系统通知打桩——在此之前跑测试会真的在桌面上弹 Windows 通知

v0.2.5

• 改进 系统提示词同步双通道行为：原来写的是「含系统提示音与桌面通知」，v0.2.4 改成按人在不在 DSH 分流后文案没跟上——现在改为「人在 DSH 里时发界面内提醒卡 + 提示音，不在 DSH 里时发系统桌面通知；需要决策时界面内常驻红卡，不在 DSH 里时额外发桌面通知」，避免 agent 向用户转述错误的通知方式
• 清理 移除调试期留下的 console.log：host 端 6 处（get-pending-setup 每次弹窗轮询都打一行、两条 stale waitingDecision 分支、三处 cleared waitingDecision）、client 端 3 处（SetupManager poll 每 2 秒打一行并 JSON.stringify 全部会话 id、get-pending-setup 结果、approval/request 到达）——这些在 DSH 控制台里会持续刷屏，且 SetupManager poll 的字符串拼接本身有开销
• 清理 保留 4 处真正有诊断价值的日志（模块配置加载/保存失败的 console.warn、session/event 与 approval/request 处理异常的 console.error）
• 移除仓库里的临时文件：.npm-cache/（暂存的 npm 缓存，已加入 .gitignore）与 _dbg_channels.mjs（调试探针，功能已被 scripts/verify-channels.mjs 覆盖）
• 顺带修正 clearWaitingDecision 三处调用点残留的缩进

v0.2.4

• 修复 设置弹窗误判为「跳过」：遮罩（弹窗外区域）点击不再等于跳过——以前点一下弹窗外区域就会永久跳过本次设置，鼠标滑出窗口后点回窗口、或在输入框里拖拽选字时松手到卡片外，都会命中这条路径
• 新增 误跳过可恢复：计时条新增「⚙ 设置计划」，对应的 reopen-session-setup RPC 会撤销「已跳过」标记并重新弹出设置窗
• 改进 get-status 增加 configured 字段；设置弹窗点击遮罩时给出提示文案
• 修复 外部通知有两个开关互相打架：设置页原来的「外部通知（提示音 + 系统弹窗）」勾选框与提醒模块里的「外部通知」开关会各自覆盖对方（开关显示「开」、实际被旧值静默关掉）。现在只保留模块开关里的那一个，旧配置项 defaults.externalAlert / session.externalAlert 已移除
• 新增 任务用时的可修改默认配置：设置页「任务用时 → 默认配置」可改默认计划用时（15/30/45/60/90/120/180 预设或自定义）与默认提醒间隔，新会话设置弹窗按此预填（defaults.plannedMinutes，get-pending-setup 下发 defaultPlannedMinutes）
• 改进 设置页按模块分组：开关与这个模块最需要的配置放在同一组里（任务用时 → 默认配置；提醒 → 外部通知配置 + 发送测试通知按钮）
• 新增 内部通知 / 外部通知双通道：client 每 2 秒上报 ui-presence（焦点 + 可见性，超时 10 秒按离开处理），host 用 shouldSendExternal() 统一判定——人在 DSH 里只发内部通知（提醒卡 + WebAudio 合成提示音），不在 DSH 里才发系统通知；判定结果回传 client，两个通道不会同时响
• 新增 「外部通知时机」配置（defaults.externalWhen）：DSH 不在前台时（默认）或 只有 DSH 页面不可见时；设置页「当前状态」实时显示此刻算不算「在 DSH 里」
• 改进 通知开关改为对称的一对：内部通知（在 DSH 里：提醒卡 + 提示音） / 外部通知（不在 DSH 里：系统 Toast + AUMID）；浏览器通知也归外部通道（人在 DSH 里不再弹）；「发送测试通知」不受时机限制
• 修复 插件刚加载就被停用时，停用回调会拿内置默认值覆盖磁盘上已存的配置（默认计划用时 / 外部通知时机等）—— 现在只有状态真的从磁盘恢复过（stateLoaded）才落盘，且停用落盘改用 RECORDS_FILE 而不是另写一份硬编码路径
• 修复 get-config / get-external-status 现在会 await ensureLoaded()，设置页不会先显示内置默认值再跳变

v0.2.1 (2026-09-10)

• 修复 end-task 缺少 history 截断，已完成记录可无限增长
• 修复 决策节流记录（decisionAlerts）只增不删导致内存泄漏 + 新决策被旧节流压制
• 修复 任务结束时未清理决策节流记录，影响同一会话的新任务
• 修复 跳过会话设置时丢弃已累积的任务计时，改为归档到已完成记录
• 修复 set-session-config/dismiss-session-setup 中 persistRecords() 无 await，即时落盘保证不可靠
• 修复 3s tick 定时器可能重叠执行导致竞态，改为递归 setTimeout
• 修复 tools/pre-execute 正则未锚定，子串匹配可误触发决策提醒

v0.2.0

• 首个正式发布版本，完整功能集见上方功能概览

---

License

MIT License — 详见 LICENSE

Copyright (c) 2026 dsh-task-time contributors