网页聊天桥

简体中文 | English

[](https://www.npmjs.com/package/dsh-webchat-bridge) [](https://github.com/nai-loong/dsh-webchat-bridge/actions/workflows/ci.yml) [](https://github.com/nai-loong/dsh-webchat-bridge/releases/latest) [](LICENSE)  [](https://github.com/exoticknight/red)

在 DSH 里直接使用 chat.deepseek.com 的网页对话，并把对话一键转成工作区会话继续开发。

功能

• 不消耗 API token 的网页对话：用真实浏览器打开 chat.deepseek.com，复用你已登录的网页会话，回复从页面自己的流式响应中读取。
• 登录一次，之后无头运行：首次点 打开登录窗口 完成扫码或密码登录，插件记住浏览器资料；之后聊天在后台无头运行，不再打扰你。
• 流式回复与两个开关：回复边生成边显示；深度思考、联网搜索 直接切换网页端的对应模式。
• 一键转到工作区：核对来源、选择目标工作区，把问答与来源写成一个新的工作区会话；也可以 追加到已有会话。转移后目标会话输入框保持空白，可以直接接着做开发任务。
• 可选的任务简报：勾选后由 DSH 当前配置的模型把对话蒸馏成 120–180 字简报，覆盖 outcome、audience、supplied_inputs、constraints、output_shape、acceptance_check、stop_boundary；对话里没有的事实写 unknown，长对话按 map-reduce 分段处理。完整原文仍会附在同一会话里，不会因为蒸馏而丢失。
• 手动导入：支持 UTF-8 的 .txt、.md、.json 对话记录，导入后同样可以转移；面板里可以随时 删除当前对话 或 清空全部 本地记录。

安装

环境要求：DeepSeek Harness >=0.2.0-rc.2 <=0.2.1-rc.2，使用 web profile。开发目标为 0.2.1-rc.2，实际验证结果见兼容性记录。

从 npm 安装（推荐）

dsh plugin --profile web add dsh-webchat-bridge

从 GitHub 安装

固定到某个 Release tag：

dsh plugin --profile web add github:nai-loong/dsh-webchat-bridge#v0.1.0

安装后重启 DSH（桌面版请重启应用），刷新页面。命令会装到你平时使用的 DSH；如果你设置了自己的 DSH_HOME，请在同一个环境中运行。

从源码安装用于开发调试，见 docs/development.md。

使用

1. 打开 DSH 页面，在左侧栏点 网页聊天。
2. 首次使用点 打开登录窗口，在弹出的浏览器里登录 chat.deepseek.com。检测到登录后窗口自动关闭。
3. 在底部输入框输入消息，按 Enter 发送；回复会流式显示。需要时勾选 深度思考 或 联网搜索。
4. 点 导入 可以把本地的 .txt、.md、.json 对话加入列表。
5. 点 转到工作区：核对来源、选择目标工作区；需要追加到已有会话时选 追加到已有会话 并选目标会话；勾选 同时蒸馏一份任务简报 会在原文之上再生成一份简报。可以对同一个会话多次追加：每次会自动结束上一次留下的未完成轮次。点 开始转移。
6. 转移完成后会话会立即出现在左侧工作区（无需重启）；打开即可继续，输入框是空的，不会替你把问题预先填好。
7. 需要清理本地记录时，点 删除当前对话 或 清空全部；已转移到工作区的会话不受影响。

配置

配置保存在 DSH 的插件设置中（cordis.patch.yml 提供默认值）。

键	默认值	说明
enabled	true	启用插件。
headless	true	登录后使用无头浏览器；首次登录仍会弹出可见窗口。
channel	auto	浏览器通道：auto、chrome、msedge、chromium。
executablePath	空	自定义 Chrome/Edge 可执行文件路径；留空自动探测。
baseUrl	https://chat.deepseek.com	DeepSeek 网页端地址。
dataDir	空	数据目录；留空使用 ~/.dsh/webchat-bridge。
replyTimeoutMs	180000	等待回复的最长毫秒数。
distillProvider	空	蒸馏简报使用的 provider；留空自动选择。
distillModel	空	蒸馏简报使用的模型；留空自动选择。
distillMaxTokens	16384	最终简报的输出 token 上限（推理模型的思考也占用该额度）。
distillChunkTokens	4096	分段摘要的输出 token 上限。
transferDistillDefault	false	转移对话框是否默认勾选“蒸馏任务简报”。

更新、回滚与卸载

版本变更与升级说明见 更新日志。

更新或回滚时请写明版本号，然后重启 DSH（新版本发布后 24 小时内，不带版本号的安装命令可能仍会装到旧版本）：

dsh plugin --profile web add dsh-webchat-bridge@X.Y.Z

dsh plugin --profile web add github:nai-loong/dsh-webchat-bridge#vX.Y.Z

卸载：

dsh plugin --profile web remove dsh-webchat-bridge

卸载后 ~/.dsh/webchat-bridge/ 仍然保留：网页登录用的浏览器资料、本地对话记录 transcripts.json 和登录令牌 token.json。不再需要时手动删除该目录即可；不删除也不会影响 DSH 本身。

隐私与数据

• 网络：插件用本机 Chrome/Edge 访问 https://chat.deepseek.com（可在配置中改地址）。除此之外不访问其他网络地址，不做遥测。
• 本机文件：~/.dsh/webchat-bridge/ 下的 browser-profile/（网页登录资料）、transcripts.json（本地对话）、token.json（从网页请求中观察到并保存的登录令牌，文件权限 0600，仅本机可读）。
• 凭据：DeepSeek 网页登录令牌只写入上面的本机文件，由 Host half 读取；Client half 只能看到“是否已保存”，页面接口永远不会返回令牌内容。
• 转移：转移写入 DSH 标准会话存储（~/.dsh/sessions/<workspace>/），内容是你选择的对话与来源信息。

兼容性

见 docs/compatibility.md。已知限制：DeepSeek 网页端的 DOM 与流式协议没有公开契约，页面改版可能导致发送或读取失败；插件会报出 PAGE_CHANGED 而不是静默丢弃内容。

开发

见 docs/development.md 与 CONTRIBUTING.md。使用 AI agent 开发、发布或维护时，让它先读 AGENTS.md。

许可证

Apache License 2.0

包内附带 vendored 的 playwright-core（Apache-2.0）和打包进 lib/index.js 的 @deepseek-ai/schemastery（MIT）。它们的 NOTICE 与许可证文本见 THIRD_PARTY_NOTICES.txt，playwright 的 NOTICE 与 ThirdPartyNotices 随包保留。