前言¶
在 DeepSeek Harness（DSH）里同时维护多条 Web 会话时，常见做法是自己在浏览器里记会话 ID，或依赖会话列表滚动查找。会话一多，想固定几条「常开」的会话、或复制 ID、从列表外快速打开，都没有统一入口。下面介绍社区客户端插件 dsh-plugins-session-favorites（维护者 cypher-yht）：在 DSH Web 侧边栏为会话增加收藏、右键操作菜单和独立的「收藏」面板，数据保存在浏览器本地，不依赖宿主后端。
这是什么¶
会话收藏（Session Favorites） 是标准 DSH bundle 插件，分类为客户端，面向 DSH Web 界面（package.json 中 dsh.client.platform 为 web）。宿主侧 index.js 为空实现，交互集中在 client.js：挂载会话行星标、右键菜单、侧边栏星形入口与收藏列表面板。装完并刷新页面即可生效，无需额外配置文件。
核心功能¶
右键会话操作菜单¶
在侧边栏任意会话行上按下右键（监听 mousedown）会立即弹出菜单，无需等松开。菜单项包括：
- 收藏 / 取消收藏
- 打开会话
- 复制会话 ID（复制成功后该项短暂显示「已复制会话 ID」并自动关闭）
支持 Esc、点击菜单外、窗口尺寸变化时关闭；右键释放时的原生右键菜单会被抑制，避免闪动或重复打开。菜单挂在 shell.overlay（order: 900），按鼠标坐标定位并做视口边界收敛。
会话行内星标¶
在会话行操作区（扩展点 sidebar.workspaces.session.row.action）注册星标按钮，单击即可收藏或取消收藏。
侧边栏「收藏」入口与面板¶
侧边栏图标区（sidebar.panellist）新增星形图标，角标显示收藏数量（超过 99 显示 99+），点击打开收藏面板。面板列出全部收藏会话，展示「运行中 / 空闲」状态；点击条目可打开会话，右侧实心星可移出收藏。会话被归档或删除后仍保留在列表中，并标注「不在当前会话列表中」。空列表与加载中均有对应提示。
本地持久化与中英文案¶
收藏数据写入浏览器 localStorage，键名为 dsh.session-favorites.v1；刷新或重启后仍保留。自动去重、按收藏时间倒序，最多 200 条。隐私模式等无法写入存储时，退化为仅内存保存。文案通过 locale.register 注册 zh / en，随界面语言切换。
打开会话调用 uiWorkspace.openSession(sessionId)；会话已不存在时异常被捕获，不打断界面。
安装与启用¶
在 PowerShell 中执行官方 README 给出的安装命令：
dsh plugin add github:cypher-yht/dsh-plugins-session-favorites
本地开发可使用目录软链：
dsh plugin add link:D:\path\to\session-favorites
安装完成后重启 DSH 宿主；在浏览器中访问 Web 界面时用 Ctrl+F5 硬刷新。
若使用 DSH 桌面客户端（Electron），客户端读取的是 desktop profile，需在桌面端会话里的 plugin_manager 中安装本插件，而不是仅在 Web 环境的插件列表里安装。
典型用法¶
- 快速收藏：在侧边栏目标会话行点击星标，或右键该行选择「收藏」。
- 集中浏览：点击侧边栏星形图标打开收藏面板，按状态查看并点击打开会话。
- 复制会话 ID：右键会话 →「复制会话 ID」，用于脚本、文档或跨环境对照。
- 取消收藏：行内星标再次单击、右键菜单「取消收藏」，或在收藏面板点击右侧实心星。
卸载插件不会清除 localStorage 中的收藏数据（键名带版本 v1）；重新安装后数据仍可被读取，除非用户自行清理站点存储。
适用场景与注意¶
适合：长期在 DSH Web（或已按说明在 desktop profile 安装的桌面端）中维护多条智能体会话，需要固定几条「书签式」会话、减少在默认列表里翻找的开发者和运维人员。
注意：
- 插件以当前 DSH 进程及浏览器同源策略下的权限运行；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。
- 收藏仅存本机浏览器，不跨设备同步；清除站点数据会丢失持久化收藏。
- 社区插件目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；星标与版本信息以仓库为准（当前 README 对应实现版本 1.0.0）。
结尾¶
dsh-plugins-session-favorites 把「收藏会话、打开、复制 ID」收拢到侧边栏交互里，不改动宿主后端，适合作为 DSH「一切皆插件」生态里的轻量客户端扩展。更多信息见 插件目录页 与 GitHub：cypher-yht/dsh-plugins-session-favorites。
