前言¶
DeepSeek Harness（DSH）裏的上下文密集型任務（讀代碼、解釋項目、回答實現細節）每次都要消耗 API token。這類任務其實是免費的網頁版最擅長的。本插件負責把“上下文搬運”這半件事做到順手：把項目上下文打包成結構化 prompt，複製到剪貼板，同屏打開 DeepSeek 網頁版粘貼提問；需要改代碼或複雜推理時，再回 Harness 走 API。
這是什麼¶
dsh-dual-bridge 是 DeepSeek Harness（DSH）的側邊欄插件，用於把當前工作區的文件打包成 prompt，方便粘貼到 DeepSeek 網頁版進行免費問答。它由 xiez0324-rgb 維護，定位是“雙入口分流”：讀項目/答疑走網頁版（免費），複雜推理/改碼仍走 Harness API（計費）。
核心功能¶
- 項目掃描：解析 .gitignore + 內置 30+ 排除規則（node_modules、.git、build、pycache、.env 等），掃描上限可調（500/2000/10000/不限，默認 2000），顯式報告截斷。
- 目錄樹選擇：可摺疊，勾選目錄 = 選中整棵子樹（三態含半選），默認不選任何文件，支持全選/僅代碼/全不選。
- 二進制可見：PDF/Office/圖片不出現“憑空消失”，目錄標註“不可打包 N”，文件行置灰。
- token 預算：按 1 token ≈ 4 字符估算，超預算時可選“只提示”或“按預算截斷”（貪心填充，被丟文件逐條列出）。
- prompt 組裝：項目結構樹 + 逐文件代碼塊（語言標註、反引號自適應）。
- 附件聲明（可選）：勾選後把同目錄下未包含的附件列進 prompt（上限 20 條）。
- 按需文本抽取：對單個 PDF/Office 文件點“抽取文本”，抽出的正文併入 prompt。
- 同屏打開網頁版：貼在屏幕右側的獨立窗口 + 自動聚焦；重複點擊只聚焦、不刷新已有對話。
- 複製到剪貼板：一步寫入系統剪貼板。
安裝與啓用¶
本插件的 UI 掛在 dsh-better-sidebar 上，必須先裝它。DSH 的 bundle 掛載只認 profile 的直接依賴（傳遞依賴不會被掛載），只裝本插件會出現“裝好了但界面沒變化”。
一條命令裝好（桌面 App / CLI）：
dsh plugin --profile desktop add dsh-dual-bridge dsh-better-sidebar@0.28.0 --allow-build=tesseract.js
命令行版 dsh web（profile = web）：
dsh plugin --profile web add dsh-dual-bridge dsh-better-sidebar@0.28.0 --allow-build=tesseract.js
裝完完全退出並重開 App（host 端路由只在啓動時加載）。版本要求：DSH >= 0.2.1-rc.1 < 0.3.0。
典型用法¶
- 在 DSH 裏打開一個會話（需要有工作區），側邊欄點“⇄ 分流對話”。
- 展開目錄，勾選要問的文件（勾目錄 = 整棵子樹；默認什麼都不選）。
- 點“📦 打包選中文件”→“📋 複製到剪貼板”。
- 點“🚀 同屏打開網頁版”→ 在網頁版輸入框 Cmd/Ctrl+V 粘貼 → 提問。
- 需要改代碼/複雜推理時，回 Harness 走 API。
PDF/Word/PPT/Excel/RTF 先點“提取文字”，圖片點“OCR 文字”——提取結果也會進剪貼板。無法轉文本的文件（視頻/壓縮包等）會自動打包到 ~/Desktop/dsh-pack-<時間戳>/，拖進網頁版上傳即可。
適用場景與注意¶
適合需要頻繁“讀代碼/解釋項目”但不必每次都計費的場景。插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。已知限制包括依賴 dsh-better-sidebar 的內部路由、host 端改動需重啓 dsh web、子目錄嵌套的 .gitignore 不解析、不跟隨目錄軟鏈、掃描上限默認 2000 個文件（可在界面調整）、抽取爲純文本會丟失排版/表格/圖片/公式結構、OCR 對藝術字/宣傳海報容易出噪聲等。
短結尾¶
dsh-dual-bridge 把“上下文搬運”做到順手，讓免費網頁版承擔讀代碼任務，把計費 API 留給真正需要複雜推理的場景。目錄頁：https://www.skillhub.cn/plugins/xiez0324-rgb/dsh-dual-bridge；GitHub：https://github.com/xiez0324-rgb/dsh-dual-bridge。
