dsh-conversation-folders
DeepSeek Harness 第三方插件：在左侧栏内嵌「项目 → 文件夹 → 对话」层级。
- 📁 新建文件夹、重命名、删除
- 对话改名、把对话移入/移出文件夹
- 🔍 对话内容搜索（侧栏顶部搜索框，按消息内容搜索）
- 🗄 归档会话（日志保留，从侧栏隐藏）
- 数据持久化在
~/.dsh/storages/convfolders.json
文件
| 文件 | 说明 |
|---|---|
package.json | 包声明；dsh.client（浏览器半部）+ dsh.bundle.patch（profile 自动挂载） |
lib/index.js | Host 半部（ESM named-export）：storageDomain 持久化 + webServer 注册 POST /folders-rpc |
lib/client.js | Client 半部：window.__ModuleLoader__.load({ id, factory }) classic script，require('react')，fetch 调 /folders-rpc |
cordis.patch.yml | bundle 挂载层：- insert: { id: conversation-folders, name: dsh-conversation-folders } |
本包按官方 client bundle 约定编写（Client 半部 window.__ModuleLoader__.load，React 经 require('react') 解析；Host 半部 ESM named-export）。纯 JS，无 TypeScript/typert 构建链，schema 用恒等 parse（不校验，兼容已有数据）。
安装与挂载（profile 插件机制，无需自建部署）
> 原理：DSH 的 web profile（~/.dsh/profiles/web/）通过 dsh.profile.bundles 列出启动时自动加载的插件。装进 profile 的包只要声明 dsh.bundle.patch，启动即自动挂载——不需要 clone 源码 / 自建部署 / 那套几 GB 环境。
1. 安装 pnpm：npm install -g pnpm（或 corepack enable） 2. 安装插件： ``sh dsh plugin --profile web add <本目录绝对路径> # 发布到 npm 后：dsh plugin --profile web add dsh-conversation-folders ` 该命令会把包装进 ~/.dsh/profiles/web/node_modules/，并自动加入 dsh.profile.bundles。 3. 若遇到 ERR_PNPM_EPERM（@img/sharp-win32-x64 目录被正在运行的 DSH 进程锁定，Windows 常见）： - 把本目录 junction 到 ~/.dsh/profiles/web/node_modules/dsh-conversation-folders （cmd /c mklink /J "<profile>\node_modules\dsh-conversation-folders" "<本目录>"） - 在 ~/.dsh/profiles/web/package.json 的 dependencies 与 dsh.profile.bundles 各加上 dsh-conversation-folders` 4. 重启 DSH：之后每次开机自动挂载，无需手动操作。
与同类插件的差异
| 本包 | dsh-session-move | dsh-plugin-dated-folders | |
|---|---|---|---|
| 项目内二级文件夹（新建/改名） | ✅ | ❌（其"文件夹"= workspace，只能跨项目搬） | ❌ |
| 项目内分组对话 | ✅ | ❌ | ❌ |
| 跨项目移动会话 | ❌ | ✅ | ❌ |
| 会话删除 / AI 改名 | ❌ | ✅ | ❌ |
| 归档 agent 生成的文件 | ❌ | ❌ | ✅（按日期） |
定位：项目内手动自由分组的唯一实现；与 dsh-session-move（跨项目搬运+删除）互补，可共存安装。
数据模型
convfolders 域（storageDomain），folders 表，每条记录：
{
"id": "f-<id>",
"workspaceId": "<workspace uuid>",
"title": "UI",
"sessionIds": ["session-…"],
"createdAt": "ISO-8601",
"updatedAt": "ISO-8601"
}约束：一个会话在同一项目内最多属于一个文件夹（moveSession 会先从其他文件夹移除）。
已知限制
- 接管了原生
sidebar.workspaces：fork、workspace 新增/删除/排序 未复刻。 - 归档无恢复入口：本插件只提供归档（隐藏），未提供已归档视图/恢复；需要恢复时请配合社区归档管理插件（如
dsh-archived-sessions）。 - 相比规范的
@Remote(typert) RPC，本方案用裸 HTTP 路由POST /folders-rpc，缺少 wire schema 校验，是刻意的最简取舍（第三方包无构建链）。 peerDependencies用>=0.1.0-rc.5；若你的 DSH 版本不同，可能需要调整。
从动态插件到正式包的改动对照
| 动态插件 | 正式包 |
|---|---|
harness.handle('folders.*') | webServer.register({ path: '/folders-rpc' }) |
host.call('folders.*') | fetch('/folders-rpc') |
恒等 { parse: v => v } | 恒等 { parse: v => v }（不引入 zod/schemastery 依赖） |
return { apply } | ESM export const name/inject + export function apply |
Builtin styles.insert | document.createElement('style') |
Client Builtin React / import | require('react') + window.__ModuleLoader__.load |