前言¶
DeepSeek Harness(DSH)采用插件化架构,支持扩展功能。在开发智能体或进行长期对话管理时,常需要将 DeepSeek 网页版的历史会话作为上下文引入 DSH。dsh-importer 插件解决了这一同步问题,它将网页版会话同步到本地,供 DSH 的文件读取工具调用。
插件简介¶
该插件将 chat.deepseek.com(DeepSeek 网页版)的会话同步到 DeepSeek Harness(DSH),作为 AI 上下文使用。插件由 PrismScopes 维护,遵循 MIT 许可证。
核心功能¶
- 自动同步:首次配置 token 后自动触发官方全量导出,导入会话清单(含真实消息数);之后按设定间隔(2/5/10 分钟)自动检查新会话并拉取内容。
- 已拉取会话自动刷新:远端有更新的已拉取会话会自动重新拉取,本地内容保持新鲜。
- 设置页:DSH 设置中新增”网页版同步”分节,包含三个子页面:
- 会话列表:支持搜索、排序(最近活动、标题、消息数)、分页、按需拉取、行内查看(含思考过程)。
- 本地会话:已拉取内容的会话,支持”发送”(把引用本地文件的提示词填入输入框,AI 自行读取文件)、查看、删除。
- 设置:token 管理、自动同步开关与间隔、获取 token 帮助、操作记录。
- 安全:token 接口校验 Origin,只接受
chat.deepseek.com与本机来源;token 只存节点侧。
安装与启用¶
在 DSH web profile 中安装(本地路径方式):
dsh plugin --profile web add link:C://path//to//dsh-importer
或在 H:\dsh-data\profiles\web\package.json 的 dependencies 加入:
"dsh-importer": "link:C://path//to//dsh-importer"
然后重启 DSH。设置页出现”网页版同步”即安装成功。
典型用法¶
- 打开 DSH 设置 → 网页版同步 → 设置,粘贴 token(获取方法见设置页帮助)。
- 保存后自动开始全量初始化,等待完成。
- 之后会话自动同步;在”本地会话”中点某会话行的”发送”,提示词(引用
dsweb-sessions-<id>.文件路径)会填入输入框,确认后发送,AI 通过文件读取工具直接读取完整会话内容。
适用场景与注意事项¶
- 数据文件:位于
$DSH_HOME/dsh-importer/(默认~/.dsh/dsh-importer/),包括dsweb-token.json、dsweb-config.json、dsweb-index.json和dsweb-sessions-<id>.json。 - 数据迁移:旧动态插件受 fs 沙箱限制把数据落在 DSH 程序目录,固化后改为 node 原生 fs 直写。升级后若旧目录仍有数据,需手动移入新目录。
- 开发说明:纯 JS 双面插件。Host half 使用 subprocess + curl(带浏览器头绕过风控),数据落盘用 node 原生 fs/promises 直写,Client half 为惰性 CJS bundle。
总结¶
该插件提供了从网页版同步到本地文件,并支持一键引用的能力。通过将网页会话转化为本地文件,配合 DSH 的文件读取工具,实现了无缝的上下文衔接。