choocoo / conversation-folders-package

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. 安装插件：

   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