dsh-local-link 1.2.1 → 1.2.3
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 +36 -0
- package/README.md +18 -13
- package/README.ru.md +267 -0
- package/README.zh.md +20 -9
- package/docs/ARCHITECTURE.md +6 -6
- package/docs/MOBILE_VIEW.md +3 -2
- package/docs/images/local-access-devices.png +0 -0
- package/docs/images/local-access-devices.zh.png +0 -0
- package/docs/images/local-access-diagnostics.png +0 -0
- package/docs/images/local-access-diagnostics.zh.png +0 -0
- package/docs/images/local-access-qr.png +0 -0
- package/docs/images/local-access-qr.zh.png +0 -0
- package/docs/images/mobile-chat.png +0 -0
- package/docs/images/mobile-chat.zh.png +0 -0
- package/docs/images/mobile-navigation.png +0 -0
- package/docs/images/mobile-navigation.zh.png +0 -0
- package/docs/images/mobile-session-info.png +0 -0
- package/docs/images/mobile-session-info.zh.png +0 -0
- package/docs/images/mobile-subagents.png +0 -0
- package/docs/images/mobile-subagents.zh.png +0 -0
- package/lib/client.js +55 -26
- package/lib/client.js.map +1 -1
- package/lib/index.mjs +3 -0
- package/package.json +44 -51
- package/docs/images/local-access-devices.jpg +0 -0
- package/docs/images/local-access-diagnostics.jpg +0 -0
- package/docs/images/local-access-qr.jpg +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,42 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this project are documented here.
|
|
4
4
|
|
|
5
|
+
## 1.2.3 — 2026-10-02
|
|
6
|
+
|
|
7
|
+
### Changed
|
|
8
|
+
|
|
9
|
+
- Built against the exact DeepSeek Harness `0.2.0-rc.2` contracts and added that release to both `engines.dsh` and the Host peer range, retaining the previously declared RC releases.
|
|
10
|
+
- Refreshed all seven README screenshots from the actual `0.2.0-rc.2` browser UI in dark mode, with separate English and Simplified Chinese demo profiles. Mobile frames retain `430 × 932`; subagents show the native header catalog, not the legacy bottom sheet. Russian documentation reuses the English frames.
|
|
11
|
+
|
|
12
|
+
### Fixed
|
|
13
|
+
|
|
14
|
+
- Kept the new native `directoryPicker.pick`, `directoryPicker.list`, and `directoryPicker.createDirectory` RPCs inaccessible through the LAN gateway, preserving the existing trusted-LAN scope after the Host API rename.
|
|
15
|
+
- Displayed recorded permission identifiers in the mobile Current session drawer when the session summary has no UI option catalog. Empty or null agent-preset identifiers now show the explicit not-recorded label. Model updates no longer discard the open drawer's session identity.
|
|
16
|
+
|
|
17
|
+
### Validated
|
|
18
|
+
|
|
19
|
+
- Type checking, all 105 automated tests, production build, and npm package dry-run passed against `0.2.0-rc.2`.
|
|
20
|
+
- On the running `0.2.0-rc.2` Host: LAN pairing returned `204`, the native browser handoff returned `303` / `303`, the authenticated root returned `200`, and `/api/remote.mux` upgraded with `101`. Revocation closed the established WebSocket and subsequent device access returned `401`.
|
|
21
|
+
- All three new native directory RPCs returned `403` through the authenticated LAN gateway. Historical RC releases were not all rerun for this patch; physical-phone acceptance remains separate from browser emulation.
|
|
22
|
+
- In-browser checks at 320, 360, 390, 430, and 834 CSS pixels kept the session-info action visible, composer actions on one row, and the Host-app opener hidden without document overflow. The 320-pixel details drawer fit the viewport; a 1280-pixel desktop check retained the Host-app opener.
|
|
23
|
+
- The user confirmed that the updated plugin works on their physical phone. The screenshot pass also checked the Simplified Chinese header, composer, and session drawer at 320 CSS pixels.
|
|
24
|
+
|
|
25
|
+
## 1.2.2 — 2026-09-27
|
|
26
|
+
|
|
27
|
+
### Changed
|
|
28
|
+
|
|
29
|
+
- Built against the exact DeepSeek Harness `0.1.7-rc.2` contracts while retaining the declared historical RC Host range.
|
|
30
|
+
- Accepted Harness's weight-named icon exports while preserving the older size-named exports for previous supported Hosts.
|
|
31
|
+
- 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.
|
|
32
|
+
- 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.
|
|
33
|
+
- Removed nine unused development-only Harness packages absent from the `0.1.7-rc.2` Host dependency graph.
|
|
34
|
+
|
|
35
|
+
### Validated
|
|
36
|
+
|
|
37
|
+
- 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.
|
|
38
|
+
- Checked the live mobile menu, Current session drawer, and visible header controls without horizontal overflow at 320, 360, 390, 430, and 834 CSS px.
|
|
39
|
+
- 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.
|
|
40
|
+
|
|
5
41
|
## 1.2.1 — 2026-09-21
|
|
6
42
|
|
|
7
43
|
### Changed
|
package/README.md
CHANGED
|
@@ -1,27 +1,29 @@
|
|
|
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`, `0.1.7-rc.2`, and `0.2.0-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
|
|
|
18
20
|
<p align="center">
|
|
19
|
-
<img src="docs/images/local-access-qr.
|
|
21
|
+
<img src="docs/images/local-access-qr.png" width="960" alt="DeepSeek Harness with dsh-local-link open: one-time QR pairing to the current stock Harness session">
|
|
20
22
|
</p>
|
|
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
|
|
|
@@ -73,6 +75,8 @@ The profile points at the checkout, so rebuild after changing client code and re
|
|
|
73
75
|
|
|
74
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
|
|
|
78
|
+
Local Link `1.2.3` is built against `0.2.0-rc.2`. On that release, LAN pairing, one-time browser handoff, authenticated page and WebSocket access, and immediate WebSocket closure on revoke were exercised. Native directory selection, browsing, and creation remain loopback-only under the new `directoryPicker` API. 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.
|
|
79
|
+
|
|
76
80
|
## Use
|
|
77
81
|
|
|
78
82
|
### Open Harness on another device
|
|
@@ -94,7 +98,7 @@ The stock Harness Web interface is difficult to operate on a phone: persistent d
|
|
|
94
98
|
| --- | --- |
|
|
95
99
|
| Desktop navigation competes with the conversation | Workspace and session navigation opens as a dismissible left drawer |
|
|
96
100
|
| Session metadata crowds the header | Context, model, access, preset, activity, and export move into a compact right drawer |
|
|
97
|
-
| 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 and 0.2, Harness owns its header catalog and navigation |
|
|
98
102
|
| Hover-oriented session and workspace actions | Overflow actions remain visible and touch-accessible |
|
|
99
103
|
| Session changes can summon the software keyboard | Automatic composer focus is suppressed while intentional input focus still works |
|
|
100
104
|
| Desktop spacing ignores phone safe areas | Header, composer, tabs, media, overlays, and scrolling adapt to narrow viewports |
|
|
@@ -104,7 +108,8 @@ The implementation changes presentation, not Harness ownership or behavior:
|
|
|
104
108
|
- the native workspace/session browser becomes a left drawer;
|
|
105
109
|
- dynamic Chat, Trajectory, composer, overlay, and third-party plugin slots remain intact;
|
|
106
110
|
- Current session opens from the header with context breakdown, model, workspace access, preset, activity, and session-log download;
|
|
107
|
-
-
|
|
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 and 0.2, the native Harness subagent header action owns that navigation;
|
|
108
113
|
- the Harness theme service powers a compact sun/moon action;
|
|
109
114
|
- desktop-only Settings and the nested Local access action are omitted from mobile navigation, while the appearance action remains available;
|
|
110
115
|
- session and active-workspace menus stay immediately available on touch screens;
|
|
@@ -112,11 +117,11 @@ The implementation changes presentation, not Harness ownership or behavior:
|
|
|
112
117
|
- plugin-owned modal drawers contain keyboard focus and return it to the invoking control when closed;
|
|
113
118
|
- existing workspaces remain available, while the misleading remote `Add workspace` directory picker is omitted.
|
|
114
119
|
|
|
115
|
-
These dark-theme previews
|
|
120
|
+
These dark-theme previews were captured from real Harness `0.2.0-rc.2` browser sessions at a `430 × 932` emulated viewport. The isolated screenshot profiles contain fictional workspaces, conversations, models, devices, and usage only; no real project data appears. The Chinese README has its own Simplified Chinese captures. Subagents use the native Harness header catalog.
|
|
116
121
|
|
|
117
122
|
| Navigation | Current session | Subagents | Conversation |
|
|
118
123
|
| :---: | :---: | :---: | :---: |
|
|
119
|
-
| <img src="docs/images/mobile-navigation.png" width="210" alt="Dark Mobile View navigation drawer with a synthetic workspace and session"> | <img src="docs/images/mobile-session-info.png" width="210" alt="Dark Mobile View Current session drawer with synthetic model, workspace access, statistics, and session log data"> | <img src="docs/images/mobile-subagents.png" width="210" alt="
|
|
124
|
+
| <img src="docs/images/mobile-navigation.png" width="210" alt="Dark Mobile View navigation drawer with a synthetic workspace and session"> | <img src="docs/images/mobile-session-info.png" width="210" alt="Dark Mobile View Current session drawer with synthetic model, workspace access, statistics, and session log data"> | <img src="docs/images/mobile-subagents.png" width="210" alt="Native dark Harness header catalog with two synthetic child agents"> | <img src="docs/images/mobile-chat.png" width="210" alt="Dark Mobile View Harness conversation with native message actions and one-line composer controls"> |
|
|
120
125
|
|
|
121
126
|
### Permissions
|
|
122
127
|
|
|
@@ -135,13 +140,13 @@ On the Harness computer, use `Paired devices` in the QR panel or open `Settings
|
|
|
135
140
|
Browsers do not reliably distinguish laptops from desktop computers, so both are shown as `Computer`.
|
|
136
141
|
|
|
137
142
|
<p align="center">
|
|
138
|
-
<img src="docs/images/local-access-devices.
|
|
143
|
+
<img src="docs/images/local-access-devices.png" width="960" alt="DeepSeek Harness Settings opened directly on the compact Local access paired-device list">
|
|
139
144
|
</p>
|
|
140
145
|
|
|
141
146
|
Expand `Diagnostics` on the same Settings page to inspect the most recent local gateway events. `Copy report` produces issue-ready JSON and `Clear` removes the local history. The report contains event codes, timestamps, severity, and a small allowlisted context only; it never includes pairing tokens, cookies, IP addresses, device or session IDs, device names, request paths, prompts, conversations, or project files.
|
|
142
147
|
|
|
143
148
|
<p align="center">
|
|
144
|
-
<img src="docs/images/local-access-diagnostics.
|
|
149
|
+
<img src="docs/images/local-access-diagnostics.png" width="960" alt="DeepSeek Harness Local access settings with the native-style Diagnostics panel expanded">
|
|
145
150
|
</p>
|
|
146
151
|
|
|
147
152
|
## Why it stays small
|
|
@@ -172,7 +177,7 @@ The gateway does not create a second Harness session. During first connection it
|
|
|
172
177
|
|
|
173
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.
|
|
174
179
|
|
|
175
|
-
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.
|
|
176
181
|
|
|
177
182
|
## Configuration
|
|
178
183
|
|
|
@@ -251,7 +256,7 @@ Project documentation:
|
|
|
251
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.
|
|
252
257
|
- Harness's footer-action container needs a compatibility layout rule when the full-width Cordis action is present.
|
|
253
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.
|
|
254
|
-
- 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.
|
|
255
260
|
|
|
256
261
|
## Development disclosure
|
|
257
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` и `0.2.0-rc.2` и делает стандартный веб-клиент удобным на узких сенсорных экранах. Существующий интерфейс Harness преобразуется в адаптивные панели, компактные элементы управления сессией и удобные для касаний действия, но сам клиент, сессия, слоты плагинов, разрешения и поток событий агента остаются прежними.
|
|
17
|
+
|
|
18
|
+
> **Граница безопасности:** шлюз работает по незашифрованному HTTP и предназначен только для доверенной частной сети. Не выставляйте его порт в интернет и не используйте плагин в публичных сетях Wi-Fi.
|
|
19
|
+
|
|
20
|
+
<p align="center">
|
|
21
|
+
<img src="docs/images/local-access-qr.png" 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.3` собирается на контрактах Harness `0.2.0-rc.2`. На нём проверены сопряжение по LAN, одноразовый вход в браузер, авторизованные страница и WebSocket, а также немедленное закрытие WebSocket после отзыва устройства. Выбор, просмотр и создание папок через новый API `directoryPicker` остаются доступны только на самом хосте, не через LAN. Адаптер мобильных значков понимает новые имена экспорта по толщине линии и прежние имена по размеру. Предыдущие 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 и 0.2 каталог и навигация принадлежат 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 и 0.2 для этого используется штатное действие Harness в заголовке;
|
|
113
|
+
- сервис тем Harness управляет компактной кнопкой «солнце/луна»;
|
|
114
|
+
- десктопные Settings и вложенное действие Local access скрыты в мобильной навигации, но переключение темы остаётся доступным;
|
|
115
|
+
- меню сессии и активного рабочего пространства сразу доступны на сенсорных экранах;
|
|
116
|
+
- безопасные области, прокручиваемые вкладки, ограниченные по размеру медиа и поведение виртуальной клавиатуры адаптированы к узким экранам;
|
|
117
|
+
- модальные панели плагина удерживают клавиатурный фокус и после закрытия возвращают его вызвавшему элементу;
|
|
118
|
+
- существующие рабочие пространства остаются доступны, а вводящая в заблуждение удалённая кнопка `Add workspace`, открывающая системный выбор каталога, скрыта.
|
|
119
|
+
|
|
120
|
+
Изображения в тёмной теме сняты из настоящих браузерных сессий Harness `0.2.0-rc.2` при эмулируемом viewport `430 × 932`. В отдельных демонстрационных профилях используются только вымышленные рабочие пространства, диалоги, модели, устройства и статистика — без данных реальных проектов. Русский README использует английские кадры; у китайского README отдельные скриншоты на упрощённом китайском. Субагенты показаны в штатном каталоге Harness в заголовке.
|
|
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="Штатный каталог субагентов Harness в заголовке с двумя вымышленными дочерними агентами"> | <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.png" 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.png" 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,27 +1,29 @@
|
|
|
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` 和 `0.2.0-rc.2`,并让原生 Web 客户端可以在窄屏触控设备上使用。移动视图只调整界面布局,不接管 Harness 的会话、权限或业务逻辑。
|
|
15
17
|
|
|
16
18
|
> **安全边界:** 网关使用明文 HTTP,仅适用于可信私有网络。不要将端口暴露到互联网,也不要在公共 Wi-Fi 上使用。
|
|
17
19
|
|
|
18
20
|
<p align="center">
|
|
19
|
-
<img src="docs/images/local-access-qr.
|
|
21
|
+
<img src="docs/images/local-access-qr.zh.png" width="960" alt="DeepSeek Harness 中的 dsh-local-link 一次性二维码配对界面">
|
|
20
22
|
</p>
|
|
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
|
|
|
@@ -71,6 +73,8 @@ profile 会指向当前 checkout。修改客户端代码后需要重新构建;
|
|
|
71
73
|
|
|
72
74
|
可安装的 DeepSeek Harness 版本范围通过 `package.json` 中的 `engines.dsh` 声明。兼容性按精确发布版本验证,不会因为安装成功或可变的 dist-tag 就推断为兼容。
|
|
73
75
|
|
|
76
|
+
Local Link `1.2.3` 使用 Harness `0.2.0-rc.2` 的开发契约构建,并在该版本上验证了局域网配对、一次性浏览器登录、经过认证的页面与 WebSocket 访问,以及撤销设备后立即关闭 WebSocket。新版 `directoryPicker` API 的目录选择、浏览和创建仍仅允许在主机本地使用,不能通过局域网调用。移动图标适配器兼容新版按线条粗细命名的导出和旧版按尺寸命名的导出。`engines.dsh` 中保留的早期 RC 基于更新日志中的历史验证;本次补丁未重新运行所有旧版本。实体手机验收仍需单独进行。
|
|
77
|
+
|
|
74
78
|
## 使用方法
|
|
75
79
|
|
|
76
80
|
1. 在电脑上打开需要使用的会话。
|
|
@@ -93,13 +97,14 @@ profile 会指向当前 checkout。修改客户端代码后需要重新构建;
|
|
|
93
97
|
- 切换会话不会自动唤起软键盘,主动点击输入区仍会正常聚焦;
|
|
94
98
|
- 深色/浅色主题继续由 Harness 主题服务管理;
|
|
95
99
|
- 远程手机上隐藏容易误导的 `Add workspace` 目录选择器;
|
|
100
|
+
- 手机端隐藏聊天底部重复的上下文用量指示器和在电脑上打开文件的按钮(资源管理器/VS Code/Rider);桌面端仍保留,手机端可在 `Current session` 查看上下文详情;
|
|
96
101
|
- 顶栏、消息操作、输入工具、安全区域和虚拟键盘行为适配窄屏。
|
|
97
102
|
|
|
98
|
-
|
|
103
|
+
以下深色主题截图来自 Harness `0.2.0-rc.2` 的真实浏览器会话,使用 `430 × 932` 模拟视口。独立截图配置只包含虚构的工作区、对话、模型、设备和用量数据,不包含真实项目数据。中文 README 使用独立的简体中文截图;子智能体通过 Harness 原生的标题栏目录展示。
|
|
99
104
|
|
|
100
105
|
| 导航 | 当前会话 | 子智能体 | 对话 |
|
|
101
106
|
| :---: | :---: | :---: | :---: |
|
|
102
|
-
| <img src="docs/images/mobile-navigation.png" width="210" alt="包含虚构工作区与会话的深色移动导航抽屉"> | <img src="docs/images/mobile-session-info.png" width="210" alt="包含虚构模型、工作区权限、统计和会话日志数据的深色当前会话抽屉"> | <img src="docs/images/mobile-subagents.png" width="210" alt="
|
|
107
|
+
| <img src="docs/images/mobile-navigation.zh.png" width="210" alt="包含虚构工作区与会话的深色移动导航抽屉"> | <img src="docs/images/mobile-session-info.zh.png" width="210" alt="包含虚构模型、工作区权限、统计和会话日志数据的深色当前会话抽屉"> | <img src="docs/images/mobile-subagents.zh.png" width="210" alt="包含两个虚构子智能体的原生深色标题栏目录"> | <img src="docs/images/mobile-chat.zh.png" width="210" alt="包含原生消息操作和单行输入工具的深色 Harness 移动对话"> |
|
|
103
108
|
|
|
104
109
|
### 权限
|
|
105
110
|
|
|
@@ -118,7 +123,13 @@ profile 会指向当前 checkout。修改客户端代码后需要重新构建;
|
|
|
118
123
|
浏览器无法可靠区分笔记本与台式机,因此两者统一显示为 `Computer`。
|
|
119
124
|
|
|
120
125
|
<p align="center">
|
|
121
|
-
<img src="docs/images/local-access-devices.
|
|
126
|
+
<img src="docs/images/local-access-devices.zh.png" width="960" alt="DeepSeek Harness Local access 已配对设备列表">
|
|
127
|
+
</p>
|
|
128
|
+
|
|
129
|
+
展开同一设置页的 `诊断` 面板,可查看本地网关事件,并复制经过隐私过滤的报告。报告不包含配对令牌、Cookie、地址、设备名称、请求路径或对话内容。
|
|
130
|
+
|
|
131
|
+
<p align="center">
|
|
132
|
+
<img src="docs/images/local-access-diagnostics.zh.png" width="960" alt="DeepSeek Harness 本地访问设置中展开的诊断面板">
|
|
122
133
|
</p>
|
|
123
134
|
|
|
124
135
|
## 工作原理
|
|
@@ -197,7 +208,7 @@ npm run verify
|
|
|
197
208
|
- 远程浏览器切换深色/浅色主题时,该选择在已支持的 Harness 版本中只对当前页面有效;
|
|
198
209
|
- 启动时会使用优先级最高的私有 IPv4 接口,暂不提供多接口选择;
|
|
199
210
|
- 移动视图支持从 360 CSS px 开始的视口,但第三方固定宽度视图、虚拟键盘、旋转、分屏和系统文字缩放仍需要真实设备验收;
|
|
200
|
-
-
|
|
211
|
+
- 受支持的 Harness 版本尚未公开完整的响应式 shell、间距和圆角契约;图标导出名称的变更由兼容适配器处理。每个受支持版本仍须重新验证界面适配。
|
|
201
212
|
|
|
202
213
|
## 开发说明
|
|
203
214
|
|
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.
|
|
69
|
+
The `0.2.0-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. Permission display accepts both the UI selection with an optional option catalog and a persisted preset; when no display catalog exists, it shows the recorded identifier rather than claiming the permission is absent. Empty agent-preset values display the explicit not-recorded label.
|
|
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.
|
|
178
|
+
The plugin develops against the exact DeepSeek Harness `0.2.0-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 these releases, `@deepseek-ai/dsh-client-ui-subagent` owns the native header catalog and navigation. The 0.2 directory-picker RPCs (`directoryPicker.pick`, `directoryPicker.list`, and `directoryPicker.createDirectory`) join the legacy Host methods in the gateway's loopback-only filter; ordinary session and workspace methods remain available.
|
|
179
179
|
|
|
180
180
|
| Adapter | Why it exists | Failure behavior | Removal condition |
|
|
181
181
|
| --- | --- | --- | --- |
|