通过可信局域网直接打开同一个 Harness 会话。
## 产品范围 Local Link 是现有 Harness Web 客户端的小型局域网配套插件，不是通用远程访问平台。它专注于一条可靠路径：在同一私有网络中的另一台设备上打开电脑中已经运行的 Harness，并继续使用相同的会话和界面。 项目重点包括： - 可靠访问当前 Harness Host； - 短时一次性邀请和清晰的已配对设备生命周期； - 在不复制 Harness 业务逻辑的前提下提供响应式布局； - 兼容已注册的视图、插槽、权限、主题和会话状态； - 在可信局域网范围内完善无障碍、本地化、诊断和安全加固。 以下内容明确不在范围内： - 公网暴露、托管中继、托管隧道或云账户； - 独立的手机或桌面原生应用； - 替代聊天客户端或 Harness 界面分支； - 独立于 Harness 的工作区、文件或会话同步； - 与当前 Web UI 无关的通用远程扩展运行时。 ## 安装 ### npm（推荐） 停止正在运行的 `dsh web`，将插件安装到 Web profile，然后重新启动 Harness： ```shell dsh plugin --profile web add dsh-local-link dsh web ``` ### Git checkout（开发） 需要 Git、Node.js 22.19+ 或 24+、Corepack，以及全局安装的、版本已验证的 `dsh`。 ```shell git clone https://github.com/donoteatme/dsh-local-link.git cd dsh-local-link corepack pnpm install --frozen-lockfile npm run verify dsh plugin --profile web add . dsh web ``` profile 会指向当前 checkout。修改客户端代码后需要重新构建；修改 Host 侧代码后需要重启 `dsh web`。 ## 兼容性 兼容性按 DeepSeek Harness 的精确版本验证，不会因为“能够安装”就推断为兼容。 | DeepSeek Harness | Local Link 状态 | | --- | --- | | `0.1.5-rc.2` | **支持的发布版本** | | `0.1.5-rc.1` | **已验证** | | `0.1.2-rc.1` | **已验证** | | `0.1.1-rc.2` | **已验证** | | `0.1.1-rc.1` | **已验证** | | `0.1.0-rc.8` | **已验证** | 以上六个版本都使用打包后的 `1.1.1` 源码通过了已安装运行时的网关和撤销测试。对于 `1.2.0`，当前发布版本 `0.1.5-rc.2` 还使用精确依赖重新构建，并在真实浏览器客户端中完成了 `430 × 932` 与 `320 × 568` 检查。历史 RC 的验证证据继续保留；移动的 `next` 标签本身不代表兼容性承诺。 只有表格中的精确版本包含兼容性承诺。已移除的 alpha 版本、早于 `0.1.0-rc.8` 的版本，以及未来移动的 `next` 标签都必须单独验证。完整证据与边界见[兼容性说明](docs/COMPATIBILITY.md)。 ## 使用方法 1. 在电脑上打开需要使用的会话。 2. 点击 Harness 侧边栏底部的 `Local access`。 3. 在同一网络的另一台设备上扫描二维码或打开一次性链接。 4. 第一个使用邀请的浏览器会打开原生 Harness 客户端并进入当前会话。 邀请只能使用一次，默认五分钟后过期。选择 `Generate another code` 会立即替换旧邀请。Harness 仅允许 loopback 执行的 Host 管理操作在远程浏览器中仍然不可用。 宽度不超过 834 CSS px 的手机和平板会自动启用移动视图。不需要 URL 参数、User-Agent 开关或第二套客户端。 ## 移动视图 移动视图会重新组织原生 Harness Web 界面，但保留同一个 Host、会话、插件插槽、权限和实时智能体输出。 - 工作区和会话导航变成可关闭的左侧抽屉； - 当前会话的上下文、模型、权限、预设、活动和日志下载进入右侧抽屉； - Chat、Trajectory、输入区、覆盖层和第三方插件视图保持动态加载； - 会话和工作区操作在触控屏上保持可见； - 切换会话不会自动唤起软键盘，主动点击输入区仍会正常聚焦； - 深色/浅色主题继续由 Harness 主题服务管理； - 远程手机上隐藏容易误导的 `Add workspace` 目录选择器； - 顶栏、消息操作、输入工具、安全区域和虚拟键盘行为适配窄屏。 以下深色主题截图来自真实的 Harness 浏览器会话，使用 `430 × 932` 模拟视口。独立截图配置只包含虚构的产品演示数据，不包含本地工作区、对话、路径、提示词、模型或用量数据。 | 导航 | 当前会话 | 子智能体 | 对话 | | :---: | :---: | :---: | :---: | |
| 
| 
| 
|
### 权限
远程浏览器继承当前 Harness 会话的 **Read only**、**Workspace write** 或 **Full access** 权限。移动视图只显示该值，不会创建或削弱权限边界。隐藏 `Add workspace` 是可用性限制，不是安全边界。
响应式增强支持 **360 到 834 CSS px**。发布矩阵检查 `360 × 800`、`390 × 844`、`430 × 932` 和 `768 × 1024`，并要求在真实手机上完成横屏与竖屏验收。详见[移动视图说明](docs/MOBILE_VIEW.md)。
## 管理可信浏览器
在 Harness 电脑上打开二维码面板中的 `Paired devices`，或进入 `Settings → Local access`。
- `Rename` 只修改显示名称；
- `Revoke` 会使浏览器凭据失效，并立即关闭该设备当前打开的 Local Link WebSocket；
- 清除 Cookie、使用无痕窗口、新建浏览器 profile 或撤销设备后，都需要重新配对。
浏览器无法可靠区分笔记本与台式机，因此两者统一显示为 `Computer`。
