dsh-up-session 1.0.3 → 1.0.4

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # 更新日志
 
+## 1.0.4 - 2026-11-07
+
+### 新增
+
+- 置顶区和最近区的会话行可打开宿主会话菜单：右键或键盘菜单键可置顶、重命名、分叉、复制 Session ID、在文件管理器中显示和归档。菜单项与工作区列表中的同一条会话一致。
+
+### 修复
+
+- 将 DSH 最低兼容版本提高到 `0.2.2-alpha.3`，避免旧版 DSH 因缺少会话菜单接口而在安装插件后无法启动。
+
 ## 1.0.3 - 2026-10-26
 
 ### 变更

package/README.en.md

@@ -15,7 +15,9 @@ A simple DeepSeek Harness sidebar plugin: it inserts two groups, "Pinned" and "R
 
 ## Installation and compatibility
 
-The DSH compatibility range is `>=0.2.1-rc.2`, allowing 0.2.1-rc.2, later prereleases of that version, and higher stable versions to install; functionality still needs to be verified against the DSH version in use.
+**Upgrade to DSH 0.2.2-alpha.3 or later. This plugin uses the session menu API introduced in that version.**
+
+Plugin version 1.0.4 requires DSH `>=0.2.2-alpha.3`. Installing it on an earlier DSH version may prevent DSH from starting.
 
 **Web**
 
@@ -29,10 +31,28 @@ Restart DSH after installation. If you use a custom profile, replace `web` with
 
 Open **Plugins** in the sidebar, click **Add plugin**, enter `dsh-up-session`, and click **Enable now** after installation.
 
+### Installing 1.0.3 on older DSH versions
+
+If your DSH version is older than 0.2.2-alpha.3 and falls within plugin version 1.0.3's compatibility range (`>=0.2.1-rc.2`), install `dsh-up-session@1.0.3`.
+
+**Web**
+
+```sh
+dsh plugin --profile web add dsh-up-session@1.0.3
+```
+
+Restart DSH after installation. If you use a custom profile, replace `web` with its name.
+
+**Desktop**
+
+Open **Plugins** in the sidebar, click **Add plugin**, enter `dsh-up-session@1.0.3`, and click **Enable now** after installation.
+
 ## Pinned section
 
 Gathers the pinned sessions of every workspace, newest activity first, and collapses like the host's own sections. Hovering a row reveals its archive and unpin buttons.
 
+Right-clicking a pinned or recent row, or focusing it and pressing the menu key or Shift+F10, opens the same session menu as a row in the workspace list: pin or unpin, rename, fork, copy the Session ID, reveal in the file manager, and archive. The items are the host's own contributions, so they stay in step with the same session further down the list. Rename is prefilled with the session's own title; an untitled session is not prefilled with the "Untitled" label.
+
 Both Pinned and Recent sit at the top of the workspaces list as its first two groups and scroll together with the workspace groups below. While the workspace search is open, they step aside so the list can show the results.
 
 ## Recent section
@@ -43,7 +63,7 @@ Sits between the pinned section and the workspace rows, lists the sessions that
 - once every session is on screen the button reads "Show less",
 - clicking "Show less" folds the list back to the latest five.
 
-Hovering a row reveals its archive and pin buttons. Pinned sessions appear only in the pinned section, so no conversation is listed twice.
+Hovering a row reveals its archive and pin buttons. The context menu is the same as in the pinned section. Pinned sessions appear only in the pinned section, so no conversation is listed twice.
 
 ## Settings
 

package/README.md

@@ -15,7 +15,9 @@
 
 ## 安装与兼容
 
-DSH 兼容版本声明为 `>=0.2.1-rc.2`，允许 0.2.1-rc.2、同版本号下更新的预发布版，以及更高的正式版安装；具体功能仍需与所用 DSH 版本验证。
+**建议升级到 DSH 0.2.2-alpha.3 以上版本，本插件使用该版本提供的会话菜单接口。**
+
+插件 1.0.4 的 DSH 兼容版本为 `>=0.2.2-alpha.3`，在更早的 DSH 版本上安装可能导致 DSH 无法启动。
 
 **Web 端**
 
@@ -29,10 +31,28 @@ dsh plugin --profile web add dsh-up-session
 
 打开侧边栏「插件」，点击「添加插件」，输入 `dsh-up-session`，安装完成后点击「立即启用」。
 
