DeepSeek Harness (DSH) 采用插件化架构，允许用户根据需求扩展功能。在长期运行智能体时，缺乏即时的任务反馈和精细的成本控制是常见痛点。dsh-task-notice 旨在通过 Web 界面通知、系统级横幅提示以及多维度的消耗统计，解决任务进度不可见和成本核算分散的问题。
插件简介¶
- 核心定位：代理任务完工通知 + 顶部提示横幅 + 按 Provider(Key)的 Token 消耗统计 + 价格编辑 + 使用分析
- 维护者：Haoxiang-Fant
- 类别：客户端
- 版本：0.3.10
核心功能¶
1. 任务通知与提醒¶
插件在代理完成顶层会话的任务或目标时触发通知。
* 完工通知：每次任务完成后，Web 界面右上角弹出 toast，并通过浏览器 Web Notifications API 向 Windows 系统发送横幅通知（桌面右下角 + 操作中心）。通知内容包含本次消耗的 tokens（缓存输入/缓外输入/输出/合计）及金额。
* 操作提醒：代理发起权限请求或提问时，同样会触发页内弹窗 + 系统通知，引导用户处理。
* 窗口切换提醒：单轮任务缓存输入超过阈值（默认 20 万 tokens，可调）时，任务完成后会提醒切换新对话，并支持一键生成 HANDOFF.md 开发交接文档。设置路径位于：顶部导航 → 工具箱 → 窗口切换提醒。
2. 消耗统计与分析¶
在“设置 → 任务通知与消耗”页面中，数据展示统一遵循 K/M/B/T 进制规则。
* Token 消耗统计：按 Provider (Key) 归集。支持 1 年/6 个月/3 个月/1 个月/15 天/1 周/24 小时/自定义 时间范围筛选。数据维度包括缓存输入、缓外输入、输出及调用次数。
* 使用分析：
* 消耗金额：饼图展示模型金额占比，悬停查看详细数据。
* Token Plan 回本：显示回本进度条及 1 Credit 兑换的 Tokens。支持重置当前周期（需 4 位验证码 + 两次点击确认）及撤回重置。
* 性价比：计算 1 元可兑换的 tokens 数量。
* 每日费用：微型日历展示每日用量，下方列出最近 6 天的详细消耗表。
3. 价格管理与编辑¶
- 价格编辑：支持按模型编辑价格。未激活自定义的模型默认按内置官方价格目录计费（基于 2026-09 数据，包含 DeepSeek 峰谷档）。
- 峰谷计价 v2：
- 支持逐日生效日（工作日/自定义星期/每天）和自定义时区（默认 UTC+8）。
- 峰时价格方式支持倍率或自定义。
- 规则按条件格式自上而下匹配，首个命中生效。
- 自定义倍率：支持 Provider 级别和模型级别的价格倍率调整。
- 旧账目处理：0.1/0.2 版本记录的旧消耗默认按低谷价计算金额，不会按峰时价回溯。
4. 界面与机制优化¶
- 顶部提示横幅：常驻页面顶部。
- 权限横幅：未授权浏览器通知时，点击即可一键索权。
- 价格横幅：当前使用的模型无价格时，点击直接弹出价格编辑弹窗，点击“保存并确定”立即生效。
- 保存机制优化：设置页采用草稿模式。更改先落本地草稿，界面即时生效。点击保存按钮、切换选项卡或退出设置页时自动保存。直接退出设置页时会询问是否保留更改，超时（10秒）默认保留。
- 显示名称：优先取全局模型设置中的自定义显示名（Provider 显示名 + 模型显示名）。
安装与启用¶
推荐使用 tarball 方式安装，以避免 Windows 下路径解析问题。
# 1. 在插件源码目录执行，生成 tarball
pnpm pack
# 2. 安装插件
dsh plugin add <tarball 路径>
安装完成后需重启 DSH（如 dsh web）以使依赖生效。
典型用法¶
- 启用通知：进入插件设置页，点击「授权并开启」以启用系统通知。
- 设置价格：如果当前使用的模型未规定价格，顶部横幅会提示，点击即可进入价格编辑页。
- 查看统计：在设置页顶部导航切换至「消耗统计」或「使用分析」，查看 Token 使用情况和成本分布。
注意事项¶
- 权限要求：需浏览器 Web Notifications API 权限。
- 数据归属：统计与分析中的“Key”指全局模型设置中的 Provider 路由，显示名取自 Provider 的
displayName。 - 价格生效：点「保存价格」后，汇总卡片、统计金额及完工通知金额立即按新价格重算。
- 数据迁移：升级后首次启动会自动执行旧价格配置的迁移脚本。
