会话看板 yiliang114/dsh-session-deck

DSH Session Deck — DeepSeek Harness 会话管理插件

English · npm · 最新发布 · 发布 CI

受 Codex 活动视图启发的 DeepSeek Harness 会话管理插件。 Session Deck 在 DSH 原生侧栏中加入 Activity 和 Favorites 视图，跨工作区查看运行中、等待回复和未读会话，快速处理需要你关注的任务，并随时回到重要对话。

活动视图的交互受到 Codex 启发，并结合 DSH 的工作区、会话状态和原生置顶会话做了适配。Session Deck 是独立的 DSH 社区插件。

社区维护的第三方插件，默认英文界面，无额外 npm 依赖、无遥测，采用 MIT 许可证。

三种视图，一个侧栏

| 视图 | 用途 |
| Activity（活动） | 跨工作区查看运行中、等待回复、未读和最近会话。 |
| Favorites（收藏） | 汇总 DSH 原生置顶会话，随时回到重要任务。 |
| Workspaces（工作区） | 使用原生工作区树、管理功能及其他插件提供的菜单。 |

切换视图不会离开当前对话。会话行显示标题、工作区、时间和状态，菜单提供收藏、重命名、分叉、归档和复制 ID 等操作。

通过 More（更多）→ Show archived（显示归档） 查看所有工作区的归档会话。支持按标题、工作区、路径或会话 ID 搜索，点击条目右侧的 Restore（恢复） 按钮才会恢复并打开原会话；点击标题或行本身不会恢复。恢复会保留原工作区位置，不会重启已停止的任务或重新置顶。恢复失败时弹窗会显示错误，便于重试。

当你在别处查看时，会话完成会播放一组短促的双音提示，并把结果标记为未读。每个导航标签右上角分别显示小蓝点：Workspaces 和 Activity 对应全部未读会话，Favorites 仅对应收藏中的未读会话，选中哪个标签不会清除其他标签的提示。工作区分组标题保留各自的未读蓝点。浏览器标签页也会在 favicon 右上角加蓝点，并在标题前显示 (N)，查看相应会话后自动更新。页面隐藏或窗口失焦且浏览器已授权通知时，同时发送一条静音系统通知；点击通知可回到对应会话。打开某个会话只清除该会话，最后一个未读成员被查看后对应蓝点才消失；展开/折叠分组或切换视图都不会把整组标成已读。

截图来自本地 DSH 安装的英文界面；会话标题和工作区名称已匿名化。

| Activity | Favorites | Workspaces |
| 掌握运行状态和未读结果。 | 回到原生置顶的重要会话。 | 保留完整的工作区操作。 |
| 英文 Activity 视图 | 英文 Favorites 视图 | 英文原生 Workspaces 视图 |

截图展示无需宿主补丁、自动位于全局面板下方和工作区区域上方的切换条。界面及匿名化后的会话标题使用英文；不包含浏览器顶部菜单、标签栏和地址栏。

从 npm 安装

从 npm 安装最新发布版本。作为历史验证记录，首次发布的 0.1.2 tarball 已在隔离环境中安装，SHA512 完整性校验通过，宿主入口、客户端和补丁文件均已与源码核对；这不代表后续版本已经完成相同验证。

环境要求：

- Node.js 22 或以上。
- DSH Web GUI 0.2.1-rc.2，这是当前精确适配的宿主版本，其他版本未经验证。
- 已启用 DSH 原生侧栏、会话和工作区插件。

安装前先检查命令行版本，并使用当前 Web GUI 对应的 profile：

node --version
dsh --version

预期 Node.js 为 v22 或以上，DSH 为 0.2.1-rc.2。以下步骤以已经可以正常打开的 DSH Web GUI 为前提；如果找不到 dsh 命令，请先安装并启动受支持的 DSH 宿主。如果启动 DSH 时使用了自定义 DSH_HOME，执行插件命令时也要使用相同的值。

从旧安装迁移：在通过 npm 安装前，请先在 DSH 插件管理中停用并移除旧插件实例，避免两个实例同时接管侧栏；浏览器存储可以保留。

dsh plugin --profile web add @yiliang114/dsh-session-deck@latest --ignore-scripts

使用其他 profile 时替换 web。刷新现有 DSH GUI，然后在全局面板下方、工作区区域上方选择 Workspaces / Activity / Favorites。在支持的 DSH 0.2.1-rc.2 布局中，插件会自动将切换条放到该位置，无需修改已安装的 DSH 文件。Workspaces 保留原生工作区浏览器。修改客户端后也需要刷新，不应假定热更新已启用。

