dsh-plugin-dsweb-harness
han-050917/dsh-plugin-dsweb-harness
Use DeepSeek's web chat inside DSH: real chat history in the leftmost sidebar, a Chat/Work switch beside the agent mode, plus streaming answers, thinking, web search and file uploads.
インストール
dsh plugin --profile web add github:han-050917/dsh-plugin-dsweb-harnessREADME
DeepSeek 网页聊天 · DSH 插件
把 chat.deepseek.com（DeepSeek 网页版）的对话记录同步进 DSH 的 Web 界面，并在同一个窗口里 直接继续聊天——不用再切到浏览器。左侧面板栏多出一个「聊天」图标，会话标题栏多出一个 聊天 / 工作 切换开关，和 ChatGPT 桌面版的 聊天 ⇄ 工作 是一个意思。
聊天模式。会话记录住在最左侧那一栏的「聊天」页里（与「任务」「频道」并列），中间是对话正文， 左上角就是 聊天 ⇄ 工作 开关——切回工作，中间立刻换回 DSH 的 Agent 会话。
┌─ 侧栏 ─┬────────────── 聊天面板 ──────────────┐
│ ▣ 插件 │ [ 聊天 | 工作 ] ⟳ 同步 ＋ 新对话 │
│ ▤ 聊天 │ ┌───────────────────────────────┐ │
│ │ │ 你: … │ │
│ 任务 聊天 │ │ DeepSeek: … │ │
│ 搜索… │ │ ▍ 生成中… │ │
│ 会话 A │ └───────────────────────────────┘ │
│ 会话 B │ │
└─────────┴───────────────────────────────────┘
↑ 会话列表在最左栏的「聊天」页里，和「任务」并列
- 聊天模式 = 这个插件面板，走你自己的 chat.deepseek.com 账号，历史记录与网页版一致。
- 工作模式 = DSH 原本的 Agent 会话（工具、文件、终端……），两者互不干扰。
- 切换只改变中间显示哪一栏，不会新建或销毁会话，来回切是瞬时的。
安装
三种装法，任选其一。装完都要重启 DSH：宿主半边是 ESM，只有新进程才会加载新的代际。
① 插件市场（推荐） —— 装一次市场，之后在 DSH 里「设置 → 插件市场」搜索本插件一键安装：
dsh plugin --profile web add dshmarket # 需要 dsh web 0.1.0-rc.6 及以上
# 然后重启 dsh web
② 命令行 / 插件页 —— 包名、Git 地址或本地目录都接受：
dsh plugin --profile desktop add dsh-deepseek-web-chat
# 或未发布到 npm 时直接指向仓库：
dsh plugin --profile desktop add github:HAN-050917/dsh-plugin-dsweb-harness
桌面版需先初始化一次 profile，并完全退出后再执行
dsh plugin --profile desktop …。 也可以让 DSH 里的 Agent 执行：plugin_manager action=install_bundle target=<本仓库绝对路径>。
③ 本仓库开发 —— clone 后以 link: 方式挂进 profile（dsh.profile.bundles），
改代码就是改插件：客户端半边刷新页面即可生效，宿主半边（lib/index.js、
lib/deepseek.js）必须重启 DSH。没有构建步骤，lib/client.js 是手写产物、由宿主直接发布。
# 跑测试（19 个套件，零依赖）
node test-surface.mjs # …test-*.mjs 都在包根目录
配置令牌（一次性）
插件需要你自己的网页版登录令牌才能读你的对话。令牌只存在本机，只用于向
chat.deepseek.com 发请求。
-
浏览器打开并登录 https://chat.deepseek.com。
-
F12→ Console，粘贴回车：JSON.parse(localStorage.getItem('userToken')).value -
复制打印出来的令牌，切到 DSH 的「聊天」面板，粘贴进输入框，点 保存并验证。
输入框也接受整段 Authorization: Bearer …，或直接粘贴 userToken 的整段 JSON——会自动解开。
令牌会过期。 过期后面板顶部会出现红色提示，按上面三步重新取一次即可。 点「清除令牌」会删除本机凭据文件（
~/.dsh/dsh-deepseek-web-chat/vault.json，仅当前用户可读）。
功能
| 功能 | 说明 |
|---|---|
| 会话同步 | 拉取网页版的会话列表（最多 500 条），带标题与时间 |
| 历史回看 | 打开任一会话，读取完整的问答记录 |
| 本地缓存 | 最近 200 个会话落在本地缓存文件，离线也能看 |
| 继续聊天 | 在已有会话里接着发消息，网页版刷新后能看到（同一条会话） |
| 新建会话 | 「＋ 新对话」在 DeepSeek 侧建一个新会话再发消息 |
| 深度思考 / 联网搜索 | 对应网页版的两个开关 |
| 模型选择 | default / expert / vision |
| 流式输出 | 逐字返回；思考内容折叠显示在回答上方 |
| 自动续写 | 上游把长回答截断时（INCOMPLETE / auto_continue）自动调 /chat/continue 接着写，最多 8 轮 |
| 可中断 | 生成中点「停止」，会中断上游请求 |
| 添加附件 | 点 composer 左侧「＋」选择文件，或把文件拖到窗口任意位置；上传后可移除，也支持仅发送文件 |
| 文件大小限制 | 最多 10 个附件、单个 100 MB |
| 按文件内容追问 | 附件留在会话里：后续回合仍带上附件 ID，模型始终读得到文档内容（上游自己不保留文件） |
| 文件解析状态 | chip 显示 解析中… / 解析失败 / 文件大小；解析未完成时发送会被拦下（409） |
| 聊天气泡 | 提问靠右（气泡）、回答靠左（正文），一轮问答之间有留白与细分割线 |
| 侧栏「聊天」页签 | 侧栏 任务 / 频道 之间多一个「聊天」页签，专放网页版对话记录 |
| 只有一份列表 | 记录只住在最左侧那一栏的「聊天」页里，面板中间不再画第二份；面板会提示列表在哪并给一键切回 |
| 干净正文 | 搜索簿记与免责声明不混进正文；[reference:N] / [citation:N] 引用标记会被剥掉 |
架构
一个包、两个半边，靠 DSH 的 dsh.bundle.patch + dsh.client 同时挂载：
dsh-deepseek-web-chat/
├── package.json # dsh.bundle.patch + dsh.client（platform: web）+ dsh-plugin 关键词
├── cordis.patch.yml # 往 profile 里 insert 一行：id deepseek-web-chat
├── icon.svg # 插件列表与市场里的图标
├── LICENSE # MIT
├── screenshots.json # 市场截图清单（相对路径）
├── lib/
│ ├── index.js # 【Host 半边】HTTP 路由 + SSE 转发 + 本地缓存
│ ├── deepseek.js # chat.deepseek.com 客户端（会话列表 / 历史 / 补全 / SSE 归约）
│ ├── pow.js # DeepSeekHashV1 工作量证明（纯 JS，无依赖）
│ ├── vault.js # 令牌保险箱（0600，原子写）
│ └── client.js # 【浏览器半边】手写 lazy-CJS bundle，无构建步骤
├── locale/{zh,en}.json # 插件列表里的显示名
├── tools/ # 开发期预览/提取脚本，不进包运行时
└── test-*.mjs # 19 个零依赖测试套件
浏览器半边
lib/client.js 走 DSH 的 lazy-CJS 协议（window.__ModuleLoader__.load({id, factory})），
没有构建步骤，外部依赖只有平台自带的 react。它占了三个官方 slot：
| Slot | 作用 |
|---|---|
sidebar.panellist（list，id: 'deepseek-web-chat'） | 左侧面板栏的图标 |
main（keyed，key: 'deepseek-web-chat'） | 聊天面板本体 |
conversation.header.leading（single，原本空着） | 标题前的 聊天 / 工作 开关 |
聊天模式下 conversation 表面被本插件的 main 面板取代，所以聊天面板自己也画一枚同样的开关，
位置必须与工作模式一致（贴在头部最左），否则一进聊天模式开关就跑到右边缘。
模式切换用的是 DSH 自己的原语：ctx.layout.selectPanel('deepseek-web-chat') 进聊天，
selectPanel(null) 回 Agent 会话。不需要任何 DOM 技巧，也不会盖掉自带界面。
表面（surface）持久化：聊天 / 工作是一个独立的应用级表面轴，既不等于 Agent 的工作模式，
也不挂在某个会话上。选择写进 localStorage，重载后回到你离开的那一面；每个模式各记一个位置
（{sessionId}），记的那个会话没了就开新对话；列表还没同步时把恢复推迟到第一次同步成功之后，
而不是靠猜。
快捷键：Alt+1 = 聊天，Alt+2 = 工作（macOS 用 Ctrl+1/2）。shortcuts 服务按需注入，
没有这个服务的组合里面板和开关照常工作。
侧栏「聊天」页签（非官方挂载点，特性探测 + 优雅降级）：侧栏的 任务 | 频道 这一行由第三方插件
@michengai/dsh-im-connect 接管后自己画出，并在 occupant 上挂了一个未公开的注册表。DSH 官方
没有在这一行插页签的 slot，所以这里做的是：从 ctx.slots.entriesOfSlot('sidebar.workspaces')
找 occupant → 读注册表 → 找得到就 insert({ id, order: 10, label, render })，找不到就什么都不做
（面板与开关完全不受影响）。同时监听 dsh-native-sidebar-change 事件以便它重建页签行后插回去。
页签只 connected，不再在中景画第二份列表。
Host 半边
九条路由挂在 /dsh-deepseek-web-chat 前缀下：
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /state | 令牌状态、用户信息、模型列表、缓存统计 |
| POST | /token | 校验并保存令牌 |
| POST | /token/clear | 删除令牌 |
| GET | /sessions?count=&refresh= | 会话列表（refresh=0 只读缓存） |
| GET | /messages?sessionId=&refresh= | 某个会话的全部消息 |
| POST | /session/new | 在 DeepSeek 侧新建会话 |
| POST | /chat | 发一条消息，SSE 流式返回（body 另可带 refFileIds、attachments、detachFiles） |
| POST | /upload | 接受单个文件原始字节，转发给 DeepSeek，返回解析 status |
| GET | /files?file_ids= | 查询已上传附件的状态 |
/chat 把本轮新挂的 refFileIds 与该会话记忆的 ID 合并后发给上游，并逐个核对：上游已不再列出的
ID（过期/被删）会被剔除；仍在解析的要等到终态，否则回 409。点 chip 的 × 则在下一轮带上
detachFiles: true，明确断开。
每条路由都自己过一遍同源检查（Host 必须是回环地址、拒绝 sec-fetch-site: cross-site、
Origin 要么没有要么与 Host 一致）。因为这是存 bearer 令牌的接口，不能只靠「在本地」就放心。
已知限制
- 只能读、写你自己账号里的会话——插件用的是你的网页版令牌，没有别的权限。
- DeepSeek 的网页接口没有公开文档，字段可能变；出错时面板会显示原文。
- 一个会话只有在通过本插件发过消息之后才会进本地缓存；纯网页版新开的会话要点一次「⟳ 同步对话」。
- 缓存是「最近 200 个会话」，更早的会从本地淘汰（网页版上还在）。
- 侧栏「聊天」页签挂的是 im-connect 的未公开注册表；它升级后若改名，页签会消失， 但面板与 聊天/工作 开关不受影响（代码里是特性探测，不是硬依赖）。
- 改 Host 半边（
lib/index.js、lib/deepseek.js）后必须重启 DSH：ESM 模块缓存不会因为文件 变动而重载。浏览器半边由dsh-client-hmr自动重载，无需重启。/state会回一个protocol版本号，客户端比对不一致时面板直接提示「插件后端仍是旧版本，请重启」。 - 同步来的思维链默认折叠成一行，点击展开；很长的思考展开后会比较占地方。
测试
19 个套件都在包目录里，全部离线、不需要令牌：
| 套件 | 钉住的行为 |
|---|---|
test-pow.mjs | 4 个官方 DeepSeekHashV1 哈希向量 + 求解 + 请求头字段 |
test-sse.mjs | 5 份真实抓包的 fragment 归类（思维链不混进正文） |
test-continue.mjs | 真实截断样本必须续写、完成样本必须不续写 |
test-envelope.mjs | 初始化信封里的正文不能丢 |
test-history.mjs | 历史记录只取 REQUEST/RESPONSE，簿记不进正文 |
test-citations.mjs | stripCitations 剥掉 [reference:N]（含跨 delta 的半个标记） |
test-search.mjs | 联网搜索的 TOOL_SEARCH/TIP 不进正文 |
test-markdown.mjs | markdown 渲染器 56 条断言（块级 / 行内 / 表格 / 任务列表 / 硬换行 / 代码卡三个工具按钮与彩色分词） |
test-think.mjs | 推理行 29 条断言（折叠摘要、展开渲染、24px 行高） |
test-paging.mjs | 会话列表翻页 15 条断言（游标闭区间去重、has_more 撒谎也不会转圈） |
test-i18n.mjs | 中英字典（76 键）：无缺键/死键、两侧键集相同、没有绕过字典的硬编码文案 |
test-style.mjs | 样式表只用真实主题 token、类名都有定义（60 个 token、100 个类） |
test-api.mjs | api() 保留查询串（丢掉就报「缺少 sessionId」） |
test-chat-route.mjs | 宿主路由 + 上传不被已读完的 request.signal 误取消 + 停止按钮中止上游 + 解析未完成 409 + 会话记住附件 + 协议版本一致 |
test-panel.mjs | 列表归属（页签注册后中间不再有第二份列表）+ 整窗拖放守卫 + 页签按钮解析 |
test-tab-sync.mjs | 侧栏页签与表面 53 条断言：只修「任务/聊天」这一对、让给别家页签、只有 isTrusted 点击算意图、定时器可拆 |
test-surface.mjs | 聊天/工作表面 60 条断言：持久化、幂等、以真实面板为准的对齐、每面各自位置记忆 |
test-load.mjs | 整个客户端 bundle 用真实 loader 完整求值一次，再对最小 ctx 调一次 apply() |
test-render.mjs | 真组件真的画一遍 19 条断言（各状态 chip / 完整对话 / 令牌卡片 / 两个侧栏座位）+ 误用 t() 的静态扫描 |
test-i18n.mjs 值得单独说一句：ctx.locale.bind(NS) 在缺键时返回键名本身而不抛错，
所以少一个键的后果是界面上出现 think.title 这样的字样，而不是一条报错——另外两套测试都看不见它。
它同时抓「硬编码兜底文案」（英文界面下漏出中文的写法）。
卸载
# 在 DSH 里：
# plugin_manager action=remove_bundle target=dsh-deepseek-web-chat
再手动删掉 ~/.dsh/dsh-deepseek-web-chat/（里面是令牌和缓存）。