@goodandready/dsh-lanmode 0.2.0 → 0.3.0

package/README.md

@@ -1,61 +1,109 @@
 # dsh-lanmode
 
-**Settings over the LAN** for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh).
+Open the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web UI from another device — a phone, a tablet, the laptop on the other side of the room — and have **all of it** work, including the parts the UI switches off when the page is not `localhost`.
 
-Open the Web UI at `http://192.168.1.50:3080` instead of `http://localhost:3080` and every settings card in the deployment goes blank — your plugins' cards, and **Settings → Plugins → Plugin configuration** with them. No error appears, the plugins load fine, and reloading does not help. Saving silently does nothing.
+Works whether you put a reverse proxy in front of the harness or let this plugin serve the network itself. Pick a mode, restart, done.
 
-This plugin fixes that. Install it, reload the page, and the settings work from any address.
+## What breaks without it
+
+Reach the UI at a LAN address and you get some mix of:
+
+- **Settings → Models**: `settings are unavailable in this browser`
+- **Settings → Plugins → Plugin configuration**: empty, no cards at all
+- every plugin's settings card: blank, and saving silently does nothing
+- on plain HTTP, nothing loads at all: sessions and models never render
+
+None of that is the server refusing. The server serves settings over the network perfectly well.
 
 ## Why it happens
 
-The decision is made in the browser, from the page's hostname:
+Two independent things.
+
+**The settings service turns itself off.** The UI decides from the page's hostname:
 
 ```js
-isLoopback: pageLocation === undefined || isLoopbackHostname(pageLocation.hostname)
+isLoopback: pageLocation === undefined || isLoopbackHostname(hostname)
 ```
 
-`isLoopbackHostname` accepts `localhost`, `[::1]` and `127.0.0.0/8` — nothing else. A page served at a LAN address is therefore "remote", and the settings service switches to a process-local mode where the shared mirror of the settings document is never read at all:
+`isLoopbackHostname` accepts `localhost`, `[::1]` and `127.0.0.0/8`, nothing else. Anything else puts the settings service into a process-local mode where the shared mirror of the settings document is never read, every namespace reports `status: "unavailable"` for the life of the page, and writes are dropped before they reach the wire.
 
-```js
-ensure() { if (this.persistence === "memory") return Promise.resolve() }
-status: persistence === "host" ? "loading" : "unavailable"
-enqueue() { if (this.persistence === "memory") return Promise.resolve() }
+**Some Web APIs only exist on a secure context.** `crypto.randomUUID` is called on boot-critical paths, and `navigator.clipboard` behind the copy buttons. Over plain HTTP from a LAN address the browser withholds both.
+
+## What the plugin does
+
+Everything happens through the web server's official index tap: one script is injected into `index.html` ahead of the boot manifest. No product source is modified, and removing the plugin restores the page exactly.
+
+| Piece | Setting | What it does |
+|---|---|---|
+| Settings | `settings` | Hands the two settings packages a connection whose `isLoopback` reads `true`. Everything downstream — the shared mirror, every namespace scope, the core's own pages — then behaves as it does on localhost. |
+| `crypto.randomUUID` | `randomUuid` | Provides an RFC 4122 v4 implementation over `crypto.getRandomValues`, which insecure origins do have. A no-op where the real one exists. |
+| `navigator.clipboard` | `clipboard` | Provides a `writeText` fallback so the copy buttons keep working. A no-op where the real one exists. |
+
+The settings substitution is deliberately narrow. Three packages read that flag, and the third is deliverables, where it decides whether a produced file may be opened locally — forcing it there would ask the Host to open paths on the server's desktop. Only the settings packages see the substitute.
+
+## Two modes
+
+```yaml
+- id: dsh-lanmode
+  config:
+    mode: proxy        # proxy | direct
 ```
 
-Every bound namespace reports `status: "unavailable"` for the life of the page, and writes are dropped before they reach the wire.
+**`proxy`** (default) — something already listens on the network in front of the harness: nginx, Caddy, Tailscale serve, an SSH tunnel. The plugin only repairs the page and touches nothing else. This is the safe default: it cannot collide with whatever you already run.
 
-**The server does not share this restriction.** Both `settings.describe` and `settings.mutate` answer normally over the network as long as the request's `Origin` matches the page it came from — which is exactly the case for requests the UI itself makes. Verified against a live harness behind a reverse proxy.
+**`direct`** — no proxy anywhere. The plugin opens a listener of its own and forwards to the harness, rewriting `Host` and `Origin` to the loopback authority so the harness's same-origin fence is satisfied:
 
-## What the plugin does
+```yaml
+- id: dsh-lanmode
+  config:
+    mode: direct
+    directHost: '0.0.0.0'   # every interface
+    directPort: 3088
+```
+
+Then open `http://<the machine's IP>:3088` from any device on the network.
+
+A listener rather than rebinding the harness itself, for two reasons: a bind host lives in the config tree and cannot be a switch inside the plugin, and rebinding to `0.0.0.0` collides with a reverse proxy already holding that port.
+
+Changing the mode takes effect on restart.
 
