前言¶
DeepSeek Harness (DSH) 插件系统强调“一切皆插件”。开发者常需要在电脑端启动 Web 会话后，在手机或平板上查看状态、验证移动端渲染效果，或处理紧急事务。常规的远程访问方案通常需要搭建中继服务器、绑定云账号或配置复杂的网络环境，对于简单的同网访问需求来说过于沉重。
dsh-local-link 旨在解决这个问题。这是一个轻量级插件，允许在同一信任网络内的其他设备（手机、平板、电脑）通过扫描二维码，直接接入当前正在运行的 DSH Web 会话。
插件定位¶
- 核心功能：扫描二维码，访问当前 DSH Web 会话。
- 维护者：donoteatme。
- 许可证：MIT。
- 版本：最新版本为 1.2.3。
核心能力¶
该插件不改变 DSH 的核心逻辑，仅提供接入层和视图适配：
- 同网访问：在同一受信任私有网络内，通过二维码或一次性链接将其他设备接入当前会话。
- 移动端适配：当设备视口宽度不超过 834 CSS 像素时，自动应用响应式移动视图，解决桌面端导航拥挤、操作不便的问题。
- 零依赖接入：无需托管中继、无需云账号、无需单独的原生 App 或替换聊天 UI。
- 状态同步：保持与桌面端相同的实时对话、权限、工作区和插件界面。
安装与启用¶
在安装前，请确保已安装并运行 DeepSeek Harness Web 模式。
- 停止当前运行的
dsh web进程。 - 在终端执行安装命令：
dsh plugin --profile web add dsh-local-link
- 重新启动 Harness Web：
dsh web
使用步骤¶
配置完成后，使用流程如下：
- 在电脑上打开并选中需要查看的 DSH 会话。
- 在 Harness 侧边栏底部找到并点击
Local access。 - 使用手机或平板扫描屏幕上的二维码，或复制显示的一次性链接。
- 第一个使用该邀请的浏览器将自动打开当前桌面端的选中会话。
此时，设备上的浏览器将获得当前会话的所有上下文和权限。对于手机和宽度不超过 834 CSS 像素的设备，系统会自动切换至 Mobile View。
安全边界与限制¶
- 网络环境：网关仅使用纯 HTTP，仅设计用于受信任的私有网络。严禁将端口暴露到公网或在公共 Wi-Fi 下使用。
- 时效性：邀请码默认为一次性使用，且在五分钟后过期。过期后需重新生成。
- 权限范围：远程访问仅能使用当前会话的权限，Host 端的某些管理功能（如仅限 Loopback 的功能）在远程端不可用。
适用场景¶
- 开发者验证移动端 UI 渲染效果。
- 在非移动设备上查看移动端适配后的聊天记录。
- 同一网络下的临时会话共享，无需配置 VPN 或云服务。
总结¶
dsh-local-link 提供了一种低门槛的本地局域网接入方案，解决了 DSH Web 在多设备场景下的状态同步与视图适配问题。其设计保持克制，不引入额外的业务逻辑，仅作为现有 Harness Web 客户端的轻量级补充。
