DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

DSHift

D

DSHift

Manifest valid

A ChatGPT-like chat layer for DeepSeek Harness with seamless Chat/Agent handoff and cross-platform memory migration.

UI (client)hasBundlePatch

DSHift

在 DeepSeek Harness 中提供 ChatGPT 式的 Chat 界面,可与原生 Agent 模式随时切换,并支持从 ChatGPT / Claude / Gemini 迁移长期记忆。

dsh plugin add github:SamuelChung2010/DSHift

DSHift 演示:Agent / Chat 模式切换、交给 Agent、长期记忆与聊天记录导入

原生 DSHDSHift
仅 Agent 模式Chat + Agent 双模式
无独立 Chat 界面独立 Chat 历史、输入框与搜索
不支持跨平台记忆迁移从 ChatGPT / Claude / Gemini 导入长期记忆
上下文需手动搬运Chat 对话整理成任务,交给 Agent 工作区

dsh-chat(DSH 插件)

dsh-chat 在 DeepSeek Harness 中加入一个原生的 DeepSeek Chat 模式,与原生的 Agent 模式并列,通过顶部的 Chat | Agent 分段控件随时切换。Chat 使用 DeepSeek 官方面向应用开放的 API 能力,界面参考 DeepSeek App / ChatGPT 桌面版

v0.2.0 Beta 更新

本版本在 0.1.0 Beta 的基础上完成三项功能,并打通「导入 → 记忆」联动:

  • 聊天记录导入:读取 DeepSeek App / 网页版导出的官方 ZIP,在本机解析、预览并选择会话导入。消息、思考过程、搜索步骤、引用来源、分支版本与可恢复图片都会转换到 Chat 历史;重复导入不会产生重复会话,导入的会话可以搜索、管理并继续聊天。
  • 长期记忆:可选的跨会话记忆,支持自动记忆提取、按问题相关度检索、Memory Summary、Ask or Update、手动增删改、从 ChatGPT / Claude / Gemini 导入已有记忆,以及记忆总开关与隐私控制。记忆保存在本机 memory.json,与聊天记录分开。
  • 原生界面收尾:输入框、+ 菜单和模型座统一到 Harness 原生风格。+ 是贴近输入框、近乎等宽的大圆角浮层,左侧图标与名称、右侧简短说明;模型与推理等级合并在同一个双层菜单中;+ 与发送按钮保持圆形,联网搜索与深度思考仍是独立按钮。
  • 导入后提取记忆:导入完成页可选择部分导入会话分析长期记忆;默认不勾选、不调用模型,确认费用提示后才逐个分析,候选记忆先预览再合并。已分析的会话会标记并默认跳过,提取失败不影响已导入的聊天。

Beta 2 修复

  • Windows 主面板对齐:Chat 主内容区左上角改用框架同款 --dsh-windows-content-radius(16px)圆角,并按原生中间列的方式裁切内容、由侧栏底色填充缺口;Windows 下同时去掉 Chat 侧栏右边线,与原生 Windows 布局一致(原先的细线会笔直穿过圆角缺口)。
  • macOS 顶栏与侧栏:Chat | Agent 切换器改为按当前模式的主内容列居中;Chat 打开时隐藏被遮住的原生侧栏开关;侧栏底色、分隔线与抽屉遮罩对齐原生。
  • macOS 拖拽区与可读性:Chat 侧栏品牌行退出 -webkit-app-region: drag,盖在原生拖拽行上的控件仍可点击;对话框主按钮与开关改用原生强调色 token,深色模式不再白底白字;发送快捷键提示在 macOS 显示 Command + Enter。

升级说明:

  • 聊天历史格式保持 v2 兼容,无需迁移;长期记忆新增 $DSH_HOME/deepseek-chat/memory.json。
  • Host 端改动需要重启 DSH 或重载插件后生效;浏览器端首次可能提示刷新插件。
  • Beta 2 只包含界面修复,无数据格式变化;从 Beta 1 升级无需迁移。
  • 本版本仍为 beta;安装包、校验和与验证记录见 GitHub Release v0.2.0-beta.2。

打开方式

应用顶部(Windows 标题栏 / macOS 顶栏)居中是共享的 Chat | Agent 分段控件:

  • Chat:显示本插件的对话界面(独立历史、独立输入框)。
  • Agent:显示 Harness 原生 Agent 界面。

两种模式各自的会话、工作区和未发送的输入都会保留;切换不会清空任何一边。

显示规则(与 ChatGPT 桌面版一致)

  • 只在新建的空白页面显示:Chat 里还没有消息的新对话,或 Agent 里没有会话 / 仍是空白会话的页面。
  • 开始发送第一条消息(无需等 AI 回答)或进入已有会话后自动隐藏;切换到其它已有会话保持隐藏。
  • 点 Chat 的「新对话」或 Agent 的「新会话」回到空白页时,切换器再次出现。
  • 空白判断不使用 DOM:Agent 侧读取 Harness 原生会话列表(ctx.sessions.list 的 blank / running,以及是否有会话被主视图持有),Chat 侧读取消息模型与会话摘要(加载中的会话按摘要的消息数判断,避免闪烁)。
  • 隐藏时不渲染任何元素(外壳是 display: contents),不会留下透明遮挡层,底层按钮可正常点击。

这个切换器是一个不对称分段控件(参考 ChatGPT 桌面版):一条深色圆角底座里只有选中项拥有独立的圆角浮起背景,选中项占约 55% 宽度、未选中项约 45%,切换时浮起背景滑动并改变宽度,底座总宽与中心保持不变。

