DeepSeek 会话导入:消息树与 1000 条上限
DeepSeek 官方会话导入插件文档披露:官网导出的消息树要压成线性事件日志,一次最多1000个会话、压缩包512MiB、单条目256MiB,导入期间整包驻留内存。附Token与缓存代价。
2026-11-14 13:31:10 · 主编:刘立永DeepSeek 官方插件文档写明:把官网导出的历史会话搬进工作区,要过三道数值闸门——一次最多 1000 个会话、单个压缩包 512 MiB、单个条目解压后 256 MiB,且导入期间整个压缩包留在内存中。这是 11 月 13 日 rc.3 新增实验性插件的默认配置值,属官方文档披露,不是生产实测。
消息树要压成线性事件日志
官网导出的每个会话靠 parent_id 连成一棵树,重新生成、编辑提问都会分叉;而 dsh 的会话是线性追加的事件日志。插件按 current_message_id 指定的消息结尾选中一条分支,其余分支丢弃。转换由 selectBranch 与 convertConversation 两个纯函数完成,把消息树变成种子事件;每个会话写入前都要经 Session.create 做与实时会话相同的种子校验,单个失败就跳过,不影响其他会话。
导入采用两遍流式扫描:第一遍在任何会话被解析之前,先把选中会话的图片存下来;第二遍在会话到达时逐个转换写入。压缩包条目顺序因此不影响结果。这套设计把「格式翻译」和「落库」拆开,是插件里最值得看的一段工程处理。
三道闸门与 owner 权限
配置项里,maxSessions 默认 1000,按导出索引的 updated_at 取最新的那些;maxUploadBytes 为 536870912 字节即 512 MiB;maxEntryBytes 为 268435456 字节即 256 MiB;maxTitleBytes 为 80,标题按 UTF-8 字节截断。插件随包附带但默认关闭,要在插件页「更多」的实验性插件里手动打开;上传路由只接受工作区 owner,limits 会拒绝其他所有主体,共享访客连按钮都看不到。同一文件导入两次会生成两份会话副本,官方没有做去重。
被内容过滤撤回的问答整段略去,只有这一个 turn 的会话不导入;PDF、文档等非图片文件以及未成功保存的图片只留一张文件卡片,卡片不能打开、模型按路径也读不到内容。导入的会话保留原标题、时间与思考,但网页抓取结果只剩标题和网址。
历史不是免费的:Token 与缓存
官方在「模型体验」一节写得很直白:导入本身不发模型请求,但用户在这条会话里继续对话时,恢复后的首个请求会发送全部导入历史,导入的思考按无签名 thinking 发送、增加该请求的输入 token,图片只在支持图片的路由上发送,其他路由替换为通用省略说明。更关键的是,恢复后的首个请求没有可复用的缓存前缀,此后的请求才像普通会话一样在此基础上延伸。官方给的是定性说明,没有给 token 数字,不能当作成本实测。
官方自己列了七条已知限制
包括:整包驻留内存;流式扫描用同步解压,声明很小却高压缩比的条目可以让宿主长时间忙于解压;重复检测只覆盖中央目录,改第二个本地文件头可绕过;压缩包中途损坏会部分写入且失败应答不列出已写入的会话;read 最多返回条目声明大小、超出即截断;只针对 2026-11-12 的导出结构,更旧的 v3 压缩包能导但不是支持目标;只接受 ZIP,不接受解压后的目录。这些是官方主动披露的待办项,不是外部挑刺。
给中小企业的三条建议
第一,把历史会话当一次数据迁移项目来做。我们给客户做财务软件与 ERP 换版时,流程都是先抽样导一批、核对字段与附件、确认可回退,再全量切;Agent 会话导入同样适用于这套验收办法,先挑一个小的导出包,看图片是否变成附件、非图片文件是不是只剩卡片。第二,先算上下文成本再谈效率,导入的长历史会在恢复后首个请求整段进入上下文,且没有缓存前缀,历史越久越不划算,重要结论建议整理成短文档而不是整包搬运。第三,导入权限按 owner 收敛,共享工作区别开放给普通成员,导入前备份源 ZIP,实验性插件的接口与格式按官方口径随时可能变。
参考来源:
• DeepSeek 官方 deepseek-chat-import 插件中文 README,2026-11-14 核验:https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/experimental/deepseek-chat-import/README.zh.md
• DeepSeek 官方插件设计细节 DETAIL.zh.md,2026-11-14 核验:https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/experimental/deepseek-chat-import/docs/DETAIL.zh.md
• DeepSeek 官方 GitHub Release dsh-v0.2.2-rc.3,2026-11-13:https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.2-rc.3
• 今日头条《DeepSeek Harness 发布新版 v0.2.2-rc.3》技术解读,2026-11-13:https://www.toutiao.com/a7707633967431762475