前言¶

在 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 内安装（推荐）¶

1. 打开 DSH，在左侧边栏点击 Plugins
2. 右上角点击 Add plugin
3. 输入 dsh-session-menu 并点击 Install
4. 重启 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 发布）