定位按实际布局计算,而不是窗口坐标:

  • 水平:居中于当前模式的主内容列。Agent 模式测量框架中间列的会话头部(它随原生侧栏、右侧面板和响应式抽屉一起变化,Windows 与 macOS 共用同一套逻辑);Chat 模式测量自己的 .dsc-main 列宽(ResizeObserver)。侧栏宽度变化后切换器自动重新居中。
  • 垂直:对齐 Agent 页面右上角原生工具按钮(header utilities / corner)的中心线。默认值来自原生头部的几何(caption 顶部 + 10px 内边距 + 30px 标题行的一半),运行时再用 header 发布的 [data-conversation-header-corner] 锚点校正,两种模式共用同一条线,切换不会上下跳动。

macOS 原生外观适配:Chat 侧栏复用 Harness 的 sidebar tint / wash 与 0.5px 分隔线,和原生侧栏同材质;Chat 打开时原生侧栏的收起按钮(以及侧栏完全收起时的展开按钮)会让位给 Chat 自己的收起按钮,避免同屏出现两个面板图标;两档发送键文案在 macOS 上显示 Command + Enter。

  • Chat 侧栏宽度由 Chat 自己管理:拖拽右边缘可在 264–420px 之间调整(与原生侧栏拖拽范围一致),窗口过窄时优先保证聊天列可读;宽度写入本机偏好,重启后保留。自动收起断点与框架一致(1024px)。

功能

  • 空白首页只有一条欢迎语和输入框,不再堆叠功能卡片:12 句不同风格的问候按「新建对话」随机轮换(同一页内保持不变,且不会连续重复);带用户名的句子会读取当前 DSH / DeepSeek 账号的显示名称,取不到时自然改用不带称呼的版本
  • 左侧栏与原生 Agent 侧栏同构:顶部是 DeepSeek 官方蓝色鲸鱼 + deepseek 字标,下方依次是新对话、搜索、历史列表与底部设置;右边缘可拖拽调整宽度并记住设置
  • 普通聊天、多轮上下文、流式输出、停止生成
  • 输入框:一个接近 Harness 原生 Agent 输入框的统一圆角容器(28px 面板圆角、原生菜单/输入面材质与描边);编辑器本身没有边框和浏览器焦点方框,聚焦时保持安静、不点亮外层光环;随文本自动增高,超过 220px 后在内部滚动;Enter 发送 / Shift + Enter 换行(可在设置中改为 Ctrl + Enter 发送),中文输入法组合文字时 Enter 只确认候选,不会误发
  • 联网搜索 / 深度思考:输入框下方两个独立的 28px 开关按钮,点击直接启用或关闭,不需要进入「+」菜单;开启时使用柔和强调色,不显示删除图标,位置不随状态变化;模型不支持时按钮禁用并在提示中说明原因
  • 「+」工具菜单:输入框左下的 28px 圆形按钮,点开后向上浮出与输入框几乎等宽的大圆角菜单面板,和输入框只隔 4px;行式布局为左侧图标 + 名称、右侧一行简短说明,当前只包含上传图片或文件,键盘方向键 / Home / End / Escape 可完整操作,空间不足时自动翻到另一侧并限制高度
  • 深度思考:展示可折叠的思考过程与固定用时(刷新、切换会话后不再增长);推理等级与模型一起显示在输入框右侧,在同一个双层菜单中选择 Off / Low / High / Max
  • 联网搜索:使用 DeepSeek 服务端 deepseek_web_search,回答带正文引用编号与折叠的来源列表
  • 模型选择:可在发送前切换 deepseek-flash / deepseek-v4-pro;右侧显示类似原生的 DeepSeek-V4.1-Flash Max,展开后先是「模型 / 推理等级」两行,再进入只有名称的模型列表或只有档位的等级列表,当前项用右侧勾选标记,选择按会话保存;不支持的能力(如 V4 Pro 的图片理解)会禁用并在行内以一行小字说明原因
  • 阅读链接:始终声明 deepseek_read_url,自动阅读用户消息中的链接
  • 文件与图片上传:PDF、Word、PPT 走版面解析;图片直接作为图片输入;文本、代码、表格、电子书走 user_data
  • 会话管理
    • 置顶 / 取消置顶:多个置顶会话集中在「已置顶」区域,按最近活动时间排序;普通会话按活动时间分组排序
    • 文件夹:创建、重命名、删除、折叠/展开(折叠状态持久化)、把一条或多条会话移入文件夹、移出文件夹;删除文件夹只把会话移回未分类,不删除聊天记录
    • 归档:归档会话从普通历史列表隐藏,在「归档管理」中查看、恢复或删除
    • 所有重命名 / 置顶 / 移动 / 归档 / 删除操作集中在右键或「···」菜单;删除会话与删除文件夹都有确认
  • 历史搜索:同时搜索会话标题和消息正文,支持中英文关键词;结果显示会话、正文片段、置顶/归档标记,点击打开会话并定位到匹配消息(老分支也会被重新打开)
  • 长期记忆:可选开启的跨会话记忆,能自动或手动保存用户的长期指令、背景、项目与偏好,在新对话中按问题相关度注入;支持记忆概述、Ask or Update 自然语言增删改查,以及从 ChatGPT / Claude / Gemini 等平台导入已有记忆(详见下文)
  • 编辑用户消息:悬停显示「编辑」「复制」;编辑框沿用消息气泡样式(无嵌套边框),Enter 保存并发送、Shift+Enter 换行、Esc 取消。编辑会创建新的对话分支:原来的回答与后续对话保留为版本,模型只接收当前分支的上下文
  • 回答版本管理:每条回答可复制、重新生成,重新生成产生独立版本(1 / 3 切换);用户消息的编辑版本也可切换回来。每个版本各自保存正文、思考块、引用来源、用量与结束原因
  • 继续生成:用户主动停止、网络中断、超时或 max_tokens 截断的回答,可从已有正文处继续(以 assistant 前缀续写的方式请求,不做无关拼接);只对当前最后一条有正文的回答开放
  • 内容渲染:代码高亮(语言标识、一键复制、长代码内部滚动、明暗两套配色)、LaTeX 公式(行内与独立公式块)、Mermaid 图表(失败时保留源代码)、表格、引用块、超链接与图片
  • 历史记录:会话列表、重命名、删除、本地持久化、会话内搜索
  • 聊天记录导入:把 DeepSeek App / 网页版导出的 ZIP 合并进 Chat 历史,保留标题、时间、思考、搜索来源、分支版本与可恢复的图片;全程在本机解析,不上传导出数据
  • 导入后提取记忆:导入完成后可选分析部分导入会话,先预览候选、确认后才写入长期记忆;默认不分析、只发送勾选的会话,已分析过的会话会标记并默认跳过,提取失败不影响已导入的聊天
  • 交给 Agent:把当前对话整理成可编辑的任务说明,可直接选择或新建 Harness 工作区,然后创建真实的 Agent 会话并把说明作为首条提示,切换到 Agent 继续开发
  • 中英文界面、明暗主题、窗口缩放与移动端布局

