Introduction¶
The Web Profile sidebar of DeepSeek Harness currently supports only workspaces and conversation lists. As the number of conversations grows, finding a specific conversation can become difficult. This plugin addresses the issue by introducing a folder hierarchy, enabling nested management of Project → Folder → Conversation.
Core Features¶
- Folder Management: create, rename, and delete folders.
- Conversation Management: rename conversations, and move conversations into or out of folders.
- Content Search: search conversations by message content using the search box at the top of the sidebar.
- Conversation Archiving: archive conversations (logs are retained, but the conversations are hidden from the sidebar).
Installation and Activation¶
The installation command is as follows:
dsh plugin --profile web add dsh-conversation-folders
This command installs the plugin to ~/.dsh/profiles/web/node_modules/ and automatically adds it to dsh.profile.bundles. It takes effect after restarting DSH.
Note: The plugin depends on peerDependencies version >=0.1.0-rc.5. If your DSH version is different, you may need to adjust it.
Data Model¶
The plugin uses the convfolders domain for data persistence. Each record is stored in a folder with the following structure:
{
"id": "f-<id>",
"workspaceId": "<workspace uuid>",
"title": "UI",
"sessionIds": ["session-…"],
"createdAt": "ISO-8601",
"updatedAt": "ISO-8601"
}
Known Limitations¶
- Sidebar Takeover: This plugin takes over the native
sidebar.workspaces, so the native workspace Fork, creation, deletion, and reordering features are not replicated. - No Archived Recovery Entry: This plugin only provides archiving (hiding) functionality, without an archived view or recovery entry. To restore archived conversations, please use another archive management plugin.
- RPC Approach: Compared with the standard
@RemoteRPC, this solution uses a bare HTTP routePOST /folders-rpc, which lacks wire schema validation. This was done to keep the implementation as simple as possible. - Version Dependency:
peerDependenciesuses>=0.1.0-rc.5.
Comparison with Similar Plugins¶
| Feature | This Plugin | dsh-session-move | dsh-plugin-dated-folders |
|---|---|---|---|
| Second-level folders within a project (create/rename) | ✅ | ❌ | ❌ |
| Group conversations within a project | ✅ | ❌ | ❌ |
| Move conversations across projects | ❌ | ✅ | ❌ |
| Delete conversations / AI renaming | ❌ | ✅ | ❌ |
| Archive by date | ❌ | ❌ | ✅ |
This plugin is positioned as the only implementation for manual free grouping within a project. It can be installed alongside dsh-session-move (cross-project moving + deletion).
Conclusion¶
This plugin provides DSH users with the ability to embed a folder hierarchy in the sidebar. It is suitable for users who need to manually organize a large number of conversations. Please inspect the source code and license before installation.