dsh-local-link 1.2.2 → 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 +20 -0
- package/README.md +9 -9
- package/README.ru.md +9 -9
- package/README.zh.md +12 -6
- package/docs/ARCHITECTURE.md +2 -2
- package/docs/MOBILE_VIEW.md +1 -1
- 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 +9 -6
- package/lib/client.js.map +1 -1
- package/lib/index.mjs +3 -0
- package/package.json +41 -41
- 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,26 @@
|
|
|
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
|
+
|
|
5
25
|
## 1.2.2 — 2026-09-27
|
|
6
26
|
|
|
7
27
|
### Changed
|
package/README.md
CHANGED
|
@@ -13,12 +13,12 @@ Use the same [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
|
|
|
13
13
|
|
|
14
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.
|
|
15
15
|
|
|
16
|
-
The `1.2.x` line supports DeepSeek Harness `0.1.5-rc.2` and `0.
|
|
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.
|
|
17
17
|
|
|
18
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.
|
|
19
19
|
|
|
20
20
|
<p align="center">
|
|
21
|
-
<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">
|
|
22
22
|
</p>
|
|
23
23
|
|
|
24
24
|
<p align="center"><sub>One Harness session, paired directly across the trusted LAN.</sub></p>
|
|
@@ -75,7 +75,7 @@ The profile points at the checkout, so rebuild after changing client code and re
|
|
|
75
75
|
|
|
76
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.
|
|
77
77
|
|
|
78
|
-
Local Link `1.2.
|
|
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
79
|
|
|
80
80
|
## Use
|
|
81
81
|
|
|
@@ -98,7 +98,7 @@ The stock Harness Web interface is difficult to operate on a phone: persistent d
|
|
|
98
98
|
| --- | --- |
|
|
99
99
|
| Desktop navigation competes with the conversation | Workspace and session navigation opens as a dismissible left drawer |
|
|
100
100
|
| Session metadata crowds the header | Context, model, access, preset, activity, and export move into a compact right drawer |
|
|
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 |
|
|
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 |
|
|
102
102
|
| Hover-oriented session and workspace actions | Overflow actions remain visible and touch-accessible |
|
|
103
103
|
| Session changes can summon the software keyboard | Automatic composer focus is suppressed while intentional input focus still works |
|
|
104
104
|
| Desktop spacing ignores phone safe areas | Header, composer, tabs, media, overlays, and scrolling adapt to narrow viewports |
|
|
@@ -109,7 +109,7 @@ The implementation changes presentation, not Harness ownership or behavior:
|
|
|
109
109
|
- dynamic Chat, Trajectory, composer, overlay, and third-party plugin slots remain intact;
|
|
110
110
|
- Current session opens from the header with context breakdown, model, workspace access, preset, activity, and session-log download;
|
|
111
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;
|
|
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;
|
|
113
113
|
- the Harness theme service powers a compact sun/moon action;
|
|
114
114
|
- desktop-only Settings and the nested Local access action are omitted from mobile navigation, while the appearance action remains available;
|
|
115
115
|
- session and active-workspace menus stay immediately available on touch screens;
|
|
@@ -117,11 +117,11 @@ The implementation changes presentation, not Harness ownership or behavior:
|
|
|
117
117
|
- plugin-owned modal drawers contain keyboard focus and return it to the invoking control when closed;
|
|
118
118
|
- existing workspaces remain available, while the misleading remote `Add workspace` directory picker is omitted.
|
|
119
119
|
|
|
120
|
-
These dark-theme previews were captured
|
|
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.
|
|
121
121
|
|
|
122
122
|
| Navigation | Current session | Subagents | Conversation |
|
|
123
123
|
| :---: | :---: | :---: | :---: |
|
|
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="
|
|
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"> |
|
|
125
125
|
|
|
126
126
|
### Permissions
|
|
127
127
|
|
|
@@ -140,13 +140,13 @@ On the Harness computer, use `Paired devices` in the QR panel or open `Settings
|
|
|
140
140
|
Browsers do not reliably distinguish laptops from desktop computers, so both are shown as `Computer`.
|
|
141
141
|
|
|
142
142
|
<p align="center">
|
|
143
|
-
<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">
|
|
144
144
|
</p>
|
|
145
145
|
|
|
146
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.
|
|
147
147
|
|
|
148
148
|
<p align="center">
|
|
149
|
-
<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">
|
|
150
150
|
</p>
|
|
151
151
|
|
|
152
152
|
## Why it stays small
|
package/README.ru.md
CHANGED
|
@@ -13,12 +13,12 @@
|
|
|
13
13
|
|
|
14
14
|
Откройте `Local access`, отсканируйте QR-код — и подключённый браузер попадёт в текущую сессию Harness, выбранную на компьютере. Диалог, права доступа, рабочие пространства и интерфейсы плагинов останутся теми же.
|
|
15
15
|
|
|
16
|
-
Ветка `1.2.x` поддерживает DeepSeek Harness `0.1.5-rc.2` и `0.
|
|
16
|
+
Ветка `1.2.x` поддерживает DeepSeek Harness `0.1.5-rc.2`, `0.1.7-rc.2` и `0.2.0-rc.2` и делает стандартный веб-клиент удобным на узких сенсорных экранах. Существующий интерфейс Harness преобразуется в адаптивные панели, компактные элементы управления сессией и удобные для касаний действия, но сам клиент, сессия, слоты плагинов, разрешения и поток событий агента остаются прежними.
|
|
17
17
|
|
|
18
18
|
> **Граница безопасности:** шлюз работает по незашифрованному HTTP и предназначен только для доверенной частной сети. Не выставляйте его порт в интернет и не используйте плагин в публичных сетях Wi-Fi.
|
|
19
19
|
|
|
20
20
|
<p align="center">
|
|
21
|
-
<img src="docs/images/local-access-qr.
|
|
21
|
+
<img src="docs/images/local-access-qr.png" width="960" alt="DeepSeek Harness с открытым dsh-local-link: одноразовое подключение по QR-коду к текущей стандартной сессии Harness">
|
|
22
22
|
</p>
|
|
23
23
|
|
|
24
24
|
<p align="center"><sub>Одна сессия Harness, прямое подключение внутри доверенной локальной сети.</sub></p>
|
|
@@ -75,7 +75,7 @@ dsh web
|
|
|
75
75
|
|
|
76
76
|
Диапазон устанавливаемых версий DeepSeek Harness объявлен в `package.json` через `engines.dsh`. Совместимость проверяется на конкретных релизах и не выводится только из успешной установки или плавающего dist-tag.
|
|
77
77
|
|
|
78
|
-
Local Link `1.2.
|
|
78
|
+
Local Link `1.2.3` собирается на контрактах Harness `0.2.0-rc.2`. На нём проверены сопряжение по LAN, одноразовый вход в браузер, авторизованные страница и WebSocket, а также немедленное закрытие WebSocket после отзыва устройства. Выбор, просмотр и создание папок через новый API `directoryPicker` остаются доступны только на самом хосте, не через LAN. Адаптер мобильных значков понимает новые имена экспорта по толщине линии и прежние имена по размеру. Предыдущие RC оставлены в `engines.dsh` на основании исторических проверок в changelog; все они повторно для этого патча не прогонялись. Проверка на физическом телефоне проводится отдельно от эмуляции браузера.
|
|
79
79
|
|
|
80
80
|
## Использование
|
|
81
81
|
|
|
@@ -98,7 +98,7 @@ Local Link `1.2.2` собирается на контрактах Harness `0.1.7
|
|
|
98
98
|
| --- | --- |
|
|
99
99
|
| Десктопная навигация конкурирует с диалогом | Навигация по рабочим пространствам и сессиям открывается в закрываемой левой панели |
|
|
100
100
|
| Метаданные сессии перегружают заголовок | Контекст, модель, доступ, пресет, активность и экспорт вынесены в компактную правую панель |
|
|
101
|
-
| Сведения о субагентах трудно просматривать и открывать | В 0.1.5 чип у поля ввода открывает каталог снизу; в 0.1.7 каталог и навигация принадлежат Harness и находятся в заголовке |
|
|
101
|
+
| Сведения о субагентах трудно просматривать и открывать | В 0.1.5 чип у поля ввода открывает каталог снизу; в 0.1.7 и 0.2 каталог и навигация принадлежат Harness и находятся в заголовке |
|
|
102
102
|
| Действия с сессиями и рабочими пространствами рассчитаны на наведение | Меню действий остаются видимыми и доступными для касания |
|
|
103
103
|
| При смене сессии может открыться экранная клавиатура | Автоматический фокус поля ввода подавляется, но намеренное касание по-прежнему устанавливает фокус |
|
|
104
104
|
| Десктопные отступы не учитывают безопасные области телефона | Заголовок, поле ввода, вкладки, медиа, оверлеи и прокрутка адаптируются к узкому экрану |
|
|
@@ -109,7 +109,7 @@ Local Link `1.2.2` собирается на контрактах Harness `0.1.7
|
|
|
109
109
|
- динамические слоты Chat, Trajectory, поля ввода, оверлеев и сторонних плагинов сохраняются;
|
|
110
110
|
- `Current session` открывается из заголовка и показывает структуру контекста, модель, доступ к рабочему пространству, пресет, активность и скачивание журнала сессии;
|
|
111
111
|
- на телефоне дублирующий индикатор контекста под чатом и кнопку открытия на компьютере (Проводник/VS Code/Rider) скрыли; на десктопе оба элемента остались;
|
|
112
|
-
- в 0.1.5 статус дочерних агентов открывает вложенный каталог в нижней панели; в 0.1.7 для этого используется штатное действие Harness в заголовке;
|
|
112
|
+
- в 0.1.5 статус дочерних агентов открывает вложенный каталог в нижней панели; в 0.1.7 и 0.2 для этого используется штатное действие Harness в заголовке;
|
|
113
113
|
- сервис тем Harness управляет компактной кнопкой «солнце/луна»;
|
|
114
114
|
- десктопные Settings и вложенное действие Local access скрыты в мобильной навигации, но переключение темы остаётся доступным;
|
|
115
115
|
- меню сессии и активного рабочего пространства сразу доступны на сенсорных экранах;
|
|
@@ -117,11 +117,11 @@ Local Link `1.2.2` собирается на контрактах Harness `0.1.7
|
|
|
117
117
|
- модальные панели плагина удерживают клавиатурный фокус и после закрытия возвращают его вызвавшему элементу;
|
|
118
118
|
- существующие рабочие пространства остаются доступны, а вводящая в заблуждение удалённая кнопка `Add workspace`, открывающая системный выбор каталога, скрыта.
|
|
119
119
|
|
|
120
|
-
|
|
120
|
+
Изображения в тёмной теме сняты из настоящих браузерных сессий Harness `0.2.0-rc.2` при эмулируемом viewport `430 × 932`. В отдельных демонстрационных профилях используются только вымышленные рабочие пространства, диалоги, модели, устройства и статистика — без данных реальных проектов. Русский README использует английские кадры; у китайского README отдельные скриншоты на упрощённом китайском. Субагенты показаны в штатном каталоге Harness в заголовке.
|
|
121
121
|
|
|
122
122
|
| Навигация | Текущая сессия | Субагенты | Диалог |
|
|
123
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="
|
|
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
125
|
|
|
126
126
|
### Разрешения
|
|
127
127
|
|
|
@@ -140,13 +140,13 @@ Local Link `1.2.2` собирается на контрактах Harness `0.1.7
|
|
|
140
140
|
Браузеры не умеют надёжно отличать ноутбук от настольного компьютера, поэтому оба варианта отображаются как `Computer`.
|
|
141
141
|
|
|
142
142
|
<p align="center">
|
|
143
|
-
<img src="docs/images/local-access-devices.
|
|
143
|
+
<img src="docs/images/local-access-devices.png" width="960" alt="Настройки DeepSeek Harness, открытые на компактном списке подключённых устройств Local access">
|
|
144
144
|
</p>
|
|
145
145
|
|
|
146
146
|
Разверните `Diagnostics` на той же странице Settings, чтобы просмотреть последние события локального шлюза. `Copy report` формирует готовый для issue JSON, а `Clear` удаляет локальную историю. Отчёт содержит только коды событий, время, серьёзность и небольшой разрешённый контекст; в него никогда не попадают токены подключения, cookie, IP-адреса, идентификаторы устройств и сессий, имена устройств, пути запросов, промпты, диалоги или файлы проекта.
|
|
147
147
|
|
|
148
148
|
<p align="center">
|
|
149
|
-
<img src="docs/images/local-access-diagnostics.
|
|
149
|
+
<img src="docs/images/local-access-diagnostics.png" width="960" alt="Настройки Local access в DeepSeek Harness с раскрытой нативной панелью Diagnostics">
|
|
150
150
|
</p>
|
|
151
151
|
|
|
152
152
|
## Почему плагин остаётся небольшим
|
package/README.zh.md
CHANGED
|
@@ -13,12 +13,12 @@
|
|
|
13
13
|
|
|
14
14
|
打开 `Local access` 并扫描二维码后,已配对的浏览器会进入桌面端当前选中的 Harness 会话,并继续使用相同的实时对话、权限、工作区和插件界面。
|
|
15
15
|
|
|
16
|
-
`1.2.x` 系列支持 DeepSeek Harness `0.1.5-rc.2` 和 `0.
|
|
16
|
+
`1.2.x` 系列支持 DeepSeek Harness `0.1.5-rc.2`、`0.1.7-rc.2` 和 `0.2.0-rc.2`,并让原生 Web 客户端可以在窄屏触控设备上使用。移动视图只调整界面布局,不接管 Harness 的会话、权限或业务逻辑。
|
|
17
17
|
|
|
18
18
|
> **安全边界:** 网关使用明文 HTTP,仅适用于可信私有网络。不要将端口暴露到互联网,也不要在公共 Wi-Fi 上使用。
|
|
19
19
|
|
|
20
20
|
<p align="center">
|
|
21
|
-
<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 一次性二维码配对界面">
|
|
22
22
|
</p>
|
|
23
23
|
|
|
24
24
|
<p align="center"><sub>通过可信局域网直接打开同一个 Harness 会话。</sub></p>
|
|
@@ -73,7 +73,7 @@ profile 会指向当前 checkout。修改客户端代码后需要重新构建;
|
|
|
73
73
|
|
|
74
74
|
可安装的 DeepSeek Harness 版本范围通过 `package.json` 中的 `engines.dsh` 声明。兼容性按精确发布版本验证,不会因为安装成功或可变的 dist-tag 就推断为兼容。
|
|
75
75
|
|
|
76
|
-
Local Link `1.2.
|
|
76
|
+
Local Link `1.2.3` 使用 Harness `0.2.0-rc.2` 的开发契约构建,并在该版本上验证了局域网配对、一次性浏览器登录、经过认证的页面与 WebSocket 访问,以及撤销设备后立即关闭 WebSocket。新版 `directoryPicker` API 的目录选择、浏览和创建仍仅允许在主机本地使用,不能通过局域网调用。移动图标适配器兼容新版按线条粗细命名的导出和旧版按尺寸命名的导出。`engines.dsh` 中保留的早期 RC 基于更新日志中的历史验证;本次补丁未重新运行所有旧版本。实体手机验收仍需单独进行。
|
|
77
77
|
|
|
78
78
|
## 使用方法
|
|
79
79
|
|
|
@@ -100,11 +100,11 @@ Local Link `1.2.2` 使用 Harness `0.1.7-rc.2` 的开发契约构建,并在该
|
|
|
100
100
|
- 手机端隐藏聊天底部重复的上下文用量指示器和在电脑上打开文件的按钮(资源管理器/VS Code/Rider);桌面端仍保留,手机端可在 `Current session` 查看上下文详情;
|
|
101
101
|
- 顶栏、消息操作、输入工具、安全区域和虚拟键盘行为适配窄屏。
|
|
102
102
|
|
|
103
|
-
以下深色主题截图来自 Harness `0.
|
|
103
|
+
以下深色主题截图来自 Harness `0.2.0-rc.2` 的真实浏览器会话,使用 `430 × 932` 模拟视口。独立截图配置只包含虚构的工作区、对话、模型、设备和用量数据,不包含真实项目数据。中文 README 使用独立的简体中文截图;子智能体通过 Harness 原生的标题栏目录展示。
|
|
104
104
|
|
|
105
105
|
| 导航 | 当前会话 | 子智能体 | 对话 |
|
|
106
106
|
| :---: | :---: | :---: | :---: |
|
|
107
|
-
| <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 移动对话"> |
|
|
108
108
|
|
|
109
109
|
### 权限
|
|
110
110
|
|
|
@@ -123,7 +123,13 @@ Local Link `1.2.2` 使用 Harness `0.1.7-rc.2` 的开发契约构建,并在该
|
|
|
123
123
|
浏览器无法可靠区分笔记本与台式机,因此两者统一显示为 `Computer`。
|
|
124
124
|
|
|
125
125
|
<p align="center">
|
|
126
|
-
<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 本地访问设置中展开的诊断面板">
|
|
127
133
|
</p>
|
|
128
134
|
|
|
129
135
|
## 工作原理
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -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
|
|
|
@@ -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
|
| --- | --- | --- | --- |
|
package/docs/MOBILE_VIEW.md
CHANGED
|
@@ -15,7 +15,7 @@ Presentation remains independent of authorization: changing the viewport never g
|
|
|
15
15
|
- **Dynamic views:** Chat, Trajectory, composer extensions, overlays, and third-party conversation tabs continue to resolve from Harness plugin slots.
|
|
16
16
|
- **Current session:** a right drawer shows context usage and its System prompt / Tools / Messages breakdown, model, workspace access, agent preset, activity statistics, and session-log download.
|
|
17
17
|
- **Mobile-only simplification:** the duplicate stock context meter below the conversation and the Host-app opener (Explorer/VS Code/Rider) are hidden on mobile, but remain visible on desktop.
|
|
18
|
-
- **Subagents:** on 0.1.5, a compact status chip opens the nested catalog as a touch-friendly bottom sheet. On 0.1.7, Harness's native header action owns the catalog and navigation.
|
|
18
|
+
- **Subagents:** on 0.1.5, a compact status chip opens the nested catalog as a touch-friendly bottom sheet. On 0.1.7 and 0.2, Harness's native header action owns the catalog and navigation.
|
|
19
19
|
- **Appearance:** a sun/moon action uses the Harness theme service. Remote theme selection remains page-scoped, so reload returns to the host preference and resolves `system` against the phone or tablet.
|
|
20
20
|
- **Touch behavior:** native session and active-workspace overflow actions remain visible without a long press, and switching sessions does not automatically focus the composer or open the software keyboard.
|
|
21
21
|
- **Keyboard accessibility:** plugin-owned modal drawers receive and contain focus, close with Escape, and restore focus to their invoking control.
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/lib/client.js
CHANGED
|
@@ -521,11 +521,12 @@ window.__ModuleLoader__.load({
|
|
|
521
521
|
}
|
|
522
522
|
reportModel(sessionId, model) {
|
|
523
523
|
if (this.snapshot.modelSessionId === sessionId && this.snapshot.model === model) return;
|
|
524
|
+
const { model: previousModel, ...snapshot } = this.snapshot;
|
|
524
525
|
this.snapshot = Object.freeze(model === void 0 ? {
|
|
525
|
-
|
|
526
|
+
...snapshot,
|
|
526
527
|
modelSessionId: sessionId
|
|
527
528
|
} : {
|
|
528
|
-
|
|
529
|
+
...snapshot,
|
|
529
530
|
modelSessionId: sessionId,
|
|
530
531
|
model
|
|
531
532
|
});
|
|
@@ -548,7 +549,7 @@ window.__ModuleLoader__.load({
|
|
|
548
549
|
}
|
|
549
550
|
};
|
|
550
551
|
function mobilePresetLabel(preset, t) {
|
|
551
|
-
if (preset
|
|
552
|
+
if (typeof preset !== "string" || preset.trim() === "") return t("mobile.sessionInfo.notRecorded");
|
|
552
553
|
switch (preset) {
|
|
553
554
|
case "standard": return t("mobile.sessionInfo.preset.standard");
|
|
554
555
|
case "code": return t("mobile.sessionInfo.preset.code");
|
|
@@ -600,14 +601,16 @@ window.__ModuleLoader__.load({
|
|
|
600
601
|
}
|
|
601
602
|
function permissionName(value) {
|
|
602
603
|
const selection = recordOf(value);
|
|
603
|
-
const currentValue =
|
|
604
|
-
if (currentValue === void 0
|
|
604
|
+
const currentValue = permissionValue(value);
|
|
605
|
+
if (currentValue === void 0) return void 0;
|
|
606
|
+
if (!Array.isArray(selection?.options)) return currentValue;
|
|
605
607
|
const name = recordOf(selection.options.find((option) => recordOf(option)?.value === currentValue))?.name;
|
|
606
608
|
return typeof name === "string" ? name : currentValue;
|
|
607
609
|
}
|
|
608
610
|
function permissionValue(value) {
|
|
609
611
|
const selection = recordOf(value);
|
|
610
|
-
|
|
612
|
+
const currentValue = selection?.currentValue ?? selection?.preset;
|
|
613
|
+
return typeof currentValue === "string" && currentValue.length > 0 ? currentValue : void 0;
|
|
611
614
|
}
|
|
612
615
|
function currentModelName(value) {
|
|
613
616
|
const directory = recordOf(value);
|