前言¶
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。
