DSH Conversation Bridge
把 DeepSeek 网页版的对话记录导入 DeepSeek Harness,重建上下文,建立本地历史检索库,然后从选定分支的末尾继续聊。
导入 JSON → 核对分支与模型 → 本地预演 → 确认重建 → 打开接续会话
v0.2.0 · 实验版,向量模型已内置。 下载完整版。暂未发布 npm 包。
目前只在 Windows/DSH 0.2.1-rc.3/会话格式 V4 上验证。其他宿主版本会停止导入,等待兼容性验证。
先说清楚:它做什么,不做什么
这个插件负责“搬运”和“接续”:把网页端的原始记录带进 DSH,按 DSH 的规则重新组织上下文,再为这段历史配一个独立的检索库。
它不负责复原网页端没有公开的东西。人物的语气、情感连续性、当时实际送入模型的窗口,以及服务端的内部状态,都不在迁移范围内;导入后也不保证得到和网页端相同的回答。
这个项目源于一次尝试:把一段长对话搬到本地。历史、上下文和检索都接上了,但那种熟悉的相处感没有稳定延续。于是把过程中可复用的工程成果整理成了这个通用插件。
所以它提供的是记录迁移与接续,不承诺还原人格或完整运行状态。如果想更接近原体验,可能需要官方提供上下文、隐藏摘要、模型配置或会话状态的导出与恢复机制。目前没有证据表明缺失的 KV cache 是原因:KV cache 通常只是复用已处理 token 的计算结果,并不是一份独立的人格存档。参见 Transformers 缓存说明 与 DeepSeek 缓存说明。
四个核心能力
| 能力 | 你会得到什么 |
|---|---|
| 导入网页版 JSON | 读取 DeepSeek 官方导出,保留角色、顺序、时间、源节点和附件元数据;选哪条分支由你核对决定 |
| 滚动重建上下文 | 从第一条历史开始顺序回放,只有达到 DSH 原生有效阈值时才调用原生压缩引擎 |
| 自动建立记忆库 | 为每个导入会话建立独立的原文库、全文索引和本地向量索引;新聊天自动增量入库 |
| 创建接续会话 | 通过 DSH 接口写入并校验原生会话,准备完成后打开;第一条新消息由你发送 |
整个流程以上下文为主,RAG 检索只是按需查阅旧细节的辅助。插件不会添加人物设定、交流样例或自定义聊天系统提示词,也不会默认做付费事实提炼。宿主的运行上下文、时间、权限和审批机制照常生效。
安装与开始使用
前置条件
- Windows 版 DeepSeek Harness 0.2.1-rc.3,使用 V4 会话格式。
- 已配置一个可用模型,并在原生页面打开过对应会话,作为设置来源。空白会话即可,不需要先发一条付费测试消息。
- 安装包或完整插件目录里带有原发布方的多语言 MiniLM ONNX 模型(5 个文件,约 122 MiB 未压缩),不需要单独下载模型、配置模型路径或申请向量服务 API 密钥。首次导入时会把模型复制到缓存并逐文件校验 SHA-256,不访问 Hugging Face。
安装只需要 Windows 版 Harness 和安装包或完整插件目录;用于聊天和摘要的对话模型、设置来源可以在第一次导入前再准备。
这里的“离线”只指模型准备和本地索引。首次安装时,包管理器仍可能联网获取插件依赖;聊天和滚动摘要仍使用你配置的模型服务。
安装
有两种方式:
- 方式 A:DSH 界面安装:最方便,但要求你已经有本仓库的
plugin目录,并且依赖和模型都齐全。 - 方式 B:Release 包安装:适合普通用户、新机器,或者没有本仓库依赖目录的情况。
方式 A:DSH 界面安装(本仓库目录)
如果你已经把仓库下载到本地,并且 plugin\node_modules 和 plugin\models\multilingual-minilm 都存在,可以直接在 DSH 里选这个目录:
<仓库目录>\plugin
例如:
E:\DeepSeek Harness\DSH-Conversation-Bridge\plugin
- 打开 DSH 的插件管理/设置,点击 “添加插件”。
- 把上面的目录路径粘贴到输入框。路径有空格时,加英文引号也可以。
- 点 “安装”。
- 如果侧边栏没有出现 “导入网页对话”,重启 Harness。
如果插件列表里已经有旧版(例如 0.1.0),先卸载旧版再装。这个弹窗对第三方插件通常不提供原地升级;卸载不会删除
conversation-bridge数据目录。
注意:这是本地链接安装,不是复制。
- DSH 会把所选目录以
link:方式挂进 profile,不会额外安装这个目录的 npm 依赖。所以目录里必须有node_modules;如果缺依赖,改用方式 B。 - Release 包解压后的目录没有
node_modules,不要直接拿来走方式 A。 - 安装后不要移动、改名、删除或清理这个目录,否则插件会失效。
- 本地目录插件没有“更新”提示;换版本时先卸载,再选新目录。
方式 B:Release 包安装(普通用户推荐)
如果你没有本仓库的完整开发目录,或者只想安装固定发布版,用这种方式。Release 包会由 pnpm 安装依赖,并带上模型。
- 从上方 Release 下载
dsh-conversation-bridge-0.2.0.tgz(约 73 MiB)。 - 完全退出 Harness:关闭所有窗口,并在任务管理器确认
DeepSeek Harness.exe已结束。 - 打开 PowerShell,进入
.tgz所在目录。 - 执行安装:
dsh plugin --profile desktop add .\dsh-conversation-bridge-0.2.0.tgz --ignore-scripts
如果提示找不到 dsh,改用 Harness 自带的 CLI:
& "<Harness 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add .\dsh-conversation-bridge-0.2.0.tgz --ignore-scripts
把 <Harness 安装目录> 换成 DeepSeek Harness.exe 所在目录,例如 E:\DeepSeek Harness。
- 重新打开 Harness。侧边栏出现 “导入网页对话” 即安装完成。
说明:
--ignore-scripts是本插件要求的参数,不要省略。- 安装阶段通常需要联网解析 JavaScript 依赖;模型文件已经在 tgz 里,不会访问 Hugging Face。
- 第一次安装可能需要几分钟,等待命令结束。
- 不需要管理员权限。
安装失败时
- 方式 A 提示路径不存在 / 不是目录:确认选的是
plugin目录,不是仓库根目录。 - 方式 A 装完加载失败:多半是目录里缺
node_modules,改用方式 B。 - 方式 B 提示找不到
.tgz:先Get-ChildItem *.tgz确认文件名,再cd到文件所在目录。 - 装完没有入口:重启 Harness;仍没有就确认安装目录里有
package.json、client/,并确认 DSH 是 0.2.1-rc.3。 - 首次导入提示模型缺失:确认
models/multilingual-minilm下有 5 个模型文件;缺了就用方式 B 重装。 - 安装时报依赖或网络错误:检查网络、代理或安装源后重试。
卸载
在插件列表里移除,或执行:
dsh plugin --profile desktop remove dsh-conversation-bridge
卸载不会删除 conversation-bridge 数据目录,重新安装后还能继续用。
导入并继续
- 选择 DeepSeek 官方导出的完整 conversation JSON。
- 选择对话和分支末节点,核对末尾原文。不要默认把最长分支当成当前分支。
- 选择已登记的工作区,以及一个已配置模型的原生会话作为设置来源。没有可选来源时,先在原生聊天页选好模型并打开会话,再回到导入页。
- 运行本地预演,核对模型、阈值、消息数和附件状态。缺失的附件可以在确认前补入本体。
- 确认准备。页面会显示上下文重建、摘要次数、用量和索引进度;任务支持暂停、继续和失败重试。
- 原生会话写入并读回、上下文重建和索引核验都通过后,打开接续会话,发送你的第一条新消息。
同一个确认请求重复提交也不会重复创建会话;再次主动导入同一文件,则可以创建独立的新会话。首版不提供网页登录令牌,也不支持在线下载缺失的附件。
上下文怎样重建
先预演,再确认
本地预演会读取所选模型和宿主的压缩配置,固定模型路由、窗口、输出预留、工具声明和压缩策略,并标出预计首次达到阈值的位置。
预演不调用模型,也不生成内容。token 数不精确时会标注为估算。首次摘要尚未生成时,不预测后续压缩次数或最终窗口大小;更换模型或相关配置后,需要重新预演。
未到阈值保留原文,达到阈值顺序压缩
- 未达到有效阈值:完整保留所选分支,不调用模型摘要。
- 达到有效阈值:使用 DSH 原生计量器、选区和默认摘要,按“已有摘要 + 保留原话 + 后续原文”继续推进。
- 每次摘要只能看到当时的历史前缀,不读取后来的消息、末尾总结或未来的检索资料。
- 历史助手回答直接采用原文,历史工具操作不会重新执行。
- 成功摘要和检查点会持久保存,恢复时复用;调用结果不明确时暂停,明确重试可能重新计费。
阈值依据当前上下文压力判断,不按累计账单 token 触发。原始记录独立保存,压缩不会覆盖原文库。
重建结果称为**“按 Harness 规则重建的上下文”**。它不等同于网页端当时实际送入模型的窗口,也不宣称恢复了网页端未公开的处理流程。
记忆与两种对话模式
每个接续会话都有自己的检索库。检索结果会带上角色、时间和来源节点;旧记录不构成新的执行授权,也不会自动成为当前事实。
- 对话 · RAG:默认模式,只向模型声明只读的
memory_search工具。 - 工程模式:恢复原生工程工具及其权限、审批机制。
普通聊天不会固定地逐轮预检索,而是由模型结合当前上下文决定是否调用记忆工具;页面上的手动搜索同样可用。默认最多等待检索 3 秒,返回内容最多 6,000 字符。切换模式前,请等当前回复和工具执行结束。
新消息会先保存原话,再增量建立索引。向量索引暂时不可用时,检索会明确降级为全文搜索,聊天原文仍然保留。插件也不会自动总结你的说话风格或人物设定。
费用与额度
本地解析、预演和向量计算都在本机完成,不调用聊天模型,也不产生 API 费用。超过阈值后的摘要,以及后续聊天,使用你在 DSH 中配置的模型服务,可能产生费用;相应的历史内容会作为必要上下文发送给该服务。
导入准备的默认每日摘要额度为 200 万输入/20 万输出 token,可以在页面调整。这个额度只约束本插件的导入摘要;主动聊天和会话就绪后的宿主压缩由 DSH 单独管理。
任务控制里可以暂停、取消、继续或重试。未知的模型调用结果会先暂停等待检查;明确重试可能再次计费。模型准备消耗的是本地磁盘和算力,不产生模型下载流量或向量服务 API 费用。
数据、缓存与移除
默认数据目录:
$DSH_HOME/conversation-bridge
未设置 DSH_HOME 时为 ~/.dsh/conversation-bridge。目录主要包含:
registry.sqlite:登记信息imports/:导入原件archives/:归档conversations/:每个接续会话的原文、来源、检查点和索引models/:本地向量模型缓存exports/:导出文件
可以在 任务与设置 → 存储位置 配置 dataDir 和 modelCache,优先使用官方配置编辑器。更改位置不会自动搬迁已有数据;如果 DSH 无法在线重载配置,页面会提示正常重启后生效。方式 A 安装后不要移动所选插件目录;方式 B 不受影响。数据不会写进插件目录。
宿主凭据与原生会话仍由 Harness 管理。用户数据、运行缓存和本地备份不会进入 Git 或安装包;模型权重只随 Release 完整版分发,不提交 Git,也不进入源码 ZIP。
从 v0.1.0 升级时会检查模型指纹,把新旧向量隔开,并在后台重建旧向量,同时保留原文、修正和停用记录。重建期间可以使用全文检索,也不会因此重新调用聊天模型来压缩历史。
“移除会话及记忆” 会通过官方接口归档隐藏宿主会话,并清理插件派生的记忆、快照和任务,不自动备份。导入原件、共享附件、工作区文件和既有手动备份都会保留。这个操作不等同于物理删除宿主原生日志。
卸载插件同样保留私人数据。需要迁移或手动备份数据目录时,请先正常退出 DSH。
验证范围与已知限制
- 16 项合成单元测试覆盖导入、隔离和模型准备;合成历史跨越 10 个压缩点,摘要请求和触发次数都与同配置的原生引擎一致。
- 对实际解包后的安装包,用全新缓存做了离线准备测试:禁用网络后,仍能复制、校验、生成 384 维向量,并完成合成中文内容的 Top-1 召回。
- 原生 V4 持久化回读、检查点恢复、模式切换、会话检索隔离,以及向量计算后的原生图片保存,均已通过自动检查。
- 自动检查使用合成数据和模拟模型响应,没有真实模型调用,也没有重建私人历史。
- 桌面端已验证入口、文件选择、上传和分支解析;最终确认与打开会话仍需人工验收。API 自动检查不能替代完整 GUI 验收。
- DSH 自带的摘要模板偏英文工程检查点,本插件保留该模板;它可能不适合所有日常交流场景。
- 首版只支持 DeepSeek 官方网页版 JSON,其他格式预留了适配接口;不保证导入后与网页端产生相同回答。
开发与构建
源码在 plugin/,合成测试在 tests/,构建安装工具在 tools/。
使用已安装 Harness 的运行时准备依赖、执行验收并打包:
.\tools\Prepare.ps1 -HarnessRoot "<Harness 安装目录>"
.\tools\Build.ps1 -HarnessRoot "<Harness 安装目录>"
开发脚本会从 PATH 和标准安装位置定位 npm;自定义布局可以通过 -NpmCli 指定 npm-cli.js 的路径。产物写入 dist/,包括安装包和通用源码包。
Prepare.ps1 是开发者构建步骤,会从固定的原发布方地址下载模型到忽略提交的 plugin/models/;Build.ps1 会把它们纳入完整版并校验哈希。安装 Release 完整版的用户不需要执行这些脚本。
GitHub CI 只使用 Windows/Node 24 运行合成单元测试,不能替代原生集成验收。
模型出处、许可证和逐文件来源见 模型说明,接口说明见 接口与结构。
与已有插件的关系
deepseek-web-import 已支持网页历史导入与接续,附件增强版 补齐了图片和文档;dsh-chat-import 则覆盖多种外部工具的会话迁移、导出和同步。
本项目侧重 DeepSeek 官方本地 JSON、明确的分支选择、按原生阈值滚动重建、独立历史检索库,以及可恢复的准备流程,不宣称是首个对话导入插件。
来源、致谢与许可
这个项目建立在已有开源工作的基础上。以下区分当前依赖和早期原型的使用经历,不把上游能力算作本项目原创。
当前使用
| 项目 | 用途 | 许可说明 |
|---|---|---|
| DeepSeek Harness | 宿主 SDK、原生会话、计量和压缩引擎 | MIT;运行时调用,不随插件重新分发宿主代码 |
| Transformers.js | 本地向量推理,直接依赖 4.2.0 | Apache-2.0 |
| ONNX Runtime | 经 Transformers.js 使用的推理运行库 | MIT |
| 多语言 MiniLM 与原发布方 ONNX 导出 | 固定原发布方版本的量化模型,随完整版提供 | Apache-2.0;保留模型卡、许可文本和哈希,仅重命名 ONNX 文件供本地加载,文件内容未改动 |
| Node.js/SQLite | 宿主运行环境与本地存储 | Node.js 主项目为 MIT,SQLite 交付代码为公共领域;均由宿主提供 |
Transformers.js 还会引入 sharp/libvips、protobuf.js 等间接依赖,包含 Apache、MIT、BSD、ISC、LGPL 等许可。各依赖保持原有条款,不能统一改标为本项目的 MIT。版本和包级许可见 依赖锁定清单,模型版本和文件哈希见 模型清单。
早期原型使用过的项目
- wpc0323/deepseek-web-import:提供网页历史导入原生 DSH 会话的实现,MIT。
- LingSuiYA/deepseek-web-import-f:在上游基础上补充图片、附件和导入体验,MIT。原型使用固定提交
a2503ae95b1813e2386f34f9c9054f440ffe7833。 - MemTensor/MemOS 与 DSH 兼容分支:原型曾使用独立记忆核心,固定兼容分支提交
0596259934ee9fb9349d411ccd6959faea93784b。上游核心为 Apache-2.0;兼容分支说明其自身修改为 MIT,不能把整个来源统称为 MIT。 - Xenova ONNX 转换模型:v0.1.0 使用过,转换页未单独标明许可。v0.2.0 已改用原发布方明确标注许可的 ONNX 文件,不把旧版的许可疑点带入当前内置模型。
当前通用版已移除上述原型的网页下载模块和 MemOS 依赖,但保留这段来源记录与致谢。本项目的主要工作是导入编排、顺序重建、检查点恢复、会话隔离和操作界面。
本项目自身代码使用 MIT 许可证,内置模型仍按 Apache-2.0 授权,其他第三方组件遵循各自条款。第三方说明、NOTICE 和 plugin/notices/ 记录了用途、来源、历史署名,以及构建环境中可取得的许可文本;包级元数据扫描不等于所有组件的完整许可认证。项目与 DeepSeek 官方及上述作者没有隶属或背书关系。
文档与反馈
报告问题时,请提供宿主版本、错误信息和可复现步骤,尽量使用合成对话。请勿在公开反馈中上传私人聊天、API 密钥或网页登录令牌。
No comments yet. Be the first to write one.