DeepSeek Harness (DSH) 的侧边栏默认以工作区为单位展示。面对多个项目和大量会话时，这种视图容易显得杂乱。Metafolder 插件提供了一种元文件夹机制，在不修改底层文件路径的前提下，在侧边栏层面对工作区和会话进行可视化的归类与整理。
插件简介¶
- 插件名称：
manoloremiddi/dsh-metafolder-plugin - 维护者：ManoloRemiddi
- 许可协议：MIT
- 核心定位：为 DeepSeek Harness 侧边栏提供彩色的工作区和会话分组视图。
核心功能¶
该插件在现有的工作区行之上叠加了一层元文件夹，提供以下能力：
- 元文件夹与计数：以命名、可折叠的组来嵌套真实的工作区文件夹和会话，并在文件夹旁显示包含的会话数量。
- 拖拽操作：将工作区或会话行拖拽到元文件夹中即可归档；拖拽到列表背景可取消归档。
- 本地持久化：分组和归属关系保存在浏览器的
localStorage中，页面刷新后依然存在（仅限当前浏览器）。 - 行菜单：提供丰富的上下文操作，包括
→ <meta folder>归档、Remove from meta folder取消归档，以及重命名、上移/下移、删除工作区。 - 自定义颜色：创建文件夹时可从八色色板、主题色或自定义颜色中选择，该颜色会应用到文件夹图标、标签和拖拽目标边框。
- 视图选项：支持按“工作区”分组或“平铺”视图，支持按“手动”或“更新时间”排序。
- 工作区与会话管理：在宽侧边栏或折叠侧边栏中均可添加工作区；支持按会话或工作区进行搜索、重命名、派生和归档。
安装与启用¶
在终端中执行以下命令，通过 web 配置文件安装指定版本：
dsh plugin --profile web add https://github.com/ManoloRemiddi/DSH-Metafolder-Plugin/releases/download/v1.2.1/dsh-metafolder-plugin-1.2.1.tgz
安装完成后，重启 DSH 进程并刷新 Web 页面即可生效。
典型用法¶
- 项目归类：将所有“Resonant OS”相关的项目和工作区会话拖拽到一个名为“Resonant OS”的元文件夹中。
- 颜色标记：为不同类型的文件夹（如开发、测试、文档）分配不同的颜色，以在视觉上快速区分。
- 快速归档：使用行菜单中的
→ <meta folder>快速将不再活跃的会话移动到对应的分组中。
适用场景与注意¶
该插件适合需要管理大量工作区和会话、希望对侧边栏视图进行自定义整理的用户。
重要限制：
* 无跨设备同步：目前的实现依赖浏览器本地存储，不支持跨设备同步或持久化的 Host 服务存储。
* 物理移动受限：工作区的物理路径移动受到保护，插件不直接修改文件系统或路径注册表，直到 DSH 提供支持路径迁移的 API。
* 权限绑定：AI 的权限始终绑定到真实的文件夹，因为插件只是渲染层，并未改变底层数据结构。
前置要求：
* DeepSeek Harness 版本 >= 0.1.5-rc.1。
* 需要在 web 配置文件下安装。
总结¶
Metafolder 插件为 DSH 侧边栏增加了一层逻辑上的组织结构。它通过元文件夹和拖拽功能，在不触碰文件系统底层的前提下，极大地改善了多项目管理的视觉体验。