-It injects one script into the served `index.html`, through the web server's official index tap, ahead of the boot manifest. The script intercepts module registration and hands the two settings packages a connection whose `isLoopback` reads `true`. Everything downstream — the shared mirror of the settings document, every namespace scope, the core's own settings pages — then behaves exactly as it does on localhost.
+## Settings
 
-The substitution is narrow on purpose. Three packages read that flag, and the third is deliverables, where it decides whether a produced file may be opened locally: forcing it there would ask the Host to open paths on the server's desktop. Only the settings packages see the substitute; the rest of the UI keeps the truth.
+All of it can be edited as the `dsh-lanmode` namespace — in `$DSH_HOME/settings.yaml`, or from the UI once the settings pages work.
 
-Taking the core settings service over instead is not possible — cordis refuses a second provider for a registered name, and refuses assignment across fibers.
+| Setting | Default | Meaning |
+|---|---|---|
+| `mode` | `proxy` | `proxy` or `direct` |
+| `directHost` | `0.0.0.0` | `direct`: which address to listen on |
+| `directPort` | `3088` | `direct`: which port to listen on |
+| `settings` | `true` | return the settings service |
+| `randomUuid` | `true` | provide `crypto.randomUUID` on plain HTTP |
+| `clipboard` | `true` | provide a clipboard fallback on plain HTTP |
 
 ## Checking it
 
-- `?lanmode=invert` — report the flag as `false` even on a loopback page. The harness then fails exactly the way it does over the LAN, which is how this plugin is verified.
-- `?lanmode=off` — stand the plugin down entirely.
+- `?lanmode=invert` — report the loopback flag as `false` even on localhost. The harness then fails exactly the way it does over the LAN; this is how the plugin is verified.
+- `?lanmode=off` — stand the plugin down entirely, to see the page as it would be without it.
 
 On a loopback page the plugin substitutes `true` where the real value is already `true`, so it cannot change behaviour there.
 
 ## What it is not
 
-Not authentication. The plugin does not add a password and does not widen what the server accepts — the harness answers those same calls with or without it. If your harness is reachable by other people, put a real gate in front of it (HTTP auth in your reverse proxy, or a VPN); a plugin cannot do that job, because the web server service hands plugins their own routes and no way to intercept anyone else's.
+**Not authentication.** It adds no password and does not widen what the server accepts — the harness answers those same calls with or without it. `direct` mode does make the harness reachable by anyone who can reach that port, exactly as a reverse proxy would. If other people share your network, put a real gate in front of the harness. A plugin cannot do that job: the web server hands plugins their own routes and no way to intercept anyone else's.
 
-## Structure
+**No microphone over plain HTTP.** Browsers withhold `navigator.mediaDevices` outside a secure context, so voice input plugins stop working on a plain-HTTP LAN address. Nothing can polyfill that. If you need the microphone, keep HTTPS in front and use `proxy` mode.
 
