前言¶
在 DeepSeek Harness（DSH）里，侧边栏会列出大量会话。内核自带的交互往往只覆盖打开、归档等基础操作；当你需要标记未读、复制会话信息、在 Finder 里定位会话目录，或用本机 IDE 打开对应工作区时，通常要自己在文件系统或终端里找路径。
dsh-session-menu 是社区维护的客户端插件，在侧边栏会话的上下文菜单里补齐上述能力，并在列表行上增加状态点与悬停卡片。下面介绍它的定位、功能、安装方式与配置要点。
这是什么¶
- 名称：
dsh-session-menu（npm 包名与插件标识一致） - 维护者：big-head-pigeon
- 分类：客户端（
dsh.client，平台为 web，安装后即时生效） - 许可证：MIT
- 环境要求：README 标明 DSH 0.2.0-rc.2+；包依赖
@deepseek-ai/cordis等，与当前 DSH 内核版本需匹配
插件一句话定位：为 DSH 侧边栏会话提供上下文菜单（标记未读、复制信息、在文件管理器中显示、用指定应用打开、永久删除等），并附带状态点、悬停详情，以及对已归档行的一键删除与批量删除入口。
核心功能¶
以下能力均来自项目 README 与 package.json 描述，安装后在侧边栏会话菜单与列表行上可见。
上下文菜单¶
- Mark as unread：将会话标为未读
- Copy：复制会话相关信息（子项可在设置里逐项开关；若内核已自带「Copy Session ID」，插件中同名子项会默认关闭以避免重复）
- Show in file manager：在 Finder（macOS 文件管理器）中显示会话位置
- Open with：用配置好的编辑器或终端等应用打开
- Delete session：永久删除会话（有确认流程，README 配图中有删除确认界面）
列表与归档¶
- Status dots：在会话行上显示状态点，便于扫一眼区分状态
- Hover card：悬停时展示更多会话详情
- 已归档行：支持一行内一键删除，并提供批量删除已归档会话的入口（设置里对应「Delete all archived sessions」）
设置页开关¶
安装后，在 Settings → Plugins → Installed 可看到插件；并在设置中增加 Session menu 区块，共 8 个开关：
Mark as unread · Copy · Show in file manager · Open with · Delete session · Delete all archived sessions · Status dots · Hover card
关闭某一开关后，对应菜单项与列表上的展示会立即隐藏，无需重启。 Copy 与 Open with 旁有三角可展开，对每个子项单独开关；父项关闭时子项会灰显。若你使用的社区构建已内置部分相同功能，可在该页面关掉重复项。
安装与启用¶
三种方式均从 npm 安装 dsh-session-menu 包。任选一种后，需要重启 DSH 应用（设置内开关除外）。
方式一：在 DSH 内安装（推荐）¶
- 打开 DSH，在左侧边栏点击 Plugins
- 右上角点击 Add plugin
- 输入
dsh-session-menu并点击 Install - 重启 DSH
方式二：让 Agent 安装¶
在 DSH 内把下面这段话发给 Agent：
Install the plugin dsh-session-menu with the plugin manager, then remind me to restart DSH.
方式三：终端¶
在 macOS 终端中执行（将 desktop 换成你的 profile 名；可用 ls ~/.dsh/profiles 查看，常见为 desktop 与 web）：
dsh plugin --profile desktop add dsh-session-menu
执行后重启 DSH。
典型用法与配置¶
卸载¶
Settings → Plugins → Installed，在 dsh-session-menu 一行点击垃圾桶图标并确认。
配置「Open with」应用¶
Open with 子菜单中的应用列表可在 profile 的 cordis.patch.yml 里配置。在 config 下增加 applications 块，例如：
config:
applications:
- kind: editor
paths:
- /Applications/Visual Studio Code.app
- kind: terminal
paths:
- /System/Applications/Utilities/Terminal.app
每条配置会取 paths 中第一个存在的路径，只有匹配到的项会出现在菜单里。注意：config 会整体替换应用列表，而不是追加；修改后需重启 DSH。
README 中的界面截图（会话菜单、状态点、悬停卡片、归档批量删除、删除确认、插件列表与 Session menu 设置）可在 GitHub 仓库 UI 一节对照查看。
适用场景与注意¶
适合谁：经常在 DSH 侧边栏管理大量会话、需要在本机 Finder / IDE / 终端与会话目录之间来回切换的开发者；需要快速复制会话信息或清理已归档会话的用户。
权限与安全：插件以当前 DSH 进程权限运行，删除会话等操作不可轻易撤销。安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，确认行为符合你的环境策略。
平台说明：文档中的「Reveal in Finder」与终端安装示例面向 macOS；其他系统上「在文件管理器中显示」等行为取决于 DSH 与插件在当前平台的实现，以实际菜单为准。
生态说明：DSH 采用「一切皆插件」的思路；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-session-menu 把侧边栏会话从「只能点开」扩展到可标记、可复制、可定位目录、可用本机工具打开，并支持永久删除与归档清理，同时用状态点与悬停卡片减轻扫列表的成本。若你已在用 DSH 0.2.0-rc.2 及以上版本，可按上文三种方式安装并在设置里按需开关各项功能。
- 目录页：https://www.skillhub.cn/plugins/big-head-pigeon/dsh-session-menu
- GitHub：https://github.com/big-head-pigeon/dsh-session-menu
- npm：
dsh-session-menu（README 当前版本徽章对应 npm 发布）
