@anionex/dsh-vision-toolkit 0.1.8 → 0.1.9

package/src/client/index.tsx

@@ -73,9 +73,11 @@ const en = {
   sourceFile: 'Credential file',
   health: 'Health',
   runHealth: 'Run health check',
-  testConnection: 'Test connection',
+  testConnection: 'Test API connection',
+  testModel: 'Test vision model',
   testing: 'Checking…',
-  connectionHint: 'Connection testing explicitly sends the configured credential to GET /models. It uploads no image and creates no completion.',
+  testingModel: 'Testing model…',
+  connectionHint: 'The API connection test only queries GET /models. The vision model test sends the bundled diagnostic image and verifies one real multimodal request.',
   saveBeforeTesting: 'Save service changes before testing the connection.',
   advanced: 'Advanced settings',
   advancedHint: 'Credential name, provider compatibility, output language, resource limits, runtime source, Python, and additional readable directories.',
@@ -140,6 +142,7 @@ const en = {
   healthArtifactDirectory: 'Artifact directory',
   healthTempDirectory: 'Temporary directory',
   healthService: 'Vision service',
+  healthModel: 'Vision model',
   statusOk: 'OK',
   statusWarning: 'Warning',
   statusError: 'Error',
@@ -154,7 +157,7 @@ const en = {
   healthDirectoryWritable: '{directory} is writable: {path}',
   healthDirectoryNotWritable: '{directory} is not writable: {path}',
   healthArtifactDirectoryFailed: 'Could not prepare the artifact directory.',
-  healthConnectionNotTested: 'Connection not tested. Use Test connection to query /models.',
+  healthConnectionNotTested: 'API connection not tested. Use Test API connection to query /models.',
   healthConnectionCredentialMissing: 'Connection test skipped because the credential is unavailable.',
   healthServiceResponded: 'Service responded at {endpoint} (HTTP {status}).',
   healthServiceRejectedCredential: 'Service rejected the configured credential (HTTP {status}).',
@@ -162,6 +165,13 @@ const en = {
   healthServiceRateLimited: 'Service is reachable, but the connection test was rate-limited (HTTP 429).',
   healthServiceHttpFailed: 'Connection test failed with HTTP {status}.',
   healthServiceUnreachable: 'Could not reach {endpoint}.',
+  healthModelNotTested: 'Vision model not tested. Run Test vision model to make one real multimodal request.',
+  healthModelCredentialMissing: 'Vision model test skipped because the credential is unavailable.',
+  healthModelReady: 'Model {model} completed a real multimodal request.',
+  healthModelFailed: 'Real multimodal request failed: {detail}',
+  modelTestVerifiedTag: 'Verified',
+  modelTestNotRunTag: 'Not tested',
+  modelTestFailedTag: 'Test failed',
 } as const
 
 type LocaleKey = keyof typeof en
@@ -213,10 +223,12 @@ const zh: Record<LocaleKey, string> = {
   sourceFile: '凭据文件',
   health: '运行检查',
   runHealth: '检查本地环境',
-  testConnection: '测试服务连接',
+  testConnection: '测试 API 连接',
+  testModel: '测试视觉模型',
   testing: '检查中…',
-  connectionHint: '“检查本地环境”只检查本机依赖和目录；“测试服务连接”会携带已配置的 API 密钥请求 /models，但不会上传图片或调用模型。',
-  saveBeforeTesting: '修改服务配置后，请先保存，再测试连接。',
+  testingModel: '正在测试模型…',
+  connectionHint: '“测试 API 连接”只请求 GET /models；“测试视觉模型”会发送插件自带的诊断图片，验证一次真实多模态调用。',
+  saveBeforeTesting: '修改服务配置后，请先保存，再执行 API 或视觉模型测试。',
   advanced: '高级设置',
   advancedHint: '凭据名称、服务兼容参数、结果语言、资源限制、运行环境来源、Python 和额外可读目录。一般无需修改。',
   pluginVersion: '插件版本',
@@ -280,6 +292,7 @@ const zh: Record<LocaleKey, string> = {
   healthArtifactDirectory: '输出目录',
   healthTempDirectory: '临时目录',
   healthService: '视觉服务',
+  healthModel: '视觉模型',
   statusOk: '正常',
   statusWarning: '注意',
   statusError: '异常',
@@ -294,7 +307,7 @@ const zh: Record<LocaleKey, string> = {
   healthDirectoryWritable: '{directory}可写：{path}',
   healthDirectoryNotWritable: '{directory}不可写：{path}',
   healthArtifactDirectoryFailed: '无法准备输出目录。',
-  healthConnectionNotTested: '尚未测试服务连接。点击“测试服务连接”可请求 /models。',
+  healthConnectionNotTested: '尚未测试 API 连接。点击“测试 API 连接”可请求 /models。',
   healthConnectionCredentialMissing: 'API 密钥不可用，未执行连接测试。',
   healthServiceResponded: '服务已响应：{endpoint}（HTTP {status}）。',
   healthServiceRejectedCredential: '服务拒绝了当前 API 密钥（HTTP {status}）。',
@@ -302,6 +315,13 @@ const zh: Record<LocaleKey, string> = {
   healthServiceRateLimited: '服务可以访问，但本次连接测试触发了限流（HTTP 429）。',
   healthServiceHttpFailed: '连接测试失败（HTTP {status}）。',
   healthServiceUnreachable: '无法连接到 {endpoint}。',
+  healthModelNotTested: '尚未测试视觉模型。点击“测试视觉模型”可执行一次真实多模态请求。',
+  healthModelCredentialMissing: '视觉模型测试已跳过，因为当前 API 密钥不可用。',
+  healthModelReady: '模型 {model} 已完成一次真实多模态请求。',
+  healthModelFailed: '真实多模态请求失败：{detail}',
+  modelTestVerifiedTag: '已实测',
+  modelTestNotRunTag: '未测试',
+  modelTestFailedTag: '测试失败',
 }
 
 type Translate = (key: LocaleKey, params?: Record<string, unknown>) => string
@@ -356,6 +376,7 @@ interface HealthResult {
   checks: Record<string, HealthCheck>
   healthy: boolean
   connectionTested: boolean
+  modelTested: boolean
 }
 
 interface SettingsValue {
@@ -754,7 +775,7 @@ interface SettingsState {
   status: 'idle' | 'loading' | 'ready' | 'error'
   snapshot?: SettingsSnapshot | undefined
   health?: HealthResult | undefined
-  action?: 'save' | 'health' | 'connection' | undefined
+  action?: 'save' | 'health' | 'connection' | 'model' | undefined
   message?: string | undefined
   error?: string | undefined
 }
@@ -842,13 +863,15 @@ export class VisionSettingsController {
     }
   }
 
-  async runHealth(testConnection: boolean): Promise<void> {
-    this.set({ ...this.state, action: testConnection ? 'connection' : 'health', error: undefined, message: undefined })
+  async runHealth(mode: 'health' | 'connection' | 'model'): Promise<void> {
+    const testConnection = mode !== 'health'
+    const testModel = mode === 'model'
+    this.set({ ...this.state, action: mode, error: undefined, message: undefined })
     try {
       const health = await apiRequest<HealthResult>({
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ action: 'health', testConnection }),
+        body: JSON.stringify({ action: 'health', testConnection, testModel }),
       })
       this.set({ ...this.state, action: undefined, health })
     } catch (error) {
@@ -959,6 +982,7 @@ const HEALTH_NAME_KEYS: Record<string, LocaleKey> = {
   artifactDirectory: 'healthArtifactDirectory',
   tempDirectory: 'healthTempDirectory',
   service: 'healthService',
+  model: 'healthModel',
 }
 
 const HEALTH_STATUS_KEYS: Record<HealthCheck['status'], LocaleKey> = {
@@ -1005,9 +1029,21 @@ function healthDetail(name: string, detail: string, t: Translate): string {
   if (match !== null) return t('healthServiceHttpFailed', { status: match[1] })
   match = /^Service could not be reached at (.+)$/u.exec(detail)
   if (match !== null) return t('healthServiceUnreachable', { endpoint: match[1] })
+  if (detail === 'Vision model was not tested; run an explicit model test to send the bundled diagnostic image') return t('healthModelNotTested')
+  if (detail === 'Vision model test skipped because the configured credential is unavailable') return t('healthModelCredentialMissing')
+  match = /^Vision model (.+) completed a multimodal request$/u.exec(detail)
+  if (match !== null) return t('healthModelReady', { model: match[1] })
+  match = /^Vision model test failed: (.+)$/u.exec(detail)
+  if (match !== null) return t('healthModelFailed', { detail: match[1] })
   return detail
 }
 
+function modelTestTag(health: HealthResult, check: HealthCheck): { status: 'ok' | 'warning' | 'error'; label: LocaleKey } {
+  if (!health.modelTested) return { status: 'warning', label: 'modelTestNotRunTag' }
+  if (check.status === 'ok') return { status: 'ok', label: 'modelTestVerifiedTag' }
+  return { status: 'error', label: 'modelTestFailedTag' }
+}
+
 function credentialSource(source: string, t: Translate): string {
   if (source === 'env') return t('sourceEnv')
   if (source === 'file') return t('sourceFile')
@@ -1079,9 +1115,12 @@ function LoadedSettings({ controller, t }: SettingsInjected) {
 
       <div className="dvt-save-row"><Button variant="primary" disabled={!canSave || busy} onClick={save}>{state.action === 'save' ? t('saving') : t('save')}</Button><Button variant="outline" disabled={busy} onClick={() => { void controller.load() }}>{t('reload')}</Button></div>
 
-      <section className="dvt-panel"><div className="dvt-panel-title"><div><h3>{t('health')}</h3><p>{t('connectionHint')}</p></div><div className="dvt-actions"><Button size="sm" variant="outline" disabled={busy || !snapshot.runtime.ready} onClick={() => { void controller.runHealth(false) }}>{state.action === 'health' ? t('testing') : t('runHealth')}</Button><Button size="sm" variant="primary" disabled={busy || !snapshot.runtime.ready} onClick={() => { void controller.runHealth(true) }}>{state.action === 'connection' ? t('testing') : t('testConnection')}</Button></div></div>
+      <section className="dvt-panel"><div className="dvt-panel-title"><div><h3>{t('health')}</h3><p>{t('connectionHint')}</p></div><div className="dvt-actions"><Button size="sm" variant="outline" disabled={busy || !snapshot.runtime.ready} onClick={() => { void controller.runHealth('health') }}>{state.action === 'health' ? t('testing') : t('runHealth')}</Button><Button size="sm" variant="outline" disabled={busy || !snapshot.runtime.ready} onClick={() => { void controller.runHealth('connection') }}>{state.action === 'connection' ? t('testing') : t('testConnection')}</Button><Button size="sm" variant="primary" disabled={busy || !snapshot.runtime.ready} onClick={() => { void controller.runHealth('model') }}>{state.action === 'model' ? t('testingModel') : t('testModel')}</Button></div></div>
         <p className="dvt-muted">{t('saveBeforeTesting')}</p>
-        {state.health === undefined ? <p className="dvt-muted">{t('notTested')}</p> : <div className="dvt-health-grid">{Object.entries(state.health.checks).map(([name, check]) => <div key={name} data-status={check.status}><span>{t(HEALTH_NAME_KEYS[name] ?? 'health')}</span><strong>{t(HEALTH_STATUS_KEYS[check.status])}</strong><p>{healthDetail(name, check.detail, t)}</p></div>)}</div>}
+        {state.health === undefined ? <p className="dvt-muted">{t('notTested')}</p> : <div className="dvt-health-grid">{Object.entries(state.health.checks).map(([name, check]) => {
+          const testTag = name === 'model' ? modelTestTag(state.health as HealthResult, check) : undefined
+          return <div key={name} data-status={check.status}><span>{t(HEALTH_NAME_KEYS[name] ?? 'health')}</span>{testTag === undefined ? null : <em className="dvt-health-test-tag" data-status={testTag.status}>{t(testTag.label)}</em>}<strong>{t(HEALTH_STATUS_KEYS[check.status])}</strong><p>{healthDetail(name, check.detail, t)}</p></div>
+        })}</div>}
       </section>
 
       <details className="dvt-advanced">
@@ -1128,7 +1167,7 @@ const CSS = `
 .dvt-artifact{border:1px solid var(--dsw-alias-border-l1);border-radius:10px;overflow:hidden;background:var(--dsw-alias-bg-layer-1)}.dvt-preview{display:block;width:100%;max-height:360px;object-fit:contain;background:repeating-conic-gradient(var(--dsw-alias-bg-module-platform) 0 25%,var(--dsw-alias-bg-layer-1) 0 50%) 50%/18px 18px;border:0}.dvt-svg{height:280px}.dvt-artifact-meta{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:9px 10px}.dvt-artifact-meta>div:first-child{min-width:0;display:grid;gap:2px}.dvt-artifact-meta strong{font-size:12px;overflow:hidden;text-overflow:ellipsis}.dvt-artifact-meta span,.dvt-artifact-meta small{font-size:10px;color:var(--dsw-alias-label-secondary)}.dvt-actions{display:flex;align-items:center;gap:7px;flex-wrap:wrap}.dvt-download{display:inline-flex;align-items:center;height:28px;padding:0 12px;border-radius:999px;background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);text-decoration:none;font-size:12px;font-weight:600}.dvt-download:hover{background:var(--dsw-alias-button-primary-hover)}.dvt-download:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}.dvt-artifact>.dvt-muted{padding:0 10px 10px}.dvt-diff-score>div{height:5px;border-radius:99px;background:var(--dsw-alias-border-l2);overflow:hidden}.dvt-diff-score i{display:block;height:100%;min-width:2px;background:linear-gradient(90deg,var(--dsw-alias-state-warn-primary),var(--dsw-alias-state-error-primary));border-radius:99px}.dvt-tool h4{font-size:11px;margin:0 0 6px}.dvt-palette{display:grid;grid-template-columns:repeat(auto-fit,minmax(112px,1fr));gap:7px}.dvt-palette>div{display:flex;align-items:center;gap:8px;padding:7px;border:1px solid var(--dsw-alias-border-l1);border-radius:9px}.dvt-palette i{width:28px;height:28px;border-radius:7px;box-shadow:inset 0 0 0 1px var(--dsw-alias-border-l2)}.dvt-palette span{display:grid}.dvt-palette strong{font-size:11px}.dvt-palette small{font-size:10px;color:var(--dsw-alias-label-secondary)}
 .dvt-settings{display:grid;gap:14px;max-width:900px;padding:8px 2px 32px;color:var(--dsw-alias-label-primary)}.dvt-settings-footer{display:flex;justify-content:space-between;gap:20px;align-items:flex-start;padding:8px 2px}.dvt-settings-footer h2{font-size:25px;letter-spacing:-.025em;margin:3px 0 6px}.dvt-settings-footer p{max-width:620px;margin:0;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:1.55}.dvt-kicker{font-size:10px;text-transform:uppercase;letter-spacing:.1em;color:var(--dsw-alias-state-business-primary);font-weight:700}.dvt-release{display:grid;gap:4px;min-width:170px;padding:9px 11px;border-radius:10px;background:var(--dsw-alias-bg-layer-2);font-size:10px;color:var(--dsw-alias-label-secondary)}.dvt-release span{display:flex;justify-content:space-between;gap:12px}.dvt-release strong{color:var(--dsw-alias-label-primary)}.dvt-alert{padding:10px 12px;border-radius:10px;font-size:12px;line-height:1.5;display:grid;gap:3px}.dvt-alert.notice{background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 10%,transparent);color:var(--dsw-alias-state-business-primary)}.dvt-alert.warning{background:color-mix(in srgb,var(--dsw-alias-state-warn-primary) 12%,transparent);color:var(--dsw-alias-state-warn-label)}.dvt-alert.error{background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent);color:var(--dsw-alias-state-error-primary)}.dvt-alert.success{background:color-mix(in srgb,var(--dsw-alias-state-success-primary) 10%,transparent);color:var(--dsw-alias-state-success-primary)}.dvt-panel{display:grid;gap:12px;padding:15px;border:1px solid var(--dsw-alias-border-l1);border-radius:14px;background:var(--dsw-alias-bg-layer-1);box-shadow:var(--dsw-shadow-lv1)}.dvt-panel-title{display:flex;align-items:flex-start;justify-content:space-between;gap:12px}.dvt-panel-title h3{font-size:14px;margin:0}.dvt-panel-title p{font-size:11px;line-height:1.45;color:var(--dsw-alias-label-secondary);margin:4px 0 0;max-width:620px}.dvt-badge{font-size:10px;padding:3px 7px;border-radius:999px;font-weight:650}.dvt-badge.ok{background:color-mix(in srgb,var(--dsw-alias-state-success-primary) 12%,transparent);color:var(--dsw-alias-state-success-primary)}.dvt-badge.error{background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,transparent);color:var(--dsw-alias-state-error-primary)}.dvt-form-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px}.dvt-field{display:grid;gap:6px;align-content:start}.dvt-field>span{font-size:11px;font-weight:600}.dvt-field>small{font-size:10px;color:var(--dsw-alias-label-secondary);line-height:1.4}.dvt-field select,.dvt-field textarea{width:100%;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l1);border-radius:9px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;font-size:12px;padding:8px 10px}.dvt-field select{height:36px}.dvt-field textarea{resize:vertical;min-height:76px}.dvt-runtime-facts{display:grid;gap:4px;padding:9px 10px;border-radius:9px;background:var(--dsw-alias-bg-layer-2);overflow:auto}.dvt-runtime-facts code{font-size:10px;white-space:nowrap;color:var(--dsw-alias-label-secondary)}.dvt-save-row{display:flex;gap:8px;padding:2px 0}
 .dvt-settings-footer{margin-top:8px;padding:20px 2px 4px;border-top:1px solid var(--dsw-alias-border-l1);opacity:.82}.dvt-settings-footer h2{font-size:18px;letter-spacing:-.015em;margin:3px 0 5px}.dvt-settings-footer p{font-size:11px;line-height:1.5}.dvt-release{min-width:220px}.dvt-release span{white-space:nowrap}.dvt-essential{border-color:color-mix(in srgb,var(--dsw-alias-state-business-primary) 30%,var(--dsw-alias-border-l1));box-shadow:var(--dsw-shadow-lv1),0 0 0 3px color-mix(in srgb,var(--dsw-alias-state-business-primary) 5%,transparent)}.dvt-advanced{border:1px solid var(--dsw-alias-border-l1);border-radius:14px;background:var(--dsw-alias-bg-layer-1);overflow:hidden}.dvt-advanced>summary{display:flex;align-items:center;justify-content:space-between;gap:14px;padding:14px 15px;cursor:pointer;list-style:none}.dvt-advanced>summary::-webkit-details-marker{display:none}.dvt-advanced>summary>span:first-child{display:grid;gap:3px}.dvt-advanced>summary strong{font-size:13px}.dvt-advanced>summary small{font-size:10px;line-height:1.45;color:var(--dsw-alias-label-secondary);font-weight:400}.dvt-details-chevron{font-size:15px;opacity:.55;transition:transform .16s ease}.dvt-advanced[open] .dvt-details-chevron{transform:rotate(180deg)}.dvt-advanced-body{display:grid;gap:12px;padding:0 12px 12px}.dvt-advanced-body>.dvt-panel{box-shadow:none}
-.dvt-health-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:8px}.dvt-health-grid>div{padding:9px 10px;border-radius:9px;background:var(--dsw-alias-bg-layer-2);border-left:3px solid var(--dsw-alias-border-l4)}.dvt-health-grid>div[data-status=ok]{border-left-color:var(--dsw-alias-state-success-primary)}.dvt-health-grid>div[data-status=warning],.dvt-health-grid>div[data-status=not_tested]{border-left-color:var(--dsw-alias-state-warn-primary)}.dvt-health-grid>div[data-status=error]{border-left-color:var(--dsw-alias-state-error-primary)}.dvt-health-grid span{font-size:10px;text-transform:capitalize}.dvt-health-grid strong{float:right;font-size:9px;text-transform:uppercase;color:var(--dsw-alias-label-secondary)}.dvt-health-grid p{clear:both;margin:5px 0 0;font-size:10px;line-height:1.4;color:var(--dsw-alias-label-secondary)}.dvt-loading{padding:24px;border-radius:12px;background:var(--dsw-alias-bg-layer-2);font-size:12px;color:var(--dsw-alias-label-secondary)}
+.dvt-health-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:8px}.dvt-health-grid>div{padding:9px 10px;border-radius:9px;background:var(--dsw-alias-bg-layer-2);border-left:3px solid var(--dsw-alias-border-l4)}.dvt-health-grid>div[data-status=ok]{border-left-color:var(--dsw-alias-state-success-primary)}.dvt-health-grid>div[data-status=warning],.dvt-health-grid>div[data-status=not_tested]{border-left-color:var(--dsw-alias-state-warn-primary)}.dvt-health-grid>div[data-status=error]{border-left-color:var(--dsw-alias-state-error-primary)}.dvt-health-grid span{font-size:10px;text-transform:capitalize}.dvt-health-grid strong{float:right;font-size:9px;text-transform:uppercase;color:var(--dsw-alias-label-secondary)}.dvt-health-test-tag{display:inline-flex;margin-left:6px;padding:1px 6px;border-radius:999px;background:var(--dsw-alias-bg-layer-1);font-size:9px;font-style:normal;font-weight:600;color:var(--dsw-alias-label-secondary)}.dvt-health-test-tag[data-status=ok]{background:color-mix(in srgb,var(--dsw-alias-state-success-primary) 12%,transparent);color:var(--dsw-alias-state-success-primary)}.dvt-health-test-tag[data-status=warning]{background:color-mix(in srgb,var(--dsw-alias-state-warn-primary) 12%,transparent);color:var(--dsw-alias-state-warn-label)}.dvt-health-test-tag[data-status=error]{background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 12%,transparent);color:var(--dsw-alias-state-error-primary)}.dvt-health-grid p{clear:both;margin:5px 0 0;font-size:10px;line-height:1.4;color:var(--dsw-alias-label-secondary)}.dvt-loading{padding:24px;border-radius:12px;background:var(--dsw-alias-bg-layer-2);font-size:12px;color:var(--dsw-alias-label-secondary)}
 .dvt-paste-dock{box-sizing:border-box;width:calc(100% - 32px);max-width:var(--dsh-composer-card-max-width,960px);margin:0 auto;display:flex;flex-wrap:wrap;gap:6px;padding:0 2px 6px}.dvt-paste-chip{max-width:100%;height:32px;box-sizing:border-box;display:flex;align-items:center;gap:7px;padding:0 6px 0 10px;border:1px solid var(--dsw-alias-border-l1);border-radius:9px;background:var(--dsw-specific-tip);font-size:12px}.dvt-paste-chip[data-status=copying]{border-color:var(--dsw-alias-state-business-primary)}.dvt-paste-chip[data-status=error]{border-color:var(--dsw-alias-state-error-primary)}.dvt-paste-name{max-width:260px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.dvt-paste-detail{color:var(--dsw-alias-label-caption);max-width:260px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.dvt-paste-chip[data-status=error] .dvt-paste-detail{color:var(--dsw-alias-state-error-primary)}.dvt-paste-chip button{width:20px;height:20px;display:grid;place-items:center;border:0;border-radius:50%;padding:0;background:transparent;color:var(--dsw-alias-label-caption);font:inherit;font-size:16px;cursor:pointer}.dvt-paste-chip button:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}.dvt-paste-chip button:disabled{opacity:.4;cursor:default}
 @media(max-width:720px){.dvt-settings-footer{display:grid}.dvt-release{width:auto}.dvt-form-grid{grid-template-columns:1fr}.dvt-metrics{grid-template-columns:1fr}.dvt-artifact-meta{align-items:flex-start;flex-direction:column}.dvt-panel-title{flex-direction:column}}
 `

package/src/runtime.ts

@@ -9,6 +9,7 @@
 import { createHash, randomUUID } from 'node:crypto'
 import { readFile, rm, stat, writeFile } from 'node:fs/promises'
 import { basename, extname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
 import type { Context } from '@deepseek-ai/cordis'
 import type { ResolvedCredential } from '@deepseek-ai/dsh-credentials'
 import { SaxesParser } from 'saxes'
@@ -49,6 +50,8 @@ import {
 import { PLUGIN_VERSION } from './version.ts'
 
 const SVG_NAMESPACE = 'http://www.w3.org/2000/svg'
+const VISION_MODEL_TEST_IMAGE = fileURLToPath(new URL('../assets/vision-model-test.png', import.meta.url))
+const VISION_MODEL_TEST_PROMPT = 'This is an explicit service readiness test. Reply with one short sentence confirming that you received the image.'
 
 function svgDocumentPathCount(svg: string): number | undefined {
   const parser = new SaxesParser({ xmlns: true })
@@ -444,9 +447,11 @@ export interface VisionToolkitHealthResult {
     artifactDirectory: HealthCheck
     tempDirectory: HealthCheck
     service: HealthCheck
+    model: HealthCheck
   }
   healthy: boolean
   connectionTested: boolean
+  modelTested: boolean
 }
 
 /** Shared per-call execution options. */
@@ -764,6 +769,10 @@ export class VisionToolkitRuntime {
         `credential ${this.config.provider.credential} is not configured; set it through DSH credentials`,
       )
     }
+    return this.visionEnv(resolved)
+  }
+
+  private visionEnv(resolved: ResolvedCredential): UpstreamEnvironment {
     return {
       VISION_API_KEY: resolved.value,
       VISION_BASE_URL: this.config.provider.baseUrl,
@@ -1690,8 +1699,8 @@ export class VisionToolkitRuntime {
     }
   }
 
-  /** health: inspect local readiness and optionally probe the configured `/models` endpoint. */
-  async health(testConnection: boolean, options: ToolCallOptions): Promise<VisionToolkitHealthResult> {
+  /** Health: inspect local readiness, optionally probe `/models`, and explicitly test one real multimodal request. */
+  async health(testConnection: boolean, options: ToolCallOptions, testModel = false): Promise<VisionToolkitHealthResult> {
     return this.runOperation('vision_toolkit_health', options, async (operation) => {
       const info = this.upstreamVersion
       const python: HealthCheck = { status: 'ok', detail: `${info.pythonVersion} via ${info.python}` }
@@ -1733,6 +1742,10 @@ export class VisionToolkitRuntime {
         status: 'not_tested',
         detail: 'Connection was not tested; pass testConnection=true to query the configured /models endpoint',
       }
+      let model: HealthCheck = {
+        status: 'not_tested',
+        detail: 'Vision model was not tested; run an explicit model test to send the bundled diagnostic image',
+      }
       if (testConnection) {
         if (resolvedCredential === undefined) {
           service = { status: 'error', detail: 'Connection test skipped because the configured credential is unavailable' }
@@ -1775,7 +1788,32 @@ export class VisionToolkitRuntime {
           }
         }
       }
-      const checks = { python, dependencies, chrome, credential, artifactDirectory, tempDirectory, service }
+      if (testModel) {
+        if (resolvedCredential === undefined) {
+          model = { status: 'error', detail: 'Vision model test skipped because the configured credential is unavailable' }
+        } else {
+          try {
+            const result = await this.runUpstream(
+              'glance',
+              [VISION_MODEL_TEST_IMAGE, '-q', VISION_MODEL_TEST_PROMPT],
+              operation,
+              this.visionEnv(resolvedCredential),
+            )
+            if (result.stdout.trim().length === 0) {
+              throw new VisionToolkitError('output', 'glance: vision API returned an empty description')
+            }
+            model = {
+              status: 'ok',
+              detail: `Vision model ${this.config.provider.model} completed a multimodal request`,
+            }
+          } catch (error) {
+            if (operation.signal.aborted) throw error
+            const detail = error instanceof Error ? error.message : String(error)
+            model = { status: 'error', detail: `Vision model test failed: ${detail.slice(0, 600)}` }
+          }
+        }
+      }
+      const checks = { python, dependencies, chrome, credential, artifactDirectory, tempDirectory, service, model }
       const healthy = Object.values(checks).every(check => check.status !== 'error')
       return {
         pluginVersion: PLUGIN_VERSION,
@@ -1783,6 +1821,7 @@ export class VisionToolkitRuntime {
         checks,
         healthy,
         connectionTested: testConnection,
+        modelTested: testModel,
       }
     })
   }

package/src/web.ts

@@ -74,6 +74,7 @@ interface SaveRequest {
 interface HealthRequest {
   action: 'health'
   testConnection: boolean
+  testModel: boolean
 }
 
 interface CredentialRequest {
@@ -156,7 +157,10 @@ function parseRequest(value: unknown): SettingsRequest {
   if (!isRecord(value) || typeof value.action !== 'string') throw new TypeError('request action is required')
   if (value.action === 'health') {
     if (typeof value.testConnection !== 'boolean') throw new TypeError('health.testConnection must be boolean')
-    return { action: 'health', testConnection: value.testConnection }
+    const testModel = value.testModel === undefined ? false : value.testModel
+    if (typeof testModel !== 'boolean') throw new TypeError('health.testModel must be boolean')
+    if (testModel && !value.testConnection) throw new TypeError('health.testModel requires health.testConnection')
+    return { action: 'health', testConnection: value.testConnection, testModel }
   }
   if (value.action === 'save') {
     if (!Number.isSafeInteger(value.expectedRevision) || (value.expectedRevision as number) < 0) {
@@ -294,7 +298,7 @@ export class VisionToolkitWebBackend {
         signal: controller.signal,
         workspace: process.cwd(),
         sessionId: 'vision-toolkit-settings',
-      })
+      }, request.testModel)
     } finally {
       req.off('aborted', abort)
       req.socket.off('close', abort)