输入框与工具菜单

输入框由 Composer 一个组件实现,空白聊天和已有聊天共用:

  • .dsc-composer 是唯一的圆角边框、输入面材质与柔和阴影;.dsc-editor-field 是透明、无边框的文本编辑器。聚焦时不画任何环(连轻微边框变化都移除),只剩原生光标,复刻 Harness 输入区的安静 focus state。
  • 内部结构对齐 Harness:文本区 4px 8px 0 14px,顶部 8px 留白,文本与工具行之间 12px,工具行 2px 8px 6px;+ 为 28px 圆形按钮(原生 selector 填充),发送为 34px 圆形信息蓝按钮(空内容时 40% 透明度),两者都使用 --dsw-* 原生 token。
  • 高度由编辑器内容决定,达到上限后 overflow-y 打开;粘贴长文本只影响内部滚动。
  • 发送键偏好保存在本机(sendKey),设置里有"Enter 发送"和"Ctrl + Enter 发送"两档。
  • 未发送的草稿按会话暂存:切换会话或点「新对话」时恢复各自的文本;附件上传会按原有逻辑中止。
  • 联网搜索和深度思考是固定位置的直接开关;推理等级属于模型座位,不再占用一个单独的触发器。窄窗口下按钮收为图标、工具行允许换行,不产生横向溢出。

工具不是写死在菜单里的按钮,而是一张定义表(client-src/48-tools.js)。surface 决定入口:

registerChatTool({
  id: 'image-generation',
  kind: 'action',                 // 或 "toggle"
  surface: 'menu',                // "menu" = + 浮窗,默认;"composer" = 输入框直接按钮
  icon: 'image',
  labelKey: 'toolImageGen',
  hintKey: 'toolImageGenHint',
  run: () => chatActions.openImageGeneration(),
})

chatMenuTools() 是「+」浮窗的数据源,composerToolDefinitions() 是输入框直接按钮的数据源;没有实现的工具不会注册,也不会出现在任一入口。上传、联网搜索和深度思考分别注册一次,因此菜单里不会重复出现搜索/思考开关。

长期记忆

Chat 设置 → 长期记忆 是一套与会话历史分开的本地记忆系统。记忆默认开启、自动提取默认关闭,两者都可以随时切换:

  • 自动记忆提取(需主动开启):一轮对话结束后,Host 先用本地规则判断这轮是否包含值得长期保存的信息(用户明确要求遵守的指令、语言/格式/工具习惯、长期背景、项目与技术栈、重要决定等),只有通过判断的轮次才会调用一次 DeepSeek 提取;普通闲聊、代码问答和短句不会产生额外请求,并且每个会话有轮次与时间节流。开启前会提示:相关内容会发送到 DeepSeek API,可能产生额外调用费用。密码、证件号、银行卡、精确住址、联系方式等敏感个人信息不会被自动保存。
  • 跨会话检索:每次请求都在 Host 端按当前问题做本地词法相关度选择,不引入向量数据库或 Embedding 服务;只有相关的少量记忆会以参考信息加入模型上下文,并限制条数与字符预算。当前用户的新指令优先于历史偏好,记忆被明确标注为参考信息,不能覆盖系统规则。关闭长期记忆后,检索、注入和自动提取全部停止。
  • 记忆概述:把单条记忆整理成自然、分类清晰的概述,显示最后更新时间。概述是派生缓存:只有记忆条目的实质内容变化(修订号增加)才标记过期,打开记忆页或点击「重新整理」时才重新生成,不会每轮聊天都调用模型。
  • Ask or Update:概述下方的输入框可以用自然语言查询记忆(“你现在记得我哪些事情”)、新增(“记住我喜欢简短的回答”)、更正(“我的项目已经从 Python 改成 TypeScript”)、删除(“忘记关于某个项目的记忆”)和重新整理概述。新增、更新、删除都会真正写入本地存储;删除目标不明确时先列出候选并要求确认,不会误删其他记忆。
  • 管理与隐私:按分类筛选,手动新增、编辑、删除,清空全部记忆(需确认);每条记忆记录来源(手动 / 来自对话 / 导入自 ChatGPT、Claude、Gemini 等)与更新时间。删除会留下墓碑,旧聊天之后的自动提取不能把它加回来。
  • 从其他 AI 导入:两步式弹窗。第一步复制一段英文、与平台无关的导出提示词发给其他 AI(Instructions / Identity / Career / Projects / Preferences 五类,每条 [YYYY-MM-DD] - 内容,未知日期用 [unknown],整个结果放在单个代码块里);第二步把结果粘贴回来,本地解析、预览、编辑、勾选后合并导入。重复、冲突或可能包含敏感信息的条目会被标记,并允许逐条选择跳过、合并或更新;重复粘贴同一份导出不会产生重复记忆。非结构化文本可以显式同意后交给 DeepSeek 整理,默认不发送。

