dsh-local-link 1.2.0 → 1.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +28 -0
- package/README.md +15 -24
- package/README.ru.md +267 -0
- package/README.zh.md +11 -20
- package/docs/ARCHITECTURE.md +6 -6
- package/docs/DIAGNOSTICS.md +1 -1
- package/docs/MOBILE_VIEW.md +3 -2
- package/lib/client.js +46 -20
- package/lib/client.js.map +1 -1
- package/package.json +46 -52
- package/docs/COMPATIBILITY.md +0 -75
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,34 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this project are documented here.
|
|
4
4
|
|
|
5
|
+
## 1.2.2 — 2026-09-27
|
|
6
|
+
|
|
7
|
+
### Changed
|
|
8
|
+
|
|
9
|
+
- Built against the exact DeepSeek Harness `0.1.7-rc.2` contracts while retaining the declared historical RC Host range.
|
|
10
|
+
- Accepted Harness's weight-named icon exports while preserving the older size-named exports for previous supported Hosts.
|
|
11
|
+
- Bound the mobile Current session drawer to the session-scoped trigger because the 0.1.7 list no longer contains current selection. The legacy custom subagent sheet now mounts only when its required catalog API exists; on 0.1.7 the native `dsh-client-ui-subagent` header action owns navigation.
|
|
12
|
+
- Hid the duplicate stock context meter and Host-app opener in Mobile View while retaining the context breakdown in Current session and both controls on desktop.
|
|
13
|
+
- Removed nine unused development-only Harness packages absent from the `0.1.7-rc.2` Host dependency graph.
|
|
14
|
+
|
|
15
|
+
### Validated
|
|
16
|
+
|
|
17
|
+
- Exercised one-use LAN pairing, native browser-auth handoff, authenticated page and `/api/remote.mux` WebSocket access, revoke-driven socket closure, and rejection after revoke on the running `0.1.7-rc.2` Host.
|
|
18
|
+
- Checked the live mobile menu, Current session drawer, and visible header controls without horizontal overflow at 320, 360, 390, 430, and 834 CSS px.
|
|
19
|
+
- Passed frozen-lockfile installation, TypeScript checking, all 103 tests, production build, package dry-run, and production dependency audit with no known vulnerabilities. Real-device mobile acceptance and the full manual plugin-surface checklist remain separate checks.
|
|
20
|
+
|
|
21
|
+
## 1.2.1 — 2026-09-21
|
|
22
|
+
|
|
23
|
+
### Changed
|
|
24
|
+
|
|
25
|
+
- Declared the supported DeepSeek Harness range through the official `engines.dsh` package metadata and added manifest format version `1`, allowing plugin clients to evaluate Host compatibility directly.
|
|
26
|
+
- Removed the duplicated compatibility matrices and standalone compatibility document; the package manifest is now the single source of truth, while historical validation remains recorded in this changelog.
|
|
27
|
+
- Updated the release contract to keep `engines.dsh` aligned with the Harness Host peer dependency.
|
|
28
|
+
|
|
29
|
+
### Validated
|
|
30
|
+
|
|
31
|
+
- Passed TypeScript checking, all 102 automated tests across 16 files, the production build, and package dry-run.
|
|
32
|
+
|
|
5
33
|
## 1.2.0 — 2026-09-18
|
|
6
34
|
|
|
7
35
|
`1.2.0` moves the development baseline to DeepSeek Harness `0.1.5-rc.2` and
|
package/README.md
CHANGED
|
@@ -1,17 +1,19 @@
|
|
|
1
1
|
# dsh-local-link
|
|
2
2
|
|
|
3
|
-
**English** | [中文](README.zh.md)
|
|
3
|
+
**English** | [中文](README.zh.md) | [Русский](README.ru.md)
|
|
4
4
|
|
|
5
5
|
[](https://github.com/donoteatme/dsh-local-link/actions/workflows/ci.yml)
|
|
6
6
|
[](https://www.npmjs.com/package/dsh-local-link)
|
|
7
|
-
[](https://www.npmjs.com/package/dsh-local-link)
|
|
8
|
+
[](https://awesome-dsh-plugin.com/p/donoteatme/dsh-local-link/)
|
|
9
|
+
[](https://dsh.market/)
|
|
8
10
|
[](LICENSE)
|
|
9
11
|
|
|
10
12
|
Use the same [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web session from a phone, tablet, or another computer on your trusted private network. `dsh-local-link` adds one-time QR pairing and a responsive Mobile View to the stock DSH client—without a hosted relay, cloud account, native app, replacement chat UI, or second workspace picker.
|
|
11
13
|
|
|
12
14
|
Open `Local access`, scan the QR code, and the paired browser arrives at the desktop's currently selected Harness session with the same live conversation, permissions, workspaces, and plugin surfaces.
|
|
13
15
|
|
|
14
|
-
The `1.2.x` line supports DeepSeek Harness `0.1.5-rc.2` and keeps the stock Web client usable on narrow touch screens. It reorganizes the existing Harness interface into responsive drawers, compact session controls, and touch-friendly actions while keeping the same client, session, plugin slots, permissions, and live agent stream.
|
|
16
|
+
The `1.2.x` line supports DeepSeek Harness `0.1.5-rc.2` and `0.1.7-rc.2` and keeps the stock Web client usable on narrow touch screens. It reorganizes the existing Harness interface into responsive drawers, compact session controls, and touch-friendly actions while keeping the same client, session, plugin slots, permissions, and live agent stream.
|
|
15
17
|
|
|
16
18
|
> **Security boundary:** the gateway uses plain HTTP and is intended only for a trusted private network. Do not expose its port to the internet or use it on public Wi-Fi.
|
|
17
19
|
|
|
@@ -21,7 +23,7 @@ The `1.2.x` line supports DeepSeek Harness `0.1.5-rc.2` and keeps the stock Web
|
|
|
21
23
|
|
|
22
24
|
<p align="center"><sub>One Harness session, paired directly across the trusted LAN.</sub></p>
|
|
23
25
|
|
|
24
|
-
##
|
|
26
|
+
## Features and scope
|
|
25
27
|
|
|
26
28
|
Local Link is intentionally a small LAN companion for the existing Harness Web client, not a general remote-access platform. Its purpose is to make one path dependable: open the Harness instance already running on a computer from another trusted device on the same private network, then use the same sessions and interface in a browser.
|
|
27
29
|
|
|
@@ -56,7 +58,7 @@ dsh web
|
|
|
56
58
|
|
|
57
59
|
### Git clone — development checkout
|
|
58
60
|
|
|
59
|
-
Requirements: Git, Node.js 22.19+ or 24+, Corepack, and a global `dsh` installation
|
|
61
|
+
Requirements: Git, Node.js 22.19+ or 24+, Corepack, and a global `dsh` installation compatible with the package's declared `engines.dsh` range.
|
|
60
62
|
|
|
61
63
|
```shell
|
|
62
64
|
git clone https://github.com/donoteatme/dsh-local-link.git
|
|
@@ -71,20 +73,9 @@ The profile points at the checkout, so rebuild after changing client code and re
|
|
|
71
73
|
|
|
72
74
|
## Compatibility
|
|
73
75
|
|
|
74
|
-
Compatibility is checked against exact
|
|
76
|
+
The installable DeepSeek Harness range is declared in `package.json` through `engines.dsh`. Compatibility is checked against exact releases—not inferred from a successful installation or a moving dist-tag.
|
|
75
77
|
|
|
76
|
-
|
|
77
|
-
| --- | --- |
|
|
78
|
-
| `0.1.5-rc.2` | **Supported release** |
|
|
79
|
-
| `0.1.5-rc.1` | **Verified** |
|
|
80
|
-
| `0.1.2-rc.1` | **Verified** |
|
|
81
|
-
| `0.1.1-rc.2` | **Verified** |
|
|
82
|
-
| `0.1.1-rc.1` | **Verified** |
|
|
83
|
-
| `0.1.0-rc.8` | **Verified** |
|
|
84
|
-
|
|
85
|
-
All six rows passed the installed-runtime gateway and revoke gate with packed `1.1.1` source. For `1.2.0`, the current `0.1.5-rc.2` release was additionally rebuilt against the exact package contracts and exercised in the real browser client at `430 × 932` and `320 × 568`. Historical RC evidence remains recorded separately and the moving `next` tag itself is never a compatibility promise.
|
|
86
|
-
|
|
87
|
-
Only the exact versions listed above carry a compatibility claim. Alpha builds—including the removed `0.1.2-alpha.1` row—versions older than `0.1.0-rc.8`, and whatever package a moving `next` tag points to later are unsupported until checked independently. See [Compatibility](docs/COMPATIBILITY.md) for the evidence and remaining real-device boundary.
|
|
78
|
+
Local Link `1.2.2` is built against `0.1.7-rc.2`. On that release, LAN pairing, one-time browser handoff, authenticated page and WebSocket access, and immediate WebSocket closure on revoke were exercised. The mobile icon adapter accepts both the new weight-named exports and the older size-named exports. Earlier RCs remain in `engines.dsh` based on the historical checks recorded in the changelog; they were not all rerun for this patch. Physical-phone acceptance is separate from browser emulation.
|
|
88
79
|
|
|
89
80
|
## Use
|
|
90
81
|
|
|
@@ -107,7 +98,7 @@ The stock Harness Web interface is difficult to operate on a phone: persistent d
|
|
|
107
98
|
| --- | --- |
|
|
108
99
|
| Desktop navigation competes with the conversation | Workspace and session navigation opens as a dismissible left drawer |
|
|
109
100
|
| Session metadata crowds the header | Context, model, access, preset, activity, and export move into a compact right drawer |
|
|
110
|
-
| Subagent details are difficult to scan or reach |
|
|
101
|
+
| Subagent details are difficult to scan or reach | On 0.1.5, a composer chip opens the catalog in a bottom sheet; on 0.1.7, Harness owns its header catalog and navigation |
|
|
111
102
|
| Hover-oriented session and workspace actions | Overflow actions remain visible and touch-accessible |
|
|
112
103
|
| Session changes can summon the software keyboard | Automatic composer focus is suppressed while intentional input focus still works |
|
|
113
104
|
| Desktop spacing ignores phone safe areas | Header, composer, tabs, media, overlays, and scrolling adapt to narrow viewports |
|
|
@@ -117,7 +108,8 @@ The implementation changes presentation, not Harness ownership or behavior:
|
|
|
117
108
|
- the native workspace/session browser becomes a left drawer;
|
|
118
109
|
- dynamic Chat, Trajectory, composer, overlay, and third-party plugin slots remain intact;
|
|
119
110
|
- Current session opens from the header with context breakdown, model, workspace access, preset, activity, and session-log download;
|
|
120
|
-
-
|
|
111
|
+
- on mobile, the duplicate stock context meter below the chat and the Host-app opener (Explorer/VS Code/Rider) are hidden; both remain available on desktop;
|
|
112
|
+
- on 0.1.5, child-agent status opens the nested catalog in a touch-friendly bottom sheet; on 0.1.7, the native Harness subagent header action owns that navigation;
|
|
121
113
|
- the Harness theme service powers a compact sun/moon action;
|
|
122
114
|
- desktop-only Settings and the nested Local access action are omitted from mobile navigation, while the appearance action remains available;
|
|
123
115
|
- session and active-workspace menus stay immediately available on touch screens;
|
|
@@ -125,7 +117,7 @@ The implementation changes presentation, not Harness ownership or behavior:
|
|
|
125
117
|
- plugin-owned modal drawers contain keyboard focus and return it to the invoking control when closed;
|
|
126
118
|
- existing workspaces remain available, while the misleading remote `Add workspace` directory picker is omitted.
|
|
127
119
|
|
|
128
|
-
These dark-theme previews
|
|
120
|
+
These dark-theme previews were captured on Harness `0.1.5-rc.2` at a `430 × 932` emulated viewport. The isolated screenshot profile uses synthetic product-demo data only; no local workspace, chat, path, prompt, model, or usage data appears in them. The 0.1.7 subagent catalog is native to Harness and differs from the pictured bottom sheet.
|
|
129
121
|
|
|
130
122
|
| Navigation | Current session | Subagents | Conversation |
|
|
131
123
|
| :---: | :---: | :---: | :---: |
|
|
@@ -185,7 +177,7 @@ The gateway does not create a second Harness session. During first connection it
|
|
|
185
177
|
|
|
186
178
|
Authorization uses a 256-bit random cookie credential. Only its SHA-256 hash is stored. The editable name and detected device/browser text never grant access.
|
|
187
179
|
|
|
188
|
-
The LAN authority is declared through Harness's official connection `trustedHosts` contract. This enables authenticated session API and WebSocket traffic without pretending that the phone is loopback. Harness `0.1.2-rc.1` and the verified `0.1.5` builds authenticate the transport as a whole, so Local Link itself rejects the configuration, credential, native Host-action, and agent-preset-authoring RPCs that earlier supported Harness builds kept loopback-only.
|
|
180
|
+
The LAN authority is declared through Harness's official connection `trustedHosts` contract. This enables authenticated session API and WebSocket traffic without pretending that the phone is loopback. Harness `0.1.2-rc.1` and the verified `0.1.5` and `0.1.7` builds authenticate the transport as a whole, so Local Link itself rejects the configuration, credential, native Host-action, and agent-preset-authoring RPCs that earlier supported Harness builds kept loopback-only.
|
|
189
181
|
|
|
190
182
|
## Configuration
|
|
191
183
|
|
|
@@ -249,7 +241,6 @@ npm run verify
|
|
|
249
241
|
Project documentation:
|
|
250
242
|
|
|
251
243
|
- [Architecture and compatibility boundaries](docs/ARCHITECTURE.md)
|
|
252
|
-
- [Verified DeepSeek Harness compatibility](docs/COMPATIBILITY.md)
|
|
253
244
|
- [Mobile View behavior and release matrix](docs/MOBILE_VIEW.md)
|
|
254
245
|
- [Local diagnostics and event codes](docs/DIAGNOSTICS.md)
|
|
255
246
|
- [Security model](docs/SECURITY.md)
|
|
@@ -265,7 +256,7 @@ Project documentation:
|
|
|
265
256
|
- The shortcut that opens a specific Settings section uses a small semantic compatibility bridge because Harness does not expose a general settings-navigation service.
|
|
266
257
|
- Harness's footer-action container needs a compatibility layout rule when the full-width Cordis action is present.
|
|
267
258
|
- Mobile View targets viewports from 360 CSS pixels wide, but third-party fixed-width views, virtual keyboards, orientation changes, split-screen browsers, and operating-system text scaling still require real-device acceptance.
|
|
268
|
-
- Plugin-owned buttons and text inputs use Harness `Button` and `Input` primitives and their semantic variants. Harness
|
|
259
|
+
- Plugin-owned buttons and text inputs use Harness `Button` and `Input` primitives and their semantic variants. The supported Harness builds do not expose a complete public responsive-shell, spacing, or radius contract, so mobile geometry and responsive compositions remain documented design-system compatibility risks; icon export changes are handled by a version-tolerant adapter.
|
|
269
260
|
|
|
270
261
|
## Development disclosure
|
|
271
262
|
|
package/README.ru.md
ADDED
|
@@ -0,0 +1,267 @@
|
|
|
1
|
+
# dsh-local-link
|
|
2
|
+
|
|
3
|
+
[English](README.md) | [中文](README.zh.md) | **Русский**
|
|
4
|
+
|
|
5
|
+
[](https://github.com/donoteatme/dsh-local-link/actions/workflows/ci.yml)
|
|
6
|
+
[](https://www.npmjs.com/package/dsh-local-link)
|
|
7
|
+
[](https://www.npmjs.com/package/dsh-local-link)
|
|
8
|
+
[](https://awesome-dsh-plugin.com/p/donoteatme/dsh-local-link/)
|
|
9
|
+
[](https://dsh.market/)
|
|
10
|
+
[](LICENSE)
|
|
11
|
+
|
|
12
|
+
Открывайте ту же веб-сессию [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) с телефона, планшета или другого компьютера в доверенной частной сети. `dsh-local-link` добавляет в стандартный клиент DSH одноразовое подключение по QR-коду и адаптивный мобильный интерфейс — без облачного ретранслятора, отдельного аккаунта, нативного приложения, альтернативного чата или второго механизма выбора рабочих пространств.
|
|
13
|
+
|
|
14
|
+
Откройте `Local access`, отсканируйте QR-код — и подключённый браузер попадёт в текущую сессию Harness, выбранную на компьютере. Диалог, права доступа, рабочие пространства и интерфейсы плагинов останутся теми же.
|
|
15
|
+
|
|
16
|
+
Ветка `1.2.x` поддерживает DeepSeek Harness `0.1.5-rc.2` и `0.1.7-rc.2` и делает стандартный веб-клиент удобным на узких сенсорных экранах. Существующий интерфейс Harness преобразуется в адаптивные панели, компактные элементы управления сессией и удобные для касаний действия, но сам клиент, сессия, слоты плагинов, разрешения и поток событий агента остаются прежними.
|
|
17
|
+
|
|
18
|
+
> **Граница безопасности:** шлюз работает по незашифрованному HTTP и предназначен только для доверенной частной сети. Не выставляйте его порт в интернет и не используйте плагин в публичных сетях Wi-Fi.
|
|
19
|
+
|
|
20
|
+
<p align="center">
|
|
21
|
+
<img src="docs/images/local-access-qr.jpg" width="960" alt="DeepSeek Harness с открытым dsh-local-link: одноразовое подключение по QR-коду к текущей стандартной сессии Harness">
|
|
22
|
+
</p>
|
|
23
|
+
|
|
24
|
+
<p align="center"><sub>Одна сессия Harness, прямое подключение внутри доверенной локальной сети.</sub></p>
|
|
25
|
+
|
|
26
|
+
## Возможности и назначение
|
|
27
|
+
|
|
28
|
+
Local Link — намеренно небольшой LAN-компаньон для существующего веб-клиента Harness, а не универсальная платформа удалённого доступа. Его задача — надёжно решить один сценарий: открыть уже запущенный на компьютере Harness с другого устройства в той же частной сети и продолжить работу с теми же сессиями в браузере.
|
|
29
|
+
|
|
30
|
+
Разработка сосредоточена на следующем:
|
|
31
|
+
|
|
32
|
+
- надёжный доступ к текущему Harness Host из той же локальной сети;
|
|
33
|
+
- короткоживущие приглашения и понятное управление жизненным циклом подключённых устройств;
|
|
34
|
+
- адаптивное отображение стандартного клиента без дублирования бизнес-логики Harness;
|
|
35
|
+
- совместимость с зарегистрированными представлениями, слотами, разрешениями, темами и состоянием сессии Harness;
|
|
36
|
+
- доступность, локализация, ограниченная диагностика и усиление безопасности внутри этой границы.
|
|
37
|
+
|
|
38
|
+
Плагин намеренно не решает следующие задачи:
|
|
39
|
+
|
|
40
|
+
- публикация в интернете, облачные ретрансляторы, управляемые туннели или облачные аккаунты;
|
|
41
|
+
- отдельное нативное приложение для телефона или компьютера;
|
|
42
|
+
- замена чата или форк интерфейса Harness;
|
|
43
|
+
- независимая синхронизация рабочих пространств, файлов или сессий вне Harness;
|
|
44
|
+
- универсальная среда удалённых расширений, не связанная с открытием текущего веб-интерфейса.
|
|
45
|
+
|
|
46
|
+
Это не означает, что плагин завершён или заморожен. Будущие изменения должны делать локальный браузерный доступ проще, безопаснее, совместимее и удобнее для диагностики, а не превращать продукт в систему другого класса.
|
|
47
|
+
|
|
48
|
+
## Установка
|
|
49
|
+
|
|
50
|
+
### npm — рекомендуемый способ
|
|
51
|
+
|
|
52
|
+
Остановите запущенный процесс `dsh web`, добавьте плагин в профиль `web`, затем снова запустите Harness:
|
|
53
|
+
|
|
54
|
+
```shell
|
|
55
|
+
dsh plugin --profile web add dsh-local-link
|
|
56
|
+
dsh web
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### Git clone — рабочая копия для разработки
|
|
60
|
+
|
|
61
|
+
Требования: Git, Node.js 22.19+ или 24+, Corepack и глобально установленный `dsh`, совместимый с диапазоном `engines.dsh`, объявленным пакетом.
|
|
62
|
+
|
|
63
|
+
```shell
|
|
64
|
+
git clone https://github.com/donoteatme/dsh-local-link.git
|
|
65
|
+
cd dsh-local-link
|
|
66
|
+
corepack pnpm install --frozen-lockfile
|
|
67
|
+
npm run verify
|
|
68
|
+
dsh plugin --profile web add .
|
|
69
|
+
dsh web
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Профиль ссылается непосредственно на рабочую копию. После изменения клиентского кода пересоберите проект, а после изменения Host-части перезапустите `dsh web`.
|
|
73
|
+
|
|
74
|
+
## Совместимость
|
|
75
|
+
|
|
76
|
+
Диапазон устанавливаемых версий DeepSeek Harness объявлен в `package.json` через `engines.dsh`. Совместимость проверяется на конкретных релизах и не выводится только из успешной установки или плавающего dist-tag.
|
|
77
|
+
|
|
78
|
+
Local Link `1.2.2` собирается на контрактах Harness `0.1.7-rc.2`. На нём проверены сопряжение по LAN, одноразовый вход в браузер, авторизованные страница и WebSocket, а также немедленное закрытие WebSocket после отзыва устройства. Адаптер мобильных значков понимает новые имена экспорта по толщине линии и прежние имена по размеру. Предыдущие RC оставлены в `engines.dsh` на основании исторических проверок в changelog; все они повторно для этого патча не прогонялись. Проверка на физическом телефоне проводится отдельно от эмуляции браузера.
|
|
79
|
+
|
|
80
|
+
## Использование
|
|
81
|
+
|
|
82
|
+
### Открытие Harness на другом устройстве
|
|
83
|
+
|
|
84
|
+
1. Откройте на компьютере нужную сессию.
|
|
85
|
+
2. Нажмите `Local access` в нижней части боковой панели Harness.
|
|
86
|
+
3. Отсканируйте QR-код или скопируйте одноразовую ссылку на другое устройство в той же сети.
|
|
87
|
+
4. Первый браузер, использовавший приглашение, откроет стандартный клиент Harness в выбранной сессии. Административные действия уровня Host, зарезервированные Harness для loopback-подключений, удалённо недоступны.
|
|
88
|
+
|
|
89
|
+
Приглашение одноразовое, по умолчанию действует пять минут и немедленно заменяется при выборе `Generate another code`.
|
|
90
|
+
|
|
91
|
+
На телефонах и планшетах Mobile View включается автоматически при ширине viewport не более 834 CSS-пикселей. То же адаптивное поведение можно проверить через эмуляцию устройства в браузере: отдельный URL-параметр, подмена user-agent или второй клиент не нужны.
|
|
92
|
+
|
|
93
|
+
## Мобильный интерфейс
|
|
94
|
+
|
|
95
|
+
Стандартным веб-интерфейсом Harness трудно пользоваться на телефоне: постоянная десктопная навигация занимает экран, элементы управления сессией конкурируют с заголовком диалога, некоторые действия зависят от наведения или долгого нажатия, а сведения о субагентах слишком плотные для узкого экрана. Mobile View делает существующий интерфейс удобным, не создавая второй клиент и не дублируя бизнес-логику Harness.
|
|
96
|
+
|
|
97
|
+
| Стандартное поведение на узком экране | Mobile View в `1.2.x` |
|
|
98
|
+
| --- | --- |
|
|
99
|
+
| Десктопная навигация конкурирует с диалогом | Навигация по рабочим пространствам и сессиям открывается в закрываемой левой панели |
|
|
100
|
+
| Метаданные сессии перегружают заголовок | Контекст, модель, доступ, пресет, активность и экспорт вынесены в компактную правую панель |
|
|
101
|
+
| Сведения о субагентах трудно просматривать и открывать | В 0.1.5 чип у поля ввода открывает каталог снизу; в 0.1.7 каталог и навигация принадлежат Harness и находятся в заголовке |
|
|
102
|
+
| Действия с сессиями и рабочими пространствами рассчитаны на наведение | Меню действий остаются видимыми и доступными для касания |
|
|
103
|
+
| При смене сессии может открыться экранная клавиатура | Автоматический фокус поля ввода подавляется, но намеренное касание по-прежнему устанавливает фокус |
|
|
104
|
+
| Десктопные отступы не учитывают безопасные области телефона | Заголовок, поле ввода, вкладки, медиа, оверлеи и прокрутка адаптируются к узкому экрану |
|
|
105
|
+
|
|
106
|
+
Меняется только представление, но не ответственность и поведение Harness:
|
|
107
|
+
|
|
108
|
+
- стандартный браузер рабочих пространств и сессий превращается в левую выдвижную панель;
|
|
109
|
+
- динамические слоты Chat, Trajectory, поля ввода, оверлеев и сторонних плагинов сохраняются;
|
|
110
|
+
- `Current session` открывается из заголовка и показывает структуру контекста, модель, доступ к рабочему пространству, пресет, активность и скачивание журнала сессии;
|
|
111
|
+
- на телефоне дублирующий индикатор контекста под чатом и кнопку открытия на компьютере (Проводник/VS Code/Rider) скрыли; на десктопе оба элемента остались;
|
|
112
|
+
- в 0.1.5 статус дочерних агентов открывает вложенный каталог в нижней панели; в 0.1.7 для этого используется штатное действие Harness в заголовке;
|
|
113
|
+
- сервис тем Harness управляет компактной кнопкой «солнце/луна»;
|
|
114
|
+
- десктопные Settings и вложенное действие Local access скрыты в мобильной навигации, но переключение темы остаётся доступным;
|
|
115
|
+
- меню сессии и активного рабочего пространства сразу доступны на сенсорных экранах;
|
|
116
|
+
- безопасные области, прокручиваемые вкладки, ограниченные по размеру медиа и поведение виртуальной клавиатуры адаптированы к узким экранам;
|
|
117
|
+
- модальные панели плагина удерживают клавиатурный фокус и после закрытия возвращают его вызвавшему элементу;
|
|
118
|
+
- существующие рабочие пространства остаются доступны, а вводящая в заблуждение удалённая кнопка `Add workspace`, открывающая системный выбор каталога, скрыта.
|
|
119
|
+
|
|
120
|
+
Приведённые ниже изображения в тёмной теме сняты на Harness `0.1.5-rc.2` при эмулируемом viewport `430 × 932`. В изолированном профиле для скриншотов используются только вымышленные демонстрационные данные: локальные рабочие пространства, диалоги, пути, запросы, модели и сведения об использовании на них не отображаются. В 0.1.7 каталог субагентов штатный и выглядит иначе, чем нижняя панель на изображении.
|
|
121
|
+
|
|
122
|
+
| Навигация | Текущая сессия | Субагенты | Диалог |
|
|
123
|
+
| :---: | :---: | :---: | :---: |
|
|
124
|
+
| <img src="docs/images/mobile-navigation.png" width="210" alt="Навигационная панель Mobile View в тёмной теме с вымышленными рабочим пространством и сессией"> | <img src="docs/images/mobile-session-info.png" width="210" alt="Панель Current session в тёмной теме с вымышленными моделью, доступом к рабочему пространству, статистикой и журналом сессии"> | <img src="docs/images/mobile-subagents.png" width="210" alt="Нижняя панель субагентов Mobile View с двумя вымышленными дочерними агентами"> | <img src="docs/images/mobile-chat.png" width="210" alt="Диалог Harness в Mobile View с исходными действиями сообщения и элементами поля ввода в одну строку"> |
|
|
125
|
+
|
|
126
|
+
### Разрешения
|
|
127
|
+
|
|
128
|
+
Удалённый браузер наследует уровень доступа выбранной сессии Harness: **Read only**, **Workspace write** или **Full access**. Mobile View только показывает это значение и не создаёт новый слой разрешений и не ослабляет существующий. Это относится к обычным операциям сессии; Settings, учётные данные, нативные Host-действия и создание пресетов агентов остаются доступными только через loopback. Скрытие `Add workspace` — ограничение интерфейса, а не граница авторизации.
|
|
129
|
+
|
|
130
|
+
Адаптивный интерфейс рассчитан на viewport шириной от 360 до 834 CSS-пикселей. Релизная матрица включает проверки `360 × 800`, `390 × 844`, `430 × 932` и `768 × 1024`; для приёмки релиза также нужны проверки на реальном телефоне в портретной и альбомной ориентации. Поведение, сохранение темы, поверхности совместимости и полный чек-лист описаны в документе [Mobile View](docs/MOBILE_VIEW.md).
|
|
131
|
+
|
|
132
|
+
### Управление доверенными браузерами
|
|
133
|
+
|
|
134
|
+
На компьютере с Harness откройте `Paired devices` в панели QR-кода либо перейдите в `Settings → Local access`. Каждый новый браузер сначала называется `My device`; подпись определяется автоматически, например `Phone · Chrome`, `Tablet · Safari` или `Computer · Edge`.
|
|
135
|
+
|
|
136
|
+
- `Rename` меняет только отображаемое имя.
|
|
137
|
+
- `Revoke` аннулирует учётные данные браузера и немедленно закрывает все открытые WebSocket-соединения Local Link, авторизованные этим устройством.
|
|
138
|
+
- После очистки cookie, открытия приватного окна, использования нового профиля браузера или отзыва устройства потребуется новое приглашение.
|
|
139
|
+
|
|
140
|
+
Браузеры не умеют надёжно отличать ноутбук от настольного компьютера, поэтому оба варианта отображаются как `Computer`.
|
|
141
|
+
|
|
142
|
+
<p align="center">
|
|
143
|
+
<img src="docs/images/local-access-devices.jpg" width="960" alt="Настройки DeepSeek Harness, открытые на компактном списке подключённых устройств Local access">
|
|
144
|
+
</p>
|
|
145
|
+
|
|
146
|
+
Разверните `Diagnostics` на той же странице Settings, чтобы просмотреть последние события локального шлюза. `Copy report` формирует готовый для issue JSON, а `Clear` удаляет локальную историю. Отчёт содержит только коды событий, время, серьёзность и небольшой разрешённый контекст; в него никогда не попадают токены подключения, cookie, IP-адреса, идентификаторы устройств и сессий, имена устройств, пути запросов, промпты, диалоги или файлы проекта.
|
|
147
|
+
|
|
148
|
+
<p align="center">
|
|
149
|
+
<img src="docs/images/local-access-diagnostics.jpg" width="960" alt="Настройки Local access в DeepSeek Harness с раскрытой нативной панелью Diagnostics">
|
|
150
|
+
</p>
|
|
151
|
+
|
|
152
|
+
## Почему плагин остаётся небольшим
|
|
153
|
+
|
|
154
|
+
- **Стандартный интерфейс Harness:** плагин открывает существующий веб-клиент и поток событий агента.
|
|
155
|
+
- **Только локальная сеть:** один шлюз частной сети перенаправляет запросы к loopback Harness Host.
|
|
156
|
+
- **Две runtime-зависимости:** поддержка схемы конфигурации и генерация QR-кода.
|
|
157
|
+
- **Без цифрового отпечатка:** доступ определяется случайными учётными данными отдельного браузера, а не попыткой угадать личность устройства.
|
|
158
|
+
- **Нативные точки расширения:** элементы боковой панели и Settings используют слоты и сервисы локализации Harness.
|
|
159
|
+
- **Нативная адаптивность:** поставляемый Harness AppFrame остаётся смонтированным, а зарегистрированные представления диалога и оверлеи продолжают работать динамически.
|
|
160
|
+
- **JSON-локализация:** весь видимый текст плагина хранится в согласованных словарях локализации.
|
|
161
|
+
- **Локальная диагностика:** ограниченная и очищенная от чувствительных данных история помогает разбирать проблемы без аналитики и внешнего сборщика.
|
|
162
|
+
|
|
163
|
+
## Как это работает
|
|
164
|
+
|
|
165
|
+
```text
|
|
166
|
+
Браузер на компьютере: 127.0.0.1:3080
|
|
167
|
+
└─ Local access → одноразовое приглашение
|
|
168
|
+
│
|
|
169
|
+
Телефон / планшет / компьютер в частной локальной сети
|
|
170
|
+
└─ 192.168.x.x:3088 → проверка сети и Host
|
|
171
|
+
→ подключение или проверка cookie устройства
|
|
172
|
+
→ прокси HTTP / WebSocket
|
|
173
|
+
→ 127.0.0.1:3080 (тот же Harness Host)
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
Шлюз не создаёт вторую сессию Harness. При первом подключении он передаёт новому origin браузера выбранную на компьютере сессию; данные сессии и текущие события диалога по-прежнему поступают из того же Host.
|
|
177
|
+
|
|
178
|
+
Для авторизации используется случайный 256-битный cookie credential. Хранится только его SHA-256-хэш. Редактируемое имя и определённые браузером сведения об устройстве никогда не предоставляют доступ.
|
|
179
|
+
|
|
180
|
+
Полномочия локальной сети объявляются через официальный контракт подключения Harness `trustedHosts`. Благодаря этому API сессий и WebSocket-трафик проходят аутентификацию без притворного обозначения телефона как loopback-клиента. Harness `0.1.2-rc.1` и проверенные сборки `0.1.5` и `0.1.7` аутентифицируют транспорт целиком, поэтому Local Link самостоятельно запрещает RPC конфигурации, учётных данных, нативных Host-действий и создания пресетов агентов, которые ранние поддерживаемые версии Harness ограничивали loopback-подключениями.
|
|
181
|
+
|
|
182
|
+
## Конфигурация
|
|
183
|
+
|
|
184
|
+
Встроенный патч профиля задаёт консервативные значения по умолчанию:
|
|
185
|
+
|
|
186
|
+
| Параметр | По умолчанию | Назначение |
|
|
187
|
+
| --- | --- | --- |
|
|
188
|
+
| `listenHost` | `0.0.0.0` | Слушать локальные интерфейсы; проверка запросов по-прежнему принимает только частные и loopback-источники. |
|
|
189
|
+
| `listenPort` | `3088` | Порт LAN-шлюза. |
|
|
190
|
+
| `upstreamOrigin` | `http://127.0.0.1:3080` | Существующий loopback веб-сервер Harness. |
|
|
191
|
+
| `accessMode` | `pairing` | Требовать одноразовое приглашение и cookie устройства. |
|
|
192
|
+
| `pairingTtlSeconds` | `300` | Срок действия приглашения. |
|
|
193
|
+
| `deviceTtlDays` | `90` | Срок запоминания браузера. |
|
|
194
|
+
| `diagnosticsEnabled` | `true` | Хранить ограниченную локальную историю диагностики. |
|
|
195
|
+
| `diagnosticsMaxEntries` | `15` | Максимальное количество сохранённых событий (`5`–`200`). |
|
|
196
|
+
| `diagnosticsFile` | рядом со `stateFile` | Локальное JSON-хранилище событий; встроенный профиль использует `~/.dsh/local-link/diagnostics.json`. |
|
|
197
|
+
|
|
198
|
+
`listenHost` принимает только `0.0.0.0` либо явный частный или loopback IP-адрес. Публичные адреса прослушивания отклоняются при запуске; эта проверка конфигурации дополняет, но не заменяет системный брандмауэр.
|
|
199
|
+
|
|
200
|
+
Режим `trusted-lan` отключает авторизацию отдельных устройств и предназначен только для изолированных сетей разработки. Поддерживаемым режимом по умолчанию остаётся `pairing`, потому что подключённый браузер Harness может читать файлы, отправлять промпты, подтверждать действия и запускать команды.
|
|
201
|
+
|
|
202
|
+
Плагин никогда не создаёт правила брандмауэра. Если Windows запросит сетевой доступ, разрешайте его только для профиля **Private** и не перенаправляйте порт `3088` на роутере.
|
|
203
|
+
|
|
204
|
+
## Устранение неполадок и диагностика
|
|
205
|
+
|
|
206
|
+
Diagnostics — локальная событийная история ошибок, а не журнал запросов. По умолчанию плагин хранит 15 событий, показывает 12 последних, объединяет одинаковые события в пределах пяти секунд и ничего не записывает для успешных запусков, запросов, подключений, копирования, переименования или отзыва.
|
|
207
|
+
|
|
208
|
+
При обращении за помощью:
|
|
209
|
+
|
|
210
|
+
1. Один раз воспроизведите ошибку.
|
|
211
|
+
2. Откройте `Settings → Local access → Diagnostics`.
|
|
212
|
+
3. Нажмите `Refresh`, если панель уже была открыта.
|
|
213
|
+
4. По новейшему стабильному коду события определите границу сбоя.
|
|
214
|
+
5. Нажмите `Copy report`, проверьте JSON и при необходимости приложите его к issue.
|
|
215
|
+
|
|
216
|
+
Отчёт никогда не содержит секреты, адреса, идентификаторы, имена, URL, пути, промпты, диалоги или данные проекта и никогда не отправляется автоматически. Полный список отслеживаемых ошибок приведён в [справочнике событий и первичных проверок](docs/DIAGNOSTICS.md).
|
|
217
|
+
|
|
218
|
+
## Локализация
|
|
219
|
+
|
|
220
|
+
Словарь плагина выбирается активным языком Harness; отдельного переключателя языка в плагине нет.
|
|
221
|
+
|
|
222
|
+
Минимальная автоматическая страница подключения загружается до появления сервисов локализации Harness. Она использует те же словари и выбирает английский или китайский по списку языков подключающегося браузера; английский используется по умолчанию.
|
|
223
|
+
|
|
224
|
+
| Язык | Словарь | Статус |
|
|
225
|
+
| --- | --- | --- |
|
|
226
|
+
| Английский | `src/locales/en.json` | Включён |
|
|
227
|
+
| Китайский | `src/locales/zh.json` | Включён |
|
|
228
|
+
|
|
229
|
+
Тесты проверяют совпадение ключей словарей. Чтобы добавить язык, скопируйте `en.json`, переведите значения, не меняя ключи, зарегистрируйте идентификатор локали в `src/client.tsx`, расширьте языковую карту страницы подключения в `src/gateway/pair-page.ts` и выполните `npm test`.
|
|
230
|
+
|
|
231
|
+
## Разработка
|
|
232
|
+
|
|
233
|
+
```shell
|
|
234
|
+
corepack pnpm install --frozen-lockfile
|
|
235
|
+
npm run typecheck
|
|
236
|
+
npm test
|
|
237
|
+
npm run build
|
|
238
|
+
npm run verify
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
Документация проекта:
|
|
242
|
+
|
|
243
|
+
- [Архитектура и границы совместимости](docs/ARCHITECTURE.md)
|
|
244
|
+
- [Поведение Mobile View и релизная матрица](docs/MOBILE_VIEW.md)
|
|
245
|
+
- [Локальная диагностика и коды событий](docs/DIAGNOSTICS.md)
|
|
246
|
+
- [Модель безопасности](docs/SECURITY.md)
|
|
247
|
+
- [Участие в разработке](CONTRIBUTING.md)
|
|
248
|
+
- [Сообщение об уязвимостях](SECURITY.md)
|
|
249
|
+
|
|
250
|
+
## Известные ограничения
|
|
251
|
+
|
|
252
|
+
- Трафик локальной сети не шифруется: текущий шлюз использует обычный HTTP.
|
|
253
|
+
- Отзыв устройства блокирует новые запросы и переподключения и завершает все открытые WebSocket-соединения Local Link, авторизованные этим устройством.
|
|
254
|
+
- Выбранная удалённым браузером светлая или тёмная тема в поддерживаемых версиях Harness действует только на текущей странице; после перезагрузки восстанавливается настройка Host, а значение `system` определяется по удалённому устройству.
|
|
255
|
+
- Для приглашений используется частный IPv4-интерфейс с наивысшим приоритетом, определённый при запуске; ручной выбор между несколькими LAN-интерфейсами пока отсутствует.
|
|
256
|
+
- Быстрый переход к конкретному разделу Settings использует небольшой семантический мост совместимости, поскольку Harness не предоставляет общий сервис навигации по настройкам.
|
|
257
|
+
- Контейнер действий в нижней части Harness требует правила совместимости разметки при наличии полноширинного действия Cordis.
|
|
258
|
+
- Mobile View рассчитан на viewport от 360 CSS-пикселей, но сторонние представления фиксированной ширины, виртуальные клавиатуры, смена ориентации, режим разделённого экрана и системное масштабирование текста всё ещё требуют проверки на реальных устройствах.
|
|
259
|
+
- Кнопки и текстовые поля плагина используют примитивы Harness `Button` и `Input` и их семантические варианты. У поддерживаемых сборок Harness нет полного публичного контракта адаптивной оболочки, отступов и скруглений, поэтому мобильная геометрия и композиции остаются задокументированными рисками совместимости с дизайн-системой; смена имён экспорта значков обработана совместимым адаптером.
|
|
260
|
+
|
|
261
|
+
## Сведения о разработке
|
|
262
|
+
|
|
263
|
+
Первоначальная реализация и документация создавались совместно сопровождающим проекта и OpenAI Codex. Все изменения по-прежнему должны проходить проверку сопровождающим, автоматические тесты, аудит безопасности и обычный процесс принятия изменений. Пакет не содержит runtime-зависимостей от AI-сервисов, телеметрии или сгенерированного кода.
|
|
264
|
+
|
|
265
|
+
## Лицензия
|
|
266
|
+
|
|
267
|
+
[MIT](LICENSE) © 2026 участники разработки dsh-local-link.
|
package/README.zh.md
CHANGED
|
@@ -1,17 +1,19 @@
|
|
|
1
1
|
# dsh-local-link
|
|
2
2
|
|
|
3
|
-
[English](README.md) | **中文**
|
|
3
|
+
[English](README.md) | **中文** | [Русский](README.ru.md)
|
|
4
4
|
|
|
5
5
|
[](https://github.com/donoteatme/dsh-local-link/actions/workflows/ci.yml)
|
|
6
6
|
[](https://www.npmjs.com/package/dsh-local-link)
|
|
7
|
-
[](https://www.npmjs.com/package/dsh-local-link)
|
|
8
|
+
[](https://awesome-dsh-plugin.com/p/donoteatme/dsh-local-link/)
|
|
9
|
+
[](https://dsh.market/)
|
|
8
10
|
[](LICENSE)
|
|
9
11
|
|
|
10
12
|
在可信私有网络中,通过手机、平板或另一台电脑使用同一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web 会话。`dsh-local-link` 为原生 DSH 客户端增加一次性二维码配对和响应式移动视图;它不使用托管中继、云账户、原生应用、替代聊天界面或第二套工作区选择器。
|
|
11
13
|
|
|
12
14
|
打开 `Local access` 并扫描二维码后,已配对的浏览器会进入桌面端当前选中的 Harness 会话,并继续使用相同的实时对话、权限、工作区和插件界面。
|
|
13
15
|
|
|
14
|
-
`1.2.x` 系列支持 DeepSeek Harness `0.1.5-rc.2`,并让原生 Web 客户端可以在窄屏触控设备上使用。移动视图只调整界面布局,不接管 Harness 的会话、权限或业务逻辑。
|
|
16
|
+
`1.2.x` 系列支持 DeepSeek Harness `0.1.5-rc.2` 和 `0.1.7-rc.2`,并让原生 Web 客户端可以在窄屏触控设备上使用。移动视图只调整界面布局,不接管 Harness 的会话、权限或业务逻辑。
|
|
15
17
|
|
|
16
18
|
> **安全边界:** 网关使用明文 HTTP,仅适用于可信私有网络。不要将端口暴露到互联网,也不要在公共 Wi-Fi 上使用。
|
|
17
19
|
|
|
@@ -21,7 +23,7 @@
|
|
|
21
23
|
|
|
22
24
|
<p align="center"><sub>通过可信局域网直接打开同一个 Harness 会话。</sub></p>
|
|
23
25
|
|
|
24
|
-
##
|
|
26
|
+
## 功能与产品范围
|
|
25
27
|
|
|
26
28
|
Local Link 是现有 Harness Web 客户端的小型局域网配套插件,不是通用远程访问平台。它专注于一条可靠路径:在同一私有网络中的另一台设备上打开电脑中已经运行的 Harness,并继续使用相同的会话和界面。
|
|
27
29
|
|
|
@@ -69,20 +71,9 @@ profile 会指向当前 checkout。修改客户端代码后需要重新构建;
|
|
|
69
71
|
|
|
70
72
|
## 兼容性
|
|
71
73
|
|
|
72
|
-
|
|
74
|
+
可安装的 DeepSeek Harness 版本范围通过 `package.json` 中的 `engines.dsh` 声明。兼容性按精确发布版本验证,不会因为安装成功或可变的 dist-tag 就推断为兼容。
|
|
73
75
|
|
|
74
|
-
|
|
75
|
-
| --- | --- |
|
|
76
|
-
| `0.1.5-rc.2` | **支持的发布版本** |
|
|
77
|
-
| `0.1.5-rc.1` | **已验证** |
|
|
78
|
-
| `0.1.2-rc.1` | **已验证** |
|
|
79
|
-
| `0.1.1-rc.2` | **已验证** |
|
|
80
|
-
| `0.1.1-rc.1` | **已验证** |
|
|
81
|
-
| `0.1.0-rc.8` | **已验证** |
|
|
82
|
-
|
|
83
|
-
以上六个版本都使用打包后的 `1.1.1` 源码通过了已安装运行时的网关和撤销测试。对于 `1.2.0`,当前发布版本 `0.1.5-rc.2` 还使用精确依赖重新构建,并在真实浏览器客户端中完成了 `430 × 932` 与 `320 × 568` 检查。历史 RC 的验证证据继续保留;移动的 `next` 标签本身不代表兼容性承诺。
|
|
84
|
-
|
|
85
|
-
只有表格中的精确版本包含兼容性承诺。已移除的 alpha 版本、早于 `0.1.0-rc.8` 的版本,以及未来移动的 `next` 标签都必须单独验证。完整证据与边界见[兼容性说明](docs/COMPATIBILITY.md)。
|
|
76
|
+
Local Link `1.2.2` 使用 Harness `0.1.7-rc.2` 的开发契约构建,并在该版本上验证了局域网配对、一次性浏览器登录、经过认证的页面与 WebSocket 访问,以及撤销设备后立即关闭 WebSocket。移动图标适配器兼容新版按线条粗细命名的导出和旧版按尺寸命名的导出。`engines.dsh` 中保留的早期 RC 基于更新日志中的历史验证;本次补丁未重新运行所有旧版本。实体手机验收仍需单独进行。
|
|
86
77
|
|
|
87
78
|
## 使用方法
|
|
88
79
|
|
|
@@ -106,9 +97,10 @@ profile 会指向当前 checkout。修改客户端代码后需要重新构建;
|
|
|
106
97
|
- 切换会话不会自动唤起软键盘,主动点击输入区仍会正常聚焦;
|
|
107
98
|
- 深色/浅色主题继续由 Harness 主题服务管理;
|
|
108
99
|
- 远程手机上隐藏容易误导的 `Add workspace` 目录选择器;
|
|
100
|
+
- 手机端隐藏聊天底部重复的上下文用量指示器和在电脑上打开文件的按钮(资源管理器/VS Code/Rider);桌面端仍保留,手机端可在 `Current session` 查看上下文详情;
|
|
109
101
|
- 顶栏、消息操作、输入工具、安全区域和虚拟键盘行为适配窄屏。
|
|
110
102
|
|
|
111
|
-
|
|
103
|
+
以下深色主题截图来自 Harness `0.1.5-rc.2` 的真实浏览器会话,使用 `430 × 932` 模拟视口。独立截图配置只包含虚构的产品演示数据,不包含本地工作区、对话、路径、提示词、模型或用量数据。`0.1.7-rc.2` 使用 Harness 原生的子智能体标题栏目录,与图中的底部面板不同。
|
|
112
104
|
|
|
113
105
|
| 导航 | 当前会话 | 子智能体 | 对话 |
|
|
114
106
|
| :---: | :---: | :---: | :---: |
|
|
@@ -198,7 +190,6 @@ npm run verify
|
|
|
198
190
|
项目文档:
|
|
199
191
|
|
|
200
192
|
- [架构与兼容性边界](docs/ARCHITECTURE.md)
|
|
201
|
-
- [已验证的 Harness 兼容性](docs/COMPATIBILITY.md)
|
|
202
193
|
- [移动视图行为与发布矩阵](docs/MOBILE_VIEW.md)
|
|
203
194
|
- [本地诊断与事件代码](docs/DIAGNOSTICS.md)
|
|
204
195
|
- [安全模型](docs/SECURITY.md)
|
|
@@ -211,7 +202,7 @@ npm run verify
|
|
|
211
202
|
- 远程浏览器切换深色/浅色主题时,该选择在已支持的 Harness 版本中只对当前页面有效;
|
|
212
203
|
- 启动时会使用优先级最高的私有 IPv4 接口,暂不提供多接口选择;
|
|
213
204
|
- 移动视图支持从 360 CSS px 开始的视口,但第三方固定宽度视图、虚拟键盘、旋转、分屏和系统文字缩放仍需要真实设备验收;
|
|
214
|
-
-
|
|
205
|
+
- 受支持的 Harness 版本尚未公开完整的响应式 shell、间距和圆角契约;图标导出名称的变更由兼容适配器处理。每个受支持版本仍须重新验证界面适配。
|
|
215
206
|
|
|
216
207
|
## 开发说明
|
|
217
208
|
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -46,9 +46,9 @@ Configuration accepts only the wildcard `0.0.0.0` or an explicit private/loopbac
|
|
|
46
46
|
|
|
47
47
|
After authentication, the gateway forwards the browser's original `Host`, `Origin`, referrer, and fetch-site headers to the loopback Harness listener. The Cordis profile patch supplies the gateway's current LAN authorities to the official connection module through its public `trustedHosts` option. Ordinary Harness API and WebSocket traffic can therefore pass the declared origin check without pretending to be loopback.
|
|
48
48
|
|
|
49
|
-
Harness `0.1.2-rc.1` and the verified `0.1.5` builds require a native browser-authentication exchange. After Local Link pairing succeeds, the plugin asks the injected Harness connection service for an authenticated URL at the gateway origin, validates that the result stays on that origin, and lets the stock root consume the short-lived token. The gateway forwards Harness authentication cookies but strips its own device cookie before proxying, so the two credentials remain independent. Older supported builds that do not expose this service keep the direct-root redirect.
|
|
49
|
+
Harness `0.1.2-rc.1` and the verified `0.1.5` and `0.1.7` builds require a native browser-authentication exchange. After Local Link pairing succeeds, the plugin asks the injected Harness connection service for an authenticated URL at the gateway origin, validates that the result stays on that origin, and lets the stock root consume the short-lived token. The gateway forwards Harness authentication cookies but strips its own device cookie before proxying, so the two credentials remain independent. Older supported builds that do not expose this service keep the direct-root redirect.
|
|
50
50
|
|
|
51
|
-
Harness `0.1.2-rc.1` and the verified `0.1.5` builds authenticate the connection transport as a whole and no longer apply the older method-specific loopback tier. To preserve Local Link's established scope, the LAN gateway rejects the former privileged configuration, credential, native Host-action, and agent-preset-authoring RPCs before proxying. This applies equally to `pairing` and `trusted-lan`; enabling `trusted-lan` never grants those Host administration operations. `tests/trust-boundary.test.ts` exercises the RC Host/Origin and browser-authentication fence, while `tests/gateway.test.ts` pins the Local Link RPC restriction including the renamed RC Settings methods and encoded-path handling.
|
|
51
|
+
Harness `0.1.2-rc.1` and the verified `0.1.5` and `0.1.7` builds authenticate the connection transport as a whole and no longer apply the older method-specific loopback tier. To preserve Local Link's established scope, the LAN gateway rejects the former privileged configuration, credential, native Host-action, and agent-preset-authoring RPCs before proxying. This applies equally to `pairing` and `trusted-lan`; enabling `trusted-lan` never grants those Host administration operations. `tests/trust-boundary.test.ts` exercises the RC Host/Origin and browser-authentication fence, while `tests/gateway.test.ts` pins the Local Link RPC restriction including the renamed RC Settings methods and encoded-path handling.
|
|
52
52
|
|
|
53
53
|
### Authentication state
|
|
54
54
|
|
|
@@ -66,7 +66,7 @@ The loopback administration route exposes list, clear, and a narrow allowlisted
|
|
|
66
66
|
|
|
67
67
|
`src/client.tsx` registers two normal Harness contributions: a compact desktop `sidebar.footer.action` that shows a QR code and copyable one-time link, and a desktop-only `settings.section` that manages paired devices and the local diagnostic report. It does not replace the root layout. The desktop surfaces use plugin-owned classes and semantic selectors; version-sensitive stock-DOM hooks are isolated in `src/mobile-layout.tsx` and documented below.
|
|
68
68
|
|
|
69
|
-
The `0.1.
|
|
69
|
+
The `0.1.7-rc.2` browser graph is a normal Cordis `Context`. Session state comes from `@deepseek-ai/dsh-api-session-controller/client`; React slot hooks are supplied by `@deepseek-ai/dsh-client-ui-session/client`, and slot ownership/rendering comes from `@deepseek-ai/dsh-client-ui-renderer/client`. Agent-preset display reads `SessionSummary.projectionValues.agentPreset`, while subagent types come from `@deepseek-ai/dsh-subagent/client`. The removed `@deepseek-ai/dsh-client-runtime` aggregate is neither injected nor imported.
|
|
70
70
|
|
|
71
71
|
The Harness `sidebar.footer.action` contract is a list, but the supported Web client renders that list as a horizontal flex row while the stock Cordis action reserves `width: 100%` with `flex: none`. Without a compatibility rule, Cordis reduces later actions to zero width. Local Link orders its entry first and changes only the footer container that semantically contains `.dsh-local-link-footer` into a vertical stack. The same scoped rule normalizes the list gap and removes the following action's private top margin so Local access, Cordis, and Settings keep one visual rhythm. The selector is anchored on the plugin-owned class and accounts for the slot renderer's `display: contents` wrapper; it never names a generated Harness class.
|
|
72
72
|
|
|
@@ -108,11 +108,11 @@ The automatic pairing page runs before the Harness client and locale service loa
|
|
|
108
108
|
|
|
109
109
|
Local Link uses Harness semantic color, state, border, background, elevation, and typography variables wherever the supported client exports an applicable token. Icons are imported from `@deepseek-ai/dsh-client-ui-primitives` when that package exposes the required glyph, and stock Harness menus, dialogs, conversation actions, Settings surfaces, and session operations that Local Link does not replace remain their native components. Literal colors following a `var(--dsw-*, fallback)` expression are defensive fallbacks and are not selected in the supported Harness build. The context breakdown's purple tools segment intentionally matches the stock Harness `ContextMeter` implementation exactly.
|
|
110
110
|
|
|
111
|
-
Harness
|
|
111
|
+
The supported Harness builds do not expose a complete public responsive-shell or Drawer contract, spacing scale, radius scale, or mobile component recipes. Mobile geometry—safe-area placement, drawer widths, tap-target dimensions, spacing, radii, and transition timing—therefore remains plugin-owned CSS. One plugin-scoped `--dllm-side-drawer-width` value keeps the stock sidebar projection, the rightbar surface, and Current session visually identical instead of duplicating width literals. A small set of concepts also has no exported Harness primitive: Local access/device, navigation, current-session information, permission variants, and the subagent group glyph. The compact feedback-note affordance is a scoped presentation adapter because the stock feedback action accepts text only and exposes no icon-mode contract.
|
|
112
112
|
|
|
113
113
|
All plugin-owned button and text-input controls use the exported Harness `Button` and `Input` primitives. Their semantic variants (`primary`, `outline`, `ghost`, and `toolbar`) remain owned by Harness; Local Link adds only the geometry required by its composed surfaces, such as a full-width sidebar row, a segmented copy action, a scrim, or a tree row. A source-level test rejects new raw `<button>` and `<input>` elements in the plugin UI.
|
|
114
114
|
|
|
115
|
-
Component-level alignment remains bounded by the contracts Harness actually exports. The responsive shell, side drawer, bottom sheet, QR composition, context card, and diagnostics disclosure have no equivalent complete public responsive component contract in
|
|
115
|
+
Component-level alignment remains bounded by the contracts Harness actually exports. The responsive shell, side drawer, bottom sheet, QR composition, context card, and diagnostics disclosure have no equivalent complete public responsive component contract in the supported Harness builds, so their structure remains semantic HTML plus scoped CSS. They use Harness tokens and primitive controls internally and should migrate if Harness later publishes compatible responsive components.
|
|
116
116
|
|
|
117
117
|
These are compatibility surfaces, not an independent theme. Every Harness upgrade must compare them against the current token vocabulary, primitive icon catalog, slot contracts, and stock mobile behavior. They should be deleted in favor of upstream tokens or components as soon as equivalent public contracts exist.
|
|
118
118
|
|
|
@@ -175,7 +175,7 @@ No service discovery, certificate generator, tunnel client, native application,
|
|
|
175
175
|
|
|
176
176
|
## Compatibility strategy
|
|
177
177
|
|
|
178
|
-
The plugin develops against the exact DeepSeek Harness `0.1.
|
|
178
|
+
The plugin develops against the exact DeepSeek Harness `0.1.7-rc.2` contracts. The installable Host range is declared by `engines.dsh`; most integration uses declared package contracts, but several adapters are intentionally version-sensitive. The 0.1.7 icon exports are weight-named rather than size-named; the client resolves either form at runtime. The 0.1.7 Session list no longer owns current selection or the older subagent catalog methods. Current-session details therefore use the session-scoped trigger identity, while the plugin's legacy subagent sheet is registered only when its required catalog actions are present. On 0.1.7, `@deepseek-ai/dsh-client-ui-subagent` owns the native header catalog and navigation.
|
|
179
179
|
|
|
180
180
|
| Adapter | Why it exists | Failure behavior | Removal condition |
|
|
181
181
|
| --- | --- | --- | --- |
|
package/docs/DIAGNOSTICS.md
CHANGED
|
@@ -83,7 +83,7 @@ The copied report wraps the retained events with a schema version and export tim
|
|
|
83
83
|
| `AUTH_REQUIRED` | An unpaired browser opened a protected gateway page. | Pair that browser with a fresh QR/link; direct `:3088` access is intentionally rejected. |
|
|
84
84
|
| `HTTP_UPSTREAM_ERROR` | The gateway could not reach Harness on `127.0.0.1:3080`. | Confirm `dsh web` is running and `upstreamOrigin` matches its port. |
|
|
85
85
|
| `BROWSER_AUTH_HANDOFF_FAILED` | Harness returned an invalid browser-authentication handoff target. | Confirm the installed Harness version is supported and restart `dsh web`. |
|
|
86
|
-
| `INDEX_REWRITE_ERROR` | The returned Harness index did not match the supported boot contract. | Confirm the installed Harness version
|
|
86
|
+
| `INDEX_REWRITE_ERROR` | The returned Harness index did not match the supported boot contract. | Confirm the installed Harness version satisfies `engines.dsh` and restart `dsh web`. |
|
|
87
87
|
| `WS_REJECTED` | A WebSocket upgrade failed trust, authorization, or path validation. | Re-pair the browser and verify no proxy rewrites the URL. |
|
|
88
88
|
| `WS_UPSTREAM_ERROR` | The gateway could not open the loopback Harness event socket. | Confirm the desktop Harness process is still running and reload the paired browser. |
|
|
89
89
|
| `CLIPBOARD_COPY_FAILED` | The browser refused or failed to copy the one-time link. | Grant clipboard permission or select and copy the displayed link manually. |
|