前言¶
DeepSeek Harness 的设计理念是“一切皆插件”，旨在让开发者通过插件扩展能力。在使用网页端 chat.deepseek.com 进行开发或调试时，历史对话往往散落在浏览器中，难以复用或整理。如何将这些对话安全地保存到本地，并精准地导入到 DSH 工作区中作为新的 Agent 会话继续开发？Convoport 插件解决了这一流程断层问题，它负责自动捕获网页对话、本地化存储，并提供消息级的导入功能。
插件定位¶
- 名称：Convoport
- 维护者：MrElysium
- 一句话介绍：捕获 AI 网页对话到本地 JSON + SQLite，并将选定消息导入 agent harnesses 作为可继续会话。
核心功能¶
- 自动捕获：通过浏览器扩展（MV3）监听
chat.deepseek.com，利用官方 API 拉取对话并自动同步到插件。 - 本地存储：数据存储在
$DSH_HOME/capture/目录下，以 JSON 格式保存，每条对话一个文件。数据完全本地化，不经过服务器上传。 - Token 节省统计：提供累计节省 Token 数、对话数、今日捕获数以及估算的金钱节省（基于参考价格计算）。
- 消息级导入：支持在导入前勾选具体消息，提供快速选择（如“前 3 条/后 3 条”），导入后将选定内容作为新 Harness 会话的历史记录。
安装与启用¶
安装插件需要两步：通过 DSH 安装插件本体，以及手动加载浏览器扩展（Chrome 的安全限制要求此步骤）。
- 安装插件本体：
dsh plugin --profile web add convoport
安装完成后，重启 dsh web 并刷新浏览器。
- 加载浏览器扩展：
扩展文件位于插件的extension/目录（可在 npm 包的node_modules/convoport/extension/或仓库根目录找到）。- 打开 Chrome 扩展管理页面：
chrome://extensions。 - 开启右上角的“开发者模式”。
- 点击“加载已解压的扩展程序”，选择
extension/目录。 - （可选）点击扩展图标进入选项，确认后端地址为
http://127.0.0.1:3080（即 dsh web 的端口）。
- 打开 Chrome 扩展管理页面：
典型用法¶
启用扩展后，在 chat.deepseek.com 上的正常对话会自动被捕获。
- 查看状态与列表：DSH Web 侧边栏底部会出现一个“⛁ Convoport”按钮。点击可查看统计卡片（总 Token、对话数、今日捕获、预估节省）以及捕获列表。
- 选择消息：在捕获列表中点击某个对话，进入消息选择界面。你可以手动勾选需要保留的消息，或使用快速选择按钮（如“前 3/后 3/全部/清除”）。
- 创建新会话：在消息选择界面点击“Import selected → new session (N)”，插件会在当前工作区创建一个新的 Harness 会话，并将选中的消息作为该会话的历史上下文。
- 查看统计：在任意 DSH 会话中输入
/capture命令，可以快速查看统计概览。
注意事项¶
- 手动加载限制：由于 Chrome 的安全策略，无法通过命令行直接加载未打包的扩展，必须手动执行“Load unpacked”操作。
- 数据位置：所有捕获的 JSON 数据均存储在
$DSH_HOME/capture/目录中，内容为纯文本，任何开发者均可读取。 - Token 计数逻辑：插件优先使用 DeepSeek 官方的
accumulated_token_count字段。如果未提供该字段，则回退到启发式算法（4 字符/Token + 结构开销）。 - 定价参考：估算的金钱节省基于 $0.02 / 1k tokens 的参考价格计算。
结尾¶
Convoport 专注于将网页端的对话资产转化为 DSH 可直接使用的本地 Session。它不改变核心架构，而是作为连接器，让开发者可以自由管理历史对话，并在本地环境中无缝继续开发。
