dsh-manage-session 0.1.0-alpha.0 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,205 +1,397 @@
1
- /**
2
- * 体检面板:体检(四门)→ 处方(命令清单)→ 出院(可逆处置 + before/after 对照)。
3
- *
4
- * 三态流转完全由 host 侧报告驱动,客户端只做展示与触发;重型动作都在 host,
5
- * 渲染周期内不发同步重活。
6
- */
7
- import { createElement, useEffect, useState, type ReactElement } from 'react'
8
- import {
9
- callHostAny,
10
- type HealthGate,
11
- type HealthRepairResponse,
12
- type HealthReport,
13
- type HealthScanResponse,
14
- type HealthSessionResponse,
15
- } from './host-api.ts'
16
- import { translate, type LocaleKey } from './locales.ts'
17
-
18
- /** 面板收到的字典面。 */
19
- export type PanelTranslate = (key: LocaleKey, params?: Record<string, unknown>) => string
20
-
21
- const GATE_LABEL: Record<HealthGate['id'], LocaleKey> = {
22
- 'log-integrity': 'health.gate.log-integrity',
23
- 'projection-cache': 'health.gate.projection-cache',
24
- 'lossless-json': 'health.gate.lossless-json',
25
- 'cold-read': 'health.gate.cold-read',
26
- }
27
-
28
- const LEVEL_LABEL = {
29
- ok: 'health.level.ok',
30
- warn: 'health.level.warn',
31
- fail: 'health.level.fail',
32
- } as const
33
-
34
- /** 体检面板。 */
35
- export function HealthPanel({ t, onClose }: { t?: PanelTranslate; onClose: () => void }): ReactElement {
36
- const [scanning, setScanning] = useState(false)
37
- const [findings, setFindings] = useState<HealthReport[] | null>(null)
38
- const [error, setError] = useState<string | null>(null)
39
- const [detail, setDetail] = useState<HealthSessionResponse | null>(null)
40
- const [repairing, setRepairing] = useState(false)
41
- const [discharge, setDischarge] = useState<HealthRepairResponse | null>(null)
42
- const [copied, setCopied] = useState<string | null>(null)
43
-
44
- useEffect(() => {
45
- const onKey = (event: KeyboardEvent): void => { if (event.key === 'Escape') onClose() }
46
- document.addEventListener('keydown', onKey)
47
- return () => { document.removeEventListener('keydown', onKey) }
48
- }, [onClose])
49
-
50
- const runScan = (): void => {
51
- setScanning(true)
52
- setError(null)
53
- setDetail(null)
54
- setDischarge(null)
55
- void callHostAny<HealthScanResponse>('session-health-scan', { limit: 30, onlyProblems: true }, 120_000)
56
- .then((res) => {
57
- if (res.ok === true) setFindings(res.findings ?? [])
58
- else setError(res.error ?? '体检失败')
59
- })
60
- .catch((err: unknown) => setError(String(err instanceof Error ? err.message : err)))
61
- .finally(() => setScanning(false))
62
- }
63
-
64
- const openDetail = (sessionId: string): void => {
65
- setError(null)
66
- setDischarge(null)
67
- void callHostAny<HealthSessionResponse>('session-health-session', { sessionId }, 120_000)
68
- .then((res) => {
69
- if (res.ok === true) setDetail(res)
70
- else setError(res.error ?? '读取体检详情失败')
71
- })
72
- .catch((err: unknown) => setError(String(err instanceof Error ? err.message : err)))
73
- }
74
-
75
- const runRepair = (sessionId: string): void => {
76
- setRepairing(true)
77
- setError(null)
78
- void callHostAny<HealthRepairResponse>('session-health-repair', { sessionId }, 120_000)
79
- .then((res) => {
80
- if (res.ok === true) {
81
- setDischarge(res)
82
- if (res.after !== undefined) setDetail({ ok: true, report: res.after, prescriptions: res.prescriptions })
83
- } else {
84
- setError(res.error ?? '处置失败')
85
- }
86
- })
87
- .catch((err: unknown) => setError(String(err instanceof Error ? err.message : err)))
88
- .finally(() => setRepairing(false))
89
- }
90
-
91
- const copy = (text: string): void => {
92
- try {
93
- void navigator.clipboard?.writeText(text)
94
- setCopied(text)
95
- } catch { /* 剪贴板不可用时仍然展示命令 */ }
96
- }
97
-
98
- const report = detail?.report ?? discharge?.after
99
- const lines: (ReactElement | null)[] = []
100
-
101
- lines.push(createElement('div', { key: 'phase1', className: 'dss_phaseRow' }, [
102
- createElement('span', { key: 'l', className: 'dss_phase' }, translate(t, 'health.phase.checkup')),
103
- createElement('button', {
104
- key: 'scan',
105
- type: 'button',
106
- className: 'dss_actBtn',
107
- disabled: scanning,
108
- onClick: runScan,
109
- }, scanning ? translate(t, 'health.scanning') : translate(t, 'health.scan')),
110
- ]))
111
-
112
- if (error !== null) lines.push(createElement('div', { key: 'err', className: 'dss_error' }, error))
113
- if (detail !== null || discharge !== null) {
114
- lines.push(createElement('div', { key: 'back', className: 'dss_btnRow' }, [
115
- createElement('button', {
116
- key: 'b',
117
- type: 'button',
118
- className: 'dss_actBtn',
119
- onClick: () => { setDetail(null); setDischarge(null) },
120
- }, translate(t, 'health.back')),
121
- ]))
122
- }
123
-
124
- if (report !== undefined) {
125
- lines.push(createElement('div', { key: 'gates', className: 'dss_gateList' }, report.gates.map(gate =>
126
- createElement('div', { key: gate.id, className: `dss_gate dss_gate_${gate.level}` }, [
127
- createElement('span', { key: 'n', className: 'dss_gateName' }, translate(t, GATE_LABEL[gate.id])),
128
- createElement('span', { key: 'lv', className: `dss_levelPill dss_level_${gate.level}` }, translate(t, LEVEL_LABEL[gate.level])),
129
- createElement('span', { key: 'ev', className: 'dss_gateEvidence' }, gate.evidence),
130
- gate.attribution !== undefined && createElement('span', { key: 'at', className: 'dss_meta' },
131
- `${translate(t, 'health.attribution')}: ${gate.attribution.package ?? 'unknown'}${gate.attribution.projection !== undefined ? ` · ${gate.attribution.projection}` : ''}${gate.attribution.field !== undefined ? ` · ${translate(t, 'health.field')} ${gate.attribution.field}` : ''}`),
132
- ]),
133
- )))
134
- } else if (findings !== null) {
135
- if (findings.length === 0) {
136
- lines.push(createElement('div', { key: 'clean', className: 'dss_empty' }, translate(t, 'health.empty')))
137
- } else {
138
- lines.push(createElement('ul', { key: 'list', className: 'dss_list', role: 'list' }, findings.map(item =>
139
- createElement('li', { key: item.sessionId, className: 'dss_row' }, [
140
- createElement('span', { key: 'lv', className: `dss_levelPill dss_level_${item.level}` }, translate(t, LEVEL_LABEL[item.level])),
141
- createElement('span', { key: 'id', className: 'dss_meta dss_uuid' }, item.sessionId),
142
- createElement('button', {
143
- key: 'd',
144
- type: 'button',
145
- className: 'dss_actBtn',
146
- onClick: () => { openDetail(item.sessionId) },
147
- }, translate(t, 'health.detail')),
148
- ]),
149
- )))
150
- }
151
- }
152
-
153
- if (report !== undefined) {
154
- lines.push(createElement('div', { key: 'phase2', className: 'dss_phaseRow' }, [
155
- createElement('span', { key: 'l', className: 'dss_phase' }, translate(t, 'health.phase.prescribe')),
156
- createElement('button', {
157
- key: 'repair',
158
- type: 'button',
159
- className: 'dss_actBtn',
160
- disabled: repairing || report.level === 'ok',
161
- onClick: () => { runRepair(report.sessionId) },
162
- }, repairing ? translate(t, 'health.repairing') : translate(t, 'health.repair')),
163
- ]))
164
- const prescriptions = detail?.prescriptions ?? discharge?.prescriptions ?? []
165
- if (prescriptions.length > 0) {
166
- lines.push(createElement('div', { key: 'cmds', className: 'dss_cmdBlock' }, [
167
- createElement('div', { key: 'h', className: 'dss_meta' }, translate(t, 'health.commands')),
168
- ...prescriptions.map((line, index) => createElement('div', { key: `c${index}`, className: 'dss_cmdLine' }, [
169
- createElement('code', { key: 'code', className: 'dss_cmd' }, line),
170
- createElement('button', {
171
- key: 'cp',
172
- type: 'button',
173
- className: 'dss_actBtn',
174
- onClick: () => { copy(line) },
175
- }, copied === line ? translate(t, 'health.copied') : translate(t, 'health.copy')),
176
- ])),
177
- ]))
178
- }
179
- }
180
-
181
- if (discharge !== null) {
182
- lines.push(createElement('div', { key: 'phase3', className: 'dss_phaseRow' }, [
183
- createElement('span', { key: 'l', className: 'dss_phase' }, translate(t, 'health.phase.discharge')),
184
- createElement('span', { key: 'b', className: `dss_levelPill dss_level_${discharge.before?.level ?? 'warn'}` },
185
- `${translate(t, 'health.before')}: ${translate(t, LEVEL_LABEL[discharge.before?.level ?? 'warn'])}`),
186
- createElement('span', { key: 'a', className: `dss_levelPill dss_level_${discharge.after?.level ?? 'warn'}` },
187
- `${translate(t, 'health.after')}: ${translate(t, LEVEL_LABEL[discharge.after?.level ?? 'warn'])}`),
188
- ]))
189
- if (discharge.repair?.ok === true) {
190
- lines.push(createElement('div', { key: 'repairNote', className: 'dss_status' },
191
- `已隔离投影缓存记录 → ${discharge.repair.to ?? ''}(重启 DSH 后重折叠)`))
192
- } else if (discharge.repair?.error !== undefined) {
193
- lines.push(createElement('div', { key: 'repairErr', className: 'dss_status' }, discharge.repair.error))
194
- }
195
- }
196
-
197
- return createElement('div', { className: 'dss_tabBody' }, lines)
198
- }
199
-
200
- /** 供单测断言:面板依赖的方法名(必须全部以 session- 开头)。 */
201
- export const HEALTH_METHOD_NAMES = [
202
- 'session-health-scan',
203
- 'session-health-session',
204
- 'session-health-repair',
205
- ] as const
1
+ /**
2
+ * 体检面板:体检(四门)→ 处方(命令清单)→ 出院(可逆处置 + before/after 对照)。
3
+ *
4
+ * 三态流转完全由 host 侧报告驱动,客户端只做展示与触发;重型动作都在 host,
5
+ * 渲染周期内不发同步重活。
6
+ */
7
+ import { createElement, useEffect, useState, type ReactElement } from 'react'
8
+ import {
9
+ callHostAny,
10
+ type HealthGate,
11
+ type HealthRepairResponse,
12
+ type HealthReport,
13
+ type HealthScanResponse,
14
+ type HealthSessionResponse,
15
+ } from './host-api.ts'
16
+ import { translate, type LocaleKey } from './locales.ts'
17
+
18
+ /** 面板收到的字典面。 */
19
+ export type PanelTranslate = (key: LocaleKey, params?: Record<string, unknown>) => string
20
+
21
+ const GATE_LABEL: Record<HealthGate['id'], LocaleKey> = {
22
+ 'log-integrity': 'health.gate.log-integrity',
23
+ 'projection-cache': 'health.gate.projection-cache',
24
+ 'lossless-json': 'health.gate.lossless-json',
25
+ 'cold-read': 'health.gate.cold-read',
26
+ }
27
+
28
+ const LEVEL_LABEL = {
29
+ ok: 'health.level.ok',
30
+ warn: 'health.level.warn',
31
+ skipped: 'health.level.skipped',
32
+ fail: 'health.level.fail',
33
+ } as const
34
+
35
+ /**
36
+ * 单批扫描的会话数。
37
+ *
38
+ * 宿主侧 `scanSessions` 是同步循环,一次批太大就长时间占住事件循环、界面全无反馈。
39
+ * 小批次连续调用把控制权交回客户端:每批之间有真实的进度与计时,且宿主无需持有
40
+ * 跨请求状态(见 host/health/scan.ts 的 offset 语义)。
41
+ */
42
+ const SCAN_BATCH = 5
43
+
44
+ /**
45
+ * 把缓存生成时刻折成一个粗粒度的相对时间 key。
46
+ *
47
+ * 不引第三方 i18n/时间库:四档粒度足够表达「这是刚才的 / 是昨天的」,
48
+ * 而这正是用户判断「要不要刷新」所需的全部信息。
49
+ */
50
+ function relativeAgo(generatedAt: number, now: number): { key: LocaleKey; n: number } {
51
+ const seconds = Math.max(0, Math.round((now - generatedAt) / 1000))
52
+ if (seconds < 60) return { key: 'health.ago.justNow', n: 0 }
53
+ const minutes = Math.floor(seconds / 60)
54
+ if (minutes < 60) return { key: 'health.ago.minutes', n: minutes }
55
+ const hours = Math.floor(minutes / 60)
56
+ if (hours < 24) return { key: 'health.ago.hours', n: hours }
57
+ return { key: 'health.ago.days', n: Math.floor(hours / 24) }
58
+ }
59
+
60
+ /** 体检面板。 */
61
+ export function HealthPanel({ t, onClose }: { t?: PanelTranslate; onClose: () => void }): ReactElement {
62
+ const [scanning, setScanning] = useState(false)
63
+ const [findings, setFindings] = useState<HealthReport[] | null>(null)
64
+ const [error, setError] = useState<string | null>(null)
65
+ const [detail, setDetail] = useState<HealthSessionResponse | null>(null)
66
+ const [repairing, setRepairing] = useState(false)
67
+ const [discharge, setDischarge] = useState<HealthRepairResponse | null>(null)
68
+ const [copied, setCopied] = useState<string | null>(null)
69
+ /** 分批扫描进度:done = 已访问会话数,total = 语料总数(0 表示尚未拿到分母)。 */
70
+ const [progress, setProgress] = useState<{ done: number; total: number } | null>(null)
71
+ const [startedAt, setStartedAt] = useState(0)
72
+ const [elapsedMs, setElapsedMs] = useState(0)
73
+ /** 缓存命中时的元信息;非 null 即「当前列表来自缓存」,必须露出生成时间。 */
74
+ const [cacheInfo, setCacheInfo] = useState<{ generatedAt: number; total: number; currentTotal: number } | null>(null)
75
+ /** 相对时间的走字刻度:缓存提示里的「N 分钟前」需要自己更新。 */
76
+ const [, setClockTick] = useState(0)
77
+
78
+ useEffect(() => {
79
+ const onKey = (event: KeyboardEvent): void => { if (event.key === 'Escape') onClose() }
80
+ document.addEventListener('keydown', onKey)
81
+ return () => { document.removeEventListener('keydown', onKey) }
82
+ }, [onClose])
83
+
84
+ // 挂载时零成本探一次缓存:命中就直接出内容。
85
+ // 不命中时**什么都不做**——绝不偷偷跑扫描,挂载即干重活正是上一版被诟病的地方。
86
+ useEffect(() => {
87
+ void callHostAny<HealthScanResponse>('session-health-scan', { resume: true }, 30_000)
88
+ .then((res) => {
89
+ if (res.ok === true && res.cached === true) {
90
+ setFindings(res.findings ?? [])
91
+ setCacheInfo({
92
+ generatedAt: res.generatedAt ?? 0,
93
+ total: res.total ?? 0,
94
+ currentTotal: res.currentTotal ?? res.total ?? 0,
95
+ })
96
+ }
97
+ })
98
+ }, [])
99
+
100
+ // 相对时间的走字:只在确实显示缓存提示时才起定时器。
101
+ useEffect(() => {
102
+ if (cacheInfo === null) return
103
+ const timer = setInterval(() => { setClockTick(tick => tick + 1) }, 30_000)
104
+ return () => { clearInterval(timer) }
105
+ }, [cacheInfo])
106
+
107
+ // 计时器只在扫描期间跑:给「不知道是否还在运行」一个可动的读数。
108
+ useEffect(() => {
109
+ if (!scanning || startedAt === 0) return
110
+ const timer = setInterval(() => { setElapsedMs(Date.now() - startedAt) }, 100)
111
+ return () => { clearInterval(timer) }
112
+ }, [scanning, startedAt])
113
+
114
+ const runScan = (options?: { forceRefresh?: boolean }): void => {
115
+ // 「刷新」跳过首批的缓存探测,强制重扫;首次体检则允许直接吃缓存。
116
+ const forceRefresh = options?.forceRefresh === true
117
+ setScanning(true)
118
+ setError(null)
119
+ setDetail(null)
120
+ setDischarge(null)
121
+ setFindings(null)
122
+ setCacheInfo(null)
123
+ setProgress({ done: 0, total: 0 })
124
+ setStartedAt(Date.now())
125
+ setElapsedMs(0)
126
+ void (async () => {
127
+ const collected: HealthReport[] = []
128
+ let offset = 0
129
+ try {
130
+ for (;;) {
131
+ const res = await callHostAny<HealthScanResponse>(
132
+ 'session-health-scan',
133
+ {
134
+ limit: SCAN_BATCH,
135
+ offset,
136
+ onlyProblems: true,
137
+ ...(offset === 0 && !forceRefresh ? { resume: true } : {}),
138
+ },
139
+ 120_000,
140
+ )
141
+ if (res.ok !== true) {
142
+ setError(res.error ?? '体检失败')
143
+ return
144
+ }
145
+ // 缓存命中:零扫描直接出内容,带生成时间供面板标注「这是多久前的」。
146
+ if (res.cached === true) {
147
+ setFindings(res.findings ?? [])
148
+ setCacheInfo({
149
+ generatedAt: res.generatedAt ?? 0,
150
+ total: res.total ?? 0,
151
+ currentTotal: res.currentTotal ?? res.total ?? 0,
152
+ })
153
+ setProgress(null)
154
+ return
155
+ }
156
+ const total = res.total ?? 0
157
+ const scanned = res.scanned ?? 0
158
+ collected.push(...(res.findings ?? []))
159
+ offset += scanned
160
+ setProgress({ done: offset, total })
161
+ // scanned 为 0 = 本批没有可扫的会话;offset >= total = 语料已走完。
162
+ if (scanned === 0 || offset >= total) break
163
+ }
164
+ setFindings(collected)
165
+ } catch (err: unknown) {
166
+ setError(String(err instanceof Error ? err.message : err))
167
+ } finally {
168
+ setScanning(false)
169
+ }
170
+ })()
171
+ }
172
+
173
+ /**
174
+ * 把单会话的最新报告同步进列表。
175
+ *
176
+ * 宿主侧缓存已就地回写(见 index.ts 的 `cache?.patch`),客户端列表必须同步,
177
+ * 否则退回列表时会看到已被处置的行还挂着旧档位。
178
+ */
179
+ const reconcileRow = (next: HealthReport): void => {
180
+ setFindings((prev) => {
181
+ if (prev === null) return prev
182
+ const index = prev.findIndex(item => item.sessionId === next.sessionId)
183
+ // 与缓存视图同构:只列非 ok,转好的行直接摘掉。
184
+ if (next.level === 'ok') return index < 0 ? prev : prev.filter(item => item.sessionId !== next.sessionId)
185
+ return index < 0 ? [...prev, next] : prev.map(item => (item.sessionId === next.sessionId ? next : item))
186
+ })
187
+ }
188
+
189
+ const openDetail = (sessionId: string): void => {
190
+ setError(null)
191
+ setDischarge(null)
192
+ void callHostAny<HealthSessionResponse>('session-health-session', { sessionId }, 120_000)
193
+ .then((res) => {
194
+ if (res.ok === true) {
195
+ setDetail(res)
196
+ if (res.report !== undefined) reconcileRow(res.report)
197
+ } else setError(res.error ?? '读取体检详情失败')
198
+ })
199
+ .catch((err: unknown) => setError(String(err instanceof Error ? err.message : err)))
200
+ }
201
+
202
+ const runRepair = (sessionId: string): void => {
203
+ setRepairing(true)
204
+ setError(null)
205
+ void callHostAny<HealthRepairResponse>('session-health-repair', { sessionId }, 120_000)
206
+ .then((res) => {
207
+ if (res.ok === true) {
208
+ setDischarge(res)
209
+ if (res.after !== undefined) {
210
+ setDetail({ ok: true, report: res.after, prescriptions: res.prescriptions })
211
+ reconcileRow(res.after)
212
+ }
213
+ } else {
214
+ setError(res.error ?? '处置失败')
215
+ }
216
+ })
217
+ .catch((err: unknown) => setError(String(err instanceof Error ? err.message : err)))
218
+ .finally(() => setRepairing(false))
219
+ }
220
+
221
+ const copy = (text: string): void => {
222
+ try {
223
+ void navigator.clipboard?.writeText(text)
224
+ setCopied(text)
225
+ } catch { /* 剪贴板不可用时仍然展示命令 */ }
226
+ }
227
+
228
+ const report = detail?.report ?? discharge?.after
229
+ const lines: (ReactElement | null)[] = []
230
+
231
+ lines.push(createElement('div', { key: 'phase1', className: 'dss_phaseRow' }, [
232
+ createElement('span', { key: 'l', className: 'dss_phase' }, translate(t, 'health.phase.checkup')),
233
+ createElement('button', {
234
+ key: 'scan',
235
+ type: 'button',
236
+ className: 'dss_actBtn',
237
+ disabled: scanning,
238
+ onClick: runScan,
239
+ }, scanning ? translate(t, 'health.scanning') : translate(t, 'health.scan')),
240
+ ]))
241
+
242
+ // 分批扫描进度:进度条 + `已访问/总数 · 已用 Xs`。
243
+ // total 尚未拿到(首批未返回)时走不确定态动画——仍能证明程序在跑,
244
+ // 这正是「不知道是否正常运行」要解决的问题。
245
+ if (scanning && progress !== null) {
246
+ const total = progress.total
247
+ const pct = total > 0 ? Math.min(100, Math.round((progress.done / total) * 100)) : 0
248
+ lines.push(createElement('div', { key: 'progress', className: 'dss_progressRow' }, [
249
+ createElement('div', { key: 'track', className: 'dss_progressTrack' },
250
+ createElement('div', {
251
+ key: 'fill',
252
+ className: total > 0 ? 'dss_progressFill' : 'dss_progressFill dss_progressIndeterminate',
253
+ ...(total > 0 ? { style: { width: `${pct}%` } } : {}),
254
+ })),
255
+ createElement('span', { key: 'read', className: 'dss_meta' },
256
+ translate(t, 'health.progress', {
257
+ done: progress.done,
258
+ total: total > 0 ? total : '?',
259
+ sec: (elapsedMs / 1000).toFixed(1),
260
+ })),
261
+ ]))
262
+ }
263
+
264
+ // 缓存提示:必须显式写出生成时间——旧结果绝不能冒充刚扫的。
265
+ // 语料总数对不上时顺带提示刷新(枚举语料很便宜,所以这条判断不构成新的失效策略)。
266
+ if (cacheInfo !== null && !scanning && detail === null && discharge === null) {
267
+ const ago = relativeAgo(cacheInfo.generatedAt, Date.now())
268
+ lines.push(createElement('div', { key: 'cache', className: 'dss_cacheRow' }, [
269
+ createElement('span', { key: 'h', className: 'dss_meta' },
270
+ translate(t, 'health.cache.hint', { ago: translate(t, ago.key, { n: ago.n }) })),
271
+ cacheInfo.currentTotal !== cacheInfo.total && createElement('span', { key: 'chg', className: 'dss_why' },
272
+ translate(t, 'health.cache.corpusChanged', { was: cacheInfo.total, now: cacheInfo.currentTotal })),
273
+ createElement('button', {
274
+ key: 'r',
275
+ type: 'button',
276
+ className: 'dss_actBtn',
277
+ onClick: () => { runScan({ forceRefresh: true }) },
278
+ }, translate(t, 'health.cache.refresh')),
279
+ ]))
280
+ }
281
+
282
+ if (error !== null) lines.push(createElement('div', { key: 'err', className: 'dss_error' }, error))
283
+ if (detail !== null || discharge !== null) {
284
+ lines.push(createElement('div', { key: 'back', className: 'dss_btnRow' }, [
285
+ createElement('button', {
286
+ key: 'b',
287
+ type: 'button',
288
+ className: 'dss_actBtn',
289
+ onClick: () => { setDetail(null); setDischarge(null) },
290
+ }, translate(t, 'health.back')),
291
+ ]))
292
+ }
293
+
294
+ if (report !== undefined) {
295
+ lines.push(createElement('div', { key: 'gates', className: 'dss_gateList' }, report.gates.map(gate =>
296
+ createElement('div', { key: gate.id, className: `dss_gate dss_gate_${gate.level}` }, [
297
+ createElement('span', { key: 'n', className: 'dss_gateName' }, translate(t, GATE_LABEL[gate.id])),
298
+ createElement('span', { key: 'lv', className: `dss_levelPill dss_level_${gate.level}` }, translate(t, LEVEL_LABEL[gate.level])),
299
+ createElement('span', { key: 'ev', className: 'dss_gateEvidence' }, gate.evidence),
300
+ gate.attribution !== undefined && createElement('span', { key: 'at', className: 'dss_meta' },
301
+ `${translate(t, 'health.attribution')}: ${gate.attribution.package ?? 'unknown'}${gate.attribution.projection !== undefined ? ` · ${gate.attribution.projection}` : ''}${gate.attribution.field !== undefined ? ` · ${translate(t, 'health.field')} ${gate.attribution.field}` : ''}`),
302
+ ]),
303
+ )))
304
+ } else if (findings !== null) {
305
+ if (findings.length === 0) {
306
+ lines.push(createElement('div', { key: 'clean', className: 'dss_empty' }, translate(t, 'health.empty')))
307
+ } else {
308
+ lines.push(createElement('ul', { key: 'list', className: 'dss_list', role: 'list' }, findings.map((item) => {
309
+ // 行内列出「哪一门·什么档位」。只有总判徽标时,30 行「注意」彼此不可区分,
310
+ // 用户必须逐条点开才发现原因(实测体验问题);门摘要让信号可扫读。
311
+ // `skipped` 一并列出:它是「未检查」而非异常,不应与 warn 混为一谈。
312
+ const reasons = item.gates
313
+ .filter(gate => gate.level !== 'ok')
314
+ .map(gate => `${translate(t, GATE_LABEL[gate.id])}·${translate(t, LEVEL_LABEL[gate.level])}`)
315
+ .join(' · ')
316
+ return createElement('li', { key: item.sessionId, className: 'dss_row' }, [
317
+ createElement('span', { key: 'lv', className: `dss_levelPill dss_level_${item.level}` }, translate(t, LEVEL_LABEL[item.level])),
318
+ createElement('span', { key: 'id', className: 'dss_meta dss_uuid' }, item.sessionId),
319
+ reasons !== '' && createElement('span', { key: 'why', className: 'dss_why' }, reasons),
320
+ createElement('button', {
321
+ key: 'd',
322
+ type: 'button',
323
+ className: 'dss_actBtn',
324
+ onClick: () => { openDetail(item.sessionId) },
325
+ }, translate(t, 'health.detail')),
326
+ ])
327
+ })))
328
+ }
329
+ }
330
+
331
+ if (report !== undefined) {
332
+ lines.push(createElement('div', { key: 'phase2', className: 'dss_phaseRow' }, [
333
+ createElement('span', { key: 'l', className: 'dss_phase' }, translate(t, 'health.phase.prescribe')),
334
+ createElement('button', {
335
+ key: 'repair',
336
+ type: 'button',
337
+ className: 'dss_actBtn',
338
+ disabled: repairing || report.level === 'ok',
339
+ onClick: () => { runRepair(report.sessionId) },
340
+ }, [
341
+ // 处置只涉及单会话(2 次报告 + 1 次文件操作),耗时不足以支撑进度条;
342
+ // 但必须有**可动的**忙碌反馈,否则点击后界面静止,用户不知道是否在跑。
343
+ repairing ? createElement('span', { key: 'sp', className: 'dss_spinner', 'aria-hidden': 'true' }) : null,
344
+ createElement('span', { key: 'tx' }, repairing ? translate(t, 'health.repairing') : translate(t, 'health.repair')),
345
+ ]),
346
+ ]))
347
+ const prescriptions = detail?.prescriptions ?? discharge?.prescriptions ?? []
348
+ if (prescriptions.length > 0) {
349
+ lines.push(createElement('div', { key: 'cmds', className: 'dss_cmdBlock' }, [
350
+ createElement('div', { key: 'h', className: 'dss_meta' }, translate(t, 'health.commands')),
351
+ ...prescriptions.map((line, index) => createElement('div', { key: `c${index}`, className: 'dss_cmdLine' }, [
352
+ createElement('code', { key: 'code', className: 'dss_cmd' }, line),
353
+ createElement('button', {
354
+ key: 'cp',
355
+ type: 'button',
356
+ className: 'dss_actBtn',
357
+ onClick: () => { copy(line) },
358
+ }, copied === line ? translate(t, 'health.copied') : translate(t, 'health.copy')),
359
+ ])),
360
+ ]))
361
+ }
362
+ }
363
+
364
+ if (discharge !== null) {
365
+ lines.push(createElement('div', { key: 'phase3', className: 'dss_phaseRow' }, [
366
+ createElement('span', { key: 'l', className: 'dss_phase' }, translate(t, 'health.phase.discharge')),
367
+ createElement('span', { key: 'b', className: `dss_levelPill dss_level_${discharge.before?.level ?? 'warn'}` },
368
+ `${translate(t, 'health.before')}: ${translate(t, LEVEL_LABEL[discharge.before?.level ?? 'warn'])}`),
369
+ createElement('span', { key: 'a', className: `dss_levelPill dss_level_${discharge.after?.level ?? 'warn'}` },
370
+ `${translate(t, 'health.after')}: ${translate(t, LEVEL_LABEL[discharge.after?.level ?? 'warn'])}`),
371
+ ]))
372
+ // 定性结论优先于机械的 before/after:处置只隔离投影缓存,
373
+ // 异常若来自会话日志(如 open step),两个档位都会是「异常」,
374
+ // 只摆档位会让人以为处置失败。explanation 直接说清是什么情况。
375
+ if (discharge.explanation !== undefined && discharge.explanation !== '') {
376
+ lines.push(createElement('div', {
377
+ key: 'verdict',
378
+ className: `dss_verdict dss_verdict_${discharge.verdict ?? 'failed'}`,
379
+ }, discharge.explanation))
380
+ }
381
+ if (discharge.repair?.ok === true) {
382
+ lines.push(createElement('div', { key: 'repairNote', className: 'dss_status' },
383
+ `${translate(t, 'health.quarantined')} → ${discharge.repair.to ?? ''}`))
384
+ } else if (discharge.repair?.error !== undefined) {
385
+ lines.push(createElement('div', { key: 'repairErr', className: 'dss_status' }, discharge.repair.error))
386
+ }
387
+ }
388
+
389
+ return createElement('div', { className: 'dss_tabBody' }, lines)
390
+ }
391
+
392
+ /** 供单测断言:面板依赖的方法名(必须全部以 session- 开头)。 */
393
+ export const HEALTH_METHOD_NAMES = [
394
+ 'session-health-scan',
395
+ 'session-health-session',
396
+ 'session-health-repair',
397
+ ] as const