前言¶
在 DeepSeek Harness 里，会话往往按工作区分散在侧栏列表中。当你同时开着多个工作区、或有任务在后台运行、等待你点选操作时，要在各工作区之间来回切换才能看清「谁在跑、谁需要你点一下、谁刚跑完还没看」。原生列表按工作区组织，缺少一张跨工作区的「活动总览」。下面介绍社区客户端插件 dsh-session-filter（仓库 Shane0315/dsh-session-filter），它在工作区标题行增加入口，在侧栏原会话列表区域切换为跨工作区活动视图，数据来自宿主名册与会话状态 API，不读会话正文。
这是什么¶
dsh-session-filter 由维护者 Shane0315 发布，分类为客户端插件。一句话定位：为 DeepSeek Harness 提供跨工作区的 Activity 侧栏，依据 sessions.list / workspaces.list 与会话状态，汇总需关注、最近活动及可选分组，并支持搜索、本地已读跟踪与经确认的批量归档。插件不修改宿主或其他插件；许可证为 MIT（见仓库 README）。
核心功能¶
入口与切换¶
在工作区标题行显示铃铛图标。点击后，侧栏原有会话列表区域改为活动视图；再次点击、按 Escape，或使用快捷键 ⌘⌥U 可返回原列表。关闭视图或禁用插件时会恢复原列表。
活动分组与数据来源¶
活动按以下方式展示（部分分组默认关闭，可在菜单中打开）：
- 需关注：运行中、等待操作、完成但未读等需跟进的会话。
- 置顶（默认关闭）。
- 定时任务（默认关闭）：通过 DSH
schedule.catalog()的最近实际交付记录及其sessionId展示关联会话并订阅变更；读取失败可重试，不影响其他活动。 - 最近活动：本地日历近七天内，按今天、昨天及星期分组；初始显示 10 条，可按 10 条加载更多。
关闭「需关注」分组时，超过七天但仍需关注的会话会出现在「更早」。归档会话、子会话和空闲空白会话不列出；折叠工作区内的会话仍会出现在列表中。点击条目走 DSH 官方跨工作区导航。
名册来自 sessions.list / workspaces.list；运行、等待操作和完成未读来自 uiSession.sessionStatus。插件不读取会话正文，不外传数据。工作区归属、归档和子会话由宿主名册判断，不通过行图标猜测。
搜索与菜单¶
支持按标题、工作区和路径搜索。
菜单提供：显示选项、恢复默认、全部标为已读、清理已读；对当前「需关注」分组还可发起批量归档——确认框逐项列出范围，运行中或等待操作的会话须明确选择「停止并归档」。
本地已读与限制¶
插件在本机 localStorage 保存已观察到的完成未读和已读确认，重建页面后仍保留待查看结果。批量已读只影响插件视图，不会修改 DSH 原生未读状态；运行或等待操作不会因标记已读而从列表消失。清理已读会移除不再需要关注的快照条目。
插件保留的活动轮次只能依据宿主状态变化和更新时间识别；若应用在完全关闭期间发生多次变化且最终状态与时间完全一致，无法区分这些轮次。DSH 没有 Codex 的 Work/Chat 来源区分；同一会话也可能包含普通对话，DSH 不提供可直接区分独立执行结果会话的合同。
安装与启用¶
推荐从 GitHub Release 安装预构建包，无需在安装时构建：
dsh plugin add https://github.com/Shane0315/dsh-session-filter/releases/latest/download/dsh-session-filter.tgz
也可从源码仓库安装（仓库内含预构建产物）：
dsh plugin add github:Shane0315/dsh-session-filter
桌面端请在插件管理或插件市场选择安装来源；desktop profile 由 Electron 管理，不应在应用运行时强行改写配置。安装后按宿主提示重载。更新可从发布页获取新包并使用宿主的更新功能；收录插件市场不保证与未来宿主版本兼容。
package.json 中声明宿主引擎为 dsh >=0.2.1-rc.2；README 写明本版本已在 DSH Desktop 0.2.1-rc.5 验证。插件通过官方客户端服务注入，并依赖宿主工作区标题和列表容器定位；DSH 界面改版可能需要适配，定位失败时界面会提示。
典型用法¶
- 安装并重载 DSH 后，在工作区标题行找到铃铛，点击进入活动侧栏。
- 在「需关注」中查看运行中、待交互或完成未读的跨工作区会话；用搜索框按标题、工作区或路径过滤。
- 处理完毕后，在菜单中使用「全部标为已读」或「清理已读」整理插件视图（不改变 DSH 原生未读）。
- 需要收尾时，在菜单对「需关注」发起批量归档，按确认框选择范围；对仍在运行或等待操作的会话选择「停止并归档」。
- 若使用定时任务，在显示选项中打开「定时任务」分组，查看
schedule.catalog()关联的最近交付与会话。 - 按
⌘⌥U、Escape 或再次点击铃铛返回原会话列表。
适用场景与注意¶
适合谁：经常在 DSH 中并行多个工作区、依赖后台运行或定时交付、希望在一屏内看到「该点哪里」的开发者。
运行权限：插件以当前 DSH 进程权限运行；安装前应自行查看仓库源码与 MIT 许可证，确认符合你的环境策略。
隐私与同步：已读状态和显示偏好仅存在本机 localStorage，不与 DSH 原生批量已读同步。
生态说明：DeepSeek Harness 采用「一切皆插件」的扩展方式；社区目录页（如 skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系，本文安装方式以 GitHub README 为准。
本地开发（仅供贡献者）：需 Node.js 20+，执行 npm ci 与 npm run check；React 由 DSH 宿主提供，发布包可直接安装，不依赖本地构建。
结尾¶
dsh-session-filter 把跨工作区的运行、待操作与完成未读集中到侧栏活动视图，配合搜索、本地已读和经确认的归档，减少在多工作区间盲找会话的成本。目录与详情可参考 SkillHub 插件页，源码与安装说明见 GitHub：Shane0315/dsh-session-filter。