插件自身文案使用英文。要让 DSH 其他界面也显示英文，在 更多 → 设置 → 通用设置 → 语言 中选择 English。会话标题仍保留用户原来使用的语言。

首次使用检查（约两分钟）

1. 完成或关闭 DSH 的首次使用对话框。在 插件 中确认 @yiliang114/dsh-session-deck 已安装并启用，然后刷新页面。
2. 选择 Activity，打开一个至少开始过一轮任务的已有会话。新建空会话即使已置顶也会被隐藏，因此全新 profile 中显示空列表是正常的。
3. 将鼠标移到该会话上，打开操作菜单，选择 Add to favorites (pin)。它应出现在 Favorites，并在 Workspaces 中显示原生置顶标记。
4. 在三个视图间切换，当前对话应保持打开；再次刷新页面，Favorites 中仍应保留该置顶会话。

如果看不到切换条，请检查插件是否装在当前 Web GUI 的 profile 和 DSH_HOME 下、是否已启用，以及宿主版本是否匹配。原生侧栏、会话和工作区插件也需要启用。同时检查侧栏底部：无法识别支持的工作区边界时，切换条会回退到那里。详见兼容性。

2026-10-25，0.1.8 版本在 DSH 0.2.1-rc.2、Node 22.20.0 的隔离 profile 中通过了安装、导航、收藏、归档恢复、GUI 卸载及重装检查。会话检查使用本地合成记录，没有调用模型；这不代表已经验证真实模型状态变化、系统通知投递或物理音频输出，也不代表后续版本完成了相同验收。

备选：链接本地仓库

git clone https://github.com/yiliang114/dsh-session-deck.git
cd dsh-session-deck
npm run verify
dsh plugin --profile web add "link:$PWD" --offline --ignore-scripts

项目没有需要安装的依赖，仓库已包含客户端文件；build 仅检查 JavaScript 语法，不生成客户端。链接安装期间请保留仓库目录。

也可以通过 Plugins → Add plugin → Install a third-party plugin 安装：输入 link:/absolute/path/to/dsh-session-deck，点击 Install，然后 Enable now，最后刷新页面。

备选：使用 tarball 安装

不经过 npm 注册表分发时，在仓库根目录执行：

npm run verify
npm pack --ignore-scripts

将生成的归档文件复制到目标机器，再用绝对路径安装。将 VERSION 替换为 npm pack 输出文件名中的版本号：

dsh plugin --profile web add /absolute/path/yiliang114-dsh-session-deck-VERSION.tgz --ignore-scripts

安装后刷新 GUI。tarball 安装不依赖原仓库目录持续存在。链接和 tarball 两种安装方式都会在支持的 rc.2 布局中自动将切换条放到工作区区域上方，无需宿主补丁。

自定义插件市场

市场索引列出已通过注册表验证的 npm 发布版本。在 DSH 自定义插件市场中添加以下原始 JSON 地址作为索引源：

https://raw.githubusercontent.com/yiliang114/dsh-session-deck/main/market-index.json

这是用户自行添加的自定义市场源，并非 DSH 官方收录。发布 npm 不会自动将插件加入官方 DSH 市场。

维护者：推送到 main 会自动排队发布补丁版本（例如 0.1.2 → 0.1.3）。连续快速推送可能合并处理：过时的排队任务跳过，最新可执行任务包含累计改动。需要手动选择次版本时，执行 npm version minor --no-git-tag-version，再正常提交并推送；显式指定的更高稳定版本（例如 0.2.0）会保留，下一次发布为 0.2.1。工作流负责验证、版本提交和标签、带 provenance 的发布、市场索引更新和 GitHub Release。认证前提与失败恢复请参阅发布指南（英文）。

会话状态与边界

