dsh-up-session 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 更新日志
 
+## 1.0.3 - 2026-10-26
+
+### 变更
+
+- 置顶区和最近区并入「工作区」列表顶部，成为工作区列表的前两个分组，随列表一起滚动；使用工作区搜索时暂时让位给搜索结果。
+
+## 1.0.2 - 2026-10-26
+
+### 修复
+
+- DSH 兼容版本改为 `>=0.2.1-rc.2`。
+
 ## 1.0.1 - 2026-10-24
 
 ### 修复

package/README.en.md

@@ -6,16 +6,16 @@
 
 [简体中文](./README.md) | English
 
-A simple DeepSeek Harness sidebar plugin: it inserts two sections, "Pinned" and "Recent", above the "Workspaces" list, gathering pinned sessions from all workspaces into one place and collecting your latest sessions into another.
+A simple DeepSeek Harness sidebar plugin: it inserts two groups, "Pinned" and "Recent", at the top of the "Workspaces" list, gathering pinned sessions from all workspaces into one place and collecting your latest sessions into another.
 
 <p align="center">
-  <img src="./assets/screenshot.png" width="32%" alt="The sidebar showing the Pinned and Recent sections above the Workspaces list">
+  <img src="./assets/screenshot.png" width="32%" alt="The sidebar showing the Pinned and Recent groups at the top of the Workspaces list">
   <img src="./assets/settings.png" width="64%" alt="The plugin settings popup with toggles for Show Pinned, Show Recent, and Reveal the session in its workspace">
 </p>
 
 ## Installation and compatibility
 
-The DSH compatibility range is `>=0.2.1-rc.3`, allowing RC.3 and later versions to install; functionality still needs to be verified against the DSH version in use.
+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.
 
 **Web**
 
@@ -33,9 +33,11 @@ Open **Plugins** in the sidebar, click **Add plugin**, enter `dsh-up-session`, a
 
 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.
 
+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
 
-Sits between the pinned section and the workspaces, lists the sessions that are not pinned, newest activity first, and shows the latest five by default. It looks and collapses exactly like the pinned section. Once there are more than five sessions, a "Show more" button appears at the bottom of the list:
+Sits between the pinned section and the workspace rows, lists the sessions that are not pinned, newest activity first, and shows the latest five by default. It looks and collapses exactly like the pinned section. Once there are more than five sessions, a "Show more" button appears at the bottom of the list:
 
 - each click reveals five more sessions,
 - once every session is on screen the button reads "Show less",

package/README.md

@@ -6,16 +6,16 @@
 
 简体中文 | [English](./README.en.md)
 
-一个简单的 DeepSeek Harness 侧边栏插件：在「工作区」列表上方插入「置顶」和「最近」两个区，把分散在各个工作区里的置顶会话汇总到一处，也把最近的会话收拢到一处。
+一个简单的 DeepSeek Harness 侧边栏插件：在「工作区」列表顶部插入「置顶」和「最近」两个分组，把分散在各个工作区里的置顶会话汇总到一处，也把最近的会话收拢到一处。
 
 <p align="center">
-  <img src="./assets/screenshot.png" width="32%" alt="侧边栏「工作区」列表上方依次显示置顶区与最近区">
+  <img src="./assets/screenshot.png" width="32%" alt="侧边栏「工作区」列表顶部依次显示置顶区与最近区">
   <img src="./assets/settings.png" width="64%" alt="插件设置弹窗，包含显示置顶、显示最近和展开工作区中的原会话三个开关">
 </p>
 
 ## 安装与兼容
 
-DSH 兼容版本声明为 `>=0.2.1-rc.3`，允许 RC.3 及后续版本安装；具体功能仍需与所用 DSH 版本验证。
+DSH 兼容版本声明为 `>=0.2.1-rc.2`，允许 0.2.1-rc.2、同版本号下更新的预发布版，以及更高的正式版安装；具体功能仍需与所用 DSH 版本验证。
 
 **Web 端**
 
@@ -33,9 +33,11 @@ dsh plugin --profile web add dsh-up-session
 
 汇总所有工作区里被置顶的会话，按最近更新时间排序，可展开收起。每行悬停时出现归档和取消置顶两个按钮。
 
+置顶区和最近区都位于「工作区」列表顶部，是该列表的前两个分组，会和下方的工作区分组一起滚动；使用「工作区」的搜索功能时，两个区暂时隐藏，把列表让给搜索结果。
+
 ## 最近区
 
-位于置顶区与工作区之间，按最近更新时间排序显示尚未置顶的会话，默认显示最新的 5 条，样式与置顶区一致，同样可以展开收起。会话超过 5 条时，列表底部出现「展开更多」：
+位于置顶区与工作区列表之间，按最近更新时间排序显示尚未置顶的会话，默认显示最新的 5 条，样式与置顶区一致，同样可以展开收起。会话超过 5 条时，列表底部出现「展开更多」：
 
 - 每点一次「展开更多」再显示 5 条；
 - 全部会话都显示完后，按钮变为「收起」；

package/client.js

