dsh-vision-router 3.1.5 → 3.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.
@@ -0,0 +1,118 @@
1
+ import test from 'node:test'
2
+ import assert from 'node:assert/strict'
3
+ import path from 'node:path'
4
+ import { createRequire } from 'node:module'
5
+ import { pathToFileURL } from 'node:url'
6
+ import { Config } from '../entry.js'
7
+ import { mutateLocalRemoteSettingsPermission } from '../lib/local-remote-settings-permission.js'
8
+
9
+ function minimumHostSettingsRoot() {
10
+ const root = process.env.DSH_MINIMUM_SETTINGS_ROOT
11
+ assert.equal(
12
+ typeof root,
13
+ 'string',
14
+ 'DSH_MINIMUM_SETTINGS_ROOT must point at the isolated minimum-supported Host @deepseek-ai/dsh-settings package',
15
+ )
16
+ assert.notEqual(root.trim(), '', 'DSH_MINIMUM_SETTINGS_ROOT must not be blank')
17
+ return path.resolve(root)
18
+ }
19
+
20
+ test('minimum supported Host SettingsProvider persists allowRemoteSettings in the raw user section', async () => {
21
+ const settingsRoot = minimumHostSettingsRoot()
22
+ const settingsModule = await import(pathToFileURL(path.join(settingsRoot, 'lib/index.js')).href)
23
+ const peerRequire = createRequire(path.join(settingsRoot, 'package.json'))
24
+ const cordisEntry = peerRequire.resolve('@deepseek-ai/cordis')
25
+ const { Context } = await import(pathToFileURL(cordisEntry).href)
26
+
27
+ class MemorySettings extends settingsModule.SettingsProvider {
28
+ constructor(ctx) {
29
+ super(ctx)
30
+ this.doc = {}
31
+ }
32
+ get writable() { return true }
33
+ load() { return Promise.resolve(structuredClone(this.doc)) }
34
+ persist(ns, section) {
35
+ this.doc[ns] = structuredClone(section)
36
+ return Promise.resolve()
37
+ }
38
+ }
39
+
40
+ const ctx = new Context()
41
+ const fiber = ctx.plugin(MemorySettings)
42
+ await fiber
43
+ const provider = ctx.get('settings')
44
+ provider.register('vision-router', Config)
45
+
46
+ const before = provider.describe({ redactSecrets: true }).find((entry) => entry.ns === 'vision-router')
47
+ assert.ok(before)
48
+ assert.equal(before.user, undefined)
49
+ assert.equal(before.value.allowRemoteSettings, false)
50
+
51
+ const result = await mutateLocalRemoteSettingsPermission(provider, {
52
+ operation: 'set',
53
+ value: true,
54
+ expectedRevision: before.revision,
55
+ })
56
+ assert.equal(result.ok, true)
57
+
58
+ const after = provider.describe({ redactSecrets: true }).find((entry) => entry.ns === 'vision-router')
59
+ assert.ok(after)
60
+ assert.equal(after.user.allowRemoteSettings, true)
61
+ assert.equal(after.value.allowRemoteSettings, true)
62
+ assert.equal(provider.doc['vision-router'].allowRemoteSettings, true)
63
+ assert.ok(after.revision > before.revision)
64
+
65
+ await fiber.dispose()
66
+ })
67
+
68
+ test('minimum supported Host SettingsProvider preserves prototype routing fields without product authority', async () => {
69
+ const settingsRoot = minimumHostSettingsRoot()
70
+ const settingsModule = await import(pathToFileURL(path.join(settingsRoot, 'lib/index.js')).href)
71
+ const peerRequire = createRequire(path.join(settingsRoot, 'package.json'))
72
+ const cordisEntry = peerRequire.resolve('@deepseek-ai/cordis')
73
+ const { Context } = await import(pathToFileURL(cordisEntry).href)
74
+
75
+ class MemorySettings extends settingsModule.SettingsProvider {
76
+ constructor(ctx) {
77
+ super(ctx)
78
+ this.doc = {
79
+ 'vision-router': {
80
+ capabilityRoutingShadow: true,
81
+ capabilityRoutingStrategy: 'privacy',
82
+ },
83
+ }
84
+ }
85
+ get writable() { return true }
86
+ load() { return Promise.resolve(structuredClone(this.doc)) }
87
+ persist(ns, section) {
88
+ this.doc[ns] = structuredClone(section)
89
+ return Promise.resolve()
90
+ }
91
+ }
92
+
93
+ const ctx = new Context()
94
+ const fiber = ctx.plugin(MemorySettings)
95
+ await fiber
96
+ const provider = ctx.get('settings')
97
+ provider.register('vision-router', Config)
98
+
99
+ const before = provider.describe({ redactSecrets: true }).find((entry) => entry.ns === 'vision-router')
100
+ assert.ok(before)
101
+ const fields = before.schema.refs[String(before.schema.uid)].dict
102
+ assert.equal(Object.hasOwn(fields, 'capabilityRoutingShadow'), false)
103
+ assert.equal(Object.hasOwn(fields, 'capabilityRoutingStrategy'), false)
104
+ assert.equal(before.user.capabilityRoutingShadow, true)
105
+ assert.equal(before.user.capabilityRoutingStrategy, 'privacy')
106
+ assert.equal(before.value.routingMode, 'ordered')
107
+ assert.equal(before.value.routingPreference, 'balanced')
108
+
109
+ await provider.mutate('vision-router', [
110
+ { op: 'set', path: ['routingMode'], value: 'auto' },
111
+ ], before.revision)
112
+ assert.equal(provider.doc['vision-router'].capabilityRoutingShadow, true)
113
+ assert.equal(provider.doc['vision-router'].capabilityRoutingStrategy, 'privacy')
114
+ assert.equal(provider.get('vision-router').routingMode, 'auto')
115
+ assert.equal(provider.get('vision-router').routingPreference, 'balanced')
116
+
117
+ await fiber.dispose()
118
+ })
@@ -29,6 +29,8 @@ Vision Router 默认让完整视觉工具表从会话开始就保持稳定。正
29
29
 
30
30
  开启后,平时只暴露 `vision_activate`,首次需要时再挂载完整视觉工具;默认关闭时,完整视觉工具从一开始就常驻。视觉工具本身的能力不变。
31
31
 
