docs: 更新项目介绍与特性总览(完整的分组管理工具)
- 定位从三层树插件升级为完整工作区分组管理工具 - 特性按能力重组:三层树浏览 / 分组管理生命周期 / 拖拽归类与排序 / 搜索与操作 / 持久化与零侵入 - 覆盖 v0.1~v0.4 全部能力(建组/重命名/删除、拖拽移入移出、项目与分组 双向排序、插入位置指示线、未分类置底、树形搜索、overlay 持久化、零侵入)
This commit is contained in:
parent
e08c4ed1e8
commit
26c816ea58
68
README.md
68
README.md
|
|
@ -3,40 +3,56 @@
|
|||

|
||||

|
||||
|
||||
> **DeepSeek Harness(DSH)Web 客户端插件**:把 GUI 侧边栏的工作区列表从两层
|
||||
> 「项目 → 会话」变成三层 **「分类文件夹 → 项目文件夹 → 会话」**。
|
||||
> **DeepSeek Harness(DSH)Web 客户端插件:完整的工作区分组管理工具。**
|
||||
> 把 GUI 侧边栏的工作区列表从两层「项目 → 会话」升级为三层
|
||||
> **「分类文件夹 → 项目文件夹 → 会话」**,并围绕它提供完整的分组管理能力——
|
||||
> 手动建组、重命名/删除分组、拖拽归类、项目与分组的自由排序、规则自动归类、
|
||||
> 树形搜索。所有操作**即时生效并持久化**,对官方数据**零侵入**。
|
||||
|
||||
典型场景:多个 DSH 插件项目(SkillsManagePlugins / Documentation-Driven AI Coding /
|
||||
DeepSeek峰谷小组件 等)归入一个「DSH 插件」分类文件夹,点开是各项目,再点开是各自会话。
|
||||
DeepSeek峰谷小组件 等)归入一个「DSH 插件」分类文件夹,点开是各项目,再点开是各自会话;
|
||||
临时项目随手建个「临时」分组拖进去,用完删除分组即全部回到「未分类」。
|
||||
|
||||
## 截图
|
||||
|
||||

|
||||

|
||||
|
||||
## 特性
|
||||
|
||||
- **三层侧边栏**:分类文件夹(可折叠)→ 项目文件夹(可折叠)→ 会话行
|
||||
- **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 安装无需执行任何依赖脚本
|
||||
|
||||
## 工作原理
|
||||
|
|
|
|||
Loading…
Reference in New Issue