会话搬运工 mswinandmc/dsh-session-port

dsh-session-port · 会话导入导出

DeepSeek Harness 插件：把会话导出成 ZIP 压缩包（含附件），或把导出的会话导入成新会话继续用。
压缩包结构与 DSH 自带的「下载会话日志」导出逐字节兼容。

把 DSH 的会话导出成压缩包带在身边，或把导出的会话导入成新会话继续用。
附件（截图、文件）随会话一起搬运。

安装

已发布到 npm 与 GitHub。安装方式取决于部署形态：

桌面版（DeepSeek Harness Desktop）——图形界面

桌面版不提供 dsh 命令行，插件在设置里安装：

1. 打开「设置 → 插件」，在插件列表或插件市场里找到 dsh-session-port 并安装（bundle 名同为 dsh-session-port；已收录到 dshmarket 后可直接在市场里搜到）；
2. 安装后重启桌面版应用（或刷新已打开的页面）。

Web / CLI 部署——命令行

自建 dsh web、CLI 或其它非桌面部署才有 dsh 命令；--profile 换成实际 profile 名（常见 web）。桌面版用户请用上面的图形界面方式，这一段不适用。

从 npm 安装（官方源；会自动写进 profile 的 bundles 列表）
dsh plugin --profile web add dsh-session-port

没装 dsh CLI 时用完整包名（npm 上那个 dsh 是同名旧包，不能用）
npx @deepseek-ai/dsh plugin --profile web add dsh-session-port

从 GitHub 仓库安装
dsh plugin --profile web add github:mswinandmc/dsh-session-port

从本地打包安装（在仓库目录 npm pack 后，把生成的 .tgz 装进 profile）
npm pack
dsh plugin --profile web add '<repo>/dsh-session-port-<version>.tgz'

装好后用这些命令查看/升级/卸载：

dsh plugin --profile web list --depth 0 # 确认 dsh-session-port 在列表里
dsh plugin --profile web update dsh-session-port # 升级到 npm 最新版
dsh plugin --profile web remove dsh-session-port # 卸载

装好后重启 dsh 服务（或刷新已打开的页面），标题栏右侧出现导出按钮、侧边栏底部出现导入按钮。

用起来

首次安装后需要刷新一次页面（F5 / Ctrl+R），页面才会加载插件的浏览器半边。

| 想做的事 | 操作 |
| 导出正在看的会话 | 打开会话 → 标题栏右侧的「导出」图标（↓）→ 浏览器下载 <标题>-<会话 id>.zip |
| 导入一个会话 | 左侧栏底部的「导入会话」图标（↑）→ 选择 .zip 或 .jsonl → 自动导入并打开新会话 |

导入的会话：

- 新建，绝不覆盖或删除已有会话；
- 落在当前会话所在的工作区（空闲时落在最近的工作区）；
- 从原会话继承标题、完整对话与工具历史、模型/预设（预设在本机不存在时自动退回默认）；
- 日志里指向原会话的内部标记（投递水位等）会自动改写成新会话，否则 DSH 会拒绝加载该会话的历史；
- 子会话（subagents/）不随导入恢复，导入的是主会话本身。

也可以用自然语言让本鲸帮忙，例如「把当前会话导出到 D 盘备份」——插件注册了 session_port 工具。

文件格式

导出格式与 DSH 自带的「下载会话日志」完全一致，两种来源的压缩包都能互相导入：

<标题>-<会话 id>.zip ├── session.v4.jsonl # 第一行会话头，随后每行一条会话事件 ├── media/<attachmentId>.<ext> # 会话引用的图片 └── files/<前缀>/<摘要>/<文件名> # 会话引用的文件

会话日志（.jsonl）本身就是合法的导入输入，便于人工检查或跨版本处理。

边界与已知限制

- 导入要求格式版本一致：v4 的压缩包导入当前 DSH；跨大版本请先用对应版本 DSH 打开再重新导出。
- 单次导入默认上限 512 MiB，可在插件配置里用 maxImportBytes 调整。
- 导入只恢复主会话；子会话、会话收藏/置顶/归档等列表状态不迁移。
- 会话的 cwd 以当前工作区为准；原目录在本机不存在时不会被记录。

配置（cordis.patch.yml 的插件行）

- id: session-port
name: dsh-session-port
config:
maxImportBytes: 536870912 # 单次导入上限，默认 512 MiB includeAttachments: true # 导出时是否打包附件 sessionFormatVersion: 4 # 仅在会话库为空、无法自动探测时使用 exportDirectory: '' # agent 工具导出目录，默认 <DSH_HOME>/session-port/exports

实现

- 宿主端 index.js：/session-port/{info,export,import} 认证路由 + session_port 工具；两个入口调用 lib/host.js 里的同一组实现，所以格式与失败语义不会分叉。
- lib/host.js：导出走 sessionQuery.readSession（与自带导出同一份已校验视图），导入通过 sessionPersistence.create → append → flush → close 落盘，再挂到工作区。
- lib/format.js：纯函数（JSONL 序列化/解析、附件引用收集与改写、文件名清洗），有单测。
- lib/zip.js：无依赖 ZIP 读写（基于 node:zlib），有单测。
- client.js：客户端半边，不依赖 @deepseek-ai/* 运行时，只用 react 与宿主主题变量。

验证

cd dsh-session-port
node --test test/format.test.mjs # 13 项：JSONL 序列化/解析、附件引用、投递标记、文件名
node --test test/host.test.mjs # 19 项：导出→导入往返、真实 zip 工具产物、投递标记改写、失败路径
node --test test/client.test.mjs # 6 项：浏览器半边注册与渲染路径（无浏览器沙箱）
node --test test/zip.test.mjs # 34 项：ZIP 读写、data descriptor 流式 zip、损坏输入

已在本机完成的端到端验证：

- 用插件工具导出当前会话（948 条事件）→ 独立 Python zipfile 校验压缩包结构、JSONL 头与事件连续性；
- 用插件工具把该压缩包导入回当前工作区 → 新会话落盘（sessions/--D-hyw--/<新 id>/session.v4.jsonl.zstd，948 条事件、序号连续），并自动加入 D:\hyw 工作区的会话列表；
- 浏览器路由已注册并通过 Connection 信任栅栏（未认证请求全部 401）；
- 界面按钮的渲染与点击需刷新页面后点击验证（本会话无浏览器控制能力，未做视觉验收）。