- Activity 保留全部运行中、等待回复和未读会话，以及最多 20 条普通最近会话，按 DSH 的 updatedAt 排序，而非最后打开时间。Favorites 不受 20 条限制。
- 收藏直接使用 DSH 原生置顶数据，与工作区树同步。Activity 和 Favorites 不单独显示归档、子代理和空白会话；普通分叉正常显示。Show archived（显示归档） 列出全部已知归档会话，包括已归档的空白会话和子代理，不受 20 条限制。
- 状态优先级为等待回复 → 运行中 → 未读。已知子代理后代仍在运行时，父会话保持运行状态；普通分叉不会向来源会话传播状态。
- 仅聚合 DSH 会话目录中已知的子代理后代。独立后台 shell 作业不在跟踪范围内，会话空闲不代表它启动的所有进程均已退出。
- 会话及已知后代全部停止时，如果你正在查看其他会话，它会标记为未读；打开即清除；开始新一轮运行也会清除上一轮结果的未读标记。从原生 Workspaces 列表进入会话时，已读确认不等待完成状态观察的排队锁。持久化记录可恢复刷新期间发生的完成状态，但无法补全所有页面关闭期间完整开始并结束、或从未观察到的运行。
- 每次实际观察到的完成最多播放一次插件提示音，并在后台且已授权时附加一条静音系统通知；刷新、恢复历史未读和仅子代理结束都不会补发提示，但下一轮完整运行仍会产生新提示。等待用户交互不算完成。通过 Session Deck 归档引起的停止会被抑制；原生或外部归档若先收到停止状态、后收到归档成员更新，仍可能被识别为手动停止。同源标签页在支持 Web Locks 时串行执行完成状态观察和提醒投递；共享存储不可用或不支持锁时仅尽力去重，不承诺严格一次。
- 每次本页观察到新的归档成员变化时，会清除会话已知的旧运行/未读基线，即使它暂时不在目录中。未变化的归档成员快照不会反复清除后来出现的共享记录，因为它们可能来自其他标签页的新活动；这些已处理记录随后参与正常的有界清理。仅凭目录缺失不会删除未读数据。恢复空闲会话不会补报旧的完成。如果恢复后的首个快照仍显示运行中，会保守地等待一次新的“空闲→运行”变化，因此恢复时已经启动的运行可能结束而不提醒。页面从未观察到的归档/恢复过程无法推断。
- 打开 Activity/Favorites 会话失败时会显示错误对话框，保留未读状态；关闭对话框后可重新点击会话或菜单重试。Open in workspace for all actions 仅在打开成功后切换视图。
- 提示音保持中性，不宣称成功：当前客户端状态无法区分正常完成、失败和手动停止。声音在本地合成，默认开启。可在自己使用的浏览器点击 More → Enable and test sound（开启并试听提示音），启用声音并通过用户手势试听；结果只确认播放已启动，不代表扬声器实际可闻。前后台都由插件播放提示音，系统通知设为静音，避免重复发声。浏览器自动播放限制可能要求先点击页面或按键。系统通知仅在浏览器站点设置中已授权时发送；插件不请求外部推送权限，也不跟踪单条聊天消息。
- Workspaces、Activity 和浏览器标签页反映所有符合条件的未读会话（不是聊天消息条数），Favorites 只反映其中已收藏的会话；页面标题显示完整数量。工作区蓝点按完整的工作区成员关系汇总同一批会话，不依赖当前渲染或截断的会话行。平面和树状视图都只统计直接成员；折叠的树状祖先不会汇总后代未读。页面隐藏或当前打开其他全局面板时，不算已查看会话。
- 归档活动会话需要确认 Stop and archive（停止并归档）。插件不提供永久删除；其他插件贡献的完整原生菜单请切回 Workspaces 使用。

DSH 兼容性与切换条位置

插件的 engines.dsh 精确声明支持 0.2.1-rc.2。自动顶部定位使用针对该版本的 DOM 兼容适配层，并非 DSH 官方扩展 API。

| DSH 侧栏 | 定位方式 | Session Deck 支持情况 |
| 官方 0.2.1-rc.2，未打补丁 | 没有官方 sidebar.workspaces.before 槽位；适配层默认将切换条放到工作区区域上方。 | 当前支持目标，严格检查 rc.2 DOM 结构。 |
| 0.2.1-rc.2 加旧版本地补丁 | 复用全局面板下方已有的 sidebar.workspaces.before 槽位。 | 兼容，但已不再需要补丁。 |
| 官方 0.2.1-rc.3 | 已发布的客户端及槽位声明中仍没有 before 槽位。 | 不支持：整体兼容性未经验证，精确版本声明不包含它。 |

识别到 rc.2 布局时，适配层在工作区区域紧前方、Automation tasks 等全局面板下方插入自己的 DOM 容器，通过 React portal 渲染切换条。它不会写入已安装的 DSH 文件，也不会替换原生工作区浏览器。遇到未知 DOM 布局时回退到底部。停用插件会移除其限定范围的观察器和 DOM 容器。

