前言¶
DeepSeek Harness（DSH）在侧边栏里自带工作区与会话浏览：搜索、拖拽排序、上下文菜单都在同一套界面里。当你同时在多个工作区之间切换、又只想盯住某一个工作区里的会话时，默认侧边栏会把所有工作区平铺展示，注意力容易被分散。社区插件 dsh-sidebar-home（维护者 fu-silent，分类：客户端）在侧边栏面板行增加 Home 入口：先选工作区，再进入 Focus mode，侧边栏只展示当前工作区的会话，其余工作区折叠到底部；退出聚焦后，DSH 自带的侧边栏工作区浏览器会原样恢复，不做持久改写。
这是什么¶
dsh-sidebar-home 是面向 DeepSeek Harness 的社区客户端插件（bundle 名 dsh-sidebar-home，当前版本 0.1.0，MIT 许可证）。它通过 DSH 的 Client 扩展点挂载：Host 侧 index.js 为空，浏览器侧仅一个零依赖的 client.js，无构建步骤、无 npm 发行包、运行时无网络请求与遥测。
一句话定位：从侧边栏 Home 挑选工作区，聚焦该工作区的聊天列表，退出后回到 DSH 出厂侧边栏行为。
目录页：SkillHub — fu-silent/dsh-sidebar-home
源码与说明：GitHub — fu-silent/dsh-sidebar-home
核心功能¶
下面介绍 README 中已列出的能力（未在资料中出现的不写入正文）。
Home 入口与布局¶
- 侧边栏面板行出现房屋图标，打开 Home 页：列出各工作区名称、路径、活跃/归档会话数、最近活动时间。
- 处于聚焦时，Home 页显示聚焦横幅并提供退出操作。
- 两种 Home 布局：卡片网格 或 紧凑列表，选择会在会话之间记住。
- Add workspace：通过宿主目录选择器选文件夹，插件注册并进入该工作区。
Focus mode（聚焦模式）¶
聚焦某一工作区后，侧边栏只展示该工作区：
- 按会话标题搜索，并显示匹配数量。
- Needs-attention 标记：Running、Waiting approval、Plan review、Waiting answer，以及未读完成的 Completed。
- 置顶会话优先，带 pin 标记；当前会话始终可见并滚动到视区内；其余通过 show more 展开（默认展示最新 8 条等规则见 README「Limits」）。
- 归档会话开关；归档项在聚焦列表中可见，但须先在出厂浏览器中取消归档才能打开。
- + New session 在聚焦工作区新建聊天。
- 页头 Focus 药丸与 Exit focus 按钮。
其他工作区折叠¶
侧边栏底部 Other workspaces (N) 可折叠：可按工作区展开会话、直接进入某工作区、或通过 View all workspaces 回到 Home 全貌。
窄侧边栏与可逆性¶
侧边栏收窄时，窄轨上保留单个 Home 按钮以重新展开侧边栏。退出聚焦会 dispose 替换用的 slot 注册，出厂工作区浏览器（搜索、拖拽、菜单、视图选项）不受影响。
语言与状态¶
界面与元数据支持英文与简体中文。插件状态保存在浏览器 localStorage 键 dsh-sidebar-home:state:v1（聚焦、Home 布局、归档开关、折叠状态等）。
安装与启用¶
发行物仅来自 GitHub，无 npm 包、无预构建产物；需要已可用的 DSH 安装。README 注明在 DSH Desktop 0.2.1-rc.5（macOS） 上测试通过。package.json 声明：
"engines": { "dsh": ">=0.2.1-rc.5 <0.3.0-0" }
不匹配的主机会拒绝安装/激活；Windows 与 Linux 未在资料中验证。
DSH Desktop（推荐）¶
- 打开 DeepSeek Harness Desktop，进入 Plugins 页。
- 选择 Add plugin，填写 checkout 的绝对路径，或 git 地址
github:fu-silent/dsh-sidebar-home。 - 安装并选 Enable now，然后重载页面（
Cmd+R/Ctrl+R）。侧边栏面板行应出现 Home 图标。
若重载后仍无图标，完全退出并重新打开应用一次，以便 DSH 加载新的 client 模块。
获取源码时，README 给出的方式是：
git clone https://github.com/fu-silent/dsh-sidebar-home.git
再将上述目录路径用于 Desktop 的 Add plugin。
本地 dsh web（可选 CLI）¶
desktop profile 由 Desktop 应用保留，请用 Plugins 页管理，不要用 CLI 改 desktop。
对本地 dsh web profile：
dsh plugin --profile web add /absolute/path/to/dsh-sidebar-home
然后重启 dsh web 并重载页面。路径需指向插件目录的绝对路径。
通过 Agent 安装¶
具备 DSH 插件管理权限的 Agent 可对 plugin_manager 调用 action: "install_bundle"，target 为 /absolute/path/to/dsh-sidebar-home（也接受 git URL）；profile 变更需审批后重载页面。移除时使用 remove_bundle，target 为 dsh-sidebar-home。
更新与卸载¶
更新采用 移除再添加：DSH 每次安装会加载新的 client 模块代际。在 Plugins 页移除 bundle，拉取新 checkout，再按路径添加并重载（若仍显示旧模块，完全重启应用）。
卸载会去掉 Home 入口与相关注册，侧边栏恢复出厂浏览器；工作区与会话数据不被插件改动。若需清除插件本地偏好，删除 localStorage 中的 dsh-sidebar-home:state:v1。
典型用法¶
- 安装并启用后，点击侧边栏面板行的 Home（房屋图标）。
- 在 Home 页浏览工作区列表（可切换卡片/列表布局），点击某一工作区进入聚焦；或使用 Add workspace 注册新目录并进入。
- 聚焦期间在侧边栏搜索会话标题、处理带 attention 标记的会话、置顶项、新建会话；需要全局出厂能力（重命名、pin、归档、fork、消息级搜索、拖拽排序、其他插件注入的行内控件等）时，点击 Exit focus。
- 底部 Other workspaces 可快速切到其他工作区而不必先回 Home；View all workspaces 返回 Home 总览。
- Home 进入工作区时打开该工作区的空白会话；聚焦期间若主面板可见会话变化，插件会自动跟随该会话（资料中的唯一自动规则）。
聚焦模式的限制¶
Focus mode 会替换出厂的 sidebar.workspaces slot，因此在退出前以下能力不可用：会话/工作区上下文菜单、拖拽排序、视图/排序/筛选、全局内容搜索（聚焦内搜索仅过滤会话标题）、以及其他插件注入出厂浏览器行的控件。退出后全部恢复。聚焦列表不会重排或写入原生工作区/会话状态。
实现要点（供排查用）¶
| 扩展点 | 用途 |
|---|---|
sidebar.panellist |
列表项 sidebar-home，order -10，Home 图标 |
main |
keyed panel sidebar-home，Home 页 |
sidebar.workspaces |
聚焦时单槽替换，负优先级；退出即 dispose |
数据来自标准 slot props（useWorkspaces、useSessions 等），不扫描 DOM、不写 Host 文件。硬依赖仅为 slots；locale、layout 等通过嵌套 ctx.inject 可选注入，缺失时插件保持惰性而非拖垮 Web 启动。
适用场景与注意¶
适合：在 DSH Desktop 或 dsh web 上管理多个工作区、希望侧边栏临时「只看我正在做的那个 workspace」的开发者；需要 Home 总览会话规模与最近活动时再展开全貌。
注意：
- 社区独立项目，与 DeepSeek / 幻方无从属关系；DSH 仍为 prerelease，插件扩展 Client slot，使用前请阅读 README 的 Compatibility 与 failure modes。
- 插件以当前 DSH 进程/浏览器上下文运行；安装前请自行查看 源码仓库 与 MIT 许可证。
- 0.2.1-rc.4 及更早、0.3.x 及更新在声明范围内不被支持；刻意豁免版本属于自担风险。
- SkillHub 目录为社区站点，不是官方应用商店。
结尾¶
dsh-sidebar-home 用 Home 面板选工作区、用 Focus mode 收窄侧边栏会话视图，并在退出时完整归还 DSH 自带侧边栏——适合多工作区并行、又需要阶段性「单工作区专注」的场景。
- 目录页：https://www.skillhub.cn/plugins/fu-silent/dsh-sidebar-home
- GitHub：https://github.com/fu-silent/dsh-sidebar-home
