前言¶
DeepSeek Harness（DSH）采用插件化架构，允许扩展功能。在开发或使用智能体时，有时需要在官方网页端进行更复杂的搜索或交互，随后将讨论内容沉淀到工作区中。dsh-chat-bridge 插件提供了这样一个连接层，它不修改官方桌面端源码，而是通过内嵌官方网页和特定的接口，实现从聊天记录到工作会话的导入。
插件定位¶
这是一个客户端插件，用于在 DSH 内部集成官方网页版聊天功能。项目由 FrostLeafKEE 维护，采用 MIT 许可证。它解决了“网页讨论”与“工作区管理”之间的割裂问题，提供了一键转换和历史上下文复用的能力。
核心功能¶
该插件提供以下能力：
* 聊天 / 工作切换：在主界面顶部切换，进入聊天区后可随时返回原工作会话。
* 内嵌官方网页：在 DSH 内部加载 DeepSeek 官方网页，支持登录和对话。
* 网页历史侧栏：显示已加载的网页会话列表，支持搜索、刷新和加载更多。
* 一键转工作：将选定的网页会话导入工作区，支持预览和快捷模式。
* 原生历史上下文：导入时保留问答内容及来源，输入框默认为空，可直接下达下一条任务。
* 独立聊天档案：本地保存聊天档案，支持搜索、重命名、导出和删除。
* 手动导入：支持 UTF-8 的 .txt、.md 文件，以及插件自身的历史 JSON 和档案 JSON。
安装与启用¶
该插件适用于官方 DeepSeek Harness Desktop 0.2.0-rc.2。
在 Windows 的 PowerShell 中，使用以下命令安装：
$dsh = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
$package = Join-Path $env:USERPROFILE 'Downloads\dsh-chat-bridge-1.0.1.tgz'
& $dsh plugin --profile desktop add $package
安装后需重启 DSH。卸载时同样使用 CLI 命令，或在 macOS 解压目录执行移除脚本。
使用流程¶
- 在新会话上方选择「聊天区」，或点击侧栏下方的「聊天区」。
- 在内嵌的官方网页完成登录。展开网页侧栏，DSH 侧栏的「网页会话」会自动显示已加载列表。点击列表项即可打开对应会话，或使用「从网页加载更多」。
- 点击「转为工作」。此时会弹出预览，需要选择目标工作区，并确认采集范围及上下文提示。
- 确认后，插件保存来源并创建带历史上下文的工作会话。此时输入框为空，可直接提出下一条工作任务。
- 勾选「记住目标」并开启「一键转换」后，下次点击「一键转工作」即可自动完成导入流程。
限制与注意事项¶
插件在运行机制和数据处理上有以下限制：
- 侧栏刷新与计数：网页侧栏每 3 秒刷新一次，读取已加载标题和链接。计数仅统计已加载条目。折叠分组或未加载的记录可能缺失。列表仅在本次运行期间保留。
- 高度限制：v1.0.1 版本对侧栏高度进行了限制。聊天记录区默认占窗口高度的 30%，网页列表占 15%，已导入历史占 12%。超出后内部滚动。
- 数据采集范围：目前采集当前已渲染分支，标记为
partial。长对话中尚未渲染的消息、其他分支及附件原文不会自动补全。网页采集限定已核对的前端版本。 - 环境冲突：若网页升级、处于生成中状态、有未发送草稿或内容发生变化，转换操作会停止并提示处理。
- 登录状态：首次登录需在官方页面完成。登录状态仅在本次应用运行期间尽量复用，重启后可能需要重新登录。插件不读取或复制登录凭据，聊天页面使用隔离载体。
- 安全与隐私：选择并导入工作会话后，才会使用目标工作区的正常能力。本地档案未加密。
- 导入限制：插件不估算模型上下文容量、不自动缩短正文。超长历史和敏感内容需在转换前核对。当前输入限额为普通文本 5 MiB、完整档案文件 64 MiB、结构化消息 5000 条，超限会拒绝，不静默截断。
- 待实机确认：小窗口、键盘焦点和 macOS 布局的兼容性仍需实机确认。