rc.2 的 More 菜单同样没有菜单项扩展槽位。Session Deck 仅在原生账号按钮和菜单结构匹配该版本时，通过自己的 portal 容器在 Settings 下方插入入口。原生设置、反馈、账号操作和键盘导航保持可用；未知或存在歧义的布局会回退为底部的 Show archived 按钮。停用插件会清理菜单容器及观察器。

工作区分组标题也没有装饰槽位。未读蓝点由一个严格识别原生项目行及其真实 workspace:<id> 键的适配器添加；它只拥有自己的 6px 标记，会清理退出动画副本里的标记，不使用标题或路径识别分组。未知布局不会改动原生树，Activity、提示音和会话跳转仍然可用。常驻的完成观察器使用官方 shell.overlay 槽位。

rc.3 发布文件检查于 2026-10-23，该检查不能证明插件兼容。支持其他宿主版本时，需要先验证会话、工作区、槽位、UI 接口及 DOM 布局，再扩大 engines.dsh 的版本范围。

旧版侧栏补丁回滚

侧栏补丁脚本保留用于回滚和向后兼容，新安装无需执行。如果之前安装过本地 before 槽位补丁，插件可以继续复用该槽位，也可以恢复原侧栏。

找到当前运行的 DSH 实际加载的 @deepseek-ai/dsh-client-ui-sidebar 包目录，在本仓库中执行以下命令。占位路径应替换为该侧栏包目录，而非 DSH 根目录或本插件目录：

node scripts/patch-sidebar-before.mjs /path/to/dsh-client-ui-sidebar --rollback

恢复依赖原始的相邻 .dsa-before.backup 备份，并会拒绝覆盖无关改动。回滚后刷新 GUI：在支持的未打补丁 rc.2 布局中，新插件仍会将切换条放到工作区区域上方。如果回滚的是 DSH 源码仓库，还需重新构建相关客户端产物。

隐私与本地存储

插件使用 DSH 的会话和工作区 API，不发起模型调用、不发送遥测、没有外部上传端点。

为兼容早期版本，浏览器 localStorage 沿用以下键：

| 键 | 内容 |
| dsh-session-activity.mode.v1 | 当前视图。 |
| dsh-session-activity.pending.v1 | 会话 ID、观察到的运行状态和完成未读元数据。 |
| dsh-session-activity.notified.v1 | 每个会话最近一次已投递通知的版本，用于避免同源标签页重复提醒。 |
| dsh-session-activity.sound.v1 | 完成提示音是否开启。 |

插件不在其中保存会话正文。收藏仍使用 DSH 原生置顶数据。视图和未读状态在同源标签页间同步，不跨设备同步；存储不可用时仅保留在内存中。清除浏览器存储会重置这些元数据。已处理记录最多保留 1,000 条，运行中和未读记录不受此清理上限影响。

停用或卸载

进入 插件 → @yiliang114/dsh-session-deck。关闭启用开关即可停用；点击 卸载 并确认则移除安装包。随后刷新 GUI：原生工作区树应保留，Activity、Favorites 以及插件添加到 更多 菜单中的条目应消失。停用也会移除适配层的观察器和 DOM 容器。

会话和原生置顶数据会保留。卸载不会清除上表中的浏览器元数据，也不会撤销旧版宿主补丁；如需撤销，请单独执行恢复命令。

如需使用命令行，请使用当前 Web GUI 对应的 profile 和 DSH_HOME：

dsh plugin --profile web remove @yiliang114/dsh-session-deck

命令行卸载后，请重启对应的 DSH Web 实例，再刷新页面。在 rc.2 验收中，命令行移除安装包后，运行中的宿主仍保留插件，直到重启才卸载运行时；GUI 卸载则立即生效。不要给 remove 添加 --ignore-scripts：宿主附带的 pnpm 不支持在移除命令中使用该参数。

开发

npm run verify

该命令依次执行语法检查、会话筛选与状态逻辑的 Node.js 测试，以及打包清单 dry-run 检查。CI 使用 Node.js 22 和 24。没有独立 lint 或 TypeScript 检查；自动检查不能替代真实 DSH GUI 验证。

客户端位于 lib/client.js，另有最小宿主入口和 Cordis 配置。反馈问题时，请在 GitHub Issues 中提供 DSH 版本、安装方式和复现步骤。

许可证

MIT。本项目独立维护，不属于 DSH 官方内置组件。