@lkzc19/dsh-workspace-virtual-groups 0.0.0-stage → 0.2.0

package/LICENSE

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

@@ -1,3 +1,79 @@
-# Temporary Holding Version
+# @lkzc19/dsh-workspace-virtual-groups
 
-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 侧边栏的工作区列表加一层**手动虚拟分组**。项目仍在原目录，插件只改变显示归属和顺序。
+
+## 功能
+
+- 内置「默认」分组固定第一，不可重命名或删除。
+- 新建、重命名、删除分组；删除后组内项目回到默认。
+- 把项目行拖到分组标题上即可归组；拖分组标题可调整顺序。
+- 分组标题的 `⋯` 菜单：添加工作区、重命名分组、删除分组。
+- 官方「视图选项 → 分组方式」新增「按虚拟分组」；选择其他模式即回到官方分组。
+- 分组和排序保存在插件自己的 JSON 中，不修改官方工作区数据。
+
+## 安装
+
+发布到 npm 后可以一行安装（包名带 `@lkzc19` scope，不占用公共命名空间）：
+
+```sh
+dsh plugin --profile desktop add @lkzc19/dsh-workspace-virtual-groups
+```
+
+`lib/` 是构建产物，不进仓库。从源码安装时先克隆并构建，再从本地目录安装：
+
+```sh
+git clone https://github.com/lkzc19/dsh-workspace-virtual-groups.git
+cd dsh-workspace-virtual-groups
+npm install   # prepare 会自动执行 npm run build
+
+# 桌面端
+dsh plugin --profile desktop add "$PWD"
+
+# Web / CLI
+dsh plugin --profile web add "$PWD"
+```
+
+安装后重启桌面端或对应的 `dsh web` 进程。
+
+> 不要从 GitHub URL 直接安装（`dsh plugin add https://github.com/...`）：pnpm 会拒绝为 git 依赖执行 `prepare`（`ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`），装进来的是一份没有 `lib/` 的源码。
+
+卸载：
+
+```sh
+dsh plugin --profile desktop remove @lkzc19/dsh-workspace-virtual-groups
+```
+
+## 使用
+
+1. 打开侧边栏「工作区」区域。
+2. 点击标题栏的「新建分组」创建分组。
+3. 把项目行拖到分组标题上完成归类。
+4. 需要回到官方分组时，在「视图选项 → 分组方式」选择「按工作区」「按工作区树」或「单列表」；再选「按虚拟分组」即可切回。
+
+## 数据
+
+手动分组、归属、排序和视图模式保存在：
+
+```text
+$DSH_HOME/workspace-virtual-groups.manual.json
+```
+
+## 兼容性
+
+- 面向 DSH 0.2.x，桌面端和 `dsh web` 共用同一套代码。
+- 插件依赖官方侧边栏的 DOM 结构；DSH 大版本升级后如果结构变化，插件会退化为不分组，不会破坏官方数据。
+- 桌面端和 Web 端使用不同的 profile，需要分别安装。
+
+## 开发
+
+```sh
+npm install   # 装依赖并自动构建（prepare）
+npm run build
+npm test
+```
+
+`lib/index.js`（Host）和 `lib/client.js`（Client）是构建产物，已被 `.gitignore` 忽略，不要提交。
+
+## 许可证
+
+MIT。基于 [z-col/dsh-workspace-groups](https://github.com/z-col/dsh-workspace-groups)（MIT）修改。完整许可见 [LICENSE](./LICENSE)。

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+# dsh-workspace-virtual-groups bundle patch.
+#
+# Installed through the official CLI:
+#
+#   dsh plugin --profile web add /absolute/path/to/dsh-workspace
+#
+# The CLI appends this package to `dsh.profile.bundles`; the profile boot then
+# merges this patch (one insert of the plugin row).
+- insert:
+    - id: workspace-virtual-groups
+      name: '@lkzc19/dsh-workspace-virtual-groups'
+      config: {}