前言¶
在 DSH 生态中，智能体开发往往依赖控制台日志或隐式状态来确认任务进展。dsh-task-capsule 是一个客户端插件，旨在把“正在跑什么任务、跑完没有”的状态固定在 Web UI 上。由 wzn16 维护，它从 dsh-dock 提取了最常用的功能，专注于任务追踪与通知，而不重复处理 token 统计。
核心功能¶
插件提供两个主要组件：
- 任务胶囊：常驻在会话 header。使用颜色区分状态：运行中、等待确认、已结束、出错。点击胶囊跳转会话；多个任务时显示下拉列表。
- 任务通知卡：任务完成、出错或等待确认时，在页内弹出通知卡片。卡片包含跳转按钮。支持 WebAudio 提示音（无音频文件）和可选的系统通知。
安装与启用¶
安装需要将插件以本地链接形式加入 profile 依赖。
# 1. 克隆仓库到本地任意位置
git clone https://github.com/wzn16/dsh-task-capsule.git
cd dsh-task-capsule
# 2. 安装运行时依赖（仅 @deepseek-ai/schemastery 一个）
pnpm install
# 3. profile 依赖加入本地链接（路径换成你自己的克隆位置）
cd ~/Library/Application\ Support/dsh-desktop/harness/profiles/web
pnpm add "link:/path/to/dsh-task-capsule"
# 4. 重启 DSH Desktop（刷新浏览器不够）
配置与使用¶
在插件设置区调整通知行为。打开「系统通知」开关时会触发系统授权弹窗（拒绝也不影响页内通知卡）。
- 测试通知：未授权时点「请求授权并测试」会弹出系统授权弹窗，允许后自动发送测试通知；已授权时点「发测试通知」直接验证链路。
- 配置项：包括完成通知、出错通知、等待确认通知、停留时长（默认 8000ms，0 为常驻直到手动关闭）、系统通知、前台时也推系统通知、提示音（WebAudio 合成音色）。
注意事项¶
- Token 统计交给 DSH 自带会话统计条，不重复做。
- 提示音使用 WebAudio 合成。
- 系统通知差异：macOS 的 tag 去重由 Electron 提供仅在 Windows / Linux 生效，macOS 上每条通知独立展示。
- 前台时也推系统通知默认关闭。
- 安装需要 profile 依赖加入本地链接。
总结¶
该插件从 dsh-dock 提取精简而成，专注于任务状态可视化与通知。适合需要清晰掌握多会话任务进度的开发者。
