工作区状态标记 Stijnus/dsh-workspace-status

dsh-workspace-status · 工作区状态与置顶会话

English ·

为 DeepSeek Harness 侧边栏增加三层能力：

1. 工作区状态标记：在侧边栏的工作区（文件夹）行上显示彩色状态——等待你处理、正在运行、刚刚完成，由该工作区内的会话聚合而来。
2. 已置顶会话区：通过 Harness 原生置顶操作置顶的会话，会从常规工作区分组中提取出来，显示在工作区列表上方的独立区域；按工作区分组，沿用原生工作区行的样式，并在行尾显示置顶图标。
3. 已置顶会话通知：置顶会话开始等待你处理或运行结束未读时，窗口在后台会发系统通知，同时置顶区内始终显示应用内提醒；通知开关与提示音按钮位于置顶区标题栏。

侧边栏本来就会在每个会话行上显示状态点，但上方的文件夹行什么都没有。收起分组或滚动之后，就看不出里面是否还有等待审批、仍在运行的会话。本插件补上这一层，并把置顶会话集中到列表上方。

功能

工作区状态标记

| 标记 | 含义 | 颜色 |
| 实心点 | 有会话在等你：审批 / 计划评审 / 回答 | 琥珀 --dsw-alias-state-warn-primary |
| 旋转圆环 | 有会话或子代理正在运行 | 蓝 --dsw-static-deepseek-450 |
| 实心点 | 有会话刚刚结束且尚未打开（1 小时提示窗口） | 绿 --dsw-alias-state-success-primary |

- 状态优先级与原生会话行一致：等待 > 运行 > 刚刚完成；一个工作区同时只显示一个主标记。
- 子代理的运行状态计入其父会话所在工作区；子代理行本身不产生标记。
- 已归档会话忽略；未分组会话落在「未分组」行。
- 标记固定在行尾时间戳的位置，不挤动标题；展开或收起都可见。
- 提供隐藏的无障碍描述（如「工作区状态：2 个运行中、1 个等待你处理 — api、web」）。

已置顶会话区

- 使用 Harness 原生置顶操作（会话行悬停按钮或 … 菜单）；置顶后无需重启即可出现在 Pinned / 已置顶 区域。
- 按工作区分组，每组沿用原生 34px 工作区行：文件夹图标、当前工作区蓝色高亮、折叠三角、圆角与计数。
- 每行显示实时状态点、相对时间、当前会话高亮，以及行尾的实心置顶图标；点击图标立即取消置顶，行会回到原工作区分组。
- Pinned 标题和各工作区分组都可折叠，折叠状态保存在浏览器本地。
- 区块限高并可独立滚动，不会把工作区列表挤走。
- 置顶集合来自 Harness 的 pinnedSessionIds（保存在 profile 的工作区注册表），重启后仍会显示同样的置顶会话与图标。
- 搜索不受影响：已置顶会话仍然出现在搜索结果中；常规分组列表则隐藏被提取的行。
- 常规列表中的工作区标题会保留（其「新会话」按钮仍可用），因此当某个工作区的会话全部被置顶时，常规列表里可能出现一个空分组，而会话显示在上方。

已置顶会话通知

- 触发条件（仅限已置顶会话）：开始等待你（审批 / 计划评审 / 提问），或运行结束且完成标记未读。
- 只对状态变化发通知：刷新后的第一次观察保持安静，同一等待原因不会重复提醒，原因变化（审批 → 提问）会再次提醒，完成只在每次运行结束时提醒一次。
- 窗口在后台且系统已授权时发桌面通知；点击通知会聚焦应用并打开对应会话。
- 置顶区始终显示应用内提醒（系统阻止通知时同样可用），带状态图标、标题与原因；点击打开会话，点 × 或等待 8 秒自动消失。
- 标题栏的铃铛开关通知并在首次点击时申请权限、显示一条测试提醒；喇叭开关可选的两声提示音。两项偏好保存在浏览器本地，默认通知开、提示音关。
- 通知是客户端行为：应用运行期间才会触发，不提供邮件 / IM / Web Push 等外部推送，也不会提醒置顶以外的会话。

快速开始

dsh plugin --profile web add dsh-workspace-status

重启 Harness（或刷新 Web 界面）。工作区行会出现状态标记；置顶任意会话即可看到上方的置顶区域与铃铛/喇叭开关。

要求

- DeepSeek Harness >=0.2.1-rc.2 <0.3.0-0，Web 或桌面版。
- Node >=22.18.0（仅测试需要；无构建步骤）。
- 不修改 Host 行为、不提供 Host 设置项、不向模型注册工具或提示词；置顶状态使用 Harness 原生工作区置顶集合，通知偏好与折叠状态保存在浏览器本地。

验证

1. 在某工作区运行会话并收起分组：工作区行尾出现蓝色圆环。
2. 在另一个工作区触发审批：即使展开，该行也显示琥珀点。
3. 让会话跑完但不打开：出现绿点，约一小时后消失。
4. 置顶任意会话：列表上方立即出现 Pinned 区，按工作区分组，行尾有置顶图标。
5. 再置顶另一个工作区的会话：出现第二个分组标题。
6. 点击行尾置顶图标取消置顶：该行立即从 Pinned 区消失并回到原工作区分组。
7. 重启 Harness：同样的置顶会话仍在，图标也仍显示。
8. 点击置顶区标题栏的铃铛：首次会申请通知权限并显示测试提醒；再次点击关闭。
9. 让置顶会话结束或开始等待：置顶区出现应用内提醒；窗口在后台时还会收到系统通知。

相关链接

- 英文说明（完整细节）：README.md
- npm：<https://www.npmjs.com/package/dsh-workspace-status>
- 更新记录：CHANGELOG.md

同系列插件：情绪板 · 输入补全 · 移动到工作区 · 工作区状态 · 提示词改写

⭐ 如果它帮你省了一步，点个 star 能让更多 DSH 用户发现它。