# DSH会话完成提醒
**Repository Path**: user_gitee/dsh-completed-ding
## Basic Information
- **Project Name**: DSH会话完成提醒
- **Description**: 功能只有一个,deepseek harness每个会话完成时,在桌面轻提醒,极低占用。
- **Primary Language**: TypeScript
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/user_gitee/dsh-completed-ding
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-30
- **Last Updated**: 2026-11-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: dsh-plugin
## README
---
> **导读** 它不负责跑任务,只负责在任务跑完时,把结果递到你眼前。一张卡片,四十秒,不打断你手上的事。
## 01 被忽略的那个瞬间
长任务跑起来之后,真正的焦虑往往不是“它慢”。
你不知道它什么时候结束,于是反复切回来看看;它失败了,只留下一段难懂的报错;它停下来等你确认,而你正在别处忙。
**完成提醒**只处理这三件事:完成时告诉你,失败时说清原因,需要你回答时把问题送到你眼前。
## 02 三种时刻
### 完成 · 温柔收尾
会话从运行变为空闲,右下角浮起一张奶油色卡片。吉祥物带着对勾轻轻晃一下,停留四十秒,然后退场。
### 失败 · 把原因说人话
额度不足、网络中断、登录失效、请求过频、上下文超限、服务不可用——先归类,再保留原始摘要。底色仍是暖色,只把点缀换成陶土红,不吓人,但足够醒目。
### 待回答 · 别让问题等你
会话向你提问、请你确认计划、等待授权时,卡片会显示具体问题,并给出一个整行的「去回答」。点一下,直接回到那个会话。
## 03 克制的设计
| 它做 | 它不做 |
| --- | --- |
| 读 DSH 已经渲染的会话状态 | 不轮询、不抓取会话内容 |
| 一次只显示一条提醒 | 不堆叠、不刷屏 |
| 提醒出现时响一声 | 不常驻后台、不写会话日志 |
| 只有检查更新时联网 | 日常提醒不联网 |
**没有构建步骤。** 没有打包器、外部 UI 依赖或 CDN,`client.js` 就是运行文件;吉祥物的眼睛会跟着鼠标轻轻转动,也会尊重系统的“减少动态效果”。
## 04 三种出现方式
默认是 **自动选择**:DSH 在前台时用窗口内卡片;切到后台、最小化或收进托盘时,优先用已打开的悬浮窗,其次交给 Windows 通知中心。三种方式不会同时出现。
### DSH 内卡片
固定在窗口右下角,奶油磨砂的果冻卡片,一次只来一条,四十秒后自动收起。
### Windows 通知中心
交给系统显示,可以出现在 DSH 窗口之外。位置、圆角、停留时间由系统决定;默认「其他应用全屏时只保留声音」。
### 桌面悬浮窗(实验)
用 Document Picture-in-Picture 打开的置顶小窗,需要点一次「打开悬浮窗」,之后复用同一张卡片。
## 05 安装
1. 打开 DSH 左侧栏的 **插件**。
2. 点击 **添加插件**,把 **安装源** 设为 **npm 官方源**。
3. 粘贴地址:
```text
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`(只删链接,别删源码),再重新安装。
逐条排查与手动清理命令见 **[使用手册 · 安装与卸载失败](./docs/README.md#安装与卸载失败)**。
## 常见问题
**会打断我正在做的事吗?**
不会。卡片是非模态的,不抢焦点,可以随时点右上角关掉。
**为什么默认四十秒?**
足够你从别的事情里注意到它,又不会长时间占着角落。
**为什么有时候没有声音?**
浏览器要求先有一次用户交互才允许播放音频。点一下页面再试听即可,也检查声音开关和音量。
**多个会话同时完成会叠在一起吗?**
不会。只保留一条当前卡片和一条待显示卡片,新的替换旧的。
**卸载后我的设置还在吗?**
还在。设置与自定义音频存在浏览器里,卸载不会清理;需要彻底清除时在开发者工具里删除对应的 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 秒冷却。
## 文档
| 文档 | 内容 |
| --- | --- |
| [使用手册](./docs/README.md) | 安装、配置、更新记录、重要说明、故障排查 |
| [开发手册](./docs/develop-readme.md) | 架构、数据流、组件、样式、扩展与发布流程 |
当前版本 **1.5.16**。检查更新与更新过程会访问 Gitee;日常提醒本身不联网,也不读取凭据或会话内容。
## License
[AGPL-3.0](./LICENSE)
---
Built for DSH · 让等待有回应