与 DeepSeek 聊天记录导入(ZIP)的整合已经打通:导入完成页会出现可选的「提取长期记忆」入口,也可以在「长期记忆」页重新打开。弹窗先列出可分析的导入会话(已分析过的带标记、默认跳过),默认不勾选任何会话;勾选后说明每个会话一次额外 API 调用及可能费用,只有再次确认后才逐个调用 extract.imported(一次最多 20 个,超出会明确提示而不是静默截断;分析过程中显示进度,可在会话之间停止)。候选记忆沿用 preview 的重复/冲突标记(提取阶段已过滤敏感信息),确认后走同一个 import 合并入口,来源记为「来自对话」。分析只读取当前分支消息,不修改 state.json 的消息树;分析成功的时间写在会话 source.memoryExtractedAt,所以同一批历史不会重复发送,除非用户显式勾选「重新分析」(关闭预览不会撤销标记,界面会提示)。详见 docs/memory-integration.md。

来源与引用

  • 回答正文里的引用是编号胶囊,点击打开原始网页;编号由 collectMessageSources() 生成:先按引用顺序给被引页面编号(1..n),再追加未被引用的搜索结果,按 URL 去重、去重不改变已分配的编号,因此刷新历史后编号与链接仍然一一对应。
  • 来源默认折叠为一行 来源 · N,展开后是单列紧凑列表(编号、标题、域名、可选摘要),列表有最大高度并内部滚动;15 条来源不再占满整页。
  • 来源为零时不渲染任何来源组件;思考区、正文、来源三层使用不同的字号与颜色权重。

模型与推理等级

模型与参数以 DeepSeek 应用 API 为准(Messages API、思考模式):

模型图片理解文件解析联网搜索深度思考推理等级
deepseek-flash(DeepSeek-V4.1-Flash)支持支持支持支持low / high / max
deepseek-v4-pro(DeepSeek-V4-Pro)不支持支持支持支持low / high / max

DeepSeek 的联网工具文档建议联网搜索使用 deepseek-flash;两个模型都接受服务端搜索工具,界面不因此禁用 V4 Pro 的搜索,但会在模型限制中提示图片能力差异。

  • 请求通过 model 选择模型;thinking: { type: "enabled" | "disabled" } 控制开关;开启时用 output_config.effort 传 low | high | max。接口接受的 minimal/medium/xhigh/ultra 只是别名,界面不展示它们,Host 端也会折叠到真实档位。
  • 模型座位是一个触发器:模型 API 名称(如 DeepSeek-V4.1-Flash)后接当前推理等级(如 Max),等级用 caption 色,和 Harness 原生模型控件一致。点击后先显示「模型 / 推理等级」两行根菜单;根菜单再进入名称列表或 Off / Low / High / Max 档位列表。两层都行式布局,当前项只用尾部勾选,不用整行色块。
  • 模型菜单不再铺长说明或能力标签;完整说明只放在行的 title 里,唯一的例外是会影响附件操作的限制(V4 Pro「不支持图片」)以一行小字显示。
  • 推理等级来自当前模型的 capabilities.efforts,不是自由数值;点击某档会确保深度思考开启并写入该档位,点击 Off 关闭深度思考。它与输入框下方的深度思考按钮共享同一个设置,但入口分工清楚。
  • 选中的模型记录在每条回复上,消息底部显示"模型 · 等级";不支持图片的模型会在输入框上方说明原因,并在发送含图片的消息前拒绝。
  • 模型目录由 Host 的 bootstrap.models 提供,浏览器不猜测模型列表;旧 Host 不返回目录时只提供 deepseek-flash(那是旧 Host 唯一会发出的模型)。旧 Host 的目录缺少 displayName 时,界面会从它已有的模型 version 推导原生风格名称。
  • 选择按会话保存(model-config.json,键为会话 id),新对话使用全局默认;该文件与会话消息历史分开存储,不改变 state.json 的消息格式与版本迁移。

内容渲染

client-src/30-markdown.js 是 Markdown 入口,另外三个模块各自独立、无外部依赖:

  • 31-highlight.js:单遍扫描的词法高亮,支持 JS/TS、JSON、HTML/XML、CSS、Python、Bash、PowerShell、SQL、Java、C#、C/C++、Go、Rust、YAML、Markdown、diff 等;未知语言按纯文本显示,字符永远不会丢失。
  • 32-math.js:LaTeX 子集渲染(分数、根式、上下标、大型运算符、定界符、矩阵、cases/aligned、重音、希腊字母与常用运算符);未知命令以灰色原文显示,解析失败时回退为原始公式文本。
  • 33-mermaid.js:flowchart/graph、sequenceDiagram、pie、classDiagram 的 React SVG 渲染;不支持或超出上限时显示错误说明并保留源代码。
  • 所有内容都以 React 元素输出,不使用 innerHTML / dangerouslySetInnerHTML / eval;链接与图片只允许 http(s)。
  • 流式输出时已完成的块靠 React.memo 跳过重渲染,Mermaid 图表在最后一个块生成结束后才绘制,避免每帧重排。

