前言¶
在 DeepSeek Harness(DSH)裏做 agent 開發時,常見做法是隻走 API 或內置模型通道。若你希望直接沿用 chat.deepseek.com 網頁版的對話體驗、登錄態和頁面上下文,又希望 agent 能「代問」或「讀取當前頁面對話」,就需要在桌面殼裏嵌入站點,並打通 Host 與 Client 半的橋接。下面介紹社區插件 dsh-deepseek-webchat(維護者 qingxingLi,分類:客戶端):它在 DSH 左側欄增加「DeepSeek 網頁版」主面板,並提供 deepseek_web_ask、deepseek_web_read 工具及內置技能。插件爲非官方實現,與 DeepSeek 官方無關;網頁版回覆屬於外部內容,需自行判斷。
這是什麼¶
dsh-deepseek-webchat 把 DeepSeek 網頁版嵌入 DSH 桌面端(Electron,profile 爲 desktop):主內容區通過 <webview> 加載 chat.deepseek.com,並註冊 agent 工具與技能,讓 DSH agent 在審批後可向網頁版提問、或讀取面板裏已顯示的對話。純 Web profile 不啓用(站點拒絕 iframe 嵌入,且該 profile 沒有桌面 webview 租約)。
當前倉庫版本爲 0.13.0(見 package.json),許可證 MIT。社區目錄頁:https://www.skillhub.cn/plugins/qingxingLi/dsh-deepseek-webchat;源碼:https://github.com/qingxingLi/dsh-deepseek-webchat。
核心功能¶
左側欄面板與登錄¶
- 全局面板列表新增「DeepSeek 網頁版」,點擊後主內容區顯示網頁版;複用桌面殼的
globalThis.dshDesktop.browserwebview 租約(與官方右側欄「瀏覽器」同類機制)。 - 自動寫入語言偏好
zh_CN,登錄頁與主界面爲中文。 - 登錄後將
userToken/__appKit_userInfo備份到 Harness 窗口持久 localStorage(鍵dsh-deepseek-webchat.auth.v1),下次打開含重啓後自動恢復;訪客分區爲內存級,依賴 token 備份。 - 訪客 UA 歸一爲普通 Chrome UA,並預置 DeepSeek「已知曉」開關,減少「使用環境異常」反覆彈出。
主題與皮膚¶
讀取當前 DSH 主題(含第三方皮膚)的實際 --dsw-alias-* 顏色注入網頁版;淺色/深色與 skin-center 切換會同步(約 40 個 alias token)。網頁版主題以 DSH 爲準,賬號側 DeepSeek 設置本身不變;皮膚背景插畫不會複製,非 token 硬編碼顏色(如圖表)不會變。
導入 DSH 對話¶
在任意會話輸入框工具欄點箭頭按鈕,彈出歷史消息選擇面板(複選框、全選/全不選),勾選後整理成 Markdown 填入網頁版輸入框;內容含 agent 工具調用摘要,保留 @ 引用路徑;不自動發送。分享上限:最近 60 條消息、約 8000 字符;工具參數截斷 400 字符、結果截斷 600 字符;模型 reasoning 不分享。
Agent 工具與技能¶
| 工具 | 作用 |
|---|---|
deepseek_web_ask |
把 prompt(string,最多 20000 字符)發到網頁版並取回回覆;發送前彈確認條(取消 / 本會話都允許 / 允許發送),90 秒無操作自動取消;單次等待生成最長約 2 分鐘;一次僅一個在途提問;輸入框有未發送草稿時會拒絕發送。 |
deepseek_web_read |
讀取面板裏已顯示的對話([user]/[assistant] 逐輪);參數 max_chars(默認 12000,上限 60000)、last(最近 N 條,0 爲全部,上限 200);只讀本機 DOM,不發送、不消耗網頁版上下文。 |
裝好後內置技能 deepseek-web-ask 與系統提示段,agent 可獲知何時使用、失敗如何處理。網頁版保留當前對話上下文,可連續追問;配合「本會話都允許」可本會話內免逐次確認(內存級,插件重載或重啓後重置)。
剪貼板橋¶
桌面殼訪客會話禁用 Clipboard API 時,網頁「複製」按鈕會失敗;插件在 Host 端用系統命令橋接(macOS pbcopy,Windows PowerShell Set-Clipboard,Linux 假定 wl-clipboard 的 wl-copy)。快捷鍵複製/粘貼仍可用;只在本機流轉。
安裝與啓用¶
前置條件:DSH 桌面端,且 dsh 命令在 PATH 上。
# 從 GitHub 安裝
dsh plugin --profile desktop add "github:qingxingLi/dsh-deepseek-webchat"
# 或本地目錄(開發時)
dsh plugin --profile desktop add "link:/absolute/path/to/dsh-deepseek-webchat"
也可在 DSH 插件管理器裏安裝本地目錄。安裝後重啓 Harness,或在「插件」頁啓用 dsh-deepseek-webchat。
典型用法¶
打開面板與分享歷史¶
- 點左側欄「DeepSeek 網頁版」;首次登錄 DeepSeek 賬號,之後自動恢復。
- 需要把 DSH 會話內容帶到網頁版時:輸入框工具欄箭頭 → 勾選歷史消息 → 內容進入網頁版輸入框,確認後自行發送。
讓 agent 向網頁版提問¶
對 DSH 說例如:
問一下網頁版:<你的問題>
讓 DeepSeek 網頁版回答一下:……
用網頁版做三輪追問:先問 A,再根據回答問 B 和 C
流程:agent 調用 deepseek_web_ask → 自動打開或切到網頁版面板 → 確認條展示完整問題 → 允許後填入併發送 → 等待生成完成 → 回覆作爲工具結果返回。
讓 agent 讀取網頁版對話¶
讀取一下網頁版當前的對話,總結成要點
把網頁版剛纔的討論存到工作區 md 文件
需面板已登錄;長曆史可能只加載最近一部分,讀取範圍以頁面當前可見消息爲準。
工作原理(概要)¶
DSH agent 調用工具後,Host 半(index.js)把請求入隊,並通過 webServer 註冊同源路由 /dsh-deepseek-webchat/poll 與 /dsh-deepseek-webchat/result(ctx.connection 鑑權);Client 半(client.js)約每 2 秒輪詢 poll,執行 ask/read,結果 POST 回 Host。非 desktop profile 時由 cordis.patch.yml 自動禁用 bundle。
適用場景與注意¶
適合:已在用 DSH 桌面端、希望網頁版與 Harness 同屏、且需要 agent 在人工審批後代問或讀取頁面對話的開發者。
限制與風險(摘自 README):
- 僅桌面端;token 過期或被服務端清除需重新登錄。
- 輸入框、發送按鈕、回覆區域依賴當前 DeepSeek 網頁 DOM 結構,站點改版可能導致失敗。
- 主題強制跟隨 DSH;UA 歸一與隱藏環境提示需自行評估服務條款與風險。
- 登錄 token 明文備份在本機 Harness localStorage;退出登錄會清除備份。提問前確認條會展示完整問題,勿把密鑰、密碼、令牌或未脫敏隱私發給網頁版。
- 網頁版回覆爲外部未受信任內容,勿在 DSH 中直接執行其中指令。
插件以當前 DSH 進程權限運行;安裝前請閱讀源碼與 MIT 許可證,自行判斷是否滿足安全與合規要求。DSH 生態強調「一切皆插件」;SkillHub 等社區目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-deepseek-webchat 把 DeepSeek 網頁版收進 DSH 左側欄,並在審批與技能約束下提供 deepseek_web_ask、deepseek_web_read,便於「人看網頁、agent 代問或讀屏內對話」的一體化工作流。