dsh-local-link 1.1.2 → 1.2.0

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,37 @@
2
2
 
3
3
  All notable changes to this project are documented here.
4
4
 
5
+ ## 1.2.0 — 2026-09-18
6
+
7
+ `1.2.0` moves the development baseline to DeepSeek Harness `0.1.5-rc.2` and
8
+ finishes the narrow-screen presentation without changing Local Link's trusted
9
+ private-LAN scope, pairing model, or use of the stock Harness client.
10
+
11
+ ### Added
12
+
13
+ - Added a complete Simplified Chinese README with an English/Chinese language switch; both README files ship in the npm package.
14
+ - Added real dark-theme browser screenshots for Navigation, Current session, Subagents, and Conversation, captured from an isolated `430 × 932` Harness profile containing synthetic data only.
15
+ - Added regression coverage for compact header actions, the narrow composer, hidden remote app-launch action, and the Harness right sidebar on mobile.
16
+
17
+ ### Changed
18
+
19
+ - Moved the supported DeepSeek Harness baseline and all direct development contracts to the exact `0.1.5-rc.2` release while retaining the explicitly verified historical RC peer range.
20
+ - Reworked the mobile header controls into compact, unframed actions with balanced safe-area spacing and a non-shrinking Current session information action.
21
+ - Kept composer actions on one row at phone widths, collapsed the model selector label before overflow, and allowed the placeholder to wrap to two lines.
22
+ - Projected the Harness `rightbar` as a full-screen mobile surface instead of hiding it.
23
+
24
+ ### Fixed
25
+
26
+ - Kept the Current session information action visible at very narrow widths, including a `320 × 568` browser-emulated check.
27
+ - Removed the misleading remote `Open in app` action from Mobile View.
28
+ - Preserved native message actions and the end of the conversation while keeping the composer fully usable on narrow screens.
29
+
30
+ ### Validated
31
+
32
+ - Passed TypeScript checking, all 102 automated tests across 16 files, the production build, the production dependency audit with no known vulnerabilities, package dry-run, and `npm publish --dry-run`.
33
+ - Booted an isolated `0.1.5-rc.2` Harness profile with the local plugin and synthetic parent/child sessions, then exercised the real Navigation, Current session, Subagents, and Conversation surfaces at `430 × 932` and the header/composer at `320 × 568`.
34
+ - Retained the previously recorded installed-runtime compatibility evidence for `0.1.5-rc.1`, `0.1.2-rc.1`, `0.1.1-rc.2`, `0.1.1-rc.1`, and `0.1.0-rc.8`; physical-phone acceptance remains a separate check.
35
+
5
36
  ## 1.1.2 — 2026-09-15
6
37
 
7
38
  ### Fixed
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # dsh-local-link
2
2
 