Chat → Agent 交接

  1. 在 Chat 里讨论完需求,点右上角 交给 Agent。
  2. Host 用 DeepSeek 把对话整理成任务说明(模型不可用时退回本地整理的版本,仍可编辑)。
  3. 选择工作区:
    • 直接选择已有工作区;
    • 或者选 + 新建工作区…,填工作区名称、选项目文件夹。选择已有目录… 会把所选目录直接当作项目文件夹;在此新建文件夹… 会把所选目录当作上级目录,按名称创建项目文件夹(目录不存在时会自动创建)。也可以直接把完整的绝对路径粘贴到输入框。
    • 创建分成两步且都由 Harness 原生能力完成:先在本地建好文件夹,再通过 Host 的 ctx.workspaceRegistry.create() 注册为工作区。成功后自动注册到 Harness 工作区列表并选中,已经写好的任务说明、补充要求和对话上下文都不会丢。
  4. 如果对话看起来是一个新项目、而当前工作区与对话标题没有关联,工作区下方会出现一条不阻断操作的提示,可以一键打开带名称建议的新建面板。
  5. 确认后创建新的 Agent 会话并把任务说明作为首条提示提交,界面自动切到 Agent 模式并打开该会话。

它走的是 Harness 原生机制:ctx.sessionController.create() + prompt() 建立会话,浏览器侧用 ctx.uiWorkspace.openSession() 切到该会话;新建工作区时用 ctx.uiWorkspace.pickDirectory() 打开原生目录选择器,由 Host 的 /api/deepseek-chat/workspace 建目录并调用 ctx.workspaceRegistry.create() 注册,不复制一套独立的工作区存储。

导入 DeepSeek 聊天记录

侧边栏底部的 导入聊天记录 会把 DeepSeek App / 网页版导出的聊天记录 ZIP 合并进 Chat 历史:

  1. 选择或拖入 ZIP(如 deepseek_data-<导出日期>.zip)。文件只交给本地 Host 解析;不上传、不调用 DeepSeek API。
  2. 预览列出导出中的全部会话:标题、创建时间、消息数。已经导入过的会话标为「已导入」并默认不勾选;可以按标题筛选、全选或逐个勾选。
  3. 导入在 Host 后台进行,弹窗显示进度并可随时取消;单个会话出错只进入失败列表,不影响其他会话。
  4. 结束后显示成功 / 跳过 / 失败的数量,并自动刷新侧边栏。导入的会话就是普通 Chat 历史:可以阅读、搜索、重命名、置顶、归档、移入文件夹、切换消息版本,也可以在原有上下文上继续对话或「交给 Agent」。

这是合并导入,不是覆盖:每条导入的会话都带稳定来源标识 source = { kind: 'deepseek-export', id: <导出中的会话 id>, importedAt },同一份导出(或另一份包含同一会话的导出)再次导入时,已存在的会话会被跳过而不是新建。写入前会把当前 state.json 复制为 state.json.import-backup-<时间戳>;历史按批写入,中断或取消时只有已完成的批次留在文件中。

支持范围

导出内容导入结果
标题、创建 / 更新时间、置顶原样保留(标题为空时用第一条提问补全)
用户提问、AI 回答、Markdown / 代码 / 公式原样保留,沿用现有渲染
深度思考 THINK思考块,按导出的 elapsed_secs 还原用时
联网搜索 TOOL_SEARCH / 打开网页 TOOL_OPEN「搜索 / 阅读」步骤 + 搜索结果与来源列表
内容风险提示 CONTENT_RISK回答下方的提示条,不进入正文、复制内容或模型上下文
文件 / 图片 FILE附件元数据;图片字节从 ZIP 中恢复并保存在本地,可直接显示
消息分支(编辑提问 / 重新生成)完整节点树;current_message_id 作为当前分支,其他版本仍可切换
未完成 / 超时 / 被内容过滤的回答保留原状态与服务器模板文案,不伪造内容
TOOL_FIND、TOOL_IMAGE_SEARCH 等片段不导入(导出中没有可还原的正文)

导出的全部真实会话只存在于本机测试环境;仓库内的测试样本全部是合成的导出结构,不含任何真实对话。

与长期记忆模块的接口

导入后的会话在存储里与普通会话完全相同,只多一个来源字段,供后续「用户授权后批量提取」使用:

  • conversation.source = { kind, id, importedAt }:kind 固定为 deepseek-export,id 是导出中的会话 UUID,importedAt 是导入时间(毫秒)。普通会话的 source 为 null。
  • store.listSummaries() 的每一项都带 source,长期记忆模块可以直接筛出 source.kind === 'deepseek-export' 的会话。
  • store.findBySource(kind, id) 与 store.importedSourceIds(kind) 用于按来源查找与去重;需要按时间范围或全量导出时,在这两个方法上扩展即可,不必改动导入流程。
  • 图片保存在 $DSH_HOME/deepseek-chat/imports/media/<sha256>.<ext>(按内容寻址,重复图片只存一份),由 /api/deepseek-chat/import/media 只读提供,浏览器经 Host 传输层取回后以 blob URL 显示。导入的附件带 local: true,protocol.js 在构造请求时会跳过它们,因此继续对话不会把无效的 file id 发给 DeepSeek。

