dsh-up-session 0.0.0-stage → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# 更新日志
+
+## 1.0.1 - 2026-10-24
+
+### 修复
+
+- 兼容 DSH 0.2.1-rc.3
+
+## 1.0.0 - 2026-10-22
+
+### 新增
+
+- 在侧边栏「工作区」上方增加可展开收起的置顶区，按最近更新时间汇总所有工作区的置顶会话。
+- 增加最近区，按最近更新时间展示尚未置顶的会话，默认显示 5 条并支持逐次展开更多和收起。
+- 支持从置顶区和最近区打开、置顶、取消置顶和归档会话，归档仍有工作进行的会话时先提示确认停止。
+- 为会话显示进行中、等待回应和刚完成未查看的状态标记，与工作区列表保持一致。
+- 提供标题栏和插件详情页两个设置入口，可控制置顶区与最近区的显示，以及打开会话时是否展开工作区中的原会话。
+- 支持在当前浏览器中保存设置，并提供简体中文与英文界面、使用说明及插件图标。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kyrsieger
+
+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.en.md

@@ -0,0 +1,84 @@
+<p align="center">
+  <img src="./icon.svg" width="128" height="128" alt="dsh-up-session logo">
+</p>
+
+# dsh-up-session
+
+[简体中文](./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.
+
+<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/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.
+
+**Web**
+
+```sh
+dsh plugin --profile web add dsh-up-session
+```
+
+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`, 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.
+
+## 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:
+
+- each click reveals five more sessions,
+- 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.
+
+## Settings
+
+Each section header carries a gear at its right edge, shown while the pointer is over the header. Clicking it opens this plugin's settings popup, styled like DSH's own settings page.
+
+You can also open the same settings popup from the sidebar via **Plugins → Installed plugins → dsh-up-session**, then click **Open settings** on the plugin detail page.
+
+There are three settings:
+
+- **Show Pinned** (on by default): show or hide the entire Pinned section.
+- **Show Recent** (on by default): show or hide the entire Recent section. Both lists can be turned off together and enabled again through **Open settings** on the native plugin detail page.
+- **Reveal the session in its workspace** (on by default): opening a session from Pinned or Recent also expands its workspace group in the sidebar so the original row is visible. Turn it off to open the session without changing which groups are expanded.
+
+## Status markers
+
+Rows in both sections read the same live status as the sidebar's own session rows, so all three places always agree. When several states apply, the first one below wins:
+
+- **amber dot**: the session is waiting for you — an answer, an approval, or a plan review;
+- **spinner**: the session is running, either its own turn or a subagent it still has working;
+- **green dot**: the session just finished and you have not opened it yet.
+
+The marker sits at the left of the title and appears only when there is something to report, so an idle row keeps its original left edge; the archive and pin buttons still appear on hover where they always did.
+
+## Publishing
+
+Publishing a GitHub Release triggers the [publishing workflow](./.github/workflows/publish.yml), which publishes the package at that tag to npm. The tag must match the version in `package.json`, for example `v1.0.1` or `1.0.1`. Stable versions use the npm `latest` tag; prerelease versions use `next` and must also be marked as prereleases on GitHub. Saving a draft or pushing a tag alone does not trigger publishing.
+
+Before the first automated release, add a GitHub Actions trusted publisher in the npm settings for `dsh-up-session` ([official npm instructions](https://docs.npmjs.com/trusted-publishers/)):
+
+- Organization or user: `kyrsieger`
+- Repository: `dsh-up-session`
+- Workflow filename: `publish.yml`
+- Environment name: leave blank
+- Allowed actions: allow direct publishing with `npm publish`
+
+The workflow authenticates through OIDC, so no `NPM_TOKEN` is needed. Commit and push the workflow, version number, and changelog first, then create a tag for that commit and publish its Release. If publishing fails, rerun the failed job in GitHub Actions; npm versions that have already been published successfully cannot be published again.
+
+## License
+
+This project is licensed under the [MIT License](./LICENSE).

package/README.md

@@ -1,3 +1,84 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="./icon.svg" width="128" height="128" alt="dsh-up-session 标志">
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# dsh-up-session
+
+简体中文 | [English](./README.en.md)
+
+一个简单的 DeepSeek Harness 侧边栏插件：在「工作区」列表上方插入「置顶」和「最近」两个区，把分散在各个工作区里的置顶会话汇总到一处，也把最近的会话收拢到一处。
+
+<p align="center">
+  <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 版本验证。
+
+**Web 端**
+
+```sh
+dsh plugin --profile web add dsh-up-session
+```
+
+安装后重启 DSH。如果使用自定义 profile，将命令中的 `web` 替换为对应名称。
+
+**桌面端**
+
+打开侧边栏「插件」，点击「添加插件」，输入 `dsh-up-session`，安装完成后点击「立即启用」。
+
+## 置顶区
+
+汇总所有工作区里被置顶的会话，按最近更新时间排序，可展开收起。每行悬停时出现归档和取消置顶两个按钮。
+
+## 最近区
+
+位于置顶区与工作区之间，按最近更新时间排序显示尚未置顶的会话，默认显示最新的 5 条，样式与置顶区一致，同样可以展开收起。会话超过 5 条时，列表底部出现「展开更多」：
+
+- 每点一次「展开更多」再显示 5 条；
+- 全部会话都显示完后，按钮变为「收起」；
+- 点击「收起」把列表收回到最新的 5 条。
+
+每行悬停时出现归档和置顶两个按钮。已置顶的会话只出现在置顶区，两区不会重复显示同一个会话。
+
+## 设置
+
+「置顶」和「最近」的标题栏右侧各有一个齿轮按钮，鼠标移到标题栏上才出现；点击后打开本插件的设置弹窗，样式沿用 DSH 原生设置页。
+
+也可以从侧边栏「插件 → 已安装插件 → dsh-up-session」进入插件详情页，点击「打开设置」打开同一个设置弹窗。
+
+目前有三项设置：
+
+- **显示置顶**（默认开启）：显示或隐藏整个置顶区。
+- **显示最近**（默认开启）：显示或隐藏整个最近区。两个列表可以同时关闭，之后仍可通过原生插件详情页的「打开设置」重新开启。
+- **展开工作区中的原会话**（默认开启）：从置顶区或最近区点击会话时，同时展开它在工作区列表中所在的分组，让原生会话行可见。关闭后只打开会话，不改变工作区的展开状态。
+
+## 状态标记
+
+两个区的会话行与工作区里的会话行共用同一份运行状态，所以三处的标记始终一致。同时满足多项时按下面的顺序取第一项：
+
+- **橙点**：会话正在等你回应，可能是等待回答、等待审批或计划待审；
+- **转圈**：会话正在进行，包括它自己的回合，以及它还有正在运行的子智能体；
+- **绿点**：会话刚完成，而你还没打开看过。
+
+状态标记插在标题左侧，只在需要提示时才出现，空闲的行保持原本的左边缘；归档、置顶等操作按钮在悬停时出现的位置不受影响。
+
+## 发布
+
+发布 GitHub Release 后，[发布工作流](./.github/workflows/publish.yml) 会自动将该 tag 对应的包发布到 npm。tag 必须与 `package.json` 的版本一致，例如 `v1.0.1` 或 `1.0.1`。正式版使用 npm 的 `latest` 标签；预发布版使用 `next`，且 GitHub Release 必须标记为预发布。仅保存草稿或推送 tag 不会触发发布。
+
+首次使用前，在 npm 的 `dsh-up-session` 包设置中添加 GitHub Actions 可信发布者（[npm 官方说明](https://docs.npmjs.com/trusted-publishers/)）：
+
+- Organization or user：`kyrsieger`
+- Repository：`dsh-up-session`
+- Workflow filename：`publish.yml`
+- Environment name：留空
+- Allowed actions：允许直接执行 `npm publish`
+
+工作流使用 OIDC 认证，无需配置 `NPM_TOKEN`。先将工作流、版本号和更新日志提交并推送，再为该提交创建 tag 和发布 Release。发布失败时，可在 GitHub Actions 中重跑失败的任务；已成功发布的 npm 版本不能重复发布。
+
+## 许可
+
+本项目基于 [MIT 许可证](./LICENSE) 授权。