前言¶
在 DeepSeek Harness(DSH)里,单个会话行在 agent 运行时会显示转圈指示;工作区列表一旦折叠或滚动,只看得到工作区标题,很难一眼判断「哪个项目正在忙」。侧栏默认也不会在工作区行上给出与下层会话一致的状态。下面介绍社区插件 dsh-workspace-activity(维护者 charliesbyte),它在客户端侧栏的工作区行上补充与官方简介一致的 running / just-finished 指示,让你不必展开每个工作区也能定位当前活跃项目。
这是什么¶
dsh-workspace-activity 是 DSH 的客户端插件(dsh.client.platform: web),分类属于客户端 UI 增强。它从与会话行相同的状态来源推导工作区是否「在跑」,并在侧栏对应工作区行尾部绘制与产品一致的 spinner;折叠时还会用与工作区浏览器相同的蓝色 tint 文件夹图标。不需要 host 服务、配置项或额外权限。
源码与说明见 GitHub:charliesbyte/dsh-workspace-activity。社区目录页:SkillHub 插件详情。DSH 生态采用「一切皆插件」思路;SkillHub 等目录站由社区维护,与 DeepSeek / 幻方无官方从属关系,安装前请自行核对仓库与许可证(本插件为 MIT)。
核心功能¶
经文档核实,插件主要做这些事:
- 工作区级指示:当该工作区下至少有一个会话处于 running 状态时,在工作区行尾部 16px 槽位显示 spinner,与会话行时间戳区域的几何与主题 token 一致。
- 与会话状态同源:优先使用状态 feed;会话列表为后备, precedence 与工作区浏览器一致,避免工作区与会话两行说法不一致。
- 折叠列表可读性:工作区折叠、会话行不可见时,用文件夹图标的蓝色 tint 单独传达「此工作区在忙」。
- 无障碍:无法看见 spinner 的读者可通过 visually hidden 文案获得运行中的会话数量与工作区名称。
- 实现边界(安装前建议了解):工作区行没有官方扩展槽位,插件通过样式表装饰侧栏已有行,不写入 DOM、不挂观察器。选择器依赖
@deepseek-ai/dsh-client-ui-workspace内部的data-row-key;若未来版本改名,指示可能消失,但文档说明不会破坏侧栏本身。
文档还说明了不会标记的情况:子 agent 会话(侧栏折叠进父会话、且无独立工作区 id)、以及按默认视图隐藏的 archived 会话;若侧栏设置改为显示 archived,插件无法感知该过滤开关,可能出现 archived 会话在跑但工作区行未标记的边界情况。
安装与启用¶
在目标 profile 下执行 marketplace / README 给出的安装命令:
dsh plugin --profile <name> add dsh-workspace-activity
将 <name> 换成你实际使用的 profile 名称(例如 Web 客户端常用 web)。安装完成后重启 dsh,或在 Web 端重新加载页面。文档说明该插件以 bundle 形式分发,也可通过插件市场等 bundle 感知客户端安装。
插件在本机 dsh 进程权限下运行;安装前请阅读 GitHub 源码与 MIT 许可证,仅信任你认可的发布来源。
典型用法¶
本插件无配置文件。典型流程如下:
- 按上一节命令安装并 reload。
- 打开带侧栏的 Web 或桌面客户端,保持默认侧栏工作区视图。
- 在某个工作区下启动 agent 会话;会话行出现 spinner 的同时,上级工作区行尾部应出现相同风格的 spinner;若工作区处于折叠状态,文件夹图标会带蓝色 tint。
侧栏示意(来自官方 README ASCII 示例):
📁 dsh-workspace ◌ ← 插件添加
◌ 处理所有 skill 同步到已同步 刚刚
适用场景与注意¶
适合谁:经常在多个工作区之间切换、习惯折叠侧栏或长列表滚动,需要快速看到「哪个 workspace 正在跑任务」的 DSH 用户。
环境要求:Web 或桌面客户端;纯 host 侧或无 UI 的场景用不上。
注意:
- 依赖客户端内部 DOM 约定,非公开 API;升级 DSH 客户端后若指示消失,需等待插件作者适配选择器。
- 与 archived / 子 agent 相关的边界见上文;若你 heavily 依赖 archived 过滤或非默认侧栏视图,安装后应自行验证是否符合预期。
- 社区目录页的星标、版本等以各站点展示为准;本文不臆测未在文档出现的版本号或用户数据。
结尾¶
dsh-workspace-activity 把会话级的运行状态「抬升」到工作区行,解决折叠侧栏下看不清 busy 项目的问题,安装成本低、零配置。进一步了解与安装入口:
- 目录页:https://www.skillhub.cn/plugins/charliesbyte/dsh-workspace-activity
- GitHub:https://github.com/charliesbyte/dsh-workspace-activity