32
+ **重要时序约束(DSH 0.2.x):** 宿主会在模型步骤开始前冻结本批可执行工具列表。因此纯文字任务中请先单独调用 `vision_activate`,等待该次调用完成,再在**下一模型步骤**调用 `vision_describe` 等深度工具;同一批并行调用会被宿主拒绝为 `UNKNOWN_TOOL`。图片消息正常会在模型步骤前提前挂载工具。首次激活完成后,工具注册会保持到插件 Fiber 卸载,并非仅对当前会话单独挂载。
33
+
32
34
  ## English
33
35
 
34
36
  Vision Router keeps the complete vision tool schema stable from the beginning of a session by default. Normal DSH bundle installs provide this composition layer:
@@ -55,3 +57,5 @@ Progressive exposure remains available as an advanced opt-in. If minimizing the
55
57
  `progressiveTools` determines which tools are registered at plugin startup, so it is a **boot-time setting**; do not rely on changing this field through live Web settings. Restart DSH after changing the profile patch.
56
58
 
57
59
  When enabled, only `vision_activate` is exposed initially and the complete vision tool set mounts on first use. With the default disabled mode, the complete vision tool set is present from the start. The vision capabilities themselves are unchanged.
60
+
61
+ **DSH 0.2.x step-snapshot contract:** The Host freezes the callable tool set at the start of each model step. On text-only turns, call `vision_activate` **alone**, wait for its result, and use `vision_describe` or another deep tool **in the next model step**. Batching the activation and deep-tool calls together produces Host `UNKNOWN_TOOL`. Image turns normally mount the tools before step admission. Once mounted, registration persists until the plugin Fiber is disposed; it is not scoped only to the current conversation.
@@ -0,0 +1,16 @@
1
+ # v3.2.0-rc.0 — Host and Node compatibility retirement
2
+
3
+ **Pre-release publication status:** This document describes the 3.2.0-rc.0 candidate. It becomes a published opt-in prerelease **only after** the protected workflow verifies the exact npm `next` tarball, immutable GitHub prerelease, assets and provenance. A branch name or source tag alone is not a published upgrade. This RC does not replace npm stable `latest`.
4
+
5
+ - Minimum DSH 0.2.1-rc.5 and Node.js 24.9.0; currently recommended DSH 0.2.2-rc.1.
6
+ - DSH 0.1.x and 0.2.0, earlier 0.2.1 RCs and Node 22 are retired from this new DVR minor.
7
+ - DSH exclusively owns Host Connection authentication, API and trustedHosts; DVR private readiness bridge removed. A minimal webServer injection-order patch remains to preserve third-party RPC routes (Windows 405 regression).
8
+ - The modules/webServer ordering shim and DVR recompose guard remain until separately qualified.
9
+ - Retire the conflicting anonymous-user-id and storage-domain optional peer declarations, but **retain one optional DSH LLM peer** as a legacy refusal guard: official DSH 0.2.0-rc.2 ignores `engines.dsh` and otherwise incorrectly admits this new plugin. Supported rc5/rc1 Hosts gate by `engines.dsh`. Strict pnpm installs with either RC now pass without manually adding anonymous-user-id; `sharp` stays optional.
10
+ - Historic session, Settings and attachment data are not deleted; user-owned custom profile patches require separate review.
11
+ - **Host historical data caveat:** DSH 0.2.1-rc.5 may reject released v0 `subagent/descriptor` version-2 records, and 0.2.2-rc.1 still rejects unnormalized legacy `permission/preset.origin` records. These are separate upstream persistence-reader issues, not DVR migration fixes. Never assert full history compatibility without a target-Host read-only migration acceptance test; do not edit live session logs.
12
+ - Release workflow validation now uses Node 24.21 instead of retired Node 22. RC builds use npm `next` plus GitHub prerelease, not `latest`; unreviewed prerelease channels fail before immutable Git tagging. A green PR does not authorize a real publish.
13
+ - Verified on the candidate branch: 66 GitHub CI checks succeeded (two conditionally skipped; SHA c142fcb) for DSH rc5/rc1 and three OSes; an additional manually dispatched Linux/macOS/Windows 100MP stress matrix passed on the same commit. These are engineering results, not a published release.
14
+ - Existing profiles with manual Connection overrides must pass the new **`doctor --upgrade-preflight` (fail-closed on known profile blockers)** and the [read-only upgrade preflight](../architecture/dvr32-host-retirement.md#upgrade-preflight-and-safe-rollback-for-existing-profiles). This Host-retirement change itself does not rewrite user-owned profile patches, session, image or Settings stores.
15
+ - Windows real-Host reload probes return the expected HTTP statuses within a 5-second bound, with isolated 1.5–2.1-second tail latencies; UI bundle switch can render an intermediate state before a subsequent read converges. Neither is evidence of a persistent 404 or permanent inverse switch.
16
+ - **Opt-in release boundary:** Protected prerelease workflow and exact-commit verification are mandatory before any publication claim. Users must not auto-migrate existing Profiles or historical Session data to validate this RC. #792 screenshot root cause is still unconfirmed; upstream #806 stale-Fiber HMR remains open even though the DVR-specific 404 trigger is mitigated.
@@ -0,0 +1,38 @@
1
+ # v3.2.0 — Host and Node compatibility retirement / Host 与 Node 兼容窗口调整
2
+
3
+ This is the curated **stable** v3.2.0 release note. Actual publication is established only by the successful protected Release workflow, the immutable GitHub Release and the matching npm `latest` artifact; a source branch or tag alone is not a publication. / 本文是 3.2.0 正式版发布说明,是否发布成功须以受保护 Release 流水线、GitHub Release 和 npm `latest` 同一构建产物核验为准。
4
+
5
+ ## Compatibility / 兼容性
6
+
7
+ - Minimum DSH `>=0.2.1-rc.5 <0.3.0-0` and Node.js `>=24.9.0`. Validated exact Host sources include DSH 0.2.1-rc.5 and 0.2.2-rc.1. Supported version-range admission is **not** a claim that every future DSH build has been tested.
8
+ - DSH 0.1.x, 0.2.0, earlier 0.2.1 RCs and Node 22 are no longer supported **by DVR 3.2**. Existing DVR 3.1.5 users can remain on their current working version while preparing the Host migration.
9
+ - DSH retains ownership of Connection authorization, API and trustedHosts. DVR removes its private readiness bridge and retains only a minimal `webStartup`/`webServer` injection-order patch required for independent third-party RPC routes; fully removing that ordering patch produced a reproducible Windows HTTP 405.
10
+ - One optional DSH LLM peer remains to prevent installation under old DSH 0.2.0-rc.2, which ignores `engines.dsh`. Strict pnpm dependency checks passed for both pinned supported Host lines.
11
+
12
+ ## Stability and release security / 稳定性与发布安全
13
+
14
+ - Includes visual-provider timeout and cancellation safeguards, proper fallback and model routing, progressive vision deep-tool activation, bounded grounding checks, and Windows/macOS/Linux real Host / Desktop regressions.
15
+ - Release verification tests, reproducible build, exact-source cross-platform Host gates, CodeQL and HOL security passed on the candidate main commit, subject to fresh checks on the final release-only metadata commit.
16
+ - The preceding v3.2.0-rc.0 publication **failed before npm**: the OIDC-only publish job had no `node_modules` while `scripts/release-channel.mjs` imported `semver`. PR #813 made the CLI dependency-free; PR #817 closed macOS/Windows path-alias silent-success risks. The preexisting `v3.2.0-rc.0` tag stays immutable and is not republished.
17
+ - Stable v3.2.0 must use the protected `Release` workflow with `tag=v3.2.0` and an exact, fully checked `main` SHA. The workflow maps stable versions to npm `latest`, verifies the tarball against the pre-tag candidate, signs/checks provenance, then publishes the GitHub Release with matching assets. Never publish manually to bypass these gates.
18
+
19
+ ## Upgrading an existing installation / 已有安装升级
20
+
21
+ 1. Confirm Node >=24.9.0 and the actual DSH Host version meets the new floor. Prefer an exact-tested Host; do not assume untested 0.2.x releases have equivalent behavior.
22
+ 2. Run the **read-only** `doctor --upgrade-preflight` before upgrading. It rejects known legacy Connection overlays, private readiness bridges, floating GitHub-version references and older Node; a pass does **not** guarantee complete historical data compatibility.
23
+ 3. Back up profile, Settings, image/attachment state and historical Session records; separately read-validate the copied records with the **target** DSH Host before changing a working profile. User-owned custom patches require manual review. Do not edit or normalize the live Session event log.
24
+ 4. Keep the prior known-good DVR 3.1.5 / Host environment available for rollback if real startup, Vision, Desktop reload, or data restoration fails. No automatic profile or Session migration/deletion is performed by this release.
25
+
26
+ ## Known boundaries / 已知边界
27
+
28
+ - Older DSH persistence formats, including released v0 `permission/preset.origin` and older `subagent/descriptor` records, can fail in particular Host readers. This is an upstream Host migration issue, not a DVR-owned session rewrite. Do not promise a universally lossless upgrade.
29
+ - The separate upstream DSH stale-Fiber/HMR defect remains open; the DVR-specific reload/404 trigger is mitigated, not the entire Host lifecycle issue. The original reported Windows raw JS/CSS screenshot and certain user-field failures have not been conclusively attributed to DVR.
30
+ - Non-loopback network, reverse proxy, untested custom profiles and future DSH releases are not universally certified by loopback CI. The default cloud Vision fallback sends image content to remote providers unless strictly local-only is configured.
31
+
32
+ ## 发布说明摘要(中文)
33
+
34
+ - **支持范围**:DSH >=0.2.1-rc.5、Node >=24.9;3.2 不再支持旧 DSH、Node 22,原先正常工作的 3.1.5 可暂不升级。
35
+ - **核心调整**:Connection 权限归还 DSH,保留保障其他插件 RPC 的必要顺序补丁,延续视觉链稳定性、深度工具和跨平台回归保护。
36
+ - **升级原则**:先运行只读升级预检、备份旧配置与会话、针对目标 Host 单独验收、保留回滚;不自动改写历史数据。
37
+ - **上游已知问题**:历史 Session 读取、HMR/Fiber 等不宣称已由本插件全部修复。
38
+ - **发布校验**:直接走修复后的受保护稳定版 Release 工作流,检查 npm `latest`、GitHub Release、包哈希及来源证明的一致性。
package/index.js CHANGED
@@ -151,6 +151,7 @@ import {
151
151
  import { currentVisionExecutionOrder } from './lib/vision-execution-order.js'
152
152
  import { applyVisionExecutionOrder } from './lib/vision-execution-order-apply.js'
153
153
  import { currentVisionTurnBudgetSignal } from './lib/turn-budget-context.js'
154
+ import { parseGroundingBoxResponse, assessGroundingBox } from './lib/grounding-box-recovery.js'
154
155
  import { createHash } from 'node:crypto'
155
156
  import {
156
157
  normalizeStructuredBootstrapResult,
@@ -3906,60 +3907,52 @@ ctx.logger?.info(
3906
3907
  const { bytes, mediaType } = await readImageBytes(exec, args.image)
3907
3908
  const { width, height } = await imageDims(bytes)
3908
3909
  if (width <= 0 || height <= 0) throw new Error('vision_ground: could not read image dimensions')
3910
+ const target = String(args.target).slice(0, 500)
3911
+ // Internal-only frame metadata comes from the trusted framing runtime,
3912
+ // not the user's tool schema. The model sees exact content bounds.
3913
+ const content = args.__dvrGroundingContentRect
3914
+ const frameHint = content &&
3915
+ [content.x1, content.y1, content.x2, content.y2].every(Number.isInteger)
3916
+ ? `The supplied image is a letterboxed ${width}x${height} frame with BLACK padding. ` +
3917
+ `Only x=[${content.x1},${content.x2}] and y=[${content.y1},${content.y2}] contain image pixels. ` +
3918
+ 'Never return a box in the source image dimensions or black padding. '
3919
+ : ''
3909
3920
  const instruction =
3910
- `Target to locate: "${String(args.target).slice(0, 500)}". ` +
3911
- `The image is ${width}x${height} pixels. Return ONE JSON object with integer fields ` +
3921
+ `Target to locate: "${target}". ` +
3922
+ `The image is ${width}x${height} pixels. ` + frameHint +
3923
+ `Return ONE JSON object with integer fields ` +
3912
3924
  `{"x1":...,"y1":...,"x2":...,"y2":...} — the tight bounding box of that target in ` +
3913
- `ORIGINAL image pixels (0 <= x1 < x2 <= ${width}, 0 <= y1 < y2 <= ${height}). ` +
3925
+ `the pixels of the image you received (0 <= x1 < x2 <= ${width}, 0 <= y1 < y2 <= ${height}). ` +
3914
3926
  `Output only the JSON object.`
3915
3927
  const vision = await answerVisionForTool(exec, bytes, mediaType, instruction)
3916
3928
  if (vision.ok === false) return JSON.stringify(vision)
3917
- const text = vision.text
3918
- const parsed = extractJson(text)
3919
- const box = parsed !== undefined ? parseBox(parsed) : undefined
3920
- if (box === undefined) {
3921
- throw new Error(`vision_ground: the vision model did not return a valid box. Raw output: ${text.slice(0, 500)}`)
3922
- }
3923
- let clamped = {
3924
- x1: Math.max(0, Math.min(box.x1, width - 1)),
3925
- y1: Math.max(0, Math.min(box.y1, height - 1)),
3926
- x2: Math.max(1, Math.min(box.x2, width)),
3927
- y2: Math.max(1, Math.min(box.y2, height)),
3928
- }
3929
- if (clamped.x2 - clamped.x1 < 2 || clamped.y2 - clamped.y1 < 2) {
3930
- // Some vision models answer with a degenerate sliver (e.g. 1px wide)
3931
- // instead of the target's box. Demand the full box once more before
3932
- // giving up.
3929
+ let assessment = assessGroundingBox(
3930
+ parseGroundingBoxResponse(vision.text), width, height, content,
3931
+ )
3932
+ if (!assessment.ok) {
3933
+ // A single correction only, including near-JSON, degenerate, and
3934
+ // wrong coordinate-space outputs. Both calls share the existing
3935
+ // turn-scoped signal/budget, provider policy, and abort behavior.
3933
3936
  const retry = await answerVisionForTool(
3934
- exec,
3935
- bytes,
3936
- mediaType,
3937
- `Your previous box ${JSON.stringify(clamped)} was a degenerate sliver, not the target. ` +
3938
- `Return ONE JSON object with the FULL tight bounding box of the target in ORIGINAL ` +
3939
- `image pixels (0 <= x1 < x2 <= ${width}, 0 <= y1 < y2 <= ${height}). Output only the JSON object.`,
3937
+ exec, bytes, mediaType,
3938
+ `Your preceding answer was invalid (${assessment.reason}). ` +
3939
+ `Locate the same target: "${target}". ` + frameHint +
3940
+ `Return one strictly valid JSON object with integer x1,y1,x2,y2 ` +
3941
+ `inside the received ${width}x${height} frame, without black padding. ` +
3942
+ 'Do not reuse the previous coordinates unless verified against the image. No prose.',
3940
3943
  )
3941
3944
  if (retry.ok === false) return JSON.stringify(retry)
3942
- const retryParsed = extractJson(retry.text)
3943
- const retryBox = retryParsed !== undefined ? parseBox(retryParsed) : undefined
3944
- if (retryBox === undefined) {
3945
- throw new Error(
3946
- `vision_ground: the vision model returned a degenerate box (${clamped.x1},${clamped.y1},${clamped.x2},${clamped.y2}) ` +
3947
- `and the retry returned no valid box. Raw output: ${retry.text.slice(0, 500)}`,
3948
- )
3949
- }
3950
- clamped = {
3951
- x1: Math.max(0, Math.min(retryBox.x1, width - 1)),
3952
- y1: Math.max(0, Math.min(retryBox.y1, height - 1)),
3953
- x2: Math.max(1, Math.min(retryBox.x2, width)),
3954
- y2: Math.max(1, Math.min(retryBox.y2, height)),
3955
- }
3956
- if (clamped.x2 - clamped.x1 < 2 || clamped.y2 - clamped.y1 < 2) {
3945
+ assessment = assessGroundingBox(
3946
+ parseGroundingBoxResponse(retry.text), width, height, content,
3947
+ )
3948
+ if (!assessment.ok) {
3957
3949
  throw new Error(
3958
- `vision_ground: the vision model returned only degenerate boxes for a ${width}x${height} image. ` +
3959
- `Last raw output: ${retry.text.slice(0, 500)}`,
3950
+ `vision_ground: no valid bounding box after one correction (${assessment.reason}). ` +
3951
+ `Last model output: ${String(retry.text).slice(0, 500)}`,
3960
3952
  )
3961
3953
  }
3962
3954
  }
3955
+ const clamped = assessment.box
3963
3956
  const result = { ...clamped, width, height }
3964
3957
  if (args.annotate !== false) {
3965
3958
  const annotated = await annotateBoxBuffer(bytes, clamped)
@@ -4948,7 +4941,7 @@ ctx.logger?.info(
4948
4941
  let deepActive = false
4949
4942
  const deepDisposers = []
4950
4943
  activateDeepTools = () => {
4951
- if (deepActive) return '视觉深看工具已在挂载状态。'
4944
+ if (deepActive) return '视觉深看工具已在挂载状态。请在下一模型步骤调用深度工具,不要与 vision_activate 同批并行调用。'
4952
4945
  deepActive = true
4953
4946
  try {
4954
4947
  for (const def of deepToolDefs) {
@@ -4997,7 +4990,7 @@ ctx.logger?.info(
4997
4990
  '视觉深看工具已挂载:vision_bootstrap(结构化预识别)、vision_describe(看图问答)、vision_ground(像素定位)、vision_detect(元素清单)、' +
4998
4991
  'vision_materialize(附件落盘)、vision_crop(裁剪放大)、vision_pixel_diff(像素对比验证)、vision_colors(取色)、' +
4999
4992
  'vision_ocr(文字识别)、vision_trace(SVG 矢量化)、vision_extract_foreground(抠图)、' +
5000
- 'vision_html_screenshot(页面截图)。现在可以直接调用已启用的工具。' +
4993
+ 'vision_html_screenshot(页面截图)。本次激活调用结束后,下一模型步骤才可调用深度工具;不要在同一批并行工具调用中同时请求 vision_activate 和 vision_describe 等深度工具。' +
5001
4994
  '注意:vision_ocr 只用于读取图片文字;视觉工具返回 ok:false 后端不可用结果时,不要改问法重复调用,继续文本任务。'
5002
4995
  )
5003
4996
  }
@@ -5024,7 +5017,7 @@ ctx.logger?.info(
5024
5017
  description:
5025
5018
  'Mount the deep vision tools (vision_bootstrap / vision_describe / vision_ground / vision_detect / vision_materialize / vision_crop / ' +
5026
5019
  'vision_pixel_diff / vision_colors / vision_ocr / vision_trace / ' +
5027
- 'vision_extract_foreground / vision_present / vision_html_screenshot) for this session. Desktop screenshot remains disabled until the user explicitly opts in through Vision Router settings. They mount ' +
5020
+ 'vision_extract_foreground / vision_present / vision_html_screenshot) for subsequent model steps. Do not call any deep vision tool in the same parallel tool batch as vision_activate: DSH freezes the callable tool set before executing that batch. Desktop screenshot remains disabled until the user explicitly opts in through Vision Router settings. They mount ' +
5028
5021
  'automatically on image turns; call this only when you need them on a text-only turn.',
5029
5022
  parameters: { type: 'object', properties: {}, additionalProperties: false },
5030
5023
  output: stringOutput,
@@ -5052,8 +5045,8 @@ ctx.logger?.info(
5052
5045
  '# 视觉深看工具(vision-tools)\n\n' +
5053
5046
  '当任务需要像素级视觉操作——照着图写 UI、定位元素、裁剪放大细看、像素对比验证还原结果、' +
5054
5047
  '提取配色、识别图中文字、矢量化图标、抠图、把生成图片安全展示给用户或给页面截图——时使用本套工具。' +
5055
- '图片消息会自动挂载它们;纯文字任务需要时可调用 `vision_activate`(只需一次)。\n' +
5056
- 'Use these tools for pixel-level vision work. They auto-mount on image turns; on text-only turns call `vision_activate` once if needed. When structured bootstrap is enabled, call `vision_bootstrap` first, then MUST call at least 1 evidence/deepening vision tool before answering; after that use more tools as needed.\n\n' +
5048
+ '图片消息会自动挂载它们;纯文字任务需要时先单独调用 `vision_activate`,等待这一批调用结束,下一模型步骤再调用深看工具;不可同批并行调用。\n' +
5049
+ 'Use these tools for pixel-level vision work. They auto-mount on image turns. On text-only turns, call `vision_activate` alone, wait for its result, then use deep tools in a subsequent model step; never batch activation and deep-tool calls together. When structured bootstrap is enabled, call `vision_bootstrap` first, then MUST call at least 1 evidence/deepening vision tool before answering; after that use more tools as needed.\n\n' +
5057
5050
  '1. 定位与细看:`vision_ground` 定位 → `vision_crop` 裁剪放大 → `vision_describe` 细看;盘点页面元素用 `vision_detect`(编号清单+框,可引用“元素 #n”);\n' +
5058
5051
  '2. 还原验证循环(本插件招牌流程):参考图 → 实现 → `vision_html_screenshot` 截图 → `vision_pixel_diff` 度量差异 → 修复 → 再截图,迭代到差异收敛(0% 是常见终点);长页面用 `fullPage: true` 一次截整页并拿到 `pageHeight`;\n' +
5059
5052
  '3. 其余按需取用:配色用 `vision_colors`,文字用 `vision_ocr`,图标矢量化用 `vision_trace`,纯色背景抠图用 `vision_extract_foreground`,本地 HTML 截图用 `vision_html_screenshot`(长页面加 `fullPage: true` 截整页);\n' +
@@ -179,7 +179,20 @@ export async function run(argv = process.argv.slice(2), io = console, env = proc
179
179
  report.hostCapabilitiesSource = probe.source
180
180
  report.hostSupportWindow = DSH_SUPPORT_WINDOW
181
181
  report.hostVerificationEvidence = DSH_VERIFICATION_EVIDENCE
182
- report.hostSupportAdvice = supportWindowUpgradeAdvice(probe.capabilities)
182
+ // An old feature-rich Host must not be admitted based on attachments alone.
183
+ // Multiple profiles with mismatched or absent Host versions stay unknown.
184
+ const rows = report.platform?.hostPackages ?? []
185
+ const detected = rows.map((row) => row.packages?.['@deepseek-ai/dsh'])
186
+ const hostVersion = detected.length > 0 && detected.every((value) =>
187
+ typeof value === 'string' && value === detected[0])
188
+ ? detected[0] : undefined
189
+ report.hostSupportVersionEvidence = {
190
+ source: hostVersion ? 'installed-profile-package' : 'unverified',
191
+ version: hostVersion ?? null,
192
+ }
193
+ report.hostSupportAdvice = supportWindowUpgradeAdvice(probe.capabilities, {
194
+ nodeVersion: process.versions.node, hostVersion,
195
+ })
183
196
  io.log(JSON.stringify(report, null, 2))
184
197
  return code
185
198
  } catch {
package/lib/doctor-cli.js CHANGED
@@ -8,7 +8,7 @@ import { inspectDoctorVisionLimits, formatDoctorVisionLimits } from './doctor-vi
8
8
  import { repairLegacySessionLogs } from './legacy-session-repair.js'
9
9
 
10
10
  function usage() {
11
- return `dsh-vision-router doctor [--profile <name>] [--json | --issue-template] [--sessions] [--runtime-url <url>] [--no-runtime] [--fix]\ndsh-vision-router repair [--profile <name>]\ndsh-vision-router repair-sessions\n\nChecks installation, profile composition, runtime routes, recent settings-save failures and local vision capabilities.\n\nCommands:\n doctor Read-only health report by default. --fix is kept for compatibility but prefer the explicit repair command.\n repair Safely remove a leading UTF-8 BOM and rewrite stale version-pinned minimumReleaseAgeExclude entries.\n repair-sessions Offline repair for exact known Vision Router session corruptions, including the legacy missing-id reminder and duplicate structured guard-stop messages. Stop DSH first.\n\nOptions:\n --profile <name> Check only one profile (for example: web).\n --json Emit a shareable, secret-minimized JSON diagnostic report.\n --issue-template Print a safe, Markdown issue template with diagnostics and fill-in reproduction fields. Read-only.\n --sessions Also scan session logs for exact known Vision Router corruption signatures (read-only; may take longer).\n --runtime-url <url> Probe a running DSH web instance (default: DSH_WEB_URL or http://127.0.0.1:3080).\n --no-runtime Skip the read-only runtime route probe.\n --fix Backward-compatible doctor repair mode; prefer \`repair\`.\n --help Show this help.\n`
11
+ return `dsh-vision-router doctor [--profile <name>] [--json | --issue-template] [--sessions] [--runtime-url <url>] [--no-runtime] [--upgrade-preflight] [--fix]\ndsh-vision-router repair [--profile <name>]\ndsh-vision-router repair-sessions\n\nChecks installation, profile composition, runtime routes, recent settings-save failures and local vision capabilities.\n\nCommands:\n doctor Read-only health report by default. --fix is kept for compatibility but prefer the explicit repair command.\n repair Safely remove a leading UTF-8 BOM and rewrite stale version-pinned minimumReleaseAgeExclude entries.\n repair-sessions Offline repair for exact known Vision Router session corruptions, including the legacy missing-id reminder and duplicate structured guard-stop messages. Stop DSH first.\n\nOptions:\n --profile <name> Check only one profile (for example: web).\n --json Emit a shareable, secret-minimized JSON diagnostic report.\n --issue-template Print a safe, Markdown issue template with diagnostics and fill-in reproduction fields. Read-only.\n --sessions Also scan session logs for exact known Vision Router corruption signatures (read-only; may take longer).\n --runtime-url <url> Probe a running DSH web instance (default: DSH_WEB_URL or http://127.0.0.1:3080).\n --no-runtime Skip the read-only runtime route probe.\n --upgrade-preflight Read-only gate for known 3.2 profile migration hazards; not a full release approval.\n --fix Backward-compatible doctor repair mode; prefer \`repair\`.\n --help Show this help.\n`
12
12
  }
13
13
 
14
14
  function parseArgs(argv) {
@@ -20,6 +20,7 @@ function parseArgs(argv) {
20
20
  let json = false
21
21
  let issueTemplate = false
22
22
  let sessions = false
23
+ let upgradePreflight = false
23
24
  let runtime = command === 'doctor'
24
25
  let runtimeUrl
25
26
 
@@ -41,6 +42,11 @@ function parseArgs(argv) {
41
42
  issueTemplate = true
42
43
  continue
43
44
  }
45
+ if (value === '--upgrade-preflight') {
46
+ if (command !== 'doctor') throw new Error('--upgrade-preflight is only used with doctor')
47
+ upgradePreflight = true
48
+ continue
49
+ }
44
50
  if (value === '--sessions') {
45
51
  if (command !== 'doctor') throw new Error('--sessions is only used with doctor')
46
52
  sessions = true
@@ -83,6 +89,8 @@ function parseArgs(argv) {
83
89
  if (!['doctor', 'repair', 'repair-sessions'].includes(command)) throw new Error(`unknown command: ${command}`)
84
90
  if (issueTemplate && json) throw new Error('--issue-template and --json cannot be combined')
85
91
  if (issueTemplate && fix) throw new Error('--issue-template is read-only and cannot be combined with --fix')
92
+ if (upgradePreflight && fix) throw new Error('--upgrade-preflight is read-only and cannot be combined with --fix')
93
+ if (upgradePreflight && issueTemplate) throw new Error('--upgrade-preflight is not an issue template; use --json instead')
86
94
  if (profile && (!/^[A-Za-z0-9._-]+$/.test(profile) || profile === '.' || profile === '..')) {
87
95
  throw new Error(`invalid profile name: ${profile}`)
88
96
  }
@@ -91,7 +99,7 @@ function parseArgs(argv) {
91
99
  try { parsed = new URL(runtimeUrl) } catch { throw new Error(`invalid runtime URL: ${runtimeUrl}`) }
92
100
  if (!['http:', 'https:'].includes(parsed.protocol)) throw new Error(`invalid runtime URL protocol: ${parsed.protocol}`)
93
101
  }
94
- return { command, profile, fix, json, issueTemplate, sessions, runtime, runtimeUrl }
102
+ return { command, profile, fix, json, issueTemplate, sessions, upgradePreflight, runtime, runtimeUrl }
95
103
  }
96
104
 
97
105
  /**
@@ -130,6 +138,8 @@ function formatIssueTemplate(report) {
130
138
  `- Vision Router profiles: ${applicable.length} applicable; ${failed.length} installation/problem profile(s)`,
131
139
  `- Install modes: ${modes}`,
132
140
  `- Offline Host core advisories: ${applicable.filter((profile) => (profile.hostCore?.advisoryCount ?? 0) > 0).length} profile(s), unverified (no Host resolution test)`,
141
+ `- Profile-owned Connection overrides: ${applicable.filter((profile) => (profile.patch?.connectionOverrideRows ?? 0) > 0).length} profile(s), manual review required`,
142
+ `- Retired private Connection-bridge references: ${applicable.filter((profile) => (profile.patch?.retiredReadyBridgeRows ?? 0) + (profile.patch?.retiredReadyInjectionRows ?? 0) > 0).length} profile(s)`,
133
143
  `- Runtime: ${runtimeState}`,
134
144
  `- Settings save failures: ${number(report.log?.currentSettingsFailureCount)} current / ${number(report.log?.historicalSettingsFailureCount)} historical`,
135
145
  `- Known session issues: ${sessionState}`,
@@ -190,6 +200,52 @@ function printProfileDetails(profile, io) {
190
200
  for (const warning of profile.installation?.warnings ?? []) io.log(` ! ${warning}`)
191
201
  }
192
202
 
203
+ /** Source refs are classified without dereferencing credentials or Git.
204
+ * A lockfile contains a resolved commit today, but lockfile regeneration can
205
+ * still follow the mutable manifest source.
206
+ */
207
+ export function isFloatingDvrGitSource(spec) {
208
+ if (typeof spec !== 'string') return false
209
+ const source = spec.trim()
210
+ if (!/^(?:github:|git\+|git@|https?:\/\/(?:www\.)?github\.com\/)/i.test(source)) return false
211
+ const anchor = source.indexOf('#')
212
+ if (anchor < 0 || anchor === source.length - 1) return true
213
+ const ref = source.slice(anchor + 1)
214
+ if (/^[0-9a-f]{40}$/i.test(ref)) return false
215
+ if (/^v?\d+\.\d+\.\d+(?:-[0-9a-z.-]+)?$/i.test(ref)) return false
216
+ // Branch names, semver ranges, HEAD and unconventional tags need
217
+ // review before the 3.2 Host floor becomes user-facing.
218
+ return true
219
+ }
220
+
221
+ /** Read-only, intentionally narrow upgrade fence. This reports only known
222
+ * profile-owned composition blockers. It does not establish the running
223
+ * Desktop Host version or prove image/transport/session functionality.
224
+ * Counts only: no user paths, hostnames, credentials or patch bodies.
225
+ */
226
+ export function assessUpgradeProfileRisk(profileReport, platform) {
227
+ const applicable = (profileReport?.profiles ?? []).filter((item) => item.installation?.applicable)
228
+ const count = (predicate) => applicable.filter(predicate).length
229
+ const blockers = []
230
+ const add = (code, n) => { if (n > 0) blockers.push({ code, affectedProfiles: n }) }
231
+ add('PROFILE_CONNECTION_OVERRIDE', count((p) => (p.patch?.connectionOverrideRows ?? 0) > 0))
232
+ add('RETIRED_READY_BRIDGE_REFERENCE', count((p) =>
233
+ (p.patch?.retiredReadyBridgeRows ?? 0) + (p.patch?.retiredReadyInjectionRows ?? 0) > 0))
234
+ add('STALE_WORKSPACE_RELEASE_AGE_PIN', count((p) =>
235
+ (p.workspace?.pinned?.length ?? 0) > 0 && p.workspace?.rewritten !== true))
236
+ add('FLOATING_GITHUB_DVR_SOURCE', count((p) => isFloatingDvrGitSource(p.pluginDependency)))
237
+ if (platform?.nodeSupported === false) add('NODE_BELOW_3_2_MINIMUM', 1)
238
+ return Object.freeze({
239
+ scope: 'known-profile-risks-only',
240
+ profileCount: applicable.length,
241
+ pass: Boolean(profileReport?.ok) && blockers.length === 0,
242
+ blockers,
243
+ actualDesktopHostVersionVerified: false,
244
+ runtimeAndHistoricalDataVerified: false,
245
+ fullReleaseApproval: false,
246
+ })
247
+ }
248
+
193
249
  function runSessionRepair(dshHome, io) {
194
250
  let report
195
251
  try {
@@ -274,13 +330,17 @@ export async function run(argv = process.argv.slice(2), io = console, env = proc
274
330
  let sessions
275
331
  if (options.sessions) sessions = repairLegacySessionLogs({ dshHome, fix: false })
276
332
 
333
+ const upgradePreflight = options.upgradePreflight
334
+ ? assessUpgradeProfileRisk(profileReport, platform) : undefined
277
335
  const overallOk = profileReport.ok
278
336
  && (runtime?.ok ?? true)
279
337
  && (!sessions || (sessions.affected === 0 && sessions.errors.length === 0))
338
+ && (!upgradePreflight || upgradePreflight.pass)
280
339
 
281
340
  if (options.json || options.issueTemplate) {
282
341
  const report = supportReport({ profileReport, runtime, platform, sessions })
283
342
  report.visionLimits = visionLimits
343
+ if (upgradePreflight) report.upgradePreflight = upgradePreflight
284
344
  report.ok = overallOk
285
345
  io.log(options.issueTemplate ? formatIssueTemplate(report) : JSON.stringify(report, null, 2))
286
346
  return overallOk ? 0 : 1
@@ -288,6 +348,14 @@ export async function run(argv = process.argv.slice(2), io = console, env = proc
288
348
 
289
349
  io.log(`DSH home: ${profileReport.dshHome}`)
290
350
  for (const profile of profileReport.profiles) printProfileDetails(profile, io)
351
+ if (upgradePreflight) {
352
+ if (upgradePreflight.pass) io.log('✓ Upgrade profile preflight: known overlay/workspace hazards not detected. Not full release approval.')
353
+ else {
354
+ io.error('✗ Upgrade profile preflight: blocked; do not upgrade this profile without resolving the following.')
355
+ for (const item of upgradePreflight.blockers) io.error(` ✗ ${item.code}: ${item.affectedProfiles} affected profile(s)`)
356
+ }
357
+ io.log('! Upgrade preflight does not verify the running Desktop Host, runtime routes, or historical data.')
358
+ }
291
359
  if (profileReport.applicableProfiles === 0) io.error('✗ Vision Router is not installed or mounted in any discovered profile.')
292
360
 
293
361
  if (profileReport.log?.settingsSaveFailures?.length > 0) {
@@ -227,11 +227,13 @@ const HOST_PACKAGES = [
227
227
  '@deepseek-ai/dsh-client-ui-settings-plugins',
228
228
  '@deepseek-ai/dsh-attachment-local',
229
229
  '@deepseek-ai/dsh-llm-deepseek',
230
+ '@deepseek-ai/dsh',
230
231
  ]
231
232
 
232
233
  function supportedNodeVersion(version = process.versions.node) {
233
- const [major, minor] = String(version).split('.').map(Number)
234
- return (major === 22 && minor >= 19) || major >= 24
234
+ const [major, minor, patch] = String(version).replace(/^v/, '').split('.').map(Number)
235
+ return Number.isInteger(major) && Number.isInteger(minor) && Number.isInteger(patch)
236
+ && (major > 24 || (major === 24 && minor >= 9))
235
237
  }
236
238
 
237
239
  export function inspectPlatform({ profileDirs = [], env = process.env } = {}) {
@@ -247,7 +249,7 @@ export function inspectPlatform({ profileDirs = [], env = process.env } = {}) {
247
249
  arch: process.arch,
248
250
  node: process.version,
249
251
  nodeSupported: supportedNodeVersion(),
250
- nodeRequirement: '^22.19.0 || >=24.0.0',
252
+ nodeRequirement: '>=24.9.0',
251
253
  release: os.release(),
252
254
  tesseract: tesseract ?? { available: false },
253
255
  chromium: chromium ?? { available: false },
@@ -348,6 +350,9 @@ export function supportReport({ profileReport, runtime, platform, sessions }) {
348
350
  workspacePinnedCount: item.workspace?.pinned?.length ?? 0,
349
351
  patch: item.patch ? {
350
352
  visionRouterRows: item.patch.visionRouterRows,
353
+ connectionOverrideRows: item.patch.connectionOverrideRows ?? 0,
354
+ retiredReadyBridgeRows: item.patch.retiredReadyBridgeRows ?? 0,
355
+ retiredReadyInjectionRows: item.patch.retiredReadyInjectionRows ?? 0,
351
356
  manualVisionRouter: item.patch.manualVisionRouter,
352
357
  disablesOfficialDeepSeek: item.patch.disablesOfficialDeepSeek,
353
358
  } : undefined,
package/lib/doctor.js CHANGED
@@ -414,6 +414,51 @@ function inspectVisionRouterPatchRows(lines) {
414
414
  return { mountRows, overrideRows }
415
415
  }
416
416
 
417
+ /**
418
+ * Read-only advisory for profile-owned DSH Connection overrides.
419
+ * The supported DSH 0.2.1+ Web Host owns this row; a user patch is applied
420
+ * after bundle patches and can silently resurrect the retired dependency.
421
+ * This deliberately reads only structure, not trust values or secrets.
422
+ */
423
+ function inspectRetiredConnectionPatchRows(lines) {
424
+ let connectionOverrideRows = 0
425
+ let retiredReadyBridgeRows = 0
426
+ let retiredReadyInjectionRows = 0
427
+ for (let index = 0; index < lines.length; index += 1) {
428
+ const line = lines[index]
429
+ const id = /^\s*-\s+id\s*:\s*['"]?([^'"\s]+)['"]?\s*$/.exec(line)?.[1]
430
+ if (id === 'connection') connectionOverrideRows += 1
431
+ if (id === 'vision-router-web-connection-ready') retiredReadyBridgeRows += 1
432
+ const name = /^\s*name\s*:\s*['"]?([^'"\s]+)['"]?\s*$/.exec(line)?.[1]
433
+ if (name === './presets/web-connection-ready/index.mjs'
434
+ || name === 'vision-router-web-connection-ready') {
435
+ // Count named bridge rows even if an alias id is used, but not twice.
436
+ const previous = lines.slice(Math.max(0, index - 5), index)
437
+ if (!previous.some((item) => /^\s*-\s+id:\s*['"]?vision-router-web-connection-ready['"]?\s*$/.test(item))) {
438
+ retiredReadyBridgeRows += 1
439
+ }
440
+ }
441
+ const inject = /^(\s*)inject\s*:\s*(.*)$/.exec(line)
442
+ if (!inject) continue
443
+ const matchService = (value) => /(?:^|[^A-Za-z0-9_])visionRouterWebConnectionReady(?:$|[^A-Za-z0-9_])/.test(value)
444
+ if (matchService(inject[2])) {
445
+ retiredReadyInjectionRows += 1
446
+ } else if (inject[2].trim() === '') {
447
+ const indent = inject[1].length
448
+ for (let cursor = index + 1; cursor < lines.length; cursor += 1) {
449
+ const row = lines[cursor]
450
+ if (!row.trim()) continue
451
+ if (yamlIndent(row) <= indent) break
452
+ if (/^\s*-\s+visionRouterWebConnectionReady\s*$/.test(row)) {
453
+ retiredReadyInjectionRows += 1
454
+ break
455
+ }
456
+ }
457
+ }
458
+ }
459
+ return { connectionOverrideRows, retiredReadyBridgeRows, retiredReadyInjectionRows }
460
+ }
461
+
417
462
  export function inspectProfilePatch(patchPath) {
418
463
  if (!existsSync(patchPath)) {
419
464
  return {
@@ -421,6 +466,9 @@ export function inspectProfilePatch(patchPath) {
421
466
  exists: false,
422
467
  visionRouterRows: 0,
423
468
  visionRouterOverrideRows: 0,
469
+ connectionOverrideRows: 0,
470
+ retiredReadyBridgeRows: 0,
471
+ retiredReadyInjectionRows: 0,
424
472
  manualVisionRouter: false,
425
473
  disablesOfficialDeepSeek: false,
426
474
  }
@@ -429,10 +477,11 @@ export function inspectProfilePatch(patchPath) {
429
477
  try {
430
478
  text = readFileBounded(patchPath).toString('utf8')
431
479
  } catch (error) {
432
- return { path: patchPath, exists: true, visionRouterRows: 0, visionRouterOverrideRows: 0, manualVisionRouter: false, disablesOfficialDeepSeek: false, error: error instanceof Error ? error.message : String(error), oversized: error?.code === 'DOCTOR_INPUT_TOO_LARGE' }
480
+ return { path: patchPath, exists: true, visionRouterRows: 0, visionRouterOverrideRows: 0, connectionOverrideRows: 0, retiredReadyBridgeRows: 0, retiredReadyInjectionRows: 0, manualVisionRouter: false, disablesOfficialDeepSeek: false, error: error instanceof Error ? error.message : String(error), oversized: error?.code === 'DOCTOR_INPUT_TOO_LARGE' }
433
481
  }
434
482
  const lines = text.split(/\r?\n/).map(stripYamlComment)
435
483
  const { mountRows: visionRouterRows, overrideRows: visionRouterOverrideRows } = inspectVisionRouterPatchRows(lines)
484
+ const retiredConnection = inspectRetiredConnectionPatchRows(lines)
436
485
  let disablesOfficialDeepSeek = false
437
486
  for (let index = 0; index < lines.length; index += 1) {
438
487
  const line = lines[index]
@@ -450,6 +499,7 @@ export function inspectProfilePatch(patchPath) {
450
499
  exists: true,
451
500
  visionRouterRows,
452
501
  visionRouterOverrideRows,
502
+ ...retiredConnection,
453
503
  manualVisionRouter: visionRouterRows > 0,
454
504
  disablesOfficialDeepSeek,
455
505
  }
@@ -525,6 +575,12 @@ export function classifyProfileInstallation(profile, { requested = false } = {})
525
575
  if (profile?.patch?.disablesOfficialDeepSeek) {
526
576
  warnings.push('cordis.patch.yml statically disables llm-deepseek; legacy stealth patches can make the official model disappear when Vision Router is disabled')
527
577
  }
578
+ if (profile?.patch?.connectionOverrideRows > 0) {
579
+ warnings.push('Profile-owned Connection override detected: DSH 0.2.1+ owns this Host row. Review/remove the obsolete override manually after backing up your profile; Doctor does not modify authentication or trustedHosts.')
580
+ }
581
+ if (profile?.patch?.retiredReadyBridgeRows > 0 || profile?.patch?.retiredReadyInjectionRows > 0) {
582
+ warnings.push('Profile still references retired visionRouterWebConnectionReady bridge: verify and migrate this custom overlay manually. DVR 3.2 no longer provides that service; Doctor changes no profile data.')
583
+ }
528
584
  for (const item of profile?.hostCore?.advisories ?? []) {
529
585
  if (item.kind === 'profile-local-host-core') {
530
586
  warnings.push('Possible Host core shadowing (unverified): profile-local '