@@ -150,7 +150,7 @@ window.__ModuleLoader__.load({
       // twice, so the section copies the real geometry instead of predicting it.
       '.dshUS-mount{box-sizing:border-box;flex:none;display:flex;flex-direction:column;gap:4px;',
       'padding-left:4px;margin:0 0 4px -4px}',
-      '.dshUS-mount[data-rail="true"]{display:none}',
+      '.dshUS-mount[data-rail="true"],.dshUS-mount[data-searching="true"]{display:none}',
       '.dshUS-root{box-sizing:border-box;display:flex;flex-direction:column;gap:2px}',
       // The header copies the host's "Workspaces" section header: same box, same
       // 14px/20px label, same tertiary label colour. The whole row is the toggle,
@@ -1009,8 +1009,8 @@ window.__ModuleLoader__.load({
     /**
      * The root of the plugin's sidebar surface: the pinned section, the recent
      * section, and the one archive confirmation both sections can raise. It is
-     * rendered through a portal into the host node the plugin keeps just above
-     * the workspace slot's anchor.
+     * rendered through a portal into the host node the plugin keeps at the top
+     * of the workspace list, inside the "Workspaces" section.
      * @param props - composed slot props plus the injected host and actions.
      * @returns the portal, or null when there is nowhere to portal into.
      */
@@ -1838,11 +1838,32 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Keep the host node immediately before the workspace slot's anchor. The
-     * workspaces seat lives in the sidebar's column flex container, so a sibling
-     * inserted there takes its own space and pushes the browser down instead of
-     * covering it. Both sections share that node and stack inside it. Hiding in
-     * the collapsed rail mirrors the shell's own rule.
+     * The scroll box holding the workspace list. In the grouped and flat views
+     * the `role="tree"` box scrolls itself; while searching, the results tree
+     * sits one level inside that same box, so the nearest scrolling ancestor is
+     * the seat either way. The sections live at the top of this box, inside the
+     * "Workspaces" section, and scroll away with the workspace rows instead of
+     * taking a fixed slice of the sidebar above them.
+     * @param anchor - the Workspaces slot anchor.
+     * @returns the scroll box, or null while the sidebar renders no list.
+     */
+    function workspaceScrollBox(anchor) {
+      const tree = anchor.querySelector('[role="tree"]');
+      if (!(tree instanceof Element)) return null;
+      for (let node = tree; node !== null && node !== anchor; node = node.parentElement) {
+        const { overflowY } = getComputedStyle(node);
+        if (overflowY === 'auto' || overflowY === 'scroll') return node;
+      }
+      return null;
+    }
+
+    /**
+     * Keep the host node at the top of the workspace list. Both sections share
+     * that node and stack inside it, so they read as the first two groups of
+     * the "Workspaces" section rather than as sections of their own. Hiding in
+     * the collapsed rail mirrors the shell's own rule, and the list cannot hold
+     * the sections while the user is searching its rows, so they step aside for
+     * the results.
      * @param host - the container the portal renders into.
      * @returns the disposer that detaches the node and its observers.
      */
@@ -1852,12 +1873,25 @@ window.__ModuleLoader__.load({
 
       const place = () => {
         const anchor = document.querySelector('[data-slot="sidebar.workspaces"]');
-        if (!(anchor instanceof Element)) return;
+        if (!(anchor instanceof Element)) {
+          host.remove();
+          return;
+        }
         const parent = anchor.parentElement;
         if (parent === null) return;
-        if (host.parentElement !== parent || host.nextElementSibling !== anchor) {
-          parent.insertBefore(host, anchor);
+        const seat = workspaceScrollBox(anchor);
+        if (seat === null) {
+          host.remove();
+          return;
+        }
+        if (host.parentElement !== seat || seat.firstElementChild !== host) {
+          seat.insertBefore(host, seat.firstChild);
         }
+        // Search results replace the list's rows; the sections would otherwise
+        // sit above those results as unrelated pinned and recent rows.
+        const search = anchor.querySelector('input[type="text"]');
+        host.dataset.searching =
+          search instanceof HTMLInputElement && search.value.trim() !== '' ? 'true' : 'false';
         if (resize === undefined) {
           // The seat spans the sidebar's inner width, which is narrower than the
           // column by its inline padding; the rail seat is far narrower still.
@@ -1891,7 +1925,7 @@ window.__ModuleLoader__.load({
       };
     }
 
-    /** Contribute the pinned and recent sections above the workspace list. */
+    /** Contribute the pinned and recent sections inside the workspace list. */
     function apply(ctx) {
       ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'up-session: dictionaries');
       const t = ctx.locale.bind(NS);

package/index.js

@@ -2,7 +2,8 @@
  * Host half of the dsh-up-session bundle.
  *
  * The plugin is a pure sidebar decoration: it reads pin state through the
- * Client's workspace controller and renders above the workspace list. There is
- * no Host-side behavior, so this module only satisfies the bundle's Host row.
+ * Client's workspace controller and renders at the top of the workspace list.
+ * There is no Host-side behavior, so this module only satisfies the bundle's
+ * Host row.
  */
 export function apply() {}

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "dsh-up-session",
-    "description": "Adds pinned and recent sections above the workspace list in the sidebar, gathering pinned and recent sessions, with a settings popup in each section header."
+    "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."
   }
 }

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.1",
+  "version": "1.0.3",
   "type": "module",
-  "description": "Adds pinned and recent session sections above 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, with a small settings popup.",
   "license": "MIT",
   "author": "kyrsieger",
   "repository": {
@@ -42,7 +42,7 @@
     "CHANGELOG.md"
   ],
   "engines": {
-    "dsh": ">=0.2.1-rc.3"
+    "dsh": ">=0.2.1-rc.2"
   },
   "dsh": {
     "bundle": {