+### 在旧版 DSH 上安装 1.0.3
+
+如果你的 DSH 版本早于 0.2.2-alpha.3，且符合插件 1.0.3 的兼容范围 `>=0.2.1-rc.2`，请指定版本安装 `dsh-up-session@1.0.3`。
+
+**Web 端**
+
+```sh
+dsh plugin --profile web add dsh-up-session@1.0.3
+```
+
+安装后重启 DSH。如果使用自定义 profile，将命令中的 `web` 替换为对应名称。
+
+**桌面端**
+
+打开侧边栏「插件」，点击「添加插件」，输入 `dsh-up-session@1.0.3`，安装完成后点击「立即启用」。
+
 ## 置顶区
 
 汇总所有工作区里被置顶的会话，按最近更新时间排序，可展开收起。每行悬停时出现归档和取消置顶两个按钮。
 
+在置顶区或最近区的会话行上右键，或聚焦该行后按菜单键 / Shift+F10，会打开与工作区列表相同的会话菜单（置顶或取消置顶、重命名、分叉会话、复制 Session ID、在文件管理器中显示、归档）。菜单项由宿主注册，因此和下面工作区里的同一条会话保持一致。重命名对话框预填的是会话自己的标题，未命名会话不会被填成「未命名」。
+
 置顶区和最近区都位于「工作区」列表顶部，是该列表的前两个分组，会和下方的工作区分组一起滚动；使用「工作区」的搜索功能时，两个区暂时隐藏，把列表让给搜索结果。
 
 ## 最近区
@@ -43,7 +63,7 @@ dsh plugin --profile web add dsh-up-session
 - 全部会话都显示完后，按钮变为「收起」；
 - 点击「收起」把列表收回到最新的 5 条。
 
-每行悬停时出现归档和置顶两个按钮。已置顶的会话只出现在置顶区，两区不会重复显示同一个会话。
+每行悬停时出现归档和置顶两个按钮。右键菜单与置顶区相同。已置顶的会话只出现在置顶区，两区不会重复显示同一个会话。
 
 ## 设置
 

package/client.js

