dsh-local-link 1.2.1 → 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 CHANGED
@@ -2,6 +2,22 @@
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
+
5
21
  ## 1.2.1 — 2026-09-21
6
22
 
7
23
  ### Changed
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
  [![CI](https://github.com/donoteatme/dsh-local-link/actions/workflows/ci.yml/badge.svg)](https://github.com/donoteatme/dsh-local-link/actions/workflows/ci.yml)
6
6
  [![npm](https://img.shields.io/npm/v/dsh-local-link.svg)](https://www.npmjs.com/package/dsh-local-link)
7
- [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
7
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-local-link.svg)](https://www.npmjs.com/package/dsh-local-link)
8
+ [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com/p/donoteatme/dsh-local-link/)
9
+ [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
8
10
  [![license](https://img.shields.io/badge/license-MIT-blue.svg)](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
- ## Focused product scope
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.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.
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 | Total/active status stays near the composer and the native catalog opens as a bottom sheet |
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 |
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
- - child-agent status shows total and active counts, then opens the native nested catalog as a touch-friendly bottom sheet;
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;
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,7 +117,7 @@ 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 are captured from a real Harness browser session 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.
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.
116
121
 
117
122
  | Navigation | Current session | Subagents | Conversation |
118
123
  | :---: | :---: | :---: | :---: |
@@ -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 `0.1.5-rc.2` still has no complete public responsive-shell, spacing, or radius contract, so mobile geometry, responsive compositions, and the few missing primitive icons remain documented design-system compatibility risks.
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
+ [![CI](https://github.com/donoteatme/dsh-local-link/actions/workflows/ci.yml/badge.svg)](https://github.com/donoteatme/dsh-local-link/actions/workflows/ci.yml)
6
+ [![npm](https://img.shields.io/npm/v/dsh-local-link.svg)](https://www.npmjs.com/package/dsh-local-link)
7
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-local-link.svg)](https://www.npmjs.com/package/dsh-local-link)
8
+ [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com/p/donoteatme/dsh-local-link/)
9
+ [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
10
+ [![license](https://img.shields.io/badge/license-MIT-blue.svg)](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
  [![CI](https://github.com/donoteatme/dsh-local-link/actions/workflows/ci.yml/badge.svg)](https://github.com/donoteatme/dsh-local-link/actions/workflows/ci.yml)
6
6
  [![npm](https://img.shields.io/npm/v/dsh-local-link.svg)](https://www.npmjs.com/package/dsh-local-link)
7
- [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
7
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-local-link.svg)](https://www.npmjs.com/package/dsh-local-link)
8
+ [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com/p/donoteatme/dsh-local-link/)
9
+ [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-zh.svg)](https://dsh.market/)
8
10
  [![license](https://img.shields.io/badge/license-MIT-blue.svg)](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
 
@@ -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.2` 使用 Harness `0.1.7-rc.2` 的开发契约构建,并在该版本上验证了局域网配对、一次性浏览器登录、经过认证的页面与 WebSocket 访问,以及撤销设备后立即关闭 WebSocket。移动图标适配器兼容新版按线条粗细命名的导出和旧版按尺寸命名的导出。`engines.dsh` 中保留的早期 RC 基于更新日志中的历史验证;本次补丁未重新运行所有旧版本。实体手机验收仍需单独进行。
77
+
74
78
  ## 使用方法
75
79
 
76
80
  1. 在电脑上打开需要使用的会话。
@@ -93,9 +97,10 @@ profile 会指向当前 checkout。修改客户端代码后需要重新构建;
93
97
  - 切换会话不会自动唤起软键盘,主动点击输入区仍会正常聚焦;
94
98
  - 深色/浅色主题继续由 Harness 主题服务管理;
95
99
  - 远程手机上隐藏容易误导的 `Add workspace` 目录选择器;
100
+ - 手机端隐藏聊天底部重复的上下文用量指示器和在电脑上打开文件的按钮(资源管理器/VS Code/Rider);桌面端仍保留,手机端可在 `Current session` 查看上下文详情;
96
101
  - 顶栏、消息操作、输入工具、安全区域和虚拟键盘行为适配窄屏。
97
102
 
98
- 以下深色主题截图来自真实的 Harness 浏览器会话,使用 `430 × 932` 模拟视口。独立截图配置只包含虚构的产品演示数据,不包含本地工作区、对话、路径、提示词、模型或用量数据。
103
+ 以下深色主题截图来自 Harness `0.1.5-rc.2` 的真实浏览器会话,使用 `430 × 932` 模拟视口。独立截图配置只包含虚构的产品演示数据,不包含本地工作区、对话、路径、提示词、模型或用量数据。`0.1.7-rc.2` 使用 Harness 原生的子智能体标题栏目录,与图中的底部面板不同。
99
104
 
100
105
  | 导航 | 当前会话 | 子智能体 | 对话 |
101
106
  | :---: | :---: | :---: | :---: |
@@ -197,7 +202,7 @@ npm run verify
197
202
  - 远程浏览器切换深色/浅色主题时,该选择在已支持的 Harness 版本中只对当前页面有效;
198
203
  - 启动时会使用优先级最高的私有 IPv4 接口,暂不提供多接口选择;
199
204
  - 移动视图支持从 360 CSS px 开始的视口,但第三方固定宽度视图、虚拟键盘、旋转、分屏和系统文字缩放仍需要真实设备验收;
200
- - `0.1.5-rc.2` 尚未公开完整的响应式 shell、间距、圆角和全部图标契约,因此每个受支持版本都必须重新验证相关界面适配。
205
+ - 受支持的 Harness 版本尚未公开完整的响应式 shell、间距和圆角契约;图标导出名称的变更由兼容适配器处理。每个受支持版本仍须重新验证界面适配。
201
206
 
202
207
  ## 开发说明
203
208
 
@@ -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.5-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.
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 `0.1.5-rc.2` does 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.
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 `0.1.5-rc.2`, 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.
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.5-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:
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
  | --- | --- | --- | --- |
@@ -14,7 +14,8 @@ Presentation remains independent of authorization: changing the viewport never g
14
14
  - **Existing sessions:** Search, View options, workspaces, sessions, rename, archive, and the active-workspace actions stay native Harness operations.
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
- - **Subagents:** a compact status chip exposes total and active counts with the native activity state, then opens the nested subagent catalog as a touch-friendly bottom sheet.
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
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.
19
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.
20
21
  - **Keyboard accessibility:** plugin-owned modal drawers receive and contain focus, close with Escape, and restore focus to their invoking control.
@@ -51,7 +52,7 @@ Landscape phones, split-screen browsers, virtual keyboards, third-party fixed-wi
51
52
 
52
53
  Mobile View keeps the official Harness root and AppFrame mounted. It contributes controls through overlay, conversation, theme, session, locale, button, and input contracts wherever Harness exposes them. The stock desktop presentation is unchanged when the media query does not match.
53
54
 
54
- Harness `0.1.5-rc.2` does not expose a complete public responsive shell, drawer recipe, spacing/radius scale, or every required glyph. The plugin therefore owns mobile geometry and a small number of scoped presentation adapters for stock brand, workspace, session-action, and feedback elements. Those hooks are documented in [Architecture and compatibility boundaries](ARCHITECTURE.md) and must be retested for each supported Harness version.
55
+ The supported Harness builds do not expose a complete public responsive shell, drawer recipe, or spacing/radius scale. The plugin therefore owns mobile geometry and a small number of scoped presentation adapters for stock brand, workspace, session-action, and feedback elements. Its icon adapter accepts both 0.1.7 weight-named and older size-named exports. These hooks are documented in [Architecture and compatibility boundaries](ARCHITECTURE.md) and must be retested for each supported Harness version.
55
56
 
56
57
  ## Security
57
58