From 26c816ea58a3911e2c22ef756fe07d00f811c1ae Mon Sep 17 00:00:00 2001 From: zcol <297114876@qq.com> Date: Sat, 22 Aug 2026 01:22:09 +0300 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E4=BB=8B=E7=BB=8D=E4=B8=8E=E7=89=B9=E6=80=A7=E6=80=BB=E8=A7=88?= =?UTF-8?q?=EF=BC=88=E5=AE=8C=E6=95=B4=E7=9A=84=E5=88=86=E7=BB=84=E7=AE=A1?= =?UTF-8?q?=E7=90=86=E5=B7=A5=E5=85=B7=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 定位从三层树插件升级为完整工作区分组管理工具 - 特性按能力重组:三层树浏览 / 分组管理生命周期 / 拖拽归类与排序 / 搜索与操作 / 持久化与零侵入 - 覆盖 v0.1~v0.4 全部能力(建组/重命名/删除、拖拽移入移出、项目与分组 双向排序、插入位置指示线、未分类置底、树形搜索、overlay 持久化、零侵入) --- README.md | 68 ++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 42 insertions(+), 26 deletions(-) diff --git a/README.md b/README.md index a21bf93..a4996e6 100644 --- a/README.md +++ b/README.md @@ -3,40 +3,56 @@ ![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg) ![DSH](https://img.shields.io/badge/DSH-0.1.1--rc.2-purple.svg) -> **DeepSeek Harness(DSH)Web 客户端插件**:把 GUI 侧边栏的工作区列表从两层 -> 「项目 → 会话」变成三层 **「分类文件夹 → 项目文件夹 → 会话」**。 +> **DeepSeek Harness(DSH)Web 客户端插件:完整的工作区分组管理工具。** +> 把 GUI 侧边栏的工作区列表从两层「项目 → 会话」升级为三层 +> **「分类文件夹 → 项目文件夹 → 会话」**,并围绕它提供完整的分组管理能力—— +> 手动建组、重命名/删除分组、拖拽归类、项目与分组的自由排序、规则自动归类、 +> 树形搜索。所有操作**即时生效并持久化**,对官方数据**零侵入**。 典型场景:多个 DSH 插件项目(SkillsManagePlugins / Documentation-Driven AI Coding / -DeepSeek峰谷小组件 等)归入一个「DSH 插件」分类文件夹,点开是各项目,再点开是各自会话。 +DeepSeek峰谷小组件 等)归入一个「DSH 插件」分类文件夹,点开是各项目,再点开是各自会话; +临时项目随手建个「临时」分组拖进去,用完删除分组即全部回到「未分类」。 ## 截图 -![dsh-workspace-groups 侧边栏三层树](screenshot.png) +![dsh-workspace-groups 工作区分组管理](screenshot.png) ## 特性 -- **三层侧边栏**:分类文件夹(可折叠)→ 项目文件夹(可折叠)→ 会话行 -- **sidecar 配置**:分类规则写在 `~/.dsh/workspace-groups.yaml`,改配置即可增删分类 / - 调整归类,无需改代码、无需重启(刷新页面生效) -- **树形搜索**:搜索命中后仍保留三层树结构(分类 → 项目 → 命中会话),命中行高亮并 - 显示内容摘要,而不是扁平的结果列表 -- **手动分组管理(所有分组)**:侧边栏区头「新建分组」按钮即建即显(空分组也渲染); - **每个分组行**(含规则分类)悬停出现 `⋯` 菜单 → 重命名 / 删除。删除分组后, - 组内所有项目回到「未分类」;规则分类的重命名/删除经 overlay 生效(`renamed`/ - `hidden`),规则 YAML 原样保留 -- **拖拽归类 + 排序**:拖动项目文件夹到任意分组行 / 分组内项目行 = 移入该组 - (拖到某项目行上半 = 插到它前面、下半 = 插到它后面,即**组内位置排序**, - 拖动时实时显示 2px **插入位置指示线**,落点所见即所得);拖动时 - **其他分组的项目自动收起**,源分组保留以便排序;拖到「未分类」或菜单 - 「移到未分类」= 强制归入未分类 -- **分组拖拽排序**:分组行也可拖动(拖动时所有分组收起),拖到另一个分组行 - 上半 = 移到它前面、下半 = 移到它后面(指示线显示落点),即改变分组顺序; - **「未分类」永远在列表最底部**(分组恒在未分类项目之上) -- **零侵入**:不修改 `~/.dsh/storages/workspace.json`、不修改会话落盘结构、 - 不修改官方 `@deepseek-ai/dsh-client-ui-workspace` 包;手动分组/归类/排序写入独立 - sidecar JSON(`~/.dsh/workspace-groups.manual.json`),规则 YAML 原样保留 -- **功能不退化**:打开/新建/搜索会话、Add Workspace、项目重命名/删除、 - 会话重命名/派生/归档、展开状态持久化(独立 key,重启保留) +### 三层树浏览 +- **分类文件夹 → 项目文件夹 → 会话行**,分类/项目均可折叠;展开状态独立持久化 + (`dsh.workspace.groups.view.v1`,刷新/重启保留) +- **「未分类」兜底桶**:不匹配任何分组、被移出分组的项目自动归入,**恒在列表最底部** + +### 分组管理(完整生命周期) +- **手动新建分组**:区头「新建分组」按钮即建即显,空分组也渲染 +- **重命名 / 删除任意分组**:每个分组行(**含规则分类**)悬停 `⋯` 菜单; + 删除分组后组内所有项目回到「未分类」;规则分类的改名/删除经 overlay 生效 + (`renamed` / `hidden`),**规则 YAML 原样保留** +- **规则自动归类**:sidecar YAML 声明分类规则(`pathPrefix` / `pathExact` / + `nameContains` / `basenameContains`),改配置即可调整归类,无需改代码 + +### 拖拽归类 + 排序 +- **拖项目进分组**:拖到任意分组行 / 分组内项目行即移入(跨组移动 = 覆盖规则归类); + 拖到「未分类」或菜单「移到未分类」= **强制归入未分类**(规则匹配也无效) +- **项目组内排序**:拖到项目行上半 = 插到它前面、下半 = 插到它后面 +- **分组排序**:分组行可拖动,拖到另一分组行上半 = 移到它前面、下半 = 移到它后面 +- **插入位置指示线**:拖动中实时显示 2px 指示线(行上/下方),松手落点所见即所得 +- **智能收起**:拖项目时其他分组的项目自动收起(源分组保留便于排序);拖分组时所有 + 分组收起(分组行仍可见作排序目标) + +### 搜索与操作 +- **树形搜索**:命中后仍保留三层树结构(分类 → 项目 → 命中会话),命中行高亮 + + 内容摘要,防抖 250ms +- **工作区/会话操作不退化**:Add Workspace、项目重命名/删除、新建/打开/重命名/ + 派生/归档会话 + +### 持久化与零侵入 +- 所有手动操作(分组、归类、排序、改名、隐藏)写入插件自有 overlay + (`~/.dsh/workspace-groups.manual.json`),host 校验后**原子写入**(写坏返回 400 并 + 保留原文件) +- **零侵入**:不修改 `~/.dsh/storages/workspace.json`、不修改会话落盘结构、不修改官方 + `@deepseek-ai/dsh-client-ui-workspace` 包;规则 YAML 永不改写 - **产物自包含**:`lib/` 已构建并随仓库分发,Git 安装无需执行任何依赖脚本 ## 工作原理