@@ -7,8 +7,8 @@ window.__ModuleLoader__.load({
 
     /** Dictionary namespace owned by this plugin. */
     const NS = 'upSession';
-    /** Services required to read pin state, render, and pin, unpin, or archive. */
-    const inject = ['slots', 'locale', 'uiWorkspace'];
+    /** Services required to read pin state, render, pin, unpin, archive, and open the host session menu. */
+    const inject = ['slots', 'locale', 'uiWorkspace', 'contextMenus'];
 
     /** Simplified Chinese dictionary and key source of truth. */
     const zh = {
@@ -204,7 +204,7 @@ window.__ModuleLoader__.load({
       'border:0;text-align:left;width:100%}',
       '.dshUS-row:hover{background:var(--dsw-alias-interactive-bg-hover)}',
       // Matches the sidebar's own selected row (same surface, same label weight).
-      '.dshUS-current{background:var(--dsw-alias-interactive-bg-hover);',
+      '.dshUS-current,.dshUS-menuOpen{background:var(--dsw-alias-interactive-bg-hover);',
       'color:var(--dsw-alias-label-primary)}',
       '.dshUS-row:focus-visible{outline:var(--dsw-focus-ring-width,2px) solid ',
       'var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary,#4d6bfe));outline-offset:-2px}',
@@ -290,7 +290,8 @@ window.__ModuleLoader__.load({
       'color:var(--dsw-alias-label-caption,currentColor)}',
       '.dshUS-row:hover .dshUS-actions,',
       '.dshUS-row:focus-visible .dshUS-actions,',
-      '.dshUS-row:focus-within .dshUS-actions{display:inline-flex}',
+      '.dshUS-row:focus-within .dshUS-actions,',
+      '.dshUS-menuOpen .dshUS-actions{display:inline-flex}',
       '.dshUS-action:hover{color:var(--dsw-alias-label-primary)}',
       '.dshUS-action:focus-visible{outline:var(--dsw-focus-ring-width,2px) solid ',
       'var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary,#4d6bfe));outline-offset:1px}',
@@ -303,7 +304,9 @@ window.__ModuleLoader__.load({
       '.dshUS-row:focus-within .dshUS-time,',
       '.dshUS-row:hover .dshUS-pinMark,',
       '.dshUS-row:focus-visible .dshUS-pinMark,',
-      '.dshUS-row:focus-within .dshUS-pinMark{display:none}',
+      '.dshUS-row:focus-within .dshUS-pinMark,',
+      '.dshUS-menuOpen .dshUS-time,',
+      '.dshUS-menuOpen .dshUS-pinMark{display:none}',
       // A touch surface never hovers, so the actions stay visible there and the
       // time and marker stay hidden with them.
       '@media (hover:none){.dshUS-actions{display:inline-flex}',
@@ -544,6 +547,8 @@ window.__ModuleLoader__.load({
     const NO_STATUSES = new Map();
     /** Stand-in for a host without the status hook, so the sections still render. */
     const useNoSessionStatus = (selector) => selector(NO_STATUSES);
+    /** Used when the host has no context-menu target store; the row still opens the menu. */
+    const useNoContextMenuTarget = () => undefined;
 
     /**
      * The pending-interaction kind the sidebar renders, or undefined for a kind
@@ -917,6 +922,8 @@ window.__ModuleLoader__.load({
       return {
         id: summary.id,
         title: summary.displayTitle || untitled,
+        // The host menu's rename draft is the raw title, not the untitled label.
+        menuTitle: summary.blank ? '' : summary.title?.trim() ?? '',
         workspace: owner?.title ?? '',
         // A known owner names its Workspace; once the list has loaded, a Session
         // no Workspace accounts for sits in the "Ungrouped" bucket (`''`).
@@ -1028,6 +1035,8 @@ window.__ModuleLoader__.load({
         useSessionStatus,
         usePanelInfo,
         settingsEvents,
+        openMenu,
+        useContextMenuTarget,
       } = props;
       const pinnedSessionIds = useWorkspaces((state) => state.pinnedSessionIds);
       const archivedSessionIds = useWorkspaces((state) => state.archivedSessionIds);
@@ -1149,10 +1158,18 @@ window.__ModuleLoader__.load({
           t,
         });
 
+      // The host menu's captured target, so the row that opened it stays marked
+      // after the pointer leaves. Undefined until a session menu is open.
+      const readMenuTarget = useContextMenuTarget ?? useNoContextMenuTarget;
+      const menuSessionId = readMenuTarget(
+        (target) => (target?.kind === 'session' ? target.value.sessionId : undefined),
+      );
       const shared = {
         currentId,
         onOpen: openRow,
         onArchive: raiseArchive,
+        onOpenMenu: openMenu,
+        menuSessionId,
         onOpenSettings: () => setSettingsOpen(true),
         settingsOpen,
         t,
@@ -1240,29 +1257,62 @@ window.__ModuleLoader__.load({
      * keyboard focus. A pinned row keeps the host's own pin marker where the
      * time would end, so a pinned row looks pinned at rest exactly as the
      * sidebar's rows do.
-     * @param props - the row, the current Session id, the open handler, the trailing buttons, the pin marker, and the translator.
+     * @param props - the row, the current Session id, the open handler, the host menu opener, the trailing buttons, the pin marker, and the translator.
      * @returns the row element.
      */
-    function SessionRow({ row, currentId, onOpen, actions, pinned, t }) {
+    function SessionRow({ row, currentId, onOpen, onOpenMenu, menuOpen, actions, pinned, t }) {
       const now = Date.now();
       // A live status is the row's own leading cell, exactly as the sidebar
       // draws it; an idle row draws none, so quiet rows keep the section's left
       // edge instead of the sidebar's deeper indent.
       const statusLabel = row.status === undefined ? undefined : statusText(row.status, t);
+      // Same capture the host's session rows use: right-click, the Context Menu
+      // key, or Shift+F10 open the shared session menu at the pointer or the row.
+      const showMenu = (point, event) => {
+        if (typeof onOpenMenu !== 'function') return;
+        event.preventDefault();
+        event.stopPropagation();
+        if (event.currentTarget instanceof HTMLElement) event.currentTarget.focus({ preventScroll: true });
+        onOpenMenu(row.id, row.menuTitle ?? '', point);
+      };
+      const className = ['dshUS-row', row.id === currentId ? 'dshUS-current' : '', menuOpen ? 'dshUS-menuOpen' : '']
+        .filter(Boolean)
+        .join(' ');
       return h(
         'div',
         {
-          className: row.id === currentId ? 'dshUS-row dshUS-current' : 'dshUS-row',
+          className,
           role: 'button',
           tabIndex: 0,
           'aria-current': row.id === currentId ? 'true' : undefined,
+          'aria-haspopup': 'menu',
           title: row.workspace === '' ? row.title : `${row.title} · ${row.workspace}`,
           'aria-label':
             statusLabel === undefined
               ? t('openNamed', { title: row.title })
               : t('openNamedStatus', { title: row.title, status: statusLabel }),
           onClick: () => onOpen(row),
+          onContextMenu: (event) => {
+            const keyboard = event.clientX === 0 && event.clientY === 0;
+            const rect = keyboard ? event.currentTarget.getBoundingClientRect() : undefined;
+            showMenu(
+              { x: rect?.left ?? event.clientX, y: rect?.bottom ?? event.clientY },
+              event,
+            );
+          },
           onKeyDown: (event) => {
+            if (
+              !event.repeat &&
+              !event.nativeEvent.isComposing &&
+              !event.ctrlKey &&
+              !event.altKey &&
+              !event.metaKey &&
+              (event.key === 'ContextMenu' || (event.key === 'F10' && event.shiftKey))
+            ) {
+              const rect = event.currentTarget.getBoundingClientRect();
+              showMenu({ x: rect.left, y: rect.bottom }, event);
+              return;
+            }
             if (event.key !== 'Enter' && event.key !== ' ') return;
             event.preventDefault();
             onOpen(row);
@@ -1337,6 +1387,8 @@ window.__ModuleLoader__.load({
       onOpen,
       onArchive,
       onUnpin,
+      onOpenMenu,
+      menuSessionId,
       onOpenSettings,
       settingsOpen,
       t,
@@ -1368,6 +1420,8 @@ window.__ModuleLoader__.load({
                   row,
                   currentId,
                   onOpen,
+                  onOpenMenu,
+                  menuOpen: menuSessionId === row.id,
                   t,
                   // Every row here is pinned, so every row wears the marker.
                   pinned: true,
@@ -1399,6 +1453,8 @@ window.__ModuleLoader__.load({
       onOpen,
       onArchive,
       onPin,
+      onOpenMenu,
+      menuSessionId,
       onOpenSettings,
       settingsOpen,
       t,
@@ -1447,6 +1503,8 @@ window.__ModuleLoader__.load({
                   row,
                   currentId,
                   onOpen,
+                  onOpenMenu,
+                  menuOpen: menuSessionId === row.id,
                   t,
                   // No row here is pinned, so no row wears the marker and the
                   // time is the row's trailing cell, flush with its edge.
@@ -1988,6 +2046,18 @@ window.__ModuleLoader__.load({
           }
         },
         stopAndArchive: (sessionId) => ctx.uiWorkspace.archiveSession(sessionId, { stopActivity: true }),
+        // The sidebar's own session menu (pin, rename, fork, copy id, Finder, archive).
+        // Opening it here reuses every contribution registered for target "session".
+        openMenu: (sessionId, displayTitle, point) => {
+          ctx.contextMenus.open(
+            {
+              kind: 'session',
+              value: { sessionId, displayTitle },
+            },
+            point,
+          );
+        },
+        hooks: { contextMenuTarget: ctx.contextMenus.active },
       });
 
       ctx.slots.inject('shell.overlay', () =>

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "dsh-up-session",
-    "description": "Adds pinned and recent groups at the top of the workspace list in the sidebar, gathering pinned and recent sessions, with a settings popup in each group header."
+    "description": "Adds pinned and recent groups at the top of the workspace list in the sidebar, gathering pinned and recent sessions. Rows open the same context menu as the workspace list, and each group header has a settings popup."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "dsh-up-session",
-    "description": "在侧边栏工作区列表顶部增加置顶区和最近区，汇总各工作区的置顶与最近会话，并在标题栏提供设置入口。"
+    "description": "在侧边栏工作区列表顶部增加置顶区和最近区，汇总各工作区的置顶与最近会话；会话行可打开与工作区相同的右键菜单，标题栏提供设置入口。"
   }
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-up-session",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "type": "module",
-  "description": "Adds pinned and recent session groups at the top of the workspace list in the DSH sidebar, with a small settings popup.",
+  "description": "Adds pinned and recent session groups at the top of the workspace list in the DSH sidebar. Rows open the host session menu, and each group header has a settings popup.",
   "license": "MIT",
   "author": "kyrsieger",
   "repository": {
@@ -42,7 +42,7 @@
     "CHANGELOG.md"
   ],
   "engines": {
-    "dsh": ">=0.2.1-rc.2"
+    "dsh": ">=0.2.2-alpha.3"
   },
   "dsh": {
     "bundle": {