前言¶
在 DSH 里做多工作区、多会话协作时，常见做法是手动复制聊天记录、在笔记里记「下一步」，或靠记忆回到某个会话继续。会话本身不会被整理成可检索的结构，跨工作区交接时也容易漏段、超长上下文又不好直接贴进新会话。DSH Task Shelf 1（社区试用版）把「资料夹、会话引用、下一步便签」和「交接包生成与压缩」放在同一套界面里，原会话不移动、不修改，适合需要暂停后再续、或要把多段讨论合成一份草稿的场景。
下面介绍插件定位、已实现能力、安装方式、典型用法与使用边界。
这是什么¶
DSH Task Shelf 1 · 任务资料夹 由社区维护者 xin505 发布，包版本 1.0.1，目标宿主为 DSH 0.2.1-rc.3（package.json 中 engines.dsh 与 peer 依赖均指向该版本）。在 SkillHub 等社区目录中分类为「记忆」；GitHub 仓库：https://github.com/xin505/dsh-task-shelf。
一句话定位：把相关会话和下一步放在一个资料夹里，下次回来继续工作；并在交接区域按「工作区 → 会话」选择多个来源，合成交接包并按需压缩，再带入目标工作区的新会话草稿（不自动发送）。
独立社区项目，与 DeepSeek 官方无隶属关系；采用 MIT 许可证。
核心功能¶
以下均来自仓库 README 的「已实现」说明，未列入项（如文件引用、消息收藏、整份资料夹 Markdown 导出、跨机器映射）当前包未实现。
资料夹与会话管理¶
- 按工作区新建、改名、搜索资料夹，编辑下一步便签。
- 从不同工作区关联会话、设置主会话、打开会话和继续任务；原会话不移动。
- 每窗口独立的当前任务标记；回收区、恢复和永久删除。
- JSON 备份导出、预览后新增导入；同一备份阻止重复导入。
- 保存冲突保留草稿；结果不明时可查询，原操作重试去重。
启动自检与诊断¶
每次插件加载自动检查数据格式、上一代备份和目录临时文件读写；界面显示启动自检结果，可导出不含内容的诊断报告。
跨工作区、跨会话交接¶
在交接区域直接展开工作区，合选 1–5 段会话，不必先关联到资料夹。两份材料均标明来源，支持分别编辑、复制下载和目标工作区草稿。
- 单段超过 12,000 字符时，按所选方式自动压缩。
- 整包超过 30,000 字符时停下，列出各段大小，由用户选择压缩哪一段。
- AI 摘要与本地精简可自由选择；界面说明优劣。本地精简保留开头与结尾；AI 摘要使用 DSH 默认模型。默认本地精简不调用模型；用户选用 AI 摘要并点击生成或压缩时会调用 DSH 默认模型，可能产生费用。压缩失败保留原内容，不静默换用其他方式。
- 带入新会话仍只准备草稿，不自动发送。
双版本与查看方式¶
默认左侧原始记录、右侧易读版；右上角可切换原始记录、易读版或并排查看。两份分别编辑且不会互相覆盖；输出版本默认易读版。未经压缩的来源展示原文；压缩后的来源明确标注为 AI 摘要或本地精简。
本地数据与限额¶
数据保存在 $DSH_HOME/task-shelf/state.json；未设置 DSH_HOME 时为 ~/.dsh/task-shelf/state.json。每次替换前保留上一代 state.json.previous。停用、卸载没有删除数据的逻辑。
试用限额（README 原文）：100 个资料夹（含回收区）、每个 50 个会话引用、便签 4096 字节、资料夹数据 2 MiB；加操作回执后状态文件最多 4 MiB。备份包含便签、会话标题和标识，请按个人资料保管。
交接选择和压缩结果不写入任务状态。范围限同一 DSH 环境，不支持跨机器或独立 profile 自动同步。
安装与启用¶
安装步骤以 README 与试用说明为准，不是 dsh plugin add github:... 一类命令。
- 在 GitHub 仓库 Releases 下载
dsh-task-shelf-1.0.1.zip（勿选源码 ZIP）。 - 解压到长期保留的位置，使用直接包含
package.json的目录。 - 在 DSH 中：插件 → 添加插件 → 安装第三方插件 → 填入上述本地包目录。
- 安装后不要删除该目录。另提供
.tgz和 SHA-256 校验文件；未发布 npm 包。
详细试用步骤见仓库内 docs/TRY-IT.md。更新前请导出备份；需要回退时请按试用说明保留升级前完整状态文件。
典型用法¶
README 给出的跨区示例可复现如下。
- 打开任意资料夹，在下方交接区域展开工作区 A、B，分别勾选讨论后生成一个包。
- 若合计超过 30,000 字符限制，按界面提示选择压缩 B 的某段讨论。
- 将交接目标设为工作区 C，点击「带入新会话草稿」，检查后再发送。
- 若 C 已有空白会话，DSH 会复用并追加草稿。
- 交接选择不会自动新增资料夹关联。
资料夹日常用法：关联会话、写下一步便签、标记当前任务；需要换机器或留档时用 JSON 备份导出，在新环境预览后导入（同一备份不会重复导入）。
适用场景与注意¶
适合谁： 在同一 DSH 环境内管理多个工作区任务、需要把多段会话合成交接包并控制长度、希望原会话保持不动只通过引用和草稿续作的使用者。
环境与验证边界： README 写明已在隔离 Web 运行时与 Edge 中验证界面和本地精简；AI 适配使用模拟流测试，未验证真实模型质量、费用和日常桌面插件组合。插件以当前 DSH 进程权限运行，安装前应阅读源码与 MIT 许可证，并知悉备份可能含会话标题与标识。
未实现与承诺范围： 文件引用、消息收藏、整份资料夹 Markdown 导出、跨机器映射尚未实现（交接包可以下载）。历史设计 v0.2 中的完整功能和容量目标不是当前包的承诺。
持久性： 原子写入和文件锁复用官方工具；坏文件不会被自动清空；官方写入工具没有 fsync，本版不提供断电持久性保证。
结尾¶
DSH Task Shelf 1 把任务资料夹、跨区会话引用和交接包压缩收进一个社区试用插件，强调原会话不动、草稿不自动发送，以及本地精简与可选 AI 摘要的分工。若要试用或查版本信息，可看社区目录页 https://www.skillhub.cn/plugins/xin505/dsh-task-shelf 与 GitHub 仓库 https://github.com/xin505/dsh-task-shelf。