3
+ **English** | [中文](README.zh.md)
4
+
3
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)
4
6
  [![npm](https://img.shields.io/npm/v/dsh-local-link.svg)](https://www.npmjs.com/package/dsh-local-link)
5
7
  [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
@@ -9,7 +11,7 @@ Use the same [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
9
11
 
10
12
  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.
11
13
 
12
- The `1.1.x` line supports DeepSeek Harness `0.1.5-rc.1` 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.
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.
13
15
 
14
16
  > **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.
15
17
 
@@ -73,14 +75,14 @@ Compatibility is checked against exact DeepSeek Harness versions—not inferred
73
75
 
74
76
  | DeepSeek Harness | Local Link status |
75
77
  | --- | --- |
76
- | `0.1.5-rc.2` | **Verified next** |
77
- | `0.1.5-rc.1` | **Supported release** |
78
+ | `0.1.5-rc.2` | **Supported release** |
79
+ | `0.1.5-rc.1` | **Verified** |
78
80
  | `0.1.2-rc.1` | **Verified** |
79
81
  | `0.1.1-rc.2` | **Verified** |
80
82
  | `0.1.1-rc.1` | **Verified** |
81
83
  | `0.1.0-rc.8` | **Verified** |
82
84
 
83
- All six rows were checked with the packed `1.1.1` source. Every exact version passed isolated profile composition, plugin peer checks, pairing, authenticated HTTP and WebSocket traffic, immediate socket closure on revoke, and rejection of the revoked device. The `0.1.5` rows also received the current real-client responsive check at `390 × 844`; historical responsive evidence remains recorded separately. `0.1.5-rc.1` is the development baseline. `0.1.5-rc.2` is an exact `next` check, not a promise about future movement of that tag.
85
+ All six rows passed the installed-runtime gateway and revoke gate with packed `1.1.1` source. For `1.2.0`, the current `0.1.5-rc.2` release was additionally rebuilt against the exact package contracts and exercised in the real browser client at `430 × 932` and `320 × 568`. Historical RC evidence remains recorded separately and the moving `next` tag itself is never a compatibility promise.
84
86
 
85
87
  Only the exact versions listed above carry a compatibility claim. Alpha builds—including the removed `0.1.2-alpha.1` row—versions older than `0.1.0-rc.8`, and whatever package a moving `next` tag points to later are unsupported until checked independently. See [Compatibility](docs/COMPATIBILITY.md) for the evidence and remaining real-device boundary.
86
88
 
@@ -101,7 +103,7 @@ Phone and tablet browsers automatically receive Mobile View when the viewport is
101
103
 
102
104
  The stock Harness Web interface is difficult to operate on a phone: persistent desktop navigation consumes the viewport, session controls compete with the conversation title, several actions depend on hover or long press, and subagent information is too dense for a narrow screen. Mobile View makes that existing interface usable without introducing a second client or duplicating Harness business logic.
103
105
 
104
- | Stock narrow-screen behavior | Mobile View in `1.1.x` |
106
+ | Stock narrow-screen behavior | Mobile View in `1.2.x` |
105
107
  | --- | --- |
106
108
  | Desktop navigation competes with the conversation | Workspace and session navigation opens as a dismissible left drawer |
107
109
  | Session metadata crowds the header | Context, model, access, preset, activity, and export move into a compact right drawer |
@@ -123,11 +125,11 @@ The implementation changes presentation, not Harness ownership or behavior:
123
125
  - plugin-owned modal drawers contain keyboard focus and return it to the invoking control when closed;
124
126
  - existing workspaces remain available, while the misleading remote `Add workspace` directory picker is omitted.
125
127
 
126
- These previews are captured from the running Harness client at a `430 × 932` viewport with non-persistent sample content; the thin rounded frame is presentation-only.
128
+ 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.
127
129
 
128
130
  | Navigation | Current session | Subagents | Conversation |
129
131
  | :---: | :---: | :---: | :---: |
130
- | <img src="docs/images/mobile-navigation.png" width="210" alt="Live Mobile View left navigation drawer with native workspace and session actions"> | <img src="docs/images/mobile-session-info.png" width="210" alt="Live Mobile View Current session drawer with context, model, workspace access, preset, activity, and session log"> | <img src="docs/images/mobile-subagents.png" width="210" alt="Live Mobile View nested subagent sheet with activity, tokens, and duration"> | <img src="docs/images/mobile-chat.png" width="210" alt="Live Mobile View Harness conversation, composer, and visible total and active subagent counts"> |
132
+ | <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="Dark Mobile View subagent sheet 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"> |
131
133
 
132
134
  ### Permissions
133
135
 
@@ -263,7 +265,7 @@ Project documentation:
263
265
  - The shortcut that opens a specific Settings section uses a small semantic compatibility bridge because Harness does not expose a general settings-navigation service.
264
266
  - Harness's footer-action container needs a compatibility layout rule when the full-width Cordis action is present.
265
267
  - 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.
266
- - Plugin-owned buttons and text inputs use Harness `Button` and `Input` primitives and their semantic variants. Harness `0.1.5-rc.1` 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.
268
+ - 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.
267
269
 
268
270
  ## Development disclosure
269
271
 
package/README.zh.md ADDED
@@ -0,0 +1,222 @@
1
+ # dsh-local-link
2
+
3
+ [English](README.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
+ [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
8
+ [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
9
+
10
+ 在可信私有网络中,通过手机、平板或另一台电脑使用同一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web 会话。`dsh-local-link` 为原生 DSH 客户端增加一次性二维码配对和响应式移动视图;它不使用托管中继、云账户、原生应用、替代聊天界面或第二套工作区选择器。
11
+
12
+ 打开 `Local access` 并扫描二维码后,已配对的浏览器会进入桌面端当前选中的 Harness 会话,并继续使用相同的实时对话、权限、工作区和插件界面。
13
+
14
+ `1.2.x` 系列支持 DeepSeek Harness `0.1.5-rc.2`,并让原生 Web 客户端可以在窄屏触控设备上使用。移动视图只调整界面布局,不接管 Harness 的会话、权限或业务逻辑。
15
+
16
+ > **安全边界:** 网关使用明文 HTTP,仅适用于可信私有网络。不要将端口暴露到互联网,也不要在公共 Wi-Fi 上使用。
17
+
18
+ <p align="center">
19
+ <img src="docs/images/local-access-qr.jpg" width="960" alt="DeepSeek Harness 中的 dsh-local-link 一次性二维码配对界面">
20
+ </p>
21
+
22
+ <p align="center"><sub>通过可信局域网直接打开同一个 Harness 会话。</sub></p>
23
+
24
+ ## 产品范围
25
+
26
+ Local Link 是现有 Harness Web 客户端的小型局域网配套插件,不是通用远程访问平台。它专注于一条可靠路径:在同一私有网络中的另一台设备上打开电脑中已经运行的 Harness,并继续使用相同的会话和界面。
27
+
28
+ 项目重点包括:
29
+
30
+ - 可靠访问当前 Harness Host;
31
+ - 短时一次性邀请和清晰的已配对设备生命周期;
32
+ - 在不复制 Harness 业务逻辑的前提下提供响应式布局;
33
+ - 兼容已注册的视图、插槽、权限、主题和会话状态;
34
+ - 在可信局域网范围内完善无障碍、本地化、诊断和安全加固。
35
+
36
+ 以下内容明确不在范围内:
37
+
38
+ - 公网暴露、托管中继、托管隧道或云账户;
39
+ - 独立的手机或桌面原生应用;
40
+ - 替代聊天客户端或 Harness 界面分支;
41
+ - 独立于 Harness 的工作区、文件或会话同步;
42
+ - 与当前 Web UI 无关的通用远程扩展运行时。
43
+
44
+ ## 安装
45
+
46
+ ### npm(推荐)
47
+
48
+ 停止正在运行的 `dsh web`,将插件安装到 Web profile,然后重新启动 Harness:
49
+
50
+ ```shell
51
+ dsh plugin --profile web add dsh-local-link
52
+ dsh web
53
+ ```
54
+
55
+ ### Git checkout(开发)
56
+
57
+ 需要 Git、Node.js 22.19+ 或 24+、Corepack,以及全局安装的、版本已验证的 `dsh`。
58
+
59
+ ```shell
60
+ git clone https://github.com/donoteatme/dsh-local-link.git
61
+ cd dsh-local-link
62
+ corepack pnpm install --frozen-lockfile
63
+ npm run verify
64
+ dsh plugin --profile web add .
65
+ dsh web
66
+ ```
67
+
68
+ profile 会指向当前 checkout。修改客户端代码后需要重新构建;修改 Host 侧代码后需要重启 `dsh web`。
69
+
70
+ ## 兼容性
71
+
72
+ 兼容性按 DeepSeek Harness 的精确版本验证,不会因为“能够安装”就推断为兼容。
73
+
74
+ | DeepSeek Harness | Local Link 状态 |
75
+ | --- | --- |
76
+ | `0.1.5-rc.2` | **支持的发布版本** |
77
+ | `0.1.5-rc.1` | **已验证** |
78
+ | `0.1.2-rc.1` | **已验证** |
79
+ | `0.1.1-rc.2` | **已验证** |
80
+ | `0.1.1-rc.1` | **已验证** |
81
+ | `0.1.0-rc.8` | **已验证** |
82
+
83
+ 以上六个版本都使用打包后的 `1.1.1` 源码通过了已安装运行时的网关和撤销测试。对于 `1.2.0`,当前发布版本 `0.1.5-rc.2` 还使用精确依赖重新构建,并在真实浏览器客户端中完成了 `430 × 932` 与 `320 × 568` 检查。历史 RC 的验证证据继续保留;移动的 `next` 标签本身不代表兼容性承诺。
84
+
85
+ 只有表格中的精确版本包含兼容性承诺。已移除的 alpha 版本、早于 `0.1.0-rc.8` 的版本,以及未来移动的 `next` 标签都必须单独验证。完整证据与边界见[兼容性说明](docs/COMPATIBILITY.md)。
86
+
87
+ ## 使用方法
88
+
89
+ 1. 在电脑上打开需要使用的会话。
90
+ 2. 点击 Harness 侧边栏底部的 `Local access`。
91
+ 3. 在同一网络的另一台设备上扫描二维码或打开一次性链接。
92
+ 4. 第一个使用邀请的浏览器会打开原生 Harness 客户端并进入当前会话。
93
+
94
+ 邀请只能使用一次,默认五分钟后过期。选择 `Generate another code` 会立即替换旧邀请。Harness 仅允许 loopback 执行的 Host 管理操作在远程浏览器中仍然不可用。
95
+
96
+ 宽度不超过 834 CSS px 的手机和平板会自动启用移动视图。不需要 URL 参数、User-Agent 开关或第二套客户端。
97
+
98
+ ## 移动视图
99
+
100
+ 移动视图会重新组织原生 Harness Web 界面,但保留同一个 Host、会话、插件插槽、权限和实时智能体输出。
101
+
102
+ - 工作区和会话导航变成可关闭的左侧抽屉;
103
+ - 当前会话的上下文、模型、权限、预设、活动和日志下载进入右侧抽屉;
104
+ - Chat、Trajectory、输入区、覆盖层和第三方插件视图保持动态加载;
105
+ - 会话和工作区操作在触控屏上保持可见;
106
+ - 切换会话不会自动唤起软键盘,主动点击输入区仍会正常聚焦;
107
+ - 深色/浅色主题继续由 Harness 主题服务管理;
108
+ - 远程手机上隐藏容易误导的 `Add workspace` 目录选择器;
109
+ - 顶栏、消息操作、输入工具、安全区域和虚拟键盘行为适配窄屏。
110
+
111
+ 以下深色主题截图来自真实的 Harness 浏览器会话,使用 `430 × 932` 模拟视口。独立截图配置只包含虚构的产品演示数据,不包含本地工作区、对话、路径、提示词、模型或用量数据。
112
+
113
+ | 导航 | 当前会话 | 子智能体 | 对话 |
114
+ | :---: | :---: | :---: | :---: |
115
+ | <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="包含两个虚构子智能体的深色底部面板"> | <img src="docs/images/mobile-chat.png" width="210" alt="包含原生消息操作和单行输入工具的深色 Harness 移动对话"> |
116
+
117
+ ### 权限
118
+
119
+ 远程浏览器继承当前 Harness 会话的 **Read only**、**Workspace write** 或 **Full access** 权限。移动视图只显示该值,不会创建或削弱权限边界。隐藏 `Add workspace` 是可用性限制,不是安全边界。
120
+
121
+ 响应式增强支持 **360 到 834 CSS px**。发布矩阵检查 `360 × 800`、`390 × 844`、`430 × 932` 和 `768 × 1024`,并要求在真实手机上完成横屏与竖屏验收。详见[移动视图说明](docs/MOBILE_VIEW.md)。
122
+
123
+ ## 管理可信浏览器
124
+
125
+ 在 Harness 电脑上打开二维码面板中的 `Paired devices`,或进入 `Settings → Local access`。
126
+
127
+ - `Rename` 只修改显示名称;
128
+ - `Revoke` 会使浏览器凭据失效,并立即关闭该设备当前打开的 Local Link WebSocket;
129
+ - 清除 Cookie、使用无痕窗口、新建浏览器 profile 或撤销设备后,都需要重新配对。
130
+
131
+ 浏览器无法可靠区分笔记本与台式机,因此两者统一显示为 `Computer`。
132
+
133
+ <p align="center">
134
+ <img src="docs/images/local-access-devices.jpg" width="960" alt="DeepSeek Harness Local access 已配对设备列表">
135
+ </p>
136
+
137
+ ## 工作原理
138
+
139
+ ```text
140
+ 电脑浏览器 127.0.0.1:3080
141
+ └─ Local access → 一次性邀请
142
+ │
143
+ 同一私有网络中的手机 / 平板 / 电脑
144
+ └─ 192.168.x.x:3088 → 网络与 Host 校验
145
+ → 配对或设备 Cookie 校验
146
+ → HTTP / WebSocket 代理
147
+ → 127.0.0.1:3080(同一个 Harness Host)
148
+ ```
149
+
150
+ 网关不会创建第二个 Harness 会话。首次连接时,它只把桌面浏览器当前选择的会话传递到新浏览器 origin;会话数据和实时事件仍来自同一个 Host。
151
+
152
+ 授权使用随机生成的 256 位浏览器凭据,磁盘中只保存 SHA-256 哈希。设备名称和浏览器描述只是显示信息,不授予权限。
153
+
154
+ ## 配置
155
+
156
+ | 选项 | 默认值 | 用途 |
157
+ | --- | --- | --- |
158
+ | `listenHost` | `0.0.0.0` | 监听本地接口;请求仍只允许来自私有或 loopback 地址。 |
159
+ | `listenPort` | `3088` | 局域网网关端口。 |
160
+ | `upstreamOrigin` | `http://127.0.0.1:3080` | 已有的 Harness Web 服务。 |
161
+ | `accessMode` | `pairing` | 要求一次性邀请和设备 Cookie。 |
162
+ | `pairingTtlSeconds` | `300` | 邀请有效时间。 |
163
+ | `deviceTtlDays` | `90` | 已记住浏览器的有效时间。 |
164
+ | `diagnosticsEnabled` | `true` | 保存受限的本地诊断历史。 |
165
+ | `diagnosticsMaxEntries` | `15` | 最多保留的事件数量。 |
166
+
167
+ `listenHost` 只接受 `0.0.0.0` 或明确的私有/loopback IP。插件不会创建防火墙规则;Windows 请求网络权限时只允许 **Private** profile,并且不要在路由器上转发 `3088` 端口。
168
+
169
+ `trusted-lan` 会关闭逐设备授权,只适用于隔离的开发网络。正式使用应保留默认的 `pairing`,因为已连接的 Harness 浏览器可以读取文件、提交提示、批准操作并触发命令。
170
+
171
+ ## 诊断
172
+
173
+ `Settings → Local access → Diagnostics` 保存的是本地、受限且经过脱敏的失败事件,不是请求日志。报告不会包含配对令牌、Cookie、IP 地址、设备或会话 ID、设备名称、URL、路径、提示词、对话或项目文件,也不会自动上传。
174
+
175
+ 排查时请复现一次问题,刷新诊断面板,查看最新稳定事件代码,并在分享前检查 `Copy report` 生成的 JSON。所有事件代码见[诊断参考](docs/DIAGNOSTICS.md)。
176
+
177
+ ## 本地化
178
+
179
+ 插件跟随 Harness 当前语言,不提供独立语言开关。配对页会根据浏览器语言选择英文或简体中文,默认回退到英文。
180
+
181
+ | 语言 | 字典 | 状态 |
182
+ | --- | --- | --- |
183
+ | English | `src/locales/en.json` | 已包含 |
184
+ | 简体中文 | `src/locales/zh.json` | 已包含 |
185
+
186
+ 测试会检查两个字典的 key 是否一致。
187
+
188
+ ## 开发
189
+
190
+ ```shell
191
+ corepack pnpm install --frozen-lockfile
192
+ npm run typecheck
193
+ npm test
194
+ npm run build
195
+ npm run verify
196
+ ```
197
+
198
+ 项目文档:
199
+
200
+ - [架构与兼容性边界](docs/ARCHITECTURE.md)
201
+ - [已验证的 Harness 兼容性](docs/COMPATIBILITY.md)
202
+ - [移动视图行为与发布矩阵](docs/MOBILE_VIEW.md)
203
+ - [本地诊断与事件代码](docs/DIAGNOSTICS.md)
204
+ - [安全模型](docs/SECURITY.md)
205
+ - [贡献指南](CONTRIBUTING.md)
206
+ - [安全问题报告](SECURITY.md)
207
+
208
+ ## 已知限制
209
+
210
+ - 局域网流量未加密,当前网关使用明文 HTTP;
211
+ - 远程浏览器切换深色/浅色主题时,该选择在已支持的 Harness 版本中只对当前页面有效;
212
+ - 启动时会使用优先级最高的私有 IPv4 接口,暂不提供多接口选择;
213
+ - 移动视图支持从 360 CSS px 开始的视口,但第三方固定宽度视图、虚拟键盘、旋转、分屏和系统文字缩放仍需要真实设备验收;
214
+ - `0.1.5-rc.2` 尚未公开完整的响应式 shell、间距、圆角和全部图标契约,因此每个受支持版本都必须重新验证相关界面适配。
215
+
216
+ ## 开发说明
217
+
218
+ 初始实现与文档由维护者和 OpenAI Codex 协作完成。所有修改仍需经过维护者审查、自动化测试、安全审查和正常贡献流程。运行时不包含 AI 服务、遥测或生成代码依赖。
219
+
220
+ ## 许可证
221
+
222
+ [MIT](LICENSE) © 2026 dsh-local-link contributors.
@@ -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.1` 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.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.
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.1` 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
+ 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.
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.1`, 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 `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.
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.1` contracts and separately checks `0.1.5-rc.2`. Most integration uses declared package contracts, but several adapters are intentionally version-sensitive:
178
+ The plugin develops against the exact DeepSeek Harness `0.1.5-rc.2` contracts and retains installed-runtime evidence for the historical RCs listed in the compatibility matrix. Most integration uses declared package contracts, but several adapters are intentionally version-sensitive:
179
179
 
180
180
  | Adapter | Why it exists | Failure behavior | Removal condition |
181
181
  | --- | --- | --- | --- |
@@ -5,13 +5,14 @@ and Settings contracts. Each supported version is therefore checked directly.
5
5
 
6
6
  ## Compatibility matrix
7
7
 
8
- Last checked on 2026-09-12 with Node.js 22 and Windows using packed
9
- `dsh-local-link@1.1.1` source for every row. Versions are newest first.
8
+ Last checked on 2026-09-18 with Node.js 22 and Windows. The current release row
9
+ uses the `dsh-local-link@1.2.0` candidate; historical rows retain their packed
10
+ `1.1.1` installed-runtime evidence. Versions are newest first.
10
11
 
11
12
  | DeepSeek Harness | Status | Local Link source | Last checked |
12
13
  | --- | --- | --- | --- |
13
- | `0.1.5-rc.2` | **Verified next** | `1.1.1` | 2026-09-12 |
14
- | `0.1.5-rc.1` | **Supported release** | `1.1.1` | 2026-09-12 |
14
+ | `0.1.5-rc.2` | **Supported release** | `1.2.0` | 2026-09-18 |
15
+ | `0.1.5-rc.1` | **Verified** | `1.1.1` | 2026-09-12 |
15
16
  | `0.1.2-rc.1` | **Verified** | `1.1.1` | 2026-09-12 |
16
17
  | `0.1.1-rc.2` | **Verified** | `1.1.1` | 2026-09-12 |
17
18
  | `0.1.1-rc.1` | **Verified** | `1.1.1` | 2026-09-12 |
@@ -26,14 +27,12 @@ unsupported until they pass a new check.
26
27
 
27
28
  - **Supported release** is the current development target and receives the
28
29
  complete repository and installed-runtime gate.
29
- - **Verified next** means the exact package version currently published under
30
- `next` passed the compatibility gate; the moving tag itself is not supported.
31
- - **Verified** means the current packed Local Link artifact passed the historical
32
- RC gate on that exact version.
30
+ - **Verified** means the recorded packed Local Link artifact passed the
31
+ historical RC gate on that exact version.
33
32
  - **Untested** means no compatibility claim is made.
34
33
 
35
34
  Every newer Harness version still requires an independent check; support for
36
- `0.1.5-rc.1` does not imply support for a moving `next` tag or later alpha.
35
+ `0.1.5-rc.2` does not imply support for a moving `next` tag or later alpha.
37
36
 
38
37
  ## Verification policy
39
38
 
@@ -60,7 +59,12 @@ automated tests, production build/package verification, desktop Local Access
60
59
  rendering, and the responsive shell at `390 × 844` without client exceptions.
61
60
  The historical versions retain their earlier real-client responsive evidence;
62
61
  the `1.1.1` patch changes package compatibility contracts and documentation, not
63
- the shipped client or gateway implementation.
62
+ the shipped client or gateway implementation. The `1.2.0` candidate was then
63
+ rebuilt against the exact `0.1.5-rc.2` contracts and booted in an isolated Web
64
+ profile with synthetic parent and subagent sessions. Its real browser client
65
+ passed Navigation, Current session, Subagents, and Conversation checks at
66
+ `430 × 932`, plus the non-shrinking information action and one-row composer at
67
+ `320 × 568`.
64
68
 
65
69
  Historical RC runs used empty profiles, so they did not create provider-backed
66
70
  conversations. Physical-phone portrait and landscape acceptance also remains a
@@ -51,7 +51,7 @@ Landscape phones, split-screen browsers, virtual keyboards, third-party fixed-wi
51
51
 
52
52
  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
53
 
54
- Harness `0.1.5-rc.1` 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.
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
55
 
56
56
  ## Security
57
57
 
Binary file
Binary file
Binary file
Binary file
package/lib/client.js CHANGED
@@ -833,7 +833,7 @@ window.__ModuleLoader__.load({
833
833
  }, t(downloading ? "mobile.sessionInfo.sessionLogDownloading" : "mobile.sessionInfo.sessionLogDownload"))))));
834
834
  }
835
835
  const MOBILE_SESSION_INFO_STYLES = `
836
- .dllm-session-info-trigger{display:grid;width:44px;height:44px;margin:0;padding:0;place-items:center;border:var(--dsh-local-link-border-width) solid var(--dsw-alias-border-l2,rgb(148 163 184 / 30%));border-radius:12px;color:inherit;background:var(--dsw-alias-bg-layer-1,rgb(255 255 255 / 92%));box-shadow:var(--dsw-shadow-lv3,0 8px 24px rgb(15 23 42 / 14%));cursor:pointer}
836
+ .dllm-session-info-trigger{display:grid;width:36px;height:36px;margin:0;padding:0;place-items:center;border:0;border-radius:8px;color:inherit;background:transparent;box-shadow:none;cursor:pointer}
837
837
  .dllm-session-info-trigger:hover{background:var(--dsw-alias-interactive-bg-hover,rgb(127 127 127 / 18%))}
838
838
  .dllm-session-info-glyph{width:20px;height:20px;fill:none;stroke:currentColor;stroke-width:1.8;stroke-linecap:round;stroke-linejoin:round}
839
839
  .dllm-session-info-layer{position:fixed;z-index:120;inset:0;display:flex;justify-content:flex-end;pointer-events:auto}.dllm-session-info-backdrop{position:absolute;inset:0;width:auto;height:auto;min-height:0;padding:0;border:0;border-radius:0;background:var(--dsw-alias-bg-mask-1,rgb(15 23 42 / 46%))!important}
@@ -1007,10 +1007,13 @@ body[data-dsh-local-link-mobile] #root>[data-slot="root"]>div:has(>[data-shell-o
1007
1007
  body[data-dsh-local-link-mobile] [data-slot="sidebar"] button[class*="_brand"]{flex:0 0 auto!important;inline-size:max-content!important;width:max-content!important;min-width:0!important;max-width:calc(100% - 72px)!important;margin-right:auto!important}
1008
1008
  body[data-dsh-local-link-mobile] #root>[data-slot="root"]>div[data-sidebar-collapsed]:has(>[data-shell-overlay])>:first-child{transform:var(--dllm-side-drawer-closed-transform);pointer-events:none}
1009
1009
  body[data-dsh-local-link-mobile] #root>[data-slot="root"]>div:has(>[data-shell-overlay])>:nth-child(2){grid-column:1;grid-row:1;min-width:0}
1010
- body[data-dsh-local-link-mobile] #root>[data-slot="root"]>div:has(>[data-shell-overlay])>:nth-child(3){display:none}
1010
+ body[data-dsh-local-link-mobile] #root>[data-slot="root"]>div:has(>[data-shell-overlay])>[data-rightbar-col]{position:absolute!important;inset:0 0 auto auto!important;display:block!important;width:0!important;height:0!important;overflow:visible!important}
1011
+ body[data-dsh-local-link-mobile] [data-rightbar-col] [data-sidebar-right-panel]{position:fixed!important;inset:0!important;z-index:100!important;width:100%!important;border:0!important}
1012
+ body[data-dsh-local-link-mobile] #root>[data-slot="root"]>div:has(>[data-shell-overlay])>[data-side]{display:none!important}
1011
1013
  body[data-dsh-local-link-mobile] #root>[data-slot="root"]>div:has(>[data-shell-overlay])>[data-shell-overlay]{z-index:90}
1012
1014
  .dllm-stock-controls{position:absolute;inset:0;pointer-events:none}
1013
- .dllm-stock-menu{position:absolute;top:max(10px,env(safe-area-inset-top));left:max(10px,env(safe-area-inset-left));display:grid;width:44px;height:44px;padding:0;place-items:center;border:var(--dsh-local-link-border-width) solid var(--dsw-alias-border-l2,rgb(148 163 184 / 30%));border-radius:12px;color:inherit;background:var(--dsw-alias-bg-layer-1,rgb(255 255 255 / 92%));box-shadow:var(--dsw-shadow-lv3,0 8px 24px rgb(15 23 42 / 14%));pointer-events:auto;transition:opacity 120ms ease,transform 120ms ease}
1015
+ .dllm-stock-menu{position:absolute;top:max(10px,env(safe-area-inset-top));left:max(8px,env(safe-area-inset-left));display:grid;width:36px;height:36px;padding:0;place-items:center;border:0;border-radius:8px;color:inherit;background:transparent;box-shadow:none;pointer-events:auto;transition:opacity 120ms ease,transform 120ms ease,background-color 120ms ease}
1016
+ .dllm-stock-menu:hover{background:var(--dsw-alias-interactive-bg-hover,rgb(127 127 127 / 14%))}
1014
1017
  .dllm-stock-menu svg{width:20px;height:20px;fill:none;stroke:currentColor;stroke-width:1.8;stroke-linecap:round}
1015
1018
  body[data-dsh-local-link-mobile] #root>[data-slot="root"]>div:not([data-sidebar-collapsed]):has(>[data-shell-overlay]) .dllm-stock-menu{opacity:0;transform:scale(.9);pointer-events:none}
1016
1019
  .dllm-stock-scrim{position:absolute;inset:0 0 0 var(--dllm-side-drawer-width);width:auto;height:auto;min-height:0;padding:0;border:0;border-radius:0;background:var(--dsw-alias-bg-mask-1,rgb(15 23 42 / 40%))!important;pointer-events:auto}
@@ -1023,8 +1026,14 @@ body[data-dsh-local-link-mobile] [role="treeitem"][aria-selected="true"]>span:ha
1023
1026
  body[data-dsh-local-link-mobile] [role="treeitem"][aria-selected="true"]>span:has(button[aria-label]) button{width:28px!important;height:28px!important}
1024
1027
  body[data-dsh-local-link-mobile] [role="tree"]>div:has([role="treeitem"][aria-selected="true"]) [role="treeitem"][aria-expanded]>span:last-child{display:inline-flex!important}
1025
1028
  body[data-dsh-local-link-mobile] [role="treeitem"][aria-expanded]:has(>span[class*="_folderActive"])>span:last-child{display:inline-flex!important}
1026
- body[data-dsh-local-link-mobile] header{min-width:0;padding-left:max(58px,env(safe-area-inset-left));padding-right:max(10px,env(safe-area-inset-right))}
1029
+ body[data-dsh-local-link-mobile] header{min-width:0;padding-left:max(48px,env(safe-area-inset-left));padding-right:max(8px,env(safe-area-inset-right))}
1030
+ body[data-dsh-local-link-mobile] header [data-conversation-header-corner]{flex:0 0 auto!important;min-width:max-content;margin-right:0!important}
1031
+ body[data-dsh-local-link-mobile] header .dllm-session-info-trigger{display:inline-flex!important;flex:0 0 28px!important;width:28px!important;min-width:28px!important;height:28px!important;padding:0!important}
1032
+ body[data-dsh-local-link-mobile] header div:has(>button[data-state]):has(>button[aria-haspopup="menu"]){display:none!important}
1027
1033
  body[data-dsh-local-link-mobile] textarea,body[data-dsh-local-link-mobile] input{font-size:max(16px,1em)}
1034
+ body[data-dsh-local-link-mobile] [data-composer-card] [data-input-scroll]{min-height:52px}
1035
+ body[data-dsh-local-link-mobile] [data-composer-placeholder]{white-space:normal!important;text-overflow:clip!important;overflow-wrap:anywhere;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;line-clamp:2;overflow:hidden}
1036
+ @media(max-width:480px){body[data-dsh-local-link-mobile] [data-composer-card]>div:last-child{flex-wrap:nowrap!important;gap:8px!important}body[data-dsh-local-link-mobile] [data-composer-card]>div:last-child>div:first-child{flex:1 1 auto;gap:8px!important}body[data-dsh-local-link-mobile] [data-composer-card]>div:last-child>div:last-child{box-sizing:border-box;width:auto;flex:0 0 auto;justify-content:flex-end;gap:6px!important}body[data-dsh-local-link-mobile] [data-composer-card]>div:last-child>div:last-child button[aria-haspopup="menu"]{width:28px;max-width:28px;padding:0;justify-content:center}body[data-dsh-local-link-mobile] [data-composer-card]>div:last-child>div:last-child button[aria-haspopup="menu"]>span{display:none!important}body[data-dsh-local-link-mobile] [data-composer-card]>div:last-child>div:last-child button[aria-haspopup="menu"]>svg:first-child{display:block!important}}
1028
1037
  body[data-dsh-local-link-mobile] [role=tablist]{display:flex;max-width:100%;overflow-x:auto;overscroll-behavior-inline:contain;scrollbar-width:none}
1029
1038
  body[data-dsh-local-link-mobile] [role=tablist]::-webkit-scrollbar{display:none}body[data-dsh-local-link-mobile] [role=tab]{flex:0 0 auto;min-height:40px;touch-action:manipulation}
1030
1039
  body[data-dsh-local-link-mobile] header nav:has(.dllm-lineage-title){gap:0!important;overflow-x:auto;overscroll-behavior-inline:contain;scrollbar-width:none}