安全与限制

  • ZIP 由 lib/import/zip.js 用 Node 内置 zlib 读取:只按名字取需要的条目,从不把条目名当作路径写文件(路径穿越无效);限制归档大小、条目数量与单条目解压上限,并校验 CRC 与声明大小;ZIP64、加密条目、多卷压缩包会被明确拒绝。
  • 解析与转换都在 Host 进程内,按会话逐个进行并让出事件循环;导入任务同时只允许一个,浏览器轮询进度,可随时取消。
  • 导入只接受 export_format_version: 3(当前 DeepSeek 导出格式)。出现新版本时会明确提示「不支持的导出格式」,不会猜测解析。
  • 图片只恢复 PNG / JPEG / WebP / GIF / BMP / AVIF / SVG;导出中缺少字节的附件只保留名称、大小与类型。
  • 导入的本地图片不会重新上传到 DeepSeek,因此继续对话时模型看不到这些图片(历史里的文字与回答照常参与上下文)。

认证

Chat 模式不会把 API Key 写进代码或配置文件,按以下顺序自动选择:

  1. Chat 设置中保存的 API Key(保存在 DSH 凭证库,键名 DEEPSEEK_CHAT_API_KEY)
  2. DSH 凭证库 / 环境变量中的 DEEPSEEK_API_KEY
  3. DSH 已登录的 DeepSeek 账号令牌(ctx.deepseekAccount,走 x-dsh-auth-token)

也可以在 Chat 设置中强制选择 DSH 账号 或 API Key。API Key 只存在 Host 进程内使用,不会发送到浏览器。

配置(可选)

Host 行配置位于插件行的 config 中,可在 $DSH_HOME/profiles/<profile>/cordis.patch.yml 中覆盖:

字段默认值说明
baseURLhttps://api.deepseek.com/anthropic/v1Anthropic 兼容 API 根地址,需包含 /v1
maxUploadBytes67108864单个上传文件上限(64 MB)
requestTimeoutMs900000单次生成超时(15 分钟)
heartbeatMs15000流式心跳间隔
handoffTimeoutMs90000生成任务说明 / 提交给 Agent 的超时
maxImportBytes536870912聊天记录导入 ZIP 上限(512 MB)
memoryTimeoutMs60000记忆提取、概述生成或 AI 整理单次请求的超时

数据

  • 历史:$DSH_HOME/deepseek-chat/state.json(原子写入)
  • 数据格式为 v2:每条会话是一棵消息节点树(nodes + leafId),messages 由当前分支推导;文件夹、置顶、归档状态保存在同一个文件中。旧版 v1 的线性 messages 会在加载时自动迁移,迁移前把原文件复制为 state.json.v1-backup-<时间戳>,可随时用备份还原
  • 编辑、重新生成只会新增兄弟节点,旧消息节点不会被覆盖;切换版本只改变 leafId
  • 消息版本各自保存 blocks(正文、思考、搜索/阅读步骤与引用)、usage、stopReason 等元数据
  • 模型与推理等级偏好:$DSH_HOME/deepseek-chat/model-config.json(按会话 id 记录覆盖项 + 新对话默认值)
  • 长期记忆:$DSH_HOME/deepseek-chat/memory.json(原子写入)——开启状态、记忆条目、来源、概述缓存、修订号与删除墓碑。它与 state.json 的聊天记录完全分开,不覆盖、不迁移聊天历史;文件损坏时会隔离为 memory.json.corrupt-<时间戳> 并从空记忆启动,聊天不受影响
  • 上传文件:由 DeepSeek Files API 托管,插件只保存 file_id 和展示元数据;附件会随编辑后的用户消息保留
  • 导入的会话写在同一个 state.json 里,只多一个 source 来源字段(含最近一次记忆提取时间 memoryExtractedAt);导入前备份为 state.json.import-backup-<时间戳>
  • 导入暂存:$DSH_HOME/deepseek-chat/imports/staging/<token>/export.zip,导入结束或 30 分钟未开始即删除
  • 导入图片:$DSH_HOME/deepseek-chat/imports/media/<sha256>.<ext>(内容寻址,只增不删)
  • 删除会话只删除本地记录和该会话的模型偏好,不删除 DeepSeek 侧已上传的文件
  • 联网搜索、深度思考搜索与文件解析使用 DeepSeek 服务,可能产生对应用量费用

