前言¶
在 DeepSeek Harness（DSH）里同时开多个工作区会话时，默认侧边栏往往只显示标题或简单列表，很难一眼区分项目、哪些在跑任务、哪些该收起来。社区插件 dsh-sidebar-shelves 把每个会话收成两行卡片，并补上工作区图标、置顶、归档、状态与任务计数，以及按最近输入排序。下面介绍它做什么、怎么装、用的时候要注意什么。
这是什么¶
dsh-sidebar-shelves 是面向 DSH Web 客户端的插件，维护者为 YL404（package.json 中作者为 Han）。它替换并增强侧边栏里的工作区/会话列表展示：每个会话一张两行卡片，并在对话标题前显示当前工作区图标。插件声明依赖 DeepSeek Harness >=0.2.1-rc.5 <0.3.0，客户端目标平台为 web（见 engines.dsh 与 dsh.client.platform）。
核心功能¶
以下能力均来自项目 README 与 package.json 说明。
项目图标（Project tiles）¶
每个 Workspace 对应一块图标：默认按名称生成字母块与配色；也可自选 emoji、颜色或方形图片，并支持 Icon Composer 的 .icon 包。图标文件通过 Host 的 workspace-files 远程从当前工作区读取，插件本身不发起网络请求。
置顶与归档¶
置顶会话排在列表最前，置顶与归档相互独立。可手动归档，或在设置里选择 3、7、14、30 天后自动归档；已归档会话进入底部「已归档」区域。
右键菜单与快捷键¶
在会话卡片上右键可：置顶、重命名、分叉、复制 Session ID、归档。键盘可用 Shift+F10 打开同一菜单。
状态与活动计数¶
卡片上显示运行中、等待中等状态标记；若会话带有终端，会显示终端标记。每个会话还会展示运行中的后台任务与子代理数量，数据由 Host 端从该会话的任务记录折叠汇总（Session projection），而非插件自行统计。
排序与界面一致性¶
列表按「最近输入」排序，最新输入的会话靠前。Composer 里工作区菜单复用同一套图标与同一顺序。当前打开的会话，其工作区图标会出现在对话标题紧前方（占用 conversation.header.leading 等扩展位）。
状态存放位置¶
| 状态 | 位置 |
|---|---|
| 设置（图标样式、自动归档天数） | 浏览器 localStorage dsh:sidebar-shelves:settings |
| 置顶 | dsh:sidebar-shelves:pinned |
| 图标选择 | dsh:sidebar-shelves:icons |
| 任务计数 | Host 端 Session 投影，由 job 事件重建 |
插件不上报遥测；安装前若关心权限与隐私，可对照上述存储方式与「仅读工作区文件、不联网」的说明审阅源码（MIT 许可证）。
安装与启用¶
CLI 安装（资料原文命令，需使用 desktop profile）：
dsh plugin --profile desktop add dsh-sidebar-shelves
图形界面：插件 → 安装，输入 dsh-sidebar-shelves 并确认。若安装后列表中没有该插件行，重启应用后再看。
卸载：
dsh plugin --profile desktop remove dsh-sidebar-shelves
或在 Plugins 界面移除对应 bundle。
典型用法¶
安装并重启（如需要）后，侧边栏会以两行卡片展示各会话。常见操作可按下面顺序熟悉：
- 浏览列表：置顶项在最前，其余按最近输入排序；底部查看「已归档」。
- 右键某张卡片（或 Shift+F10）进行置顶、重命名、分叉、复制 Session ID 或归档。
- 在插件设置中调整图标样式（字母块 / emoji / 颜色 / 图片或
.icon）以及自动归档天数（3 / 7 / 14 / 30 天）。 - 打开某个会话后，在对话标题前确认工作区图标是否与侧边栏一致；在输入框的工作区菜单中，图标与顺序应与侧边栏一致。
无单独「示例仓库」或脚本；行为以 Harness 桌面/Web 客户端中的侧边栏与对话头为准。
适用场景与注意¶
适合谁： 经常在 DSH 里切换多个工作区、需要一眼区分项目、管理长期会话列表、或关心后台 job/subagent 数量的开发者。
兼容性： 插件注册 sidebar.workspaces、conversation.hero.workspace、conversation.header.leading 三个扩展位。若有其他插件以更高优先级占用同槽位，后者会覆盖本插件；此时应卸载 dsh-sidebar-shelves 或调整插件优先级，避免界面行为不一致。
安全与信任： 插件以当前 DSH 进程权限运行；它不联网、不上报，但会读写浏览器 localStorage，并通过 Host 读取工作区内的图标文件。安装前建议查看 GitHub 仓库 源码与 MIT 许可证，再决定是否启用。
结尾¶
dsh-sidebar-shelves 把 DSH 侧边栏收成带图标、置顶、归档与任务信息的会话卡片，并与 Composer 工作区菜单、对话标题区对齐展示。社区目录页（与 DeepSeek / 幻方无官方从属关系）见 SkillHub 插件页；源码与完整说明见 GitHub：YL404/dsh-sidebar-shelves。
