---

导读　它不负责跑任务，只负责在任务跑完时，把结果递到你眼前。一张卡片，四十秒，不打断你手上的事。

01 被忽略的那个瞬间

长任务跑起来之后，真正的焦虑往往不是“它慢”。

你不知道它什么时候结束，于是反复切回来看看；它失败了，只留下一段难懂的报错；它停下来等你确认，而你正在别处忙。

完成提醒只处理这三件事：完成时告诉你，失败时说清原因，需要你回答时把问题送到你眼前。

02 三种时刻

完成 · 温柔收尾

会话从运行变为空闲，右下角浮起一张奶油色卡片。吉祥物带着对勾轻轻晃一下，停留四十秒，然后退场。

失败 · 把原因说人话

额度不足、网络中断、登录失效、请求过频、上下文超限、服务不可用——先归类，再保留原始摘要。底色仍是暖色，只把点缀换成陶土红，不吓人，但足够醒目。

待回答 · 别让问题等你

会话向你提问、请你确认计划、等待授权时，卡片会显示具体问题，并给出一个整行的「去回答」。点一下，直接回到那个会话。

03 克制的设计

它做	它不做
读 DSH 已经渲染的会话状态	不轮询、不抓取会话内容
一次只显示一条提醒	不堆叠、不刷屏
提醒出现时响一声	不常驻后台、不写会话日志
只有检查更新时联网	日常提醒不联网

没有构建步骤。 没有打包器、外部 UI 依赖或 CDN，client.js 就是运行文件；吉祥物的眼睛会跟着鼠标轻轻转动，也会尊重系统的“减少动态效果”。

04 三种出现方式

默认是 自动选择：DSH 在前台时用窗口内卡片；切到后台、最小化或收进托盘时，优先用已打开的悬浮窗，其次交给 Windows 通知中心。三种方式不会同时出现。

DSH 内卡片

固定在窗口右下角，奶油磨砂的果冻卡片，一次只来一条，四十秒后自动收起。

Windows 通知中心

交给系统显示，可以出现在 DSH 窗口之外。位置、圆角、停留时间由系统决定；默认「其他应用全屏时只保留声音」。

桌面悬浮窗（实验）

用 Document Picture-in-Picture 打开的置顶小窗，需要点一次「打开悬浮窗」，之后复用同一张卡片。

05 安装

1. 打开 DSH 左侧栏的 插件。

2. 点击 添加插件，把 安装源 设为 npm 官方源。

3. 粘贴地址：

   https://gitee.com/user_gitee/dsh-completed-ding.git
   

4. 安装并启用，刷新一次页面；左侧栏出现 完成提醒。

需要 DSH 的 Web 或 Desktop 版本，并带有插件管理器。插件没有构建步骤，装完不需要再装依赖。

06 设置

打开左侧栏 完成提醒，所有修改自动保存。

配置	默认	可以改什么
总开关	开	临时关掉所有提醒与声音，入口保留
通知位置	自动选择	DSH 内卡片 / Windows 通知中心 / 桌面悬浮窗
全屏时只保留声音	开	其他应用全屏时不弹 Windows 通知
提醒内容	工作区 + 任务名 + 时间	字数、完整路径、时间显示
提示声音	轻提示音	六种短音、两段内置语音、自定义音频
音量	55%	只影响本插件
自动关闭时长	40 秒	5–60 秒
连续提醒间隔	200 毫秒	上一条收起后隔多久显示下一条
提醒范围	主会话	是否包含子代理、待回答时是否提醒
侧栏入口	显示在左侧栏	可收进「插件」页，从那里打开设置
自动更新	不自动	不自动 / 每天提示 / 每天自动安装

设置与自定义音频只保存在当前浏览器，不写入会话记录。左侧栏入口可以关掉：关闭后到 插件 → 完成提醒 里打开设置，切换立即生效。

07 更新与卸载

检查更新

设置页底部「版本与更新」：点击 检查更新，发现新版本后点击 立即更新。运行文件会被替换，设置与音频保留，页面随即刷新；刷新后的页面会在右下角提醒一次「已更新到 vX.Y.Z」（1.5.9 起，首次升级到该版本时旧版还没有记录，不弹）。

也可以直接点右上角的 更新 按钮：就地检查一次，不跳转页面。发现新版本会直接弹出确认框，点「立即更新」即可下载替换；没有新版本时只在按钮下方显示「已是最新」。

自动更新

三种模式，默认 不自动更新：不自动检查、每天检查并提示、每天检查并自动安装。检查按二十四小时节流，失败不会记为已检查。

卸载

设置页右上角的 卸载 按钮（取出图标 + 文字），确认后先清理本插件可能留下的残留，再交给 DSH 插件管理器执行；成功后页面自动刷新，侧栏入口一起消失。也可以随时从左侧栏 插件 页面卸载。

08 装不上、卸不掉

两个常见原因，先看这里：

• 提示「中国大陆镜像源不可用」：国内 npm 镜像同步慢，换 npm 官方源（国际源）重试；卸载报错时同理。
• 提示「没有写入权限，无法安装」：通常不是权限，而是之前用本地目录装过，node_modules 里留下了同名目录联接。完全退出 DSH，删掉 node_modules/dsh-completed-ding（只删链接，别删源码），再重新安装。

逐条排查与手动清理命令见 使用手册 · 安装与卸载失败。

常见问题

会打断我正在做的事吗？

不会。卡片是非模态的，不抢焦点，可以随时点右上角关掉。

为什么默认四十秒？

足够你从别的事情里注意到它，又不会长时间占着角落。

为什么有时候没有声音？

浏览器要求先有一次用户交互才允许播放音频。点一下页面再试听即可，也检查声音开关和音量。

多个会话同时完成会叠在一起吗？

不会。只保留一条当前卡片和一条待显示卡片，新的替换旧的。

卸载后我的设置还在吗？

还在。设置与自定义音频存在浏览器里，卸载不会清理；需要彻底清除时在开发者工具里删除对应的 localStorage 键。

卸载失败、或卸载后侧栏还有入口？

先把安装源换成 npm 官方源 再卸载；仍然失败就重启 DSH；还不行按使用手册里的相对路径手动清理 node_modules/dsh-completed-ding 与 node_modules/dsh-completed-ding_tmp_*。

更新时提示「Gitee 403 Rate Limit Exceeded」？

Gitee 对未登录接口按 IP 限流，约每小时 60 次，同一网络共用。等约一小时，或换个网络（例如手机热点）即可；1.5.12 起更新改走 raw 地址、不再调用接口，并给手动检查加了 30 秒冷却。

文档

文档	内容
使用手册	安装、配置、更新记录、重要说明、故障排查
开发手册	架构、数据流、组件、样式、扩展与发布流程

当前版本 1.5.16。检查更新与更新过程会访问 Gitee；日常提醒本身不联网，也不读取凭据或会话内容。

License

AGPL-3.0

---