实现

  • Host:index.js + lib/,通过 ctx.connection.fetch 注册 owner-only 路由,代理 DeepSeek Messages / Files API,解析 SSE 并持久化;交接路由调用 Harness 的 sessionController;问候用户名走 /api/deepseek-chat/profile,只读取已登录账号的显示名称并在 Host 缓存 60 秒,失败时返回空名称而不影响聊天。
  • 存储:lib/store.js 维护会话节点树、文件夹与组织状态;presentPath() 只把当前分支交给协议层,selectVersion() / focusMessage() 通过切换 leafId 重开旧分支;历史搜索在本地线性扫描标题与正文,不引入额外数据库。
  • 流式协议:/api/deepseek-chat/stream 支持 send / edit / regenerate / continue 四种模式。edit 把新提问挂到原提问的父节点下,regenerate 在同一个提问下新增回答兄弟节点,continue 用已保存的可见正文作为 assistant 前缀(prefill)请求剩余内容并原地追加。start 帧会下发本次生效的完整分支,浏览器用它替换乐观渲染的消息,避免旧分支回答混入当前上下文。
  • 模型:lib/model-config.js 是模型目录、能力与偏好的唯一来源,bootstrap.models 把目录送到浏览器;/api/deepseek-chat/model 读写偏好;stream 用目录校验 model,把偏好中的 effort 与请求值折叠后交给协议层。
  • 导入:lib/import/ 与聊天界面解耦——zip.js 只读 ZIP(文件句柄 + zlib.inflateRaw,条目名只做键、不落盘)、format.js 校验导出结构与时间戳、convert.js 把导出消息树转换成 Chat 的节点树(思考、搜索步骤、来源、图片、分支)、media.js 是内容寻址的图片库、index.js 负责暂存上传、后台任务、分批合并与去重。路由是 /api/deepseek-chat/import/{upload,start,status,cancel,discard,media}:upload 把请求流写到暂存文件并返回预览,start 返回 job id,浏览器轮询 status;每 40 个会话写一次历史,写入失败时把这些会话从内存中回滚,保证内存与文件一致。
  • 记忆:lib/memory-text.js(规范化、内容指纹、词法相似度、分类推断、敏感信息检测)、lib/memory-store.js(memory.json、去重/合并、导入、删除墓碑、概述修订号)、lib/memory.js(相关度检索与字符预算、系统提示记忆块、自动提取的门控与提示词、概述生成、Ask or Update 规划器、extractFromMessages 历史导入接口)。Host 的 /api/deepseek-chat/memory 提供记忆读写、预览、导入、概述刷新、Ask/确认和 AI 整理动作;stream 在构造请求时注入相关记忆,并在回复结束后异步触发自动提取,提取失败只记一条警告,不影响聊天。
  • Client:client.js 由 client-src/*.js 拼接,通过 shell.overlay 渲染全屏 Chat(起点在 --dsh-frame-chrome-top 之下,即原生标题栏下方),并在同一 shell.overlay 注册 root 级的 deepseek-chat-mode:mode-switch,作为两种模式共享的顶层导航。样式全部使用 --dsw-* 主题变量;侧栏品牌沿用 DeepSeek 官方鲸鱼与字标矢量,内联在插件中,不加载 Harness Client 包。
  • Client 模块:30-markdown.js(Markdown 与引用标记)、31-highlight.js、32-math.js、33-mermaid.js、43-popover.js(原生菜单几何、视口夹取与键盘)、47-model.js(模型 + 推理等级双层菜单)、48-tools.js(工具注册表与「+」面板)、58-memory.js(长期记忆设置页、记忆概述、Ask or Update、跨平台导入弹窗与本地导出解析器)。
  • 协议:Anthropic 兼容 Messages API(https://api.deepseek.com/anthropic/v1),使用 deepseek-flash、deepseek-v4-pro、deepseek_web_search、deepseek_read_url、safety_check、title 与 Files API。
  • 继续生成使用 assistant 前缀续写:请求以现有可见正文作为最后一条 assistant 消息,并关闭 reasoning、只保留 deepseek_read_url;返回内容追加到同一条回答,不新建分支。

参考文档:

已知限制

  • 兼容性:本版本在 DeepSeek Harness 0.2.2-rc.5 上验证:Windows Desktop 与 macOS 的本次界面修复均已实机核对;engines.dsh 声明为 >=0.2.2-rc.5。Web 尚未验证。
  • 数学公式是面向聊天的 LaTeX 子集(不是完整 KaTeX);\begin{tikzcd}、自定义宏等高级用法会以原文或灰色命令名显示。
  • Mermaid 支持流程图、时序图、饼图与基础类图;思维导图、甘特图等类型会显示错误说明并保留源代码。
  • 编辑/重新生成采用线性版本导航(‹ 1 / 3 ›)而不是完整的可视化分支树面板;被替换的分支仍保存并可切换回来。
  • 「继续生成」依赖 DeepSeek Messages API 的 assistant 前缀续写(prefill)语义;如果账号或服务端拒绝该模式,请改用重新生成。续写不会恢复深度思考,只延续可见正文。
  • 历史搜索在本地扫描当前 state.json 的全部消息节点,适合本机历史量;没有独立搜索索引服务。
  • 导入大量会话会让 state.json 变大(几百个会话约几十 MB),每次保存都要重写整份文档;建议只勾选需要的会话(可导入会话超过 100 个时弹窗会提示)。
  • 导入是单任务的:同一时间只允许一个导入任务,取消后会保留已写入的批次。
  • 导入只恢复导出中确实存在的内容:TOOL_FIND / TOOL_IMAGE_SEARCH 等没有正文的片段不会进入消息;导出中缺少字节的附件只保留元数据。
  • 导入后的记忆提取是用户主动发起的:默认不分析任何会话,每个被分析的会话会产生一次额外 DeepSeek 调用与相应费用。真正发出请求并完成的会话写入 source.memoryExtractedAt,下次默认跳过;模型有响应但没有候选时仍算已分析(避免为同一段历史重复付费),没有可分析内容或请求失败的会话不写标记,也不修改已导入的聊天。分析中途停止时,已完成请求的会话保留标记,未开始的保持可分析。
  • 文件夹整理通过菜单完成,未实现拖拽排序(避免引入拖拽依赖)。
  • 生成过程中需先停止回复,才能切换会话、编辑消息或新建对话。
  • deepseek-v4-pro 不支持图片理解;含图片的消息会在发送前被拒绝并提示切换模型。
  • 宿主端代码(index.js / lib/)改动后需要重载插件或重启 Harness 才会生效;浏览器端会先显示“需要刷新插件”的提示。
  • 长期记忆的跨会话检索使用本地词法匹配(中文按二元字符、英文按单词),没有向量数据库或 Embedding;语义相近但用词完全不同的记忆可能检索不到,适合轻量本机使用。
  • 自动提取依赖本地规则判断加每轮最多一次额外模型调用;关闭自动提取后手动记忆、检索与导入仍然可用。
  • 记忆概述一次生成一种界面语言的文本;切换界面语言后点击「重新整理」才会按新语言重新生成。
  • 跨平台导入优先使用本地解析器,支持常见标题、列表与代码块格式;极端格式可能需要「AI 整理」(需显式同意后才会发送到 DeepSeek)。
  • 敏感信息检测与去重都是启发式规则,不能替代用户自己检查;导入前预览会标出可能重复、冲突或敏感的内容。
  • 长期记忆只保存在本机 DSH Host 的 memory.json,不参与 Harness 原生 Agent 会话存储,也不会同步到其他设备。
  • 联网搜索、文件解析是否可用取决于账号/API Key 与所选模型的服务端能力,可能产生额外用量费用。
  • 本插件不是 DeepSeek 官方产品。

开发

node --test tests/*.test.js        # 或逐个执行(受限沙箱里 --test 子进程不可用)
node tools/build-client.js         # client-src/*.js -> client.js
node tools/smoke-client.js         # 无浏览器渲染冒烟(会话分组、搜索、编辑/重生成/续写、输入框、菜单、来源、模型、工作区创建、长期记忆、公式/图表/代码)
node tools/check-css.js            # 样式括号 / 硬编码颜色检查
node tools/check-classes.js        # JS 与样式类名一致性
node tools/check-i18n.js           # 中英文键一致性
node tools/check-highlight.js      # 代码高亮字符不丢失 / 分类 / 性能
node tools/check-math.js           # LaTeX 子集渲染回退与深度保护
node tools/check-mermaid.js        # Mermaid 解析、几何与错误回退
node tools/check-memory-client.js  # 跨平台记忆导出提示词与本地解析器

测试覆盖:tests/store.test.js(v1→v2 迁移与备份、文件夹/置顶/归档、搜索、分支与版本切换、导入会话的记忆分析标记)、tests/protocol.test.js(上下文构造与续写前缀)、tests/conversation.test.js(Host 路由与 send/edit/regenerate/continue 端到端、导入会话继续聊天)、tests/workspace.test.js(项目文件夹创建、工作区注册与交接)、tests/import.test.js(导出预览、导入、去重、重启持久化、取消、损坏会话隔离、路径穿越与解压上限)、tests/import-convert.test.js(片段映射、分支选择、来源字段、存储合并与请求构造)、tests/model-config.test.js、tests/service-stream.test.js、tests/api.test.js、tests/profile.test.js、tests/host-entry.test.js、tests/memory-store.test.js(记忆持久化、去重/合并、导入幂等、墓碑、概述修订、损坏恢复)、tests/memory-service.test.js(检索与预算、提取门控、概述并发、Ask or Update 增删改确认、历史会话提取接口)、tests/memory-conversation.test.js(记忆注入真实流式请求、关闭/删除后停止注入、后台提取成功与失败、memory 路由端到端、导入会话的选择性提取/确认/去重/失败隔离/空会话不标记/并发去重)、tests/memory-import.test.js(跨平台导出解析器)。导入测试的样本由 tests/support/export-fixture.js 现场生成,不包含任何真实聊天记录。

安装:在 DSH 的 Plugins 页面选择本地目录,或由 Agent 使用 plugin_manager install_bundle 安装本目录。发布包也可以使用 .tgz 直接安装;.zip 需先解压,安装目标为解压后的目录(DSH 不接受 .zip 文件本身)。本机开发时 profile 里用 link: 指向本仓库即可。

Comments

Loading…

Similar plugins

dsh-chat

by SamuelChung2010

**dsh-chat** — Bring a ChatGPT-like Chat & Agent experience to DeepSeek Harness, with seamless handoff to coding agents.

Manifest valid

★ 4

JavaScript

Nov 20, 2026

dsh plugin --profile web add @local/deepseek-chat-mode

by yx-yinhe

ChatGPT-style message navigator for DeepSeek Harness conversations with hover previews and smooth jump navigation.

Development & InfrastructureManifest valid

★ 0

MIT

JavaScript

Aug 28, 2026

dsh plugin --profile web add @yinhe/dsh-message-navigator

by AprilCrystal

ChatGPT-desktop-style model selection and thinking-level control for the DeepSeek Harness Web composer, with an animated fast-mode particle trail

UI & ExperienceDevelopment & InfrastructureTerminal & ClientsManifest valid

★ 2

MIT

JavaScript

Oct 18, 2026

dsh plugin --profile web add dsh-client-ui-gpt-helper

by 1985899182

Adds ChatGPT-style stop, edit-and-resend, native quote annotations, and an independent sidebar follow-up chat with model and image input for DeepSeek Harness Desktop.

UI & ExperienceTerminal & ClientsManifest valid

★ 8

↓ 52/wk

MIT

JavaScript

Nov 2, 2026

dsh plugin --profile web add dsh-harness-chat-control

by ThomasTZh

DeepSeek Harness bundle that adds a chat preset with web tools, skill loading, and no filesystem or shell access.

Manifest valid

★ 0

MIT

JavaScript

Nov 1, 2026

dsh plugin --profile web add @local/dsh-chat-preset

by liaosiliangCodeLife

Connects the DeepSeek Harness agent running on your own computer to the HarnessMate platform, so you can chat with it, exchange files and approve its tool calls from a phone or a browser.

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Oct 29, 2026

dsh plugin --profile web add harness-mate