@anionex/dsh-pinned-sessions 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anionex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# DSH Pinned Sessions
+
+Pin important DeepSeek Harness sessions at the top of the Workspace sidebar.
+
+## Features
+
+- Adds **Pin session** / **Unpin session** to the native Session actions menu.
+- Keeps pinned Sessions in a compact list above the native Workspace tree.
+- Opens a pinned Session through the official DSH Session service.
+- Preserves the original Session in its Workspace and keeps search, grouping, drag ordering, fork, rename, and archive behavior unchanged.
+- Stores pins in versioned browser-profile storage and removes stale or archived entries after DSH data is ready.
+- Supports both the DSH `web` profile and DSH Desktop's embedded Web client.
+
+## Install
+
+From a checkout:
+
+```bash
+dsh plugin --profile web add .
+dsh plugin --profile desktop add .
+```
+
+Restart each long-running profile after installation. Open a Session's `...` menu and choose **Pin session**. The pinned list appears directly below the Workspace header.
+
+Pins persist independently in each browser/Desktop profile. They are UI preferences and are not written into Session logs or Workspace files.
+
+## Compatibility
+
+DSH currently exposes additive root overlays but no row-level Session menu or Workspace-list header slot. This plugin mounts through the official `shell.overlay` lifecycle, then uses DSH's stable `[data-slot="sidebar.workspaces"]` and ARIA roles for placement. It captures a row's real Session ID from the native `sessions.open(node.id)` callback without navigating; if that verified capture is unavailable, the plugin fails closed and does not add a menu action.
+
+No title or list-position matching is used. All observers, listeners, portal hosts, and styles are removed on plugin disposal/HMR.
+
+## Development
+
+```bash
+pnpm install
+pnpm run check
+```
+
+The repository commits `lib/` so a Git checkout can be installed directly.
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,44 @@
+# DSH 置顶会话
+
+把重要的 DeepSeek Harness 会话固定在左侧工作区列表顶部。
+
+## 功能
+
+- 在原生会话“...”菜单中增加“置顶会话 / 取消置顶”。
+- 在原生工作区树上方显示紧凑的置顶会话列表。
+- 点击置顶项时通过 DSH 官方 Session 服务打开会话。
+- 原会话仍保留在原工作区中，搜索、分组、拖拽排序、分叉、重命名和归档全部保持原样。
+- 使用带版本号的浏览器 profile 存储；DSH 数据就绪后自动移除已归档或已消失的条目。
+- 同时支持 DSH `web` profile 和 DSH Desktop 内嵌的 Web 客户端。
+
+## 安装
+
+在插件仓库中执行：
+
+```bash
+dsh plugin --profile web add .
+dsh plugin --profile desktop add .
+```
+
+安装后重启对应的长期运行 profile。打开任意会话的“...”菜单并选择“置顶会话”，置顶区会出现在“工作区”标题正下方。
+
+Web 与 Desktop 各自在自己的浏览器 profile 中持久化置顶状态；该状态不会写入会话日志或工作区文件。
+
+## 兼容实现
+
+当前 DSH 提供可叠加的根级 overlay slot，但没有逐会话菜单或工作区列表头部 slot。本插件通过官方 `shell.overlay` 生命周期挂载，再使用 DSH 稳定的 `[data-slot="sidebar.workspaces"]` 和 ARIA role 完成精确放置。插件通过原生 `sessions.open(node.id)` 回调无导航地捕获真实 Session ID；如果无法验证该捕获路径，就直接不添加菜单项。
+
+实现不会按标题或列表序号猜测会话。插件卸载或热重载时会完整清理 observer、事件监听、portal 宿主和样式。
+
+## 开发
+
+```bash
+pnpm install
+pnpm run check
+```
+
+仓库提交 `lib/` 构建产物，因此 Git checkout 可以直接安装。
+
+## 许可证
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# Mount the host marker so DSH discovers this bundle's Web client entry.
+- insert:
+    - id: pinned-sessions
+      name: '@anionex/dsh-pinned-sessions'