前言¶

DSH 的理念是「一切皆插件」。当一个工作区里同时开着多个会话、每个会话下面还挂着若干子代理时，靠反复翻列表很难快速判定：哪些会话在等我处理，哪些还在跑，哪些刚结束，这段时间 Token 花了多少。dsh-plugin-task-radar（维护者 hualidan42-beep）把这件事做成一个可拖动、可折叠的浮窗，外加一块主区工作面板。下面介绍它的定位、功能、安装与使用方式。

这是什么¶

一句话定位：面向 DSH Web 的客户端插件，按工作区归堆展示会话状态、子代理、待办与 Token 用量，点一下直达对应会话。

维护者：hualidan42-beep。分类：客户端。星标：0。当前包版本以 package.json 为准，为 0.10.0。它解决的问题是：DSH 原生界面没有专门面向「多会话并行 + 子代理 + Token 观察」的状态面板，开发者需要自己在会话之间来回切换，才能拼出进度和用量。

核心功能¶

先列出插件已经实现的能力：

• 按工作区查看会话，状态分为四类：等你处理、正在运行、刚完成、空闲。
• 展示待办清单、子代理、模型标签和 Token 用量，点击条目直达会话。
• 本地记录今天、本周、本月的 Token 增量；首次观察只建立基线，不回补历史用量。
• 可选系统通知、浮窗外观与主题插画，首次安装默认「桂花月兔」。
• 边框粗细（0–3px）与颜色可调，默认跟随主题，可一键恢复默认。
• 框体尺寸拖右下角把手即可调整，范围 240–560 × 160–760，双击复位。
• 干扰控制：对单条会话静音 1 小时、「我认这活做完了」一键收工、今天不再弹系统通知。
• 可选联动 dsh-plugin-skin；未安装该皮肤插件时，任务监控和浮窗外观仍可独立使用。

安装与启用¶

安装分两步：先加索引源，再从市场点安装。

1、打开 DSH 的「插件 → 实验性插件 → 更多」，启用「自定义插件市场」。

2、进入「发现 → 管理索引源」，添加下面这个作者自己的索引地址：

https://raw.githubusercontent.com/hualidan42-beep/dsh-plugin-task-radar/main/market-index.json

需要说明的是：这只是作者的自定义索引，不是 DSH 官方市场。索引里的每个版本都指向 npm 上的精确版本号，并记录真实发布时间。

3、在市场里找到「工作小管家」点击安装。也可以直接装 npm 包：

dsh plugin --profile <你的-profile> add "dsh-plugin-task-radar@0.10.0"

安装 bundle 后默认选中启用，是否需要刷新或重启以宿主提示为准。不需要手工建立 junction，也不需要覆盖 profile 文件。

启用之后怎么用¶

安装完成后，浮窗默认出现在界面上。常用的操作集中在三件事上。

第一是看状态和改外观。会话按工作区归堆，点开可以看到子代理、模型标签与 Token 用量。拖右下角把手可改框体大小，双击复位；边框颜色与粗细在外观设置里调整。

第二是加干扰控制。某条会话暂时不需要提醒，就对它静音 1 小时；某个任务已确认完成，用「我认这活做完了」收工；今天不想再弹系统通知，就开启免打扰。

第三是看 Token 流水。主区面板提供今天/本周/本月的增量视图。插件只记录开始观察之后的变化，不做历史回算，所以首次使用时数字会从零基线起步，需要观察一段时间才有参考价值。

数据与权限¶

插件读取的都是宿主已经下发的数据：工作区、会话状态、待办、子代理和 Token 投影。它不注册 Host 路由，不写业务目录，不调用模型，也不主动把会话数据上传到外部服务。

本地侧的设置和记录存放在浏览器 localStorage 的 dsh-plugin-task-radar/v1 键下，包括浮窗位置、外观、已读与计时记录、用量流水。系统通知需要用户手动授权，通知内容里可能出现会话标题。

需要注意两点：清除当前浏览器的站点数据会一并清掉插件记录，卸载插件不会自动删除这些浏览器数据。Token 流水只是观察记录，不是账单。

适用场景与注意¶

适合的对象：主要面向使用 DSH Web、同时维护多个会话与子代理的开发者，希望有一个常驻浮窗做进度与用量观察。仓库的验证命令 npm run verify 和 npm pack --dry-run --ignore-scripts 需要 Node.js >= 18，但用户侧安装不要求本机装 Node。

已知限制按 README 列示如下：

• 仅中文界面，面向 DSH Web，需要现代浏览器支持 relative color、color-mix 等 CSS。
• 尚未宣称对特定 DSH 版本范围的兼容保证，也未在干净 profile 中完成安装验收。
• 父会话计时从插件开始观察时算起；待办内容由代理维护，不保证结束时全部勾选。
• Token 明细保留最多 400 天，采用本地时区；清除缓存或更换浏览器不继承。
• 缺少宿主投影时，相关明细可能不显示。

安装前建议：插件以当前 dsh 进程的权限运行，安装前应检查源码与许可证。包配置里声明 MIT，但该声明针对作者有权授权的代码，第三方素材或角色的权利仍属于各自权利人。仓库不包含开发机工作区和业务数据，图片已内嵌在 client.js 中。

小结¶

这个插件的价值在于把散落的会话进度和用量信息收进一个可拖动、可折叠的浮窗，减少在多个会话之间来回切换的成本。它不替代 DSH 原生列表，更像一个常驻在手边的观察面板。

目录页：https://www.skillhub.cn/plugins/hualidan42-beep/dsh-plugin-task-radar

仓库：https://github.com/hualidan42-beep/dsh-plugin-task-radar