概览

@goodandready/dsh-lanmode

LAN and reverse-proxy access for the DeepSeek Harness Web UI: returns the settings service on pages that are not localhost, fills in the Web APIs the browser withholds on plain HTTP, and can open a listener of its own so nothing else is needed. Compatible with DeepSeek Harness 0.1.2-alpha.5.

README / ZH

插件文档

📦 @goodandready/dsh-lanmode

修复 DSH 0.1.2-alpha.5 兼容性： 保留异步插件初始化的等待语义，避免 Web UI 启动时服务尚未就绪。查看兼容性测试和 0.6.11 更新说明。

DeepSeek Harness 局域网访问优化、mDNS (dsh.local)、PWA、Root CA、QR 码、后台通知与自动 TLS 插件

🇬🇧 English • 🇷🇺 Русский • 🇨🇳 中文说明

⚡ 核心痛点：为什么局域网 IP 访问 DSH 会遭遇多重功能锁定

在纯 HTTP 环境下通过内网 IP（如 192.168.x.x 或 10.x.x.x）访问 DeepSeek Harness 时，浏览器与 DSH 前端会触发多项强制拦截：

🔒 设置与模型管理锁定：前端检测 !isLoopbackHostname 将设置服务降级为只读内存态，所有插件配置卡片变空，模型页面提示 "settings are unavailable in this browser"；
💥 UUID 生成崩溃：crypto.randomUUID() 仅在安全上下文存在，纯 HTTP 下调用直接报错崩溃；
📋 剪贴板复制失效：navigator.clipboard 接口被禁用，代码块一键复制按钮无响应；
🎙️ 麦克风语音输入拦截：移动端浏览器禁止纯 HTTP 访问麦克风接口，导致 dsh-voice 语音功能瘫痪；
🛡️ 核心 API 环回接口限制：核心设置及密钥接口只接受来自 127.0.0.1 的请求。

dsh-lanmode 通过 webServer.tapIndex 动态注入无侵入 Polyfill 补丁、启动直连网桥、mDNS 域名解析、本地根证书（Root CA）生成以及客户端设置卡片，在局域网内 100% 恢复全功能体验。

graph LR
    subgraph RemoteDevices [局域网终端设备]
        Client[📱 移动端 Safari / 💻 局域网笔记本: dsh.local:3088] -->|mDNS & HTTPS| Bridge[dsh-lanmode 智能直连网桥]
    end

    subgraph ShimsLayer [前端 tapIndex 注入补丁层 & PWA]
        Bridge --> Shim1[🔓 解除 Loopback 限制: 开启设置与模型管理]
        Bridge --> Shim2[🆔 补全 RFC 4122 crypto.randomUUID Polyfill]
        Bridge --> Shim3[📋 补全剪贴板复制降级兼容]
        Bridge --> Shim4[🔐 Local Root CA & TLS: 解锁麦克风权限]
        Bridge --> Shim5[📱 PWA Manifest 与移动端安全区适配]
        Bridge --> Shim6[🔔 Agent 生成结束后台系统通知]
    end

    subgraph HostBackend [DSH 服务端核心]
        Bridge --> HeaderRewrite[请求头 Host/Origin 环回重写]
        HeaderRewrite --> PrivilegedAPI[设置、凭据与模型管理接口]
    end

    subgraph Output [最终效果]
        Shim1 --> FullWeb[✅ 局域网与移动端 100% 完整体验]
        Shim2 --> FullWeb
        Shim3 --> FullWeb
        Shim4 --> FullWeb
        Shim5 --> FullWeb
        Shim6 --> FullWeb
        PrivilegedAPI --> FullWeb
    end

    style RemoteDevices fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
    style ShimsLayer fill:#181825,stroke:#cba6f7,stroke-width:2px,color:#cdd6f4
    style HostBackend fill:#11111b,stroke:#a6e3a1,stroke-width:2px,color:#cdd6f4
    style Output fill:#181825,stroke:#f38ba8,stroke-width:2px,color:#cdd6f4

✨ 核心特性

📱 /mobileqr 命令与二维码快速扫码连接：一键生成纯 SVG 二维码与内网连接带 Token 链接，手机扫码秒进；
📲 PWA 与移动端全屏模式：支持添加到主屏幕全屏无边框运行，完美适配刘海屏与状态栏；
🌐 自动 mDNS (dsh.local) 发现：局域网内直接输入 https://dsh.local:3088 即可访问；
🔐 本地 Root CA 根证书：提供 GET /dsh-lanmode/ca.crt 下载，安装至手机即可获得永久绿色可信 HTTPS；
🔔 后台系统通知（Web Notifications）：当浏览器最小化或手机锁屏时，Agent 回复完毕自动推送系统通知；
🎨 UI 设置卡片（lib/client.js）：无缝融入 DSH 设置面板，支持一键复制内网 URL 与切换二维码；
🛡️ 访问控制与可选 LAN PIN 码：支持 CIDR 子网白名单及特权修改 PIN 保护。

📦 安装指南

dsh plugin --profile web add @goodandready/dsh-lanmode

@goodandready/dsh-lanmode