+## Install
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-lanmode
 ```
-dsh-lanmode/
-├── package.json            # dsh bundle/plugin metadata
-├── cordis.patch.yml        # bundle layer: inserts the plugin row
-├── lib/index.js            # host: nothing but a log line — the work is in the browser
-├── lib/client.js           # browser: the settings mirror and namespace scopes
-├── README.md
-└── LICENSE                 # MIT
-```
+
+Restart the harness, then reload the browser.
+
+## Credit
+
+The index-tap approach and the `crypto.randomUUID` polyfill come from [dsh-web-lan-access](https://github.com/AcidGr/dsh-web-lan-access) (MIT), which solves the secure-context half of this problem. Several other plugins in the same space — `dsh-lan-access`, `dsh-lan`, `dsh-LAN`, `dsh-lan-gate`, `dsh-Remote` — cover binding, mobile layout and device approval; none of them return the settings service, which is what this one is for.
 
 ## License
 

package/cordis.patch.yml

@@ -1,10 +1,22 @@
 # dsh-lanmode bundle layer: applied automatically when the package is installed
 # as a profile bundle (package.json declares dsh.bundle.patch).
 #
-# `name` must stay the full npm package name: the client-modules registry
-# resolves the browser bundle by the loader entry name, so a shortened name
-# leaves the UI half silently out of window.__DSH_BOOT__ — and the UI half is
-# the whole plugin here.
+# `name` must stay the full npm package name: the loader entry name is how the
+# served bundle is resolved.
+#
+# Everything is configurable in the `dsh-lanmode` settings namespace, so the
+# row below stays empty. To pin the mode in the tree instead of the settings
+# document, override it in your own profile patch:
+#
+#   - id: dsh-lanmode
+#     config:
+#       mode: direct
+#       directPort: 3088
+#
+# Note there is deliberately no webserver override here. Other plugins in this
+# space rebind the harness to 0.0.0.0; that cannot be switched from inside a
+# plugin and collides with a reverse proxy already holding the port. Direct
+# mode opens a listener of its own instead.
 - insert:
     - id: dsh-lanmode
       name: '@goodandready/dsh-lanmode'

package/lib/bridge.js

@@ -0,0 +1,92 @@
+// Прямой режим: слушатель на сетевом адресе, который передаёт всё харнессу.
+//
+// Зачем не привязка харнесса к 0.0.0.0, как делают соседние плагины. Привязка
+// задаётся в дереве конфигурации и меняется только перезапуском, то есть
+// «переключателем в плагине» быть не может. Хуже того, если перед харнессом
+// уже стоит обратный прокси на том же порту, привязка столкнётся с ним лбами.
+// Отдельный слушатель включается и гасится вместе со строкой плагина и живёт
+// рядом с любым прокси.
+//
+// Заголовки Host и Origin переписываются на локальные: харнесс пропускает
+// запрос, только когда Origin совпадает с адресом, по которому он слушает.
+// Это ровно то, что делает любой обратный прокси, и это же означает, что
+// прямой режим открывает харнесс всем, кто дотянется до этого порта, — как и
+// nginx сегодня. Пароля здесь нет и быть не может: плагин чужие маршруты не
+// перехватывает.
+
+import http from 'node:http'
+
+function rewritten(headers, authority) {
+  const out = { ...headers, host: authority }
+  if (out.origin) out.origin = 'http://' + authority
+  if (out.referer) out.referer = String(out.referer).replace(/^https?:\/\/[^/]+/, 'http://' + authority)
+  return out
+}
+
+/**
+ * @param ctx контекст плагина (нужен ctx.webServer.port)
+ * @param options {{host: string, port: number, log: (message: string) => void}}
+ * @returns функция остановки
+ */
+export function startDirectBridge(ctx, options) {
+  const upstreamPort = ctx.webServer.port
+  if (!upstreamPort) {
+    options.log('прямой режим не поднят: веб-сервер ещё не сообщил порт')
+    return () => {}
+  }
+  const authority = '127.0.0.1:' + upstreamPort
+
+  const bridge = http.createServer((req, res) => {
+    const upstream = http.request({
+      host: '127.0.0.1',
+      port: upstreamPort,
+      method: req.method,
+      path: req.url,
+      headers: rewritten(req.headers, authority),
+    }, (answer) => {
+      res.writeHead(answer.statusCode || 502, answer.headers)
+      answer.pipe(res)
+    })
+    upstream.on('error', () => {
+      if (!res.headersSent) res.writeHead(502, { 'content-type': 'text/plain; charset=utf-8' })
+      res.end('dsh-lanmode: харнесс не отвечает')
+    })
+    req.pipe(upstream)
+  })
+
+  // Веб-сокеты интерфейса идут через Upgrade: их надо передать сырыми.
+  bridge.on('upgrade', (req, socket, head) => {
+    const upstream = http.request({
+      host: '127.0.0.1',
+      port: upstreamPort,
+      method: req.method,
+      path: req.url,
+      headers: rewritten(req.headers, authority),
+    })
+    upstream.on('upgrade', (answer, upstreamSocket, upstreamHead) => {
+      const lines = ['HTTP/1.1 101 Switching Protocols']
+      for (const [key, value] of Object.entries(answer.headers)) lines.push(key + ': ' + value)
+      socket.write(lines.join('\r\n') + '\r\n\r\n')
+      if (upstreamHead && upstreamHead.length) socket.unshift(upstreamHead)
+      upstreamSocket.pipe(socket)
+      socket.pipe(upstreamSocket)
+      const drop = () => { try { upstreamSocket.destroy() } catch (already) { /* уже мертво */ } }
+      socket.on('error', drop)
+      socket.on('close', drop)
+    })
+    upstream.on('error', () => { try { socket.destroy() } catch (already) { /* уже мертво */ } })
+    if (head && head.length) upstream.write(head)
+    upstream.end()
+  })
+
+  bridge.on('error', (failure) => {
+    options.log('прямой режим не поднялся: ' + String(failure && failure.message || failure))
+  })
+
+  bridge.listen(options.port, options.host, () => {
+    options.log('прямой режим: слушаю ' + options.host + ':' + options.port
+      + ', передаю на ' + authority)
+  })
+
+  return () => { bridge.close() }
+}

package/lib/index.js

@@ -1,50 +1,140 @@
 // dsh-lanmode — хост-половина.
 //
-// Задача плагина: вернуть настройки на страницах, открытых не с localhost.
+// Плагин возвращает веб-интерфейсу то, что он сам себе запрещает на странице,
+// открытой не с localhost. Три независимых куска, каждый выключается отдельно.
 //
-// Веб-интерфейс решает это в браузере, по имени хоста страницы:
+// 1. Настройки. Интерфейс решает по имени хоста страницы:
 //
-//   isLoopback: pageLocation === undefined || isLoopbackHostname(hostname)
+//      isLoopback: pageLocation === undefined || isLoopbackHostname(hostname)
 //
-// где своими считаются только localhost, [::1] и 127.0.0.0/8. Дальше сервис
-// настроек уходит в режим «памяти»: общий вид документа не читается никогда,
-// каждый раздел получает статус "unavailable", запись выбрасывается до
-// отправки. Внешне — пустые карточки всех плагинов, пустая вкладка «Настройки
-// плагинов» и страница «Модели» с надписью
-// "settings are unavailable in this browser".
+//    и своими считает только localhost, [::1] и 127.0.0.0/8. Дальше сервис
+//    настроек уходит в режим «памяти»: общий вид документа не читается никогда,
+//    каждый раздел получает статус "unavailable", запись выбрасывается до
+//    отправки. Наружу это выглядит как пустые карточки всех плагинов, пустая
+//    вкладка «Настройки плагинов» и страница «Модели» с надписью
+//    "settings are unavailable in this browser". Сервер это ограничение не
+//    разделяет: describe и mutate по сети отвечают штатно.
 //
-// Сервер это ограничение не разделяет: settings.describe и settings.mutate по
-// сети отвечают штатно, когда Origin совпадает с адресом страницы, — то есть
-// ровно в том случае, когда запрос шлёт сам интерфейс.
+// 2. crypto.randomUUID. Существует только на защищённом соединении, а
+//    интерфейс зовёт его на пути загрузки. На чистом HTTP по сетевому адресу
+//    его нет, и каждый вызов к серверу падает. Приём и заготовка заплатки
+//    взяты у dsh-web-lan-access (AcidGr), MIT.
 //
-// Поэтому плагин вставляет в index.html короткий скрипт (через официальную
-// точку webServer.tapIndex) и подменяет флаг ТОЧЕЧНО — только для двух
-// настроечных пакетов ядра. Флаг читают трое, и третьему подменять нельзя:
-// в результатах работы isLoopback решает, можно ли открыть файл локально, и
-// с подменой браузер просил бы открыть путь на машине сервера.
+// 3. navigator.clipboard. Тоже только для защищённого соединения — без него
+//    кнопки «Копировать» молчат. Подставляем запасной путь.
+//
+// Всё это вставляется в index.html через официальную точку webServer.tapIndex.
+//
+// Чего здесь намеренно НЕТ — привязки к 0.0.0.0. Она нужна тем, кто ходит на
+// харнесс напрямую, и ставится отдельным слоем в cordis.patch.yml профиля
+// (образец — в нашем cordis.patch.yml). Включать её вслепую нельзя: если
+// перед харнессом стоит обратный прокси на том же порту, они столкнутся.
 
+import z from '@deepseek-ai/schemastery'
 import { readFileSync } from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
+import { startDirectBridge } from './bridge.js'
 
 export const name = 'dsh-lanmode'
 export const inject = ['webServer']
 
+export const Config = z.object({
+  mode: z
+    .string()
+    .description('How the browser reaches the harness. '
+      + '"proxy": something in front of it already listens on the network (nginx and friends) — '
+      + 'the plugin only repairs the page. '
+      + '"direct": the plugin also opens a listener of its own on the network and forwards to the '
+      + 'harness, so nothing else is needed.')
+    .default('proxy'),
+  directHost: z
+    .string()
+    .description('mode=direct: which address to listen on. 0.0.0.0 means every interface.')
+    .default('0.0.0.0'),
+  directPort: z
+    .number()
+    .description('mode=direct: which port to listen on. Keep it clear of whatever else is running.')
+    .default(3088),
+  settings: z
+    .boolean()
+    .description('Return the settings service on pages that are not localhost. '
+      + 'This is the part no other plugin does.')
+    .default(true),
+  randomUuid: z
+    .boolean()
+    .description('Provide crypto.randomUUID where the browser withholds it (plain HTTP). '
+      + 'A no-op on HTTPS and on localhost.')
+    .default(true),
+  clipboard: z
+    .boolean()
+    .description('Provide a fallback for navigator.clipboard.writeText on plain HTTP, '
+      + 'so the copy buttons keep working. A no-op where the real one exists.')
+    .default(true),
+})
+
 const here = path.dirname(fileURLToPath(import.meta.url))
 
-/** Скрипт-заплатка читается с диска: так его видно и правится он как код. */
+/** Заплатка лежит рядом обычным файлом: так её видно и правится она как код. */
 function shimSource() {
   return readFileSync(path.join(here, 'shim.js'), 'utf8')
 }
 
-export function apply(ctx) {
-  const script = '<script data-dsh-lanmode="1">' + shimSource() + '</script>'
+/** Namespace, который плагин объявляет: через него режим правится настройками. */
+const NS = 'dsh-lanmode'
+
+export function apply(ctx, config) {
+  // Значения берём из сервиса настроек, если он есть: тогда режим правится
+  // в настройках, а не только в дереве плагинов. Смена режима требует
+  // перезапуска — слушатель поднимается один раз при старте.
+  ctx.inject(['settings'], (sctx) => {
+    let effective = config
+    try {
+      const scope = sctx.settings.register(NS, Config, { base: config })
+      effective = scope.get() ?? config
+    } catch (alreadyRegistered) {
+      effective = config
+    }
+    start(sctx, effective)
+  })
+
+  // Без сервиса настроек тоже должно работать — тогда только дерево плагинов.
+  ctx.effect(() => {
+    if (ctx.get && ctx.get('settings')) return () => {}
+    start(ctx, config)
+    return () => {}
+  }, 'dsh-lanmode: запуск без сервиса настроек')
+}
+
+function start(ctx, config) {
+  // Прямой режим: свой слушатель на сетевом адресе. В режиме прокси не
+  // поднимаем ничего — сеть уже обслуживает кто-то другой.
+  if (config.mode === 'direct') {
+    ctx.effect(() => startDirectBridge(ctx, {
+      host: config.directHost || '0.0.0.0',
+      port: config.directPort || 3088,
+      // eslint-disable-next-line no-console
+      log: (message) => console.info('[dsh-lanmode] ' + message),
+    }), 'dsh-lanmode: слушатель прямого режима')
+  }
+
+  const pieces = {
+    settings: config.settings !== false,
+    randomUuid: config.randomUuid !== false,
+    clipboard: config.clipboard !== false,
+  }
+  // Ничего не включено — и вставлять нечего.
+  if (!pieces.settings && !pieces.randomUuid && !pieces.clipboard) return
+
+  const script = '<script data-dsh-lanmode="1">'
+    + 'window.__DSH_LANMODE__=' + JSON.stringify(pieces) + ';'
+    + shimSource()
+    + '</script>'
 
   ctx.effect(() => ctx.webServer.tapIndex((html) => {
     if (html.includes('data-dsh-lanmode')) return html
-    // Сразу за <head>: к моменту, когда страница начнёт грузить бандлы,
-    // перехватчик уже стоит. Загрузчик к этому моменту может ещё не
-    // существовать — заплатка это учитывает.
+    // Сразу за <head>: заплатка должна отработать раньше всего остального,
+    // иначе заглушка приедет после первого же вызова, который её ждёт.
     const at = html.indexOf('<head>')
     if (at === -1) return script + html
     return html.slice(0, at + '<head>'.length) + script + html.slice(at + '<head>'.length)

package/lib/shim.js

@@ -1,29 +1,85 @@
 (function () {
-  // Заплатка выполняется в самом начале страницы, до загрузки бандлов ядра.
+  // Заплатка выполняется первой на странице, до загрузки чего бы то ни было.
+  // Что включено — решает хост-половина, значения приезжают в __DSH_LANMODE__.
+  var options = window.__DSH_LANMODE__ || {}
+
+  // Отладочные переключатели в адресной строке:
+  //   ?lanmode=off    — не вмешиваться совсем (посмотреть, как без плагина);
+  //   ?lanmode=invert — притвориться чужой страницей на своей же
+  //                     (так проверяется, что заплатка правда управляет флагом).
+  var mode = ''
+  try { mode = new URLSearchParams(location.search).get('lanmode') || '' } catch (noSearch) { mode = '' }
+  if (mode === 'off') return
+  var loopbackAnswer = mode !== 'invert'
+
+  // ------------------------------------------------------- crypto.randomUUID
   //
-  // Она перехватывает регистрацию двух настроечных пакетов и подсовывает им
-  // связь, у которой isLoopback всегда true. Остальные пакеты видят правду:
-  // в результатах работы этот же флаг решает, открывать ли файл локально, и
-  // подменять его там нельзя.
+  // Приём и заготовка — из dsh-web-lan-access (AcidGr), MIT. Существует только
+  // на защищённом соединении, а интерфейс зовёт его при загрузке: на чистом
+  // HTTP по сетевому адресу без этого не поднимается вообще ничего.
+  if (options.randomUuid) {
+    var crypto_ = globalThis.crypto
+    if (!crypto_) { try { crypto_ = globalThis.crypto = {} } catch (frozen) { crypto_ = null } }
+    if (crypto_ && typeof crypto_.randomUUID !== 'function' && typeof crypto_.getRandomValues === 'function') {
+      crypto_.randomUUID = function randomUUID() {
+        var bytes = new Uint8Array(16)
+        crypto_.getRandomValues(bytes)
+        bytes[6] = (bytes[6] & 15) | 64
+        bytes[8] = (bytes[8] & 63) | 128
+        var hex = ''
+        for (var i = 0; i < 16; i++) hex += bytes[i].toString(16).padStart(2, '0')
+        return hex.slice(0, 8) + '-' + hex.slice(8, 12) + '-' + hex.slice(12, 16)
+          + '-' + hex.slice(16, 20) + '-' + hex.slice(20)
+      }
+    }
+  }
+
+  // ------------------------------------------------------ navigator.clipboard
+  //
+  // Тоже только для защищённого соединения. Без него кнопки «Копировать»
+  // молча ничего не делают; подставляем старый способ через скрытое поле.
+  if (options.clipboard) {
+    var nav = window.navigator
+    if (nav && (!nav.clipboard || typeof nav.clipboard.writeText !== 'function')) {
+      var writeText = function (text) {
+        return new Promise(function (resolve, reject) {
+          try {
+            var area = document.createElement('textarea')
+            area.value = String(text)
+            area.setAttribute('readonly', '')
+            area.style.position = 'fixed'
+            area.style.opacity = '0'
+            document.body.appendChild(area)
+            area.select()
+            var copied = document.execCommand('copy')
+            document.body.removeChild(area)
+            copied ? resolve() : reject(new Error('copy rejected'))
+          } catch (failure) { reject(failure) }
+        })
+      }
+      try {
+        if (nav.clipboard) nav.clipboard.writeText = writeText
+        else Object.defineProperty(nav, 'clipboard', { configurable: true, value: { writeText: writeText } })
+      } catch (cannotDefine) { /* останется как было */ }
+    }
+  }
+
+  // ------------------------------------------------------------- настройки
+  if (!options.settings) return
+
+  // Флаг читают трое, и третьему подменять нельзя: в результатах работы он
+  // решает, можно ли открыть файл локально, и с подменой браузер просил бы
+  // открыть путь на машине сервера. Поэтому — только два настроечных пакета.
   var TARGETS = [
     '@deepseek-ai/dsh-client-ui-settings',
     '@deepseek-ai/dsh-client-ui-settings-general',
   ]
 
-  // Отладочные переключатели через адресную строку:
-  //   ?lanmode=off — не вмешиваться (проверить, как было без плагина);
-  //   ?lanmode=invert — притвориться чужим на своей же странице
-  //                     (так проверяется, что заплатка вообще управляет флагом).
-  var mode = ''
-  try { mode = new URLSearchParams(location.search).get('lanmode') || '' } catch (noSearch) { mode = '' }
-  if (mode === 'off') return
-  var forced = mode === 'invert' ? false : true
-
   function connectionWithForcedFlag(connection) {
     if (!connection || typeof connection !== 'object') return connection
     return new Proxy(connection, {
-      get: function (target, prop, receiver) {
-        if (prop === 'isLoopback') return forced
+      get: function (target, prop) {
+        if (prop === 'isLoopback') return loopbackAnswer
         var value = Reflect.get(target, prop, target)
         return typeof value === 'function' ? value.bind(target) : value
       },
@@ -32,7 +88,7 @@
 
   function ctxWithForcedConnection(ctx) {
     return new Proxy(ctx, {
-      get: function (target, prop, receiver) {
+      get: function (target, prop) {
         if (prop === 'get') {
           return function (nameRequested) {
             var value = target.get(nameRequested)
@@ -64,11 +120,12 @@
     return patched
   }
 
-  // Загрузчик подменяет собственный load, когда переходит из режима очереди
-  // в рабочий, — обёртка при этом слетала бы. Поэтому ставим её через
+  // Загрузчик подменяет собственный load, когда переходит из режима очереди в
+  // рабочий, — обёртка при этом слетала бы. Поэтому ставим её через
   // свойство-аксессор: любая новая функция оборачивается снова.
   function install(loader) {
     if (!loader || typeof loader !== 'object') return loader
+    if (loader.load && loader.load.__dshLanmode) return loader
     var wrapped
 
     function rewrap(fn) {
@@ -78,7 +135,6 @@
       wrapped.__dshLanmode = true
     }
 
-    if (loader.load && loader.load.__dshLanmode) return loader
     rewrap(loader.load)
     try {
       Object.defineProperty(loader, 'load', {
@@ -96,15 +152,9 @@
         loader.pendingQueue[i] = wrap(loader.pendingQueue[i])
       }
     }
-    try {
-      console.info('[dsh-lanmode] настройки будут работать на этой странице'
-        + (forced ? '' : ' (перевёрнутый режим: притворяемся чужим)'))
-    } catch (noConsole) { /* незачем */ }
     return loader
   }
 
-  // Загрузчик объявляется встроенным скриптом страницы. Если он уже есть —
-  // оборачиваем сразу; если нет — дожидаемся присваивания.
   if (window.__ModuleLoader__) {
     install(window.__ModuleLoader__)
     return
@@ -117,7 +167,7 @@
       set: function (value) { held = install(value) },
     })
   } catch (cannotDefine) {
-    // Свойство неподатливо — молчим: без заплатки страница остаётся такой же,
-    // какой была без плагина.
+    // Свойство неподатливо — молчим: страница останется такой же, какой была
+    // без плагина.
   }
 })()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goodandready/dsh-lanmode",
-  "version": "0.2.0",
-  "description": "Settings over the LAN for DeepSeek Harness: the Web UI turns its settings service off on any page that is not localhost, even though the server serves settings over the network fine. This plugin taps the served index.html and hands the two settings packages a connection that reports loopback, so every settings surface works from any address.",
+  "version": "0.3.0",
+  "description": "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.",
   "license": "MIT",
   "type": "module",
   "main": "./lib/index.js",
@@ -22,7 +22,9 @@
     "deepseek-harness",
     "settings",
     "lan",
-    "remote"
+    "remote",
+    "proxy",
+    "nginx"
   ],
   "repository": {
     "type": "git",