dsh-gitnexus-plus 0.1.1 → 0.1.3

package/lib/client.js

@@ -58,6 +58,26 @@ const h = React.createElement;
 const PLUGIN_ID = 'dsh-gitnexus-plus';
 /** The sidebar-right tab type this plugin contributes. */
 const TAB_KIND = 'gitnexus';
+/** Captured from `ctx.inject(['sidebarRight'])`; null when the profile has no column. */
+let openResource = null;
+let openResourceIn = null;
+/**
+ * Build the platform's file resource address.
+ *
+ * The address is `dsh-resource://file/session/<session>/<path>`, exactly what the
+ * built-in file strip and the chat's file links use. Relative paths resolve through
+ * that session's workspace, which is the project this panel is reporting on. The
+ * encoding keeps `:` literal so a Windows drive letter survives, and encodes each
+ * segment separately so `/` stays a path separator.
+ */
+function fileResourceAddress(sessionId, filePath) {
+    const encodeSegment = (segment) => encodeURIComponent(segment).replace(/%3A/gi, ':');
+    const normalized = filePath.replace(/\\/g, '/').replace(/^(?:\.\/)+/, '');
+    return `dsh-resource://file/session/${encodeSegment(sessionId)}/${normalized
+        .split('/')
+        .map(encodeSegment)
+        .join('/')}`;
+}
 /**
  * How a run's state reads at a glance.
  *
@@ -113,6 +133,7 @@ const ZERO_TOTALS = {
     large: 0,
     largeBytes: 0,
     suppressedDeclarations: 0,
+    scannedBytes: 0,
 };
 const ZERO_CAP = { text: '—', source: 'default', maxText: '—' };
 const ZERO_ANALYZER = {
@@ -157,6 +178,23 @@ function fileSize(bytes) {
         return primitives.fileSizeText(bytes);
     return formatBytes(bytes);
 }
+/**
+ * The cap's provenance, in the panel's language. The host reports stable English
+ * keys (`index` / `env` / `default`); showing those raw put an English word in the
+ * middle of a Chinese metric row, measured in the real panel as "512.0 KB index".
+ */
+function capSourceLabel(source) {
+    switch (source) {
+        case 'index':
+            return '索引记录';
+        case 'env':
+            return '环境变量';
+        case 'default':
+            return '默认值';
+        default:
+            return source;
+    }
+}
 function formatBytes(bytes) {
     if (!Number.isFinite(bytes) || bytes < 0)
         return '—';
@@ -428,16 +466,23 @@ const SOFT_BG = 'color-mix(in srgb, currentColor 6%, transparent)';
  * full-width cards reads as broken at the wide end — every metric row stretches
  * across a metre of empty space.
  *
- * Column count is content-driven rather than media-queried, because an inline-styled
- * plugin has no stylesheet to put a breakpoint in: `auto-fit` with a 620px floor
- * yields two columns once the pane can hold them and one column below that. A
- * card that needs the full width says so with `gridColumn: '1 / -1'`, which is
- * column-count agnostic — unlike `span 2`, which would overflow a single column.
+ * A single column is the honest layout for a docked sidebar. The previous
+ * `auto-fit` grid asked for two columns whenever the pane was wide enough for
+ * `2 × 620px + gap`; in a real narrow sidebar it therefore laid the second column —
+ * the entire language breakdown — past the visible edge, and the wide Git-activity
+ * card lost its third verdict. Tuning the floor only moves which pane width breaks;
+ * one column always fits. On a wide pane the card internals still distribute their
+ * metrics, so the space is not wasted.
+ *
+ * `minmax(0, 1fr)` also removes the min-content floor that let the grid widen its
+ * own container. A card that needs the full width still says so with
+ * `gridColumn: '1 / -1'`, which is harmless in one column and keeps the markup
+ * honest if the layout ever changes.
  */
 const styles = {
     root: {
         display: 'grid',
-        gridTemplateColumns: 'repeat(auto-fit, minmax(min(100%, 620px), 1fr))',
+        gridTemplateColumns: 'minmax(0, 1fr)',
         // No `alignItems: start`: grid items stretch to the row height by default, so
         // two cards sharing a row end level. With `start` each card took its natural
         // height and the row showed a ragged bottom edge.
@@ -445,7 +490,13 @@ const styles = {
         padding: '12px',
         fontSize: '12px',
         lineHeight: 1.5,
+        width: '100%',
+        maxWidth: '100%',
+        minWidth: 0,
         overflowY: 'auto',
+        // A card that overflows must be scrolled to, not painted outside the pane and
+        // mistaken for a neighbouring surface.
+        overflowX: 'hidden',
         height: '100%',
         boxSizing: 'border-box',
     },
@@ -571,6 +622,14 @@ function Histogram({ histogram, height = 54 }) {
         return null;
     const max = Math.max(...buckets.map((b) => b.commits), 1);
     const bucketDays = histogram.bucketDays ?? 1;
+    // One bucket is not a time series. Drawing it produced a full-width, full-height
+    // rectangle that read as a skeleton or a broken chart — measured on this
+    // repository, whose entire history fits in one week. The totals directly above
+    // already say the same number, so state the bucket instead of drawing it.
+    if (buckets.length === 1) {
+        const only = buckets[0];
+        return h('div', { style: { ...MUTED, display: 'flex', gap: '8px', flexWrap: 'wrap' } }, h('span', null, `${only.label} 起这一${bucketDays === 7 ? '周' : '天'}`), h('span', null, `${only.commits} 次提交`), h('span', null, `+${compactNumber(only.insertions)} / -${compactNumber(only.deletions)}`));
+    }
     return h('div', { style: { display: 'flex', flexDirection: 'column', gap: '3px' } }, h('div', {
         style: { display: 'flex', alignItems: 'flex-end', gap: '1px', height: `${height}px` },
         role: 'img',
@@ -582,10 +641,18 @@ function Histogram({ histogram, height = 54 }) {
     }, h('div', {
         style: {
             flex: '1 1 0',
+            // Bars do not grow past a readable width on a wide pane; a two-bucket
+            // chart otherwise stretches each bar across half the card.
+            maxWidth: '56px',
             // A zero bucket keeps a visible floor so a gap reads as "no commits"
             // rather than as missing data.
             height: `${Math.max(2, (bucket.commits / max) * height)}px`,
-            background: bucket.commits === 0 ? 'currentColor' : 'var(--dsw-color-accent, currentColor)',
+            // The host's real token. The first version invented `--dsw-color-accent`,
+            // which does not exist, so every bar fell back to `currentColor` and the
+            // chart rendered as a grey block in both themes.
+            background: bucket.commits === 0
+                ? 'currentColor'
+                : 'var(--dsw-alias-brand-primary, currentColor)',
             opacity: bucket.commits === 0 ? 0.16 : 0.75,
             borderRadius: '1px',
             alignSelf: 'flex-end',
@@ -649,7 +716,9 @@ function LanguageSection({ languages }) {
         totalBytes: languages.totalBytes,
         totalFiles: languages.totalFiles,
         metric,
-    }), h('div', { style: { marginTop: 'auto', paddingTop: '8px', fontSize: '10px', ...MUTED } }, `按${unit}计的占比；GitNexus 只解析其中一部分语言，其余仅作为文件节点存在`));
+    }), h('div', { style: { marginTop: 'auto', paddingTop: '8px', fontSize: '10px', ...MUTED } }, languages.detector === 'builtin'
+        ? `按${unit}计的占比；GitNexus 不可用，语言由内置扩展名映射识别（仅作参考）`
+        : `按${unit}计的占比；GitNexus 只解析其中一部分语言，其余仅作为文件节点存在`));
 }
 /**
  * The files the size cap dropped.
@@ -749,10 +818,160 @@ function activityView(activity) {
  * whether the graph knows about it.
  * @param {{file: any}} props
  */
-function ActivityFileRow({ file }) {
+function ActivityFileRow({ file, onSelect, }) {
     const tone = file.verdict === 'indexed' ? 'solid' : file.verdict === 'missing' ? 'outline' : 'neutral';
     const label = file.verdict === 'indexed' ? '已索引' : file.verdict === 'missing' ? '缺失' : '排除';
-    return h('div', { style: styles.fileRow }, h(FileTypeIcon, { path: file.path, size: 16 }), h('span', { style: { minWidth: 0, flex: '1 1 auto' } }, h(PathLabel, { path: file.path })), h('span', { style: styles.fileMeta }, h(Tag, { tone }, label), h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, `${file.changes}×`)));
+    const interactive = typeof onSelect === 'function';
+    return h('div', {
+        role: interactive ? 'button' : undefined,
+        tabIndex: interactive ? 0 : undefined,
+        title: interactive ? '查看该文件的提交时间线' : undefined,
+        onClick: interactive ? () => onSelect?.(file.path) : undefined,
+        onKeyDown: interactive
+            ? (event) => {
+                if (event.key === 'Enter' || event.key === ' ') {
+                    event.preventDefault();
+                    onSelect?.(file.path);
+                }
+            }
+            : undefined,
+        style: { ...styles.fileRow, cursor: interactive ? 'pointer' : undefined },
+    }, h(FileTypeIcon, { path: file.path, size: 16 }), h('span', { style: { minWidth: 0, flex: '1 1 auto' } }, h(PathLabel, { path: file.path })), h('span', { style: styles.fileMeta }, interactive
+        ? h('span', { style: { ...MUTED, fontSize: '10px', whiteSpace: 'nowrap' } }, '时间线')
+        : null, h(Tag, { tone }, label), h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, `${file.changes}×`)));
+}
+/** Shared labels/tones for the three activity verdicts. */
+function activityVerdict(verdict) {
+    if (verdict === 'indexed')
+        return { label: '已索引', tone: 'solid', dot: 'done' };
+    if (verdict === 'missing')
+        return { label: '索引缺失', tone: 'outline', dot: 'warning' };
+    return { label: '设计排除', tone: 'neutral', dot: 'idle' };
+}
+/**
+ * The three-way verdict with the volume behind it.
+ *
+ * The old UI had counts only, which made "2 missing" look as urgent as "2 excluded"
+ * even when the missing files accounted for 40 commits. This table adds the volume
+ * without changing the verdict definition.
+ */
+function ActivityCrossTable({ cross }) {
+    const rows = Array.isArray(cross.rows) ? cross.rows : [];
+    if (rows.length === 0)
+        return null;
+    const cell = { padding: '3px 0', textAlign: 'right' };
+    return h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, `活动 × 索引交叉对比 · ${compactNumber(cross.totalFiles ?? 0)} 文件 / ` +
+        `${compactNumber(cross.totalChanges ?? 0)} 次变更`), h('div', {
+        style: {
+            display: 'grid',
+            gridTemplateColumns: 'minmax(0, 1.5fr) repeat(4, minmax(0, 0.65fr))',
+            gap: '4px',
+            alignItems: 'center',
+            fontSize: '10px',
+        },
+    }, h('span', { style: MUTED }, '分类'), h('span', { style: { ...MUTED, ...cell } }, '文件'), h('span', { style: { ...MUTED, ...cell } }, '变更'), h('span', { style: { ...MUTED, ...cell } }, '+行'), h('span', { style: { ...MUTED, ...cell } }, '−行'), rows.map((row) => {
+        const verdict = activityVerdict(row.verdict);
+        return [
+            h('span', { key: `${row.verdict}-label`, style: { display: 'flex', alignItems: 'center', gap: '5px' } }, h(StateDot, { state: verdict.dot }), verdict.label),
+            h('span', { key: `${row.verdict}-files`, style: cell }, compactNumber(row.files)),
+            h('span', { key: `${row.verdict}-changes`, style: cell }, compactNumber(row.changes)),
+            h('span', { key: `${row.verdict}-ins`, style: cell }, `+${compactNumber(row.insertions)}`),
+            h('span', { key: `${row.verdict}-del`, style: cell }, `−${compactNumber(row.deletions)}`),
+        ];
+    })));
+}
+/** HEAD against the commit the index was built from. */
+function ActivityBaseline({ baseline, onSelect, }) {
+    const changedFiles = Array.isArray(baseline.changedFiles) ? baseline.changedFiles : [];
+    const short = baseline.shortSha ?? baseline.ref?.slice(0, 8) ?? '未知';
+    const date = typeof baseline.date === 'string' ? baseline.date.slice(0, 10) : '';
+    const windowBaseline = baseline.source === 'window';
+    return h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, `${windowBaseline ? '活动窗口基线审查' : '索引基线审查'} · ${short}` +
+        (date === '' ? '' : ` · ${date}`)), windowBaseline
+        ? h('div', { style: { ...MUTED, fontSize: '10px', marginBottom: '3px' } }, '索引没有记录基线提交，使用活动窗口最早的提交作为基线。')
+        : null, baseline.available === false
+        ? h('div', { style: { display: 'flex', gap: '6px', alignItems: 'flex-start' } }, h(StateDot, { state: 'warning' }), h('span', null, baseline.reason ?? '基线提交不可读'))
+        : h('div', { style: { ...MUTED } }, (baseline.commits ?? 0) === 0 && (baseline.files ?? 0) === 0
+            ? '工作区与索引基线一致，没有新增变更。'
+            : `自基线以来 ${compactNumber(baseline.commits ?? 0)} 个提交 · ` +
+                `${compactNumber(baseline.files ?? 0)} 个文件 · ` +
+                `+${compactNumber(baseline.insertions ?? 0)} / −${compactNumber(baseline.deletions ?? 0)}`), changedFiles.length > 0
+        ? h('div', { style: { marginTop: '4px' } }, changedFiles
+            .slice(0, 8)
+            .map((file) => h(ActivityFileRow, { key: file.path, file, onSelect })))
+        : null);
+}
+/** Newest-first commit list with per-commit index verdict. */
+function ActivityTimeline({ timeline, indexKnown, }) {
+    if (timeline.length === 0) {
+        return h('div', { style: { ...MUTED } }, '该时间范围内没有提交。');
+    }
+    return h('div', null, timeline.slice(0, 15).map((commit) => {
+        const verdict = indexKnown
+            ? activityVerdict(commit.verdict)
+            : { label: '索引未知', tone: 'neutral', dot: 'idle' };
+        return h('div', {
+            key: commit.sha,
+            style: {
+                display: 'flex',
+                flexDirection: 'column',
+                gap: '2px',
+                padding: '4px 0',
+                borderTop: HAIRLINE,
+                minWidth: 0,
+            },
+        }, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px', minWidth: 0 } }, h(StateDot, { state: verdict.dot }), h('span', { style: { ...styles.mono, color: 'inherit', whiteSpace: 'nowrap' } }, commit.shortSha ?? commit.sha.slice(0, 8)), h('span', {
+            style: {
+                minWidth: 0,
+                flex: '1 1 auto',
+                overflow: 'hidden',
+                textOverflow: 'ellipsis',
+                whiteSpace: 'nowrap',
+            },
+            title: commit.subject,
+        }, commit.subject === '' ? '(无提交说明)' : commit.subject)), h('div', {
+            style: {
+                ...MUTED,
+                fontSize: '10px',
+                display: 'flex',
+                flexWrap: 'wrap',
+                alignItems: 'center',
+                gap: '6px',
+                marginLeft: '14px',
+            },
+        }, h(Tag, { tone: verdict.tone }, verdict.label), h('span', { style: { whiteSpace: 'nowrap' } }, commit.date.slice(0, 10)), h('span', { style: { whiteSpace: 'nowrap' } }, commit.author), h('span', { style: { whiteSpace: 'nowrap' } }, `+${compactNumber(commit.insertions)}/−${compactNumber(commit.deletions)}`), h('span', { style: { whiteSpace: 'nowrap' } }, `${compactNumber(commit.files)} 文件`)));
+    }));
+}
+/** On-demand commit timeline for one file selected from the activity lists. */
+function FileHistorySection({ filePath, history, busy, error, onClose, }) {
+    if (filePath === null)
+        return null;
+    return h('div', { style: { borderTop: HAIRLINE, paddingTop: '6px', marginTop: '2px' } }, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px', minWidth: 0 } }, h('span', { style: { ...MUTED, flexShrink: 0 } }, '文件时间线'), h('span', { style: { minWidth: 0, flex: '1 1 auto' } }, h(PathLabel, { path: filePath })), h(Button, { variant: 'ghost', onClick: onClose }, '关闭')), busy
+        ? h('div', { style: { ...MUTED, marginTop: '4px' } }, '读取文件历史…')
+        : error !== null
+            ? h('div', { style: { ...MUTED, color: 'var(--dsw-alias-state-error-primary, inherit)' } }, error)
+            : history === null
+                ? null
+                : history.available === false
+                    ? h('div', { style: { ...MUTED, marginTop: '4px' } }, history.reason ?? '文件历史不可用')
+                    : h('div', { style: { marginTop: '4px' } }, h('div', { style: { ...MUTED, fontSize: '10px', marginBottom: '3px' } }, `近 ${history.days} 天 · ${history.commits} 提交 · ` +
+                        `+${compactNumber(history.insertions)} / −${compactNumber(history.deletions)}`), history.timeline.length === 0
+                        ? h('div', { style: { ...MUTED } }, '该时间范围内没有提交。')
+                        : history.timeline.length > 30
+                            ? h('div', { style: { ...MUTED, fontSize: '10px', marginBottom: '2px' } }, `仅显示最近 30 个提交（共 ${history.timeline.length} 个）`)
+                            : null, history.timeline.slice(0, 30).map((commit) => h('div', {
+                        key: commit.sha,
+                        style: { ...styles.fileRow, alignItems: 'flex-start' },
+                    }, h('span', { style: { ...styles.mono, color: 'inherit', whiteSpace: 'nowrap' } }, commit.shortSha ?? commit.sha.slice(0, 8)), h('span', {
+                        style: {
+                            minWidth: 0,
+                            flex: '1 1 auto',
+                            overflow: 'hidden',
+                            textOverflow: 'ellipsis',
+                            whiteSpace: 'nowrap',
+                        },
+                        title: commit.subject,
+                    }, commit.subject === '' ? '(无提交说明)' : commit.subject), h('span', { style: { ...styles.fileMeta, flexWrap: 'wrap' } }, h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, commit.date.slice(0, 10)), h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, commit.author), h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, `+${compactNumber(commit.insertions)}/−${compactNumber(commit.deletions)}`))))));
 }
 /**
  * Git activity, crossed with the index.
@@ -762,7 +981,16 @@ function ActivityFileRow({ file }) {
  * never expands it learns whether recent work is visible to the graph.
  * @param {{activity: any}} props
  */
-function GitActivitySection({ activity: rawActivity }) {
+function GitActivitySection({ activity: rawActivity, projectPath, }) {
+    // The project timeline defaults to 7 days and caps at 30; the file timeline
+    // reuses the same range. Hooks are before the "activity unavailable" return so
+    // the hook order cannot change with the data.
+    const [timelineDays, setTimelineDays] = React.useState(7);
+    const [selectedFile, setSelectedFile] = React.useState(null);
+    const [fileHistory, setFileHistory] = React.useState(null);
+    const [fileHistoryBusy, setFileHistoryBusy] = React.useState(false);
+    const [fileHistoryError, setFileHistoryError] = React.useState(null);
+    const fileHistorySeq = React.useRef(0);
     // Narrowed to a local const before use. `activityView` returns null for an absent
     // activity, but TypeScript cannot carry that back to the parameter, so every later
     // read would need its own guard — and a guard per read is how one gets forgotten.
@@ -772,6 +1000,62 @@ function GitActivitySection({ activity: rawActivity }) {
         return h('div', { style: { ...MUTED } }, 'Git 活动不可用');
     }
     const missing = view.verdicts.find((v) => v.key === 'missing')?.value ?? 0;
+    const requestFileHistory = (path, days) => {
+        if (projectPath === null)
+            return;
+        const seq = fileHistorySeq.current + 1;
+        fileHistorySeq.current = seq;
+        setSelectedFile(path);
+        setFileHistory(null);
+        setFileHistoryError(null);
+        setFileHistoryBusy(true);
+        const query = `/api/gitnexus/file-history?repo=${encodeURIComponent(projectPath)}` +
+            `&path=${encodeURIComponent(path)}&days=${days}`;
+        fetch(routeUrl(query))
+            .then(async (res) => ({ status: res.status, body: await res.json().catch(() => null) }))
+            .then(({ status, body }) => {
+            if (seq !== fileHistorySeq.current)
+                return;
+            // The client bundle can hot-reload before the host does. An unregistered
+            // route comes back as the desktop carrier's 401/404, not the route's own
+            // not-a-project JSON; say that instead of a generic status.
+            if ((status === 404 && body?.code !== 'not-a-project') ||
+                status === 401) {
+                throw new Error('当前宿主没有文件时间线路由；重启 DSH 后再试。');
+            }
+            if (!body?.ok) {
+                throw new Error(typeof body?.message === 'string' ? body.message : `请求失败 (${status})`);
+            }
+            setFileHistory(body);
+        })
+            .catch((cause) => {
+            if (seq !== fileHistorySeq.current)
+                return;
+            setFileHistoryError(String(cause?.message ?? cause));
+        })
+            .finally(() => {
+            if (seq === fileHistorySeq.current)
+                setFileHistoryBusy(false);
+        });
+    };
+    const openFileHistory = (path) => requestFileHistory(path, timelineDays);
+    const closeFileHistory = () => {
+        fileHistorySeq.current += 1;
+        setSelectedFile(null);
+        setFileHistory(null);
+        setFileHistoryError(null);
+        setFileHistoryBusy(false);
+    };
+    const changeTimelineDays = (days) => {
+        setTimelineDays(days);
+        if (selectedFile !== null)
+            requestFileHistory(selectedFile, days);
+    };
+    const cutoff = Date.now() - timelineDays * 86_400_000;
+    const projectTimeline = (Array.isArray(activity.timeline) ? activity.timeline : []).filter((commit) => {
+        const at = Date.parse(commit.date);
+        return !Number.isFinite(at) || at >= cutoff;
+    });
     return h('div', { style: { display: 'flex', flexDirection: 'column', gap: '10px', paddingTop: '4px' } }, h('div', { style: MUTED }, view.totals), view.truncated
         ? h('div', { style: MUTED }, `活动窗口达到提交上限，更早的改动未统计`)
         : null, h(MetricGrid, {
@@ -783,27 +1067,61 @@ function GitActivitySection({ activity: rawActivity }) {
     activity.histogram !== undefined && activity.histogram !== null
         ? h(Histogram, { histogram: activity.histogram })
         : null, 
+    // Three views over the same window: what the index sees, what changed since the
+    // index baseline, and the individual commits in order. Old hosts omit these
+    // fields; each block disappears rather than rendering a false empty state.
+    activity.totals?.indexKnown === false
+        ? h('div', { style: { ...MUTED } }, '项目尚未建立索引：无法把活动文件与图谱交叉，也没有索引基线可审查。')
+        : activity.cross !== undefined && activity.cross !== null
+            ? h(ActivityCrossTable, { cross: activity.cross })
+            : null, activity.baseline !== undefined && activity.baseline !== null
+        ? h(ActivityBaseline, { baseline: activity.baseline, onSelect: openFileHistory })
+        : null, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px', minWidth: 0 } }, h('span', { style: { ...MUTED } }, `提交时间线 · 近 ${timelineDays} 天 · ${projectTimeline.length} 个`), h('span', { style: { flex: 1 } }), h('select', {
+        value: String(timelineDays),
+        'aria-label': '项目提交时间线范围',
+        onChange: (event) => changeTimelineDays(Number(event.target.value)),
+        style: {
+            font: 'inherit',
+            fontSize: '10px',
+            padding: '2px 4px',
+            border: HAIRLINE,
+            borderRadius: '4px',
+            background: SOFT_BG,
+            color: 'inherit',
+        },
+    }, [7, 14, 30].map((days) => h('option', { key: days, value: String(days) }, `${days} 天`)))), h(ActivityTimeline, {
+        timeline: projectTimeline,
+        indexKnown: activity.totals?.indexKnown === true,
+    }), activity.timelineTruncated === true
+        ? h('div', { style: { ...MUTED, fontSize: '10px' } }, '时间线最多显示最近 100 个提交；缩短范围可看更早记录。')
+        : null, 
     // Missing files come from their own list, not from the display-capped
     // by-changes slice — otherwise the summary can report a count with no rows.
     missing > 0 && Array.isArray(activity.missingFiles) && activity.missingFiles.length > 0
         ? h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, '应被索引却缺失'), activity.missingFiles
             .slice(0, 8)
-            .map((file) => h(ActivityFileRow, { key: file.path, file })))
+            .map((file) => h(ActivityFileRow, { key: file.path, file, onSelect: openFileHistory })))
         : null, Array.isArray(activity.byChanges) && activity.byChanges.length > 0
         ? h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, '改动最频繁'), activity.byChanges
             .filter((f) => f.verdict !== 'excluded')
             .slice(0, 8)
-            .map((file) => h(ActivityFileRow, { key: file.path, file })))
+            .map((file) => h(ActivityFileRow, { key: file.path, file, onSelect: openFileHistory })))
         : null, Array.isArray(activity.byRecency) && activity.byRecency.length > 0
         ? h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, '最近改动'), activity.byRecency
             .filter((f) => f.verdict !== 'excluded')
             .slice(0, 5)
-            .map((file) => h(ActivityFileRow, { key: file.path, file })))
+            .map((file) => h(ActivityFileRow, { key: file.path, file, onSelect: openFileHistory })))
         : null, Array.isArray(activity.authors) && activity.authors.length > 0
         ? h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, '提交者'), activity.authors.slice(0, 6).map((author) => h('div', { key: `${author.name}-${author.email}`, style: styles.fileRow }, h('span', { style: { minWidth: 0, flex: '1 1 auto' } }, author.name), h('span', { style: styles.fileMeta }, author.bot ? h(Tag, { tone: 'neutral' }, 'bot') : null, h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, `${author.commits} 提交`), h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, `${author.files} 文件`)))))
         : null, Array.isArray(activity.branches) && activity.branches.length > 0
         ? h('div', null, h('div', { style: { ...MUTED, marginBottom: '4px' } }, `分支 · ${activity.branches.length}`), activity.branches.slice(0, 6).map((branch) => h('div', { key: branch.name, style: styles.fileRow }, h('span', { style: { minWidth: 0, flex: '1 1 auto', ...styles.mono } }, branch.name), h('span', { style: styles.fileMeta }, branch.current ? h(Tag, { tone: 'solid' }, '当前') : null, h('span', { style: { ...MUTED, whiteSpace: 'nowrap' } }, branch.lastCommitDate ? branch.lastCommitDate.slice(0, 10) : '')))))
-        : null);
+        : null, h(FileHistorySection, {
+        filePath: selectedFile,
+        history: fileHistory,
+        busy: fileHistoryBusy,
+        error: fileHistoryError,
+        onClose: closeFileHistory,
+    }));
 }
 /**
  * Resolve the project this panel is about.
@@ -945,20 +1263,23 @@ function ToolchainNotice({ toolchain, run, runError, now, onInstall, onCancelIns
         },
     }, command), h(Button, { variant: 'ghost', onClick: copy }, copied ? '已复制' : '复制')), h('div', { style: MUTED }, '用你能访问到的源安装即可 —— 本插件不假设任何网络，也不会自行下载。')), h('div', { style: { display: 'flex', flexDirection: 'column', gap: '4px' } }, h('div', { style: { fontWeight: 600 } }, '② 授权本插件安装'), h('div', { style: { display: 'flex', alignItems: 'center', gap: '8px', flexWrap: 'wrap' } }, installing
         ? h(Button, { variant: 'ghost', onClick: onCancelInstall }, `取消（已进行 ${elapsed}s）`)
-        : h(Button, { variant: 'ghost', onClick: () => setConfirming(true) }, '授权并安装'), h('span', { style: MUTED }, '装到插件自己的目录，用你已配置的 npm 源，不改全局前缀、不需要管理员权限。')), activeRun === null
+        : h(Button, { variant: 'ghost', onClick: () => setConfirming(true) }, '授权并安装'), h('span', { style: MUTED }, '装到插件自己的目录，用你已配置的 npm 源，不改全局前缀、不需要管理员权限；' +
+        '若当前项目还没有索引，装完会继续初始化一次。')), activeRun === null
         ? null
         : h('div', { style: { display: 'flex', flexDirection: 'column', gap: '3px', paddingTop: '2px' } }, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px' } }, h(StateDot, { state: runStateTone(activeRun.state) }), h('span', { style: { fontWeight: 600 } }, runStateLabel(activeRun.state)), h('span', { style: MUTED }, installing ? `已运行 ${elapsed}s` : `${elapsed}s`)), activeRun.message === null ? null : h('div', { style: MUTED }, activeRun.message), activeRun.output === ''
             ? null
-            : h('pre', { style: { ...styles.mono, margin: 0, whiteSpace: 'pre-wrap', maxHeight: '9em', overflow: 'auto' } }, activeRun.output)), runError === null ? null : h('div', { style: { ...MUTED, color: 'var(--dsw-color-danger, inherit)' } }, runError)), h(primitives.RiskConfirmation, {
+            : h('pre', { style: { ...styles.mono, margin: 0, whiteSpace: 'pre-wrap', maxHeight: '9em', overflow: 'auto' } }, activeRun.output)), runError === null ? null : h('div', { style: { ...MUTED, color: 'var(--dsw-alias-state-error-primary, inherit)' } }, runError)), h(primitives.RiskConfirmation, {
         open: confirming,
         title: '授权本插件安装 GitNexus？',
         description: '本插件将执行：\n\nnpm install --prefix <插件数据目录>/gitnexus gitnexus@^1.6.12\n\n' +
             '· 从你已配置的 npm 源下载约 500 MB ~ 1 GB\n' +
             '· 需要几分钟；网络慢或需要本地编译时更久\n' +
             '· 会在本机运行这些包的安装期构建脚本（原生数据库与解析器需要本地编译）\n' +
-            '· 安装到插件自己的目录，不改动你的全局 npm 前缀\n\n' +
+            '· 安装到插件自己的目录，不改动你的全局 npm 前缀\n' +
+            '· 安装成功后，若当前项目尚无索引，会继续运行一次 ' +
+            '`gitnexus analyze --index-only`（只写 .gitnexus/，不改源文件）\n\n' +
             '命令走 DSH 的 shell 执行器，沙箱与其它命令一致 —— 本插件不申请扩权。',
-        acknowledgeLabel: '我已了解这会下载数百 MB 并在本机编译原生模块',
+        acknowledgeLabel: '我已了解这会下载数百 MB、在本机编译原生模块，并在需要时初始化当前项目',
         cancelLabel: '取消',
         confirmLabel: '授权并开始',
         closeLabel: '关闭',
@@ -975,19 +1296,132 @@ function ToolchainNotice({ toolchain, run, runError, now, onInstall, onCancelIns
         },
     })));
 }
+/**
+ * Keyword search over the graph's symbol names and file paths.
+ *
+ * A native `input` rather than a primitives component: the shared package ships no
+ * declarations for an input, and guessing a prop name there fails at mount time in a
+ * browser where no test here can see it. The styling is the same theme-agnostic
+ * vocabulary the rest of the panel uses — inherited colour, borders from
+ * `currentColor`.
+ */
+function SearchSection({ search }) {
+    const keyOf = (hit) => `${hit.kind}:${hit.filePath}:${hit.startLine ?? ''}:${hit.name}`;
+    const canSubmit = search.query.trim() !== '' && !search.searching;
+    return h(Section, {
+        wide: true,
+        title: '关键词搜索',
+        meta: h('span', { style: { ...MUTED, fontSize: '11px' } }, search.mode === 'text' ? '源码关键词（回退）' : '符号名 / 文件路径'),
+    }, h('div', { style: { display: 'flex', gap: '8px', alignItems: 'center', paddingTop: '4px', flexWrap: 'wrap' } }, h('input', {
+        type: 'search',
+        value: search.query,
+        placeholder: '搜索符号或文件，例如 analyzeCoverage',
+        'aria-label': '关键词搜索',
+        spellCheck: false,
+        autoComplete: 'off',
+        onChange: (event) => search.onQueryChange(event.target.value),
+        onKeyDown: (event) => {
+            if (event.key === 'Enter' && canSubmit) {
+                event.preventDefault();
+                search.onSubmit();
+            }
+        },
+        style: {
+            flex: '1 1 auto',
+            minWidth: 0,
+            padding: '5px 8px',
+            border: HAIRLINE,
+            borderRadius: '6px',
+            background: SOFT_BG,
+            color: 'inherit',
+            font: 'inherit',
+        },
+    }), h(Button, { variant: 'primary', disabled: !canSubmit, onClick: search.onSubmit }, search.searching ? '搜索中…' : '搜索'), search.query === '' ? null : h(Button, { variant: 'ghost', onClick: search.onClear }, '清除')), search.error !== null
+        ? h('div', {
+            style: {
+                ...MUTED,
+                color: 'var(--dsw-alias-state-error-primary, inherit)',
+                marginTop: '6px',
+            },
+        }, search.error)
+        : null, h('div', { style: { ...MUTED, fontSize: '10px', marginTop: '4px' } }, search.warning ??
+        (search.mode === 'text'
+            ? '图查询不可用，已回退到源码关键词搜索。'
+            : '按符号名与文件路径匹配；不搜索正文。')), search.results === null
+        ? null
+        : search.results.length === 0
+            ? h('div', { style: { ...MUTED, marginTop: '6px' } }, `没有匹配“${search.query}”的符号或文件。`)
+            : h('div', { style: { display: 'flex', flexDirection: 'column', marginTop: '6px' } }, h('div', { style: { ...MUTED, fontSize: '10px', paddingBottom: '2px' } }, (search.mode === 'text'
+                ? `找到 ${search.total} 处源码匹配`
+                : `找到 ${search.total} 个结果`) +
+                `${search.truncated ? '（已截断）' : ''} · 点击结果打开文件`), search.results.map((hit) => h('div', {
+                key: keyOf(hit),
+                style: { ...styles.fileRow, borderTop: HAIRLINE, padding: '5px 0' },
+            }, h('button', {
+                type: 'button',
+                onClick: () => search.onOpen(hit),
+                title: hit.startLine === null
+                    ? `打开 ${hit.filePath}`
+                    : `打开 ${hit.filePath}:${hit.startLine}`,
+                style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: '6px',
+                    flex: '1 1 auto',
+                    minWidth: 0,
+                    padding: 0,
+                    border: 0,
+                    background: 'none',
+                    color: 'inherit',
+                    font: 'inherit',
+                    textAlign: 'left',
+                    cursor: 'pointer',
+                },
+            }, h(Tag, { tone: 'neutral' }, hit.kind), h('span', {
+                style: {
+                    fontWeight: 600,
+                    minWidth: 0,
+                    overflow: 'hidden',
+                    textOverflow: 'ellipsis',
+                    whiteSpace: 'nowrap',
+                },
+            }, hit.name), h('span', {
+                style: {
+                    ...MUTED,
+                    ...styles.mono,
+                    minWidth: 0,
+                    flex: '1 1 auto',
+                    overflow: 'hidden',
+                    textOverflow: 'ellipsis',
+                    whiteSpace: 'nowrap',
+                },
+            }, h(PathLabel, { path: hit.filePath }), hit.startLine !== null ? `:${hit.startLine}` : '')), h(Button, { variant: 'ghost', onClick: () => search.onCopy(hit) }, search.copied === keyOf(hit) ? '已复制' : '复制')))));
+}
 function MaintenanceSection({ maintenance, projectPath, indexed, run, runError, now, onStartRun, onCancelRun, }) {
     // `projectPath` is part of the prop set for the header, which builds the commands
     // from it; the body does not read it.
     void projectPath;
     const [copied, setCopied] = React.useState(null);
-    const [confirming, setConfirming] = React.useState(false);
+    const [confirming, setConfirming] = React.useState(null);
     // `RiskConfirmation`'s checkbox is controlled, so the tick has to live here. Without
     // this the box renders but never moves, which is how it looked the first time.
     const [acknowledged, setAcknowledged] = React.useState(false);
     const commands = Array.isArray(maintenance?.commands) ? maintenance.commands : [];
     if (commands.length === 0)
         return null;
-    const applicable = indexed ? 'full' : 'init';
+    // The incremental command is the normal action on both states: it initialises a
+    // missing index and refreshes a present one. The full rebuild is an escape hatch
+    // for a hung refresh, never "what applies" — marking it applicable on every
+    // indexed repository recommended the destructive path by default.
+    const applicable = 'init';
+    const fullConfirm = confirming === 'full';
+    const confirmCommand = commands.find((c) => c.mode === (fullConfirm ? 'full' : 'init'));
+    // `supportsForce` is also the host-generation marker: the same 0.1.2 release
+    // added the adaptive FTS decision and the project-local GITNEXUS_HOME. An older
+    // host's runner does not include either fix, so a refresh can fail on the FTS
+    // install or the registry write. Refuse to start it and say why, rather than
+    // leaving a button that is known to be wrong on this host.
+    const hostCurrent = maintenance.supportsForce === true;
     // Normalised rather than trusted. The declared type says `ClientAnalyzeRun | null`,
     // but a React element built without the prop arrives as `undefined` — which is
     // exactly what happened the first time this component was rendered by a caller that
@@ -1017,7 +1451,10 @@ function MaintenanceSection({ maintenance, projectPath, indexed, run, runError,
     // The old line said "复制后到会话执行". That stopped being the whole story once the
     // plugin could start the run itself, so the sentence says which parts it runs and
     // which it only hands over.
-    h('div', { style: MUTED }, '增量刷新可直接执行（走 DSH 的 shell 执行器，沙箱与其它命令一致，本插件不申请扩权）；其余命令复制后到会话执行。'), 
+    h('div', { style: MUTED }, hostCurrent
+        ? '两条命令都可由本插件执行（走 DSH 的 shell 执行器，沙箱与其它命令一致，本插件不申请扩权）。' +
+            '全量重建只应在增量刷新卡死或结果反常时使用。'
+        : '当前宿主是旧版本（不包含 FTS 自适应与注册表重定向修复）；重启 DSH 后再执行维护。命令仍可复制。'), 
     // The run sits above the commands rather than under one of them: the host holds a
     // single run per repository, and nesting it would imply the two variants have
     // separate ones.
@@ -1033,9 +1470,13 @@ function MaintenanceSection({ maintenance, projectPath, indexed, run, runError,
                 borderRadius: '6px',
                 background: SOFT_BG,
             },
-        }, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px' } }, h(StateDot, { state: runStateTone(activeRun.state) }), h('span', { style: { fontWeight: 600 } }, runStateLabel(activeRun.state)), h('span', { style: MUTED }, activeRun.state === 'running' ? `已运行 ${elapsed}s` : `${elapsed}s`), h('span', { style: { flex: 1 } }), running
+        }, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px' } }, h(StateDot, { state: runStateTone(activeRun.state) }), h('span', { style: { fontWeight: 600 } }, runStateLabel(activeRun.state)), activeRun.force === true ? h(Tag, { tone: 'outline' }, '全量') : null, h('span', { style: MUTED }, activeRun.state === 'running' ? `已运行 ${elapsed}s` : `${elapsed}s`), h('span', { style: { flex: 1 } }), running
             ? h(Button, { variant: 'ghost', onClick: onCancelRun }, '取消')
-            : h(Button, { variant: 'ghost', onClick: onStartRun }, '再次执行')), activeRun.message === null ? null : h('div', { style: MUTED }, activeRun.message), 
+            // Wrapped, not passed directly: once `onStartRun` takes a `force`
+            // argument, React's click event would arrive as that argument and every
+            // "run again" would become a full rebuild. Repeating the last mode is
+            // also the honest reading of "run again" after a force rebuild.
+            : h(Button, { variant: 'ghost', disabled: !hostCurrent, onClick: () => onStartRun(activeRun.force === true) }, '再次执行')), activeRun.message === null ? null : h('div', { style: MUTED }, activeRun.message), 
         // The output is the evidence. A run that reports success with a warning in
         // its log is a different outcome from one that does not, and hiding the text
         // would leave the panel's own verdict as the only thing to check.
@@ -1051,72 +1492,138 @@ function MaintenanceSection({ maintenance, projectPath, indexed, run, runError,
                 },
             }, activeRun.output)), runError === null
         ? null
-        : h('div', { style: { ...MUTED, color: 'var(--dsw-color-danger, inherit)' } }, runError), commands.map((command) => h('div', {
-        key: command.mode,
-        style: {
-            display: 'flex',
-            flexDirection: 'column',
-            gap: '3px',
-            // The inapplicable one stays visible — an operator may still want the
-            // text — but recedes.
-            opacity: command.mode === applicable ? 1 : 0.55,
-        },
-    }, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px' } }, h('span', { style: { fontWeight: 600 } }, command.label), command.mode === applicable ? h(Tag, { tone: 'solid' }, '当前适用') : null, command.destructive ? h(Tag, { tone: 'outline' }, '破坏性') : null, h('span', { style: { flex: 1 } }), 
-    // Only the incremental command gets a button, and only because it is the one
-    // the host route implements. A button on `--force` would quietly run
-    // something other than what its label says.
-    command.mode === 'init'
-        ? h(Button, { variant: 'ghost', disabled: running, onClick: () => setConfirming(true) }, running ? '运行中' : '执行增量刷新')
-        : null, h(Button, { variant: 'ghost', onClick: () => copy(command) }, copied === command.mode ? '已复制' : '复制')), h('code', {
-        style: {
-            ...styles.mono,
-            display: 'block',
-            padding: '6px 8px',
-            border: HAIRLINE,
-            borderRadius: '6px',
-            background: SOFT_BG,
-            wordBreak: 'break-all',
-            userSelect: 'all',
-        },
-    }, command.shell), h('div', { style: MUTED }, command.when), command.caveat !== null && command.caveat !== undefined
-        ? h('div', { style: MUTED }, command.caveat)
-        : null)), Array.isArray(maintenance?.rationale) && maintenance.rationale.length > 0
+        : h('div', { style: { ...MUTED, color: 'var(--dsw-alias-state-error-primary, inherit)' } }, runError), commands.map((command) => {
+        // The host's wording is written for the no-index state ("初始化索引", "该项目还没有
+        // … 索引时使用"). Reusing it on an indexed project told the operator to initialise
+        // an index that already existed. Only the label and the "when" line are stateful;
+        // the command itself is identical.
+        const shown = command.mode === 'init' && indexed
+            ? {
+                ...command,
+                label: '增量刷新',
+                when: '索引落后或有文件改动时使用；未变更文件的解析产物会复用。',
+            }
+            : command;
+        return h('div', {
+            key: command.mode,
+            style: {
+                display: 'flex',
+                flexDirection: 'column',
+                gap: '3px',
+                // The inapplicable one stays visible — an operator may still want the
+                // text — but recedes.
+                opacity: command.mode === applicable ? 1 : 0.55,
+            },
+        }, h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px' } }, h('span', { style: { fontWeight: 600 } }, shown.label), command.mode === applicable ? h(Tag, { tone: 'solid' }, '当前适用') : null, command.destructive ? h(Tag, { tone: 'outline' }, '破坏性') : null, h('span', { style: { flex: 1 } }), 
+        // Both commands are executable now, each behind its own confirmation. The
+        // force button exists because the host route implements `--force`; a button
+        // labelled "全量重建" that quietly ran an incremental refresh would be the
+        // exact failure the earlier revision refused to ship.
+        command.mode === 'init'
+            ? h(Button, { variant: 'ghost', disabled: running || !hostCurrent, onClick: () => setConfirming('init') }, running ? '运行中' : hostCurrent ? '执行增量刷新' : '执行增量刷新（需重启）')
+            : hostCurrent
+                ? h(Button, { variant: 'ghost', disabled: running, onClick: () => setConfirming('full') }, running ? '运行中' : '全量重建')
+                : h(Button, {
+                    variant: 'ghost',
+                    disabled: true,
+                    title: '当前宿主版本尚未支持 force=1；重启 DSH 后再试，或复制命令执行',
+                }, '全量重建（需重启）'), h(Button, { variant: 'ghost', onClick: () => copy(command) }, copied === command.mode ? '已复制' : '复制')), h('code', {
+            style: {
+                ...styles.mono,
+                display: 'block',
+                padding: '6px 8px',
+                border: HAIRLINE,
+                borderRadius: '6px',
+                background: SOFT_BG,
+                wordBreak: 'break-all',
+                userSelect: 'all',
+            },
+        }, command.shell), h('div', { style: MUTED }, shown.when), command.caveat !== null && command.caveat !== undefined
+            ? h('div', { style: MUTED }, command.caveat)
+            : null);
+    }), Array.isArray(maintenance?.rationale) && maintenance.rationale.length > 0
         ? h('div', { style: { ...MUTED, display: 'flex', flexDirection: 'column', gap: '2px' } }, maintenance.rationale.map((note, index) => h('div', { key: index }, `· ${note}`)))
         : null, 
     // The confirmation. Everything the operator needs before a process touches their
     // working tree goes in `description`, because that is the prop the modal renders:
     // an earlier revision passed this as children and the dialog opened with an empty
     // body and two unlabelled buttons.
+    //
+    // One dialog, two modes. The full rebuild gets its own title, wording and
+    // acknowledgement because it is a different risk: it discards the graph and FTS
+    // and can take minutes, while the incremental path reuses unchanged files.
     h(primitives.RiskConfirmation, {
-        open: confirming,
-        title: '执行增量刷新？',
-        description: '将在项目目录下运行：\n\n' +
-            (commands.find((c) => c.mode === 'init')?.shell ?? 'gitnexus analyze --index-only') +
-            '\n\n' +
-            '只写入 .gitnexus/，不改动任何源文件，也不会重写 AGENTS.md / CLAUDE.md。' +
-            '耗时取决于改动量：无改动时约 7 秒，改动几个文件时实测可到 3 分钟，' +
-            '大仓库的全量重建可能更久（上限 10 分钟，可随时取消）。' +
-            '命令由 DSH 的 shell 执行器运行，沙箱与其它命令一致 —— 本插件不申请扩权。',
-        acknowledgeLabel: '我了解这会运行一个进程并写入 .gitnexus/',
+        open: confirming !== null,
+        title: fullConfirm ? '执行全量重建？' : '执行增量刷新？',
+        description: fullConfirm
+            ? '将执行强制全量重建：\n\n' +
+                (confirmCommand?.shell ?? 'gitnexus analyze --index-only --force') +
+                '\n\n' +
+                '这会重建图与 FTS；未变更文件的解析产物仍会复用。' +
+                '但耗时以分钟计，索引很大时更久（上限 10 分钟，可随时取消）。' +
+                '重建期间索引可能短暂不可用。' +
+                '只写入 .gitnexus/，不改动源文件，也不会重写 AGENTS.md / CLAUDE.md。' +
+                '命令由 DSH 的 shell 执行器运行，沙箱与其它命令一致 —— 本插件不申请扩权。'
+            : '将在项目目录下运行：\n\n' +
+                (confirmCommand?.shell ?? 'gitnexus analyze --index-only') +
+                '\n\n' +
+                '只写入 .gitnexus/，不改动任何源文件，也不会重写 AGENTS.md / CLAUDE.md。' +
+                '耗时取决于改动量：无改动时约 7 秒，改动几个文件时实测可到 3 分钟，' +
+                '大仓库的初始化或刷新可能更久（上限 10 分钟，可随时取消）。' +
+                '命令由 DSH 的 shell 执行器运行，沙箱与其它命令一致 —— 本插件不申请扩权。',
+        acknowledgeLabel: fullConfirm
+            ? '我了解这会重建图与 FTS、耗时数分钟，并可能让索引短暂不可用'
+            : '我了解这会运行一个进程并写入 .gitnexus/',
         cancelLabel: '取消',
-        confirmLabel: '执行',
+        confirmLabel: fullConfirm ? '开始重建' : '执行',
         closeLabel: '关闭',
         // The checkbox is controlled, so it needs state of its own, and it is reset on
         // close: the acknowledgement is per-action rather than remembered.
         acknowledged,
         onAcknowledgedChange: setAcknowledged,
         onCancel: () => {
-            setConfirming(false);
+            setConfirming(null);
             setAcknowledged(false);
         },
         onConfirm: () => {
-            setConfirming(false);
+            const force = confirming === 'full';
+            setConfirming(null);
             setAcknowledged(false);
-            onStartRun();
+            onStartRun(force);
         },
     }));
 }
-function CoverageView({ report, maintenance, projectPath, context, busy, error, readAt, run, runError, now, onRefresh, onStartRun, onCancelRun, installRun, installError, onInstall, onCancelInstall, }) {
+function LoadingBar({ label, percent }) {
+    const value = percent === null || percent === undefined
+        ? undefined
+        : Math.max(0, Math.min(100, Math.round(percent)));
+    const text = value === undefined ? label : `${label} · ${value}%`;
+    return h('div', {
+        style: {
+            gridColumn: '1 / -1',
+            display: 'flex',
+            flexDirection: 'column',
+            gap: '4px',
+        },
+    }, h('progress', {
+        value,
+        max: 100,
+        'aria-label': label,
+        'aria-valuetext': text,
+        'aria-valuenow': value,
+        style: {
+            width: '100%',
+            height: '4px',
+            border: 0,
+            borderRadius: '999px',
+            overflow: 'hidden',
+            background: 'var(--dsw-alias-bg-layer-3, rgba(127, 127, 127, 0.16))',
+            accentColor: 'var(--dsw-alias-brand-primary, #4f8cff)',
+            color: 'var(--dsw-alias-brand-primary, #4f8cff)',
+        },
+    }), h('div', { style: { ...MUTED, fontSize: '10px' } }, text));
+}
+function CoverageView({ report, maintenance, projectPath, context, busy, progress, error, readAt, run, runError, now, onRefresh, onStartRun, onCancelRun, installRun, installError, onInstall, onCancelInstall, search, }) {
     // Whether an index exists decides which maintenance command is applicable. When
     // the project could not even be identified there is nothing to claim, so it is
     // false rather than assumed.
@@ -1137,6 +1644,16 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
         title: '重新读取报告（不会重建索引；重建见下方「维护命令」）',
         'aria-label': '重新读取报告',
     }, h(IconRefreshOutlineRegular, { size: 14 })));
+    // A report already on screen stays readable while a manual refresh runs; the bar
+    // rides above it. Before the first report exists, the bar is the whole body.
+    // `percent` is null when the host does not stream (old host, or a cached read):
+    // the native progress element is then indeterminate, not a made-up number.
+    const progressBar = report === null || busy
+        ? h(LoadingBar, {
+            label: progress?.label ?? (report === null ? '正在读取索引…' : '正在刷新索引…'),
+            percent: progress?.percent ?? null,
+        })
+        : null;
     // "I cannot tell which project this is" and "this project has no index" are
     // different facts, and the first revision conflated them: an unresolved project
     // fell through to the no-index branch and told the operator to initialise an
@@ -1157,34 +1674,52 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
             }, h(MaintenanceSection, { maintenance, projectPath, indexed: false, run, runError, now, onStartRun, onCancelRun })));
     }
     if (report === null) {
-        return h('div', { style: styles.root }, header, h('div', { style: MUTED }, '正在读取索引…'));
+        return h('div', { style: styles.root }, header, progressBar);
     }
-    // No index yet. This is the state the initialize command exists for, so the
-    // panel leads with the command rather than an error.
+    // Defaults are resolved before the no-index branch: a scan-only report still has
+    // totals, a cap and languages even though it has no graph. Building them only for
+    // an indexed report is what made "no index" mean "nothing to show".
+    const totals = report.totals ?? ZERO_TOTALS;
+    const cap = report.cap ?? ZERO_CAP;
+    const analyzer = report.analyzer ?? ZERO_ANALYZER;
+    const largeFiles = report.largeFiles ?? [];
+    const languages = report.languages ?? null;
+    const { notable, context: contextWarnings } = splitWarnings(report.warnings);
+    const ratio = coverageRatio(report);
+    // No index yet. This is the state the initialize command exists for, but it is
+    // also a state in which the working tree is still readable: file counts, bytes,
+    // the cap and the language split do not need GitNexus. The panel used to show
+    // only "没有索引" and a command, which made an otherwise healthy repository look
+    // empty. The scan is the "at least something to look at" floor.
     if (report.repo?.indexed !== true) {
-        return h('div', { style: styles.root }, header, h(Section, { wide: true, style: { display: 'flex', gap: '8px', alignItems: 'flex-start' } }, h(StateDot, { state: 'idle' }), h('span', null, '该项目还没有 GitNexus 索引。')), maintenance === null || maintenance === undefined
+        return h('div', { style: styles.root }, h('div', { style: { gridColumn: '1 / -1', display: 'flex', flexDirection: 'column', gap: '6px' } }, header), progressBar, h(ToolchainNotice, {
+            toolchain: report.toolchain,
+            run: installRun,
+            runError: installError,
+            now,
+            onInstall,
+            onCancelInstall,
+        }), h('div', { style: { gridColumn: '1 / -1', display: 'flex', gap: '8px', alignItems: 'flex-start' } }, h(StateDot, { state: 'idle' }), h('span', null, '该项目还没有 GitNexus 索引。下面是工作区扫描结果；初始化后可看到图谱、查询能力与 Git 活动对账。')), h(Section, { wide: true, title: '扫描概览 · 尚未索引' }, h(MetricGrid, {
+            items: [
+                { label: '扫描文件', value: compactNumber(totals.scanned) },
+                { label: '选中文件', value: compactNumber(totals.selected) },
+                { label: '扫描字节', value: fileSize(totals.scannedBytes ?? 0) },
+                { label: '大小上限', value: cap.text, hint: capSourceLabel(cap.source) },
+            ],
+        }), h('div', { style: { ...MUTED, marginTop: '6px' } }, '这里的数字来自工作区，不是索引；索引里有什么，只有建立后才能回答。')), languages !== null && languages.rows.length > 0 ? h(LanguageSection, { languages }) : null, maintenance === null || maintenance === undefined
             ? null
             : h(Section, {
                 wide: true,
                 title: '初始化索引',
-                meta: h('span', { style: { ...MUTED, fontSize: '11px' } }, '复制后到会话执行（沙箱与提权由 DSH 处理）'),
+                meta: h('span', { style: { ...MUTED, fontSize: '11px' } }, maintenance.supportsForce === true
+                    ? '均可直接执行，也可复制到会话（沙箱与提权由 DSH 处理）'
+                    : '重启 DSH 后可执行；当前仅可复制（沙箱与提权由 DSH 处理）'),
             }, h(MaintenanceSection, { maintenance, projectPath, indexed, run, runError, now, onStartRun, onCancelRun })));
     }
-    // Past this point an index exists, and the host builds these blocks
-    // unconditionally for one. Defaulting them once here beats a `?? []` at each of
-    // twenty read sites — and a default repeated twenty times is one that will
-    // eventually be forgotten at the twenty-first.
-    const totals = report.totals ?? ZERO_TOTALS;
-    const cap = report.cap ?? ZERO_CAP;
-    const analyzer = report.analyzer ?? ZERO_ANALYZER;
-    const largeFiles = report.largeFiles ?? [];
-    const { notable, context: contextWarnings } = splitWarnings(report.warnings);
-    const ratio = coverageRatio(report);
-    const languages = report.languages ?? null;
     return h('div', { style: styles.root }, 
     // The header and the two status lines span everything: they describe the whole
     // panel, so giving them a column would make them look like one card's heading.
-    h('div', { style: { gridColumn: '1 / -1', display: 'flex', flexDirection: 'column', gap: '6px' } }, header), 
+    h('div', { style: { gridColumn: '1 / -1', display: 'flex', flexDirection: 'column', gap: '6px' } }, header), progressBar, 
     // Immediately after the header, before any index content. If GitNexus is missing,
     // that single fact explains everything the panel is about to show or fail to show,
     // so it belongs above the numbers rather than beside them.
@@ -1208,6 +1743,9 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
             const s = stalenessView(report.staleness);
             return h('div', { style: { display: 'flex', alignItems: 'center', gap: '6px' } }, h(StateDot, { state: s.state }), h('span', null, s.text));
         })()), 
+    // Search sits above the report cards: it is the action a reader reaches for
+    // before reading, not an annotation on the numbers below it.
+    search === undefined ? null : h(SearchSection, { search }), 
     // One card for the whole "what is this index" question — file coverage and
     // graph contents together.
     //
@@ -1225,13 +1763,15 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
         : h(Ring, {
             ratio,
             caption: '覆盖',
-            tone: ratio >= 0.9 ? 'var(--dsw-color-success, #3fb950)' : 'var(--dsw-color-warning, #d9a441)',
+            tone: ratio >= 0.9
+                ? 'var(--dsw-alias-state-success-primary, #3fb950)'
+                : 'var(--dsw-alias-state-warn-primary, #d9a441)',
         }), h('div', { style: { display: 'flex', flexDirection: 'column', gap: '9px', minWidth: 0, flex: '1 1 auto' } }, h('div', { style: MUTED }, summaryLine(report)), 
     // Files in, graph out — the two halves sit side by side so the wide card
     // is used rather than merely filled.
     h('div', { style: { display: 'flex', gap: '24px', flexWrap: 'wrap', alignItems: 'flex-start' } }, h('div', { style: { minWidth: '200px', flex: '1 1 auto' } }, h('div', { style: { ...MUTED, marginBottom: '5px' } }, '文件'), h(MetricGrid, {
         items: [
-            { label: '大小上限', value: cap.text, hint: cap.source },
+            { label: '大小上限', value: cap.text, hint: capSourceLabel(cap.source) },
             { label: '跳过合计', value: fileSize(totals.largeBytes) },
             { label: '超限文件', value: compactNumber(totals.large) },
         ],
@@ -1245,7 +1785,9 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
                 { label: '流程', value: compactNumber(report.graph.processes) },
                 { label: '向量', value: compactNumber(report.graph.embeddings) },
             ],
-        }))), h('div', { style: { borderTop: HAIRLINE, paddingTop: '8px' } }, h('div', { style: { ...MUTED, marginBottom: '5px' } }, '查询能力'), h(CapabilityStrip, { capabilities: report.capabilities }))))), 
+        }))), h('div', { style: { borderTop: HAIRLINE, paddingTop: '8px' } }, h('div', { style: { ...MUTED, marginBottom: '5px' } }, '查询能力'), h(CapabilityStrip, { capabilities: report.capabilities }), report.capabilities?.fts?.status === 'available'
+        ? null
+        : h('div', { style: { ...MUTED, marginTop: '4px', fontSize: '10px' } }, '顶部「关键词搜索」会先查图；图查询不可用时回退到源码关键词。'))))), 
     // Shares a row with the overview card: a bar plus its legend is a proportional
     // reading, and pairing it with the coverage figure puts the two "how much of
     // this repository" answers side by side. Order matters — it must directly
@@ -1313,14 +1855,18 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
             meta: h('span', { style: { display: 'inline-flex', alignItems: 'center', gap: '5px', ...MUTED, fontSize: '11px' } }, h(StateDot, {
                 state: activityView(report.activity)?.verdicts.find((v) => v.key === 'missing')?.tone ?? 'done',
             }), activityCollapsed(report.activity)),
-        }, h(GitActivitySection, { activity: report.activity })), 
+        }, h(GitActivitySection, { activity: report.activity, projectPath })), 
     // Wide, and always open: the commands are the action this panel offers.
     maintenance === null || maintenance === undefined
         ? null
         : h(Section, {
             wide: true,
             title: '维护命令',
-            meta: h('span', { style: { ...MUTED, fontSize: '11px' } }, `${maintenance.commands?.length ?? 0} 条 · 复制后到会话执行（沙箱与提权由 DSH 处理）`),
+            meta: h('span', { style: { ...MUTED, fontSize: '11px' } }, `${maintenance.commands?.length ?? 0} 条 · ` +
+                (maintenance.supportsForce === true
+                    ? '均可直接执行，也可复制到会话'
+                    : '重启 DSH 后可执行；当前仅可复制') +
+                '（沙箱与提权由 DSH 处理）'),
         }, h(MaintenanceSection, { maintenance, projectPath, indexed, run, runError, now, onStartRun, onCancelRun })));
 }
 /**
@@ -1334,10 +1880,12 @@ function CoverageView({ report, maintenance, projectPath, context, busy, error,
  */
 function CoveragePanel(props) {
     const projectPath = useProjectPath(props);
+    const sessionId = typeof props.sessionId === 'string' ? props.sessionId : null;
     const [report, setReport] = React.useState(null);
     const [maintenance, setMaintenance] = React.useState(null);
     const [error, setError] = React.useState(null);
     const [busy, setBusy] = React.useState(false);
+    const [progress, setProgress] = React.useState(null);
     const [reloadToken, setReloadToken] = React.useState(0);
     // When the report on screen was read. Without it a refresh of an unchanged
     // repository produces a byte-identical panel, so the control looks inert even
@@ -1345,6 +1893,19 @@ function CoveragePanel(props) {
     const [readAt, setReadAt] = React.useState(null);
     // Only a manual refresh bypasses the host's cache; the initial load does not.
     const wantsFresh = reloadToken > 0;
+    // Keyword search. Its own state because it is an on-demand action, not part of
+    // the report the panel loads: an idle panel makes no search requests at all.
+    const [searchQuery, setSearchQuery] = React.useState('');
+    const [searchResults, setSearchResults] = React.useState(null);
+    const [searchMode, setSearchMode] = React.useState(null);
+    const [searchTotal, setSearchTotal] = React.useState(0);
+    const [searchTruncated, setSearchTruncated] = React.useState(false);
+    const [searchWarning, setSearchWarning] = React.useState(null);
+    const [searching, setSearching] = React.useState(false);
+    const [searchError, setSearchError] = React.useState(null);
+    const [searchCopied, setSearchCopied] = React.useState(null);
+    // Monotonic request id: a slower earlier search must not overwrite a newer one.
+    const searchSeq = React.useRef(0);
     // The refresh run, and the tick that makes its elapsed time advance. `run` is null
     // until something is started in this host's lifetime — a state the card renders as
     // "not run yet" rather than as a failure.
@@ -1389,14 +1950,13 @@ function CoveragePanel(props) {
             clearInterval(id);
         };
     }, [projectPath, running]);
-    const startRun = React.useCallback(async () => {
+    const startRun = React.useCallback(async (force = false) => {
         if (projectPath === null)
             return;
         setRunError(null);
         try {
-            const res = await fetch(routeUrl(`/api/gitnexus/analyze?repo=${encodeURIComponent(projectPath)}`), {
-                method: 'POST',
-            });
+            const suffix = force ? '&force=1' : '';
+            const res = await fetch(routeUrl(`/api/gitnexus/analyze?repo=${encodeURIComponent(projectPath)}${suffix}`), { method: 'POST' });
             const body = await res.json().catch(() => null);
             if (!body?.ok)
                 throw new Error(body?.message ?? `请求失败 (${res.status})`);
@@ -1422,12 +1982,155 @@ function CoveragePanel(props) {
             setRunError(String(cause?.message ?? cause));
         }
     }, [projectPath]);
+    /**
+     * Run one keyword search.
+     *
+     * No request on mount and no request per keystroke: a graph query is cheap but not
+     * free, and the operator's typing is not a search intent until Enter or the button.
+     * `searchSeq` makes an older in-flight response a no-op, which is the difference
+     * between "the last search wins" and a result list that flickers backwards.
+     */
+    const runSearch = React.useCallback(async () => {
+        if (projectPath === null)
+            return;
+        const query = searchQuery.trim();
+        if (query === '') {
+            setSearchResults(null);
+            setSearchError(null);
+            return;
+        }
+        const seq = ++searchSeq.current;
+        setSearching(true);
+        setSearchError(null);
+        setSearchCopied(null);
+        try {
+            const res = await fetch(routeUrl(`/api/gitnexus/search?repo=${encodeURIComponent(projectPath)}` +
+                `&q=${encodeURIComponent(query)}&limit=20`));
+            const body = await res.json().catch(() => null);
+            if (seq !== searchSeq.current)
+                return;
+            if (!body?.ok) {
+                // A 404 without the route's own code means the host predates the search
+                // route, not that the project is wrong: the panel's own project path is a
+                // project root by construction.
+                if (res.status === 404 && body?.code !== 'not-a-project') {
+                    throw new Error('当前宿主没有搜索路由；重启 DSH 后再试。');
+                }
+                throw new Error(typeof body?.message === 'string' ? body.message : `请求失败 (${res.status})`);
+            }
+            const results = Array.isArray(body.results)
+                ? body.results.filter((hit) => hit !== null &&
+                    typeof hit === 'object' &&
+                    typeof hit.kind === 'string' &&
+                    typeof hit.name === 'string' &&
+                    typeof hit.filePath === 'string')
+                : [];
+            setSearchResults(results);
+            setSearchMode(body.mode === 'text' ? 'text' : body.mode === 'graph' ? 'graph' : null);
+            setSearchTotal(typeof body.total === 'number' ? body.total : results.length);
+            setSearchTruncated(body.truncated === true);
+            setSearchWarning(typeof body.warning === 'string' ? body.warning : null);
+        }
+        catch (cause) {
+            if (seq !== searchSeq.current)
+                return;
+            setSearchResults(null);
+            setSearchError(String(cause?.message ?? cause));
+        }
+        finally {
+            if (seq === searchSeq.current)
+                setSearching(false);
+        }
+    }, [projectPath, searchQuery]);
+    const clearSearch = React.useCallback(() => {
+        searchSeq.current += 1;
+        setSearchQuery('');
+        setSearchResults(null);
+        setSearchMode(null);
+        setSearchTotal(0);
+        setSearchTruncated(false);
+        setSearchWarning(null);
+        setSearchError(null);
+        setSearching(false);
+        setSearchCopied(null);
+    }, []);
+    const copySearchHit = React.useCallback((hit) => {
+        const text = `${hit.filePath}${hit.startLine !== null ? `:${hit.startLine}` : ''}`;
+        const key = `${hit.kind}:${hit.filePath}:${hit.startLine ?? ''}:${hit.name}`;
+        const write = typeof primitives.writeClipboard === 'function'
+            ? primitives.writeClipboard
+            : (value) => navigator.clipboard?.writeText(value);
+        try {
+            const outcome = write(text);
+            if (outcome && typeof outcome.then === 'function') {
+                outcome
+                    .then(() => {
+                    setSearchCopied(key);
+                    setTimeout(() => setSearchCopied(null), 1500);
+                })
+                    .catch(() => setSearchCopied(null));
+            }
+            else {
+                setSearchCopied(key);
+                setTimeout(() => setSearchCopied(null), 1500);
+            }
+        }
+        catch {
+            setSearchCopied(null);
+        }
+    }, []);
+    /**
+     * Open a hit in the platform's file viewer at its line.
+     *
+     * The resource address is the same `dsh-resource://file/session/...` the built-in
+     * file strip uses; `params.line` is what the chat's file links pass. If the
+     * deployment has no right-sidebar controller (a headless profile, or a host older
+     * than the service), opening is impossible — copy the `path:line` instead of
+     * silently doing nothing, and say why.
+     */
+    const openSearchHit = React.useCallback((hit) => {
+        setSearchError(null);
+        if (sessionId === null) {
+            setSearchError('未能定位当前会话，已复制路径。');
+            copySearchHit(hit);
+            return;
+        }
+        const address = fileResourceAddress(sessionId, hit.filePath);
+        const options = hit.startLine === null
+            ? undefined
+            : { params: { line: hit.startLine } };
+        try {
+            if (openResourceIn !== null) {
+                openResourceIn(sessionId, address, options);
+                return;
+            }
+            if (openResource !== null) {
+                openResource(address, options);
+                return;
+            }
+        }
+        catch {
+            /* fall through to the copy path */
+        }
+        setSearchError('当前宿主没有可用的文件打开能力，已复制路径。');
+        copySearchHit(hit);
+    }, [sessionId, copySearchHit]);
+    // A different project means the previous hits are another repository's symbols.
+    React.useEffect(() => {
+        clearSearch();
+    }, [projectPath, clearSearch]);
     // The GitNexus install. Its own state because it is not tied to a repository: the
     // install target is one directory per machine, and the operator may have several
     // projects open across a session.
     const [installRun, setInstallRun] = React.useState(null);
     const [installError, setInstallError] = React.useState(null);
     const installing = installRun?.state === 'running';
+    // Only an install the operator authorised *in this panel* may chain into an
+    // analyze. A successful install from an earlier session is still visible in the
+    // host's run state, and starting a write from that would be acting on consent the
+    // operator gave for a different action.
+    const autoInitArmed = React.useRef(false);
+    const autoInitDone = React.useRef(null);
     React.useEffect(() => {
         if (!installing)
             return undefined;
@@ -1460,6 +2163,7 @@ function CoveragePanel(props) {
     }, [installing]);
     const startInstall = React.useCallback(async () => {
         setInstallError(null);
+        autoInitArmed.current = true;
         try {
             const res = await fetch(routeUrl('/api/gitnexus/install'), { method: 'POST' });
             const body = await res.json().catch(() => null);
@@ -1469,6 +2173,7 @@ function CoveragePanel(props) {
             setTick(0);
         }
         catch (cause) {
+            autoInitArmed.current = false;
             setInstallError(String(cause?.message ?? cause));
         }
     }, []);
@@ -1483,38 +2188,142 @@ function CoveragePanel(props) {
             setInstallError(String(cause?.message ?? cause));
         }
     }, []);
+    /**
+     * Install → initialize, in one authorised step.
+     *
+     * The install is machine-wide; the index is per-project. Chaining them is the
+     * difference between "you now have a CLI" and "you can see the index", which is
+     * what the operator asked for. Three conditions keep it honest: the install must
+     * have finished successfully, the project must still have no index (otherwise
+     * this would silently refresh an index nobody asked to refresh), and the operator
+     * must have started *this* install from this panel.
+     *
+     * The key includes the install's start time, so a retry after a cancellation is a
+     * new run and may chain again, while the poll ticks of one run cannot start two
+     * analyses.
+     */
+    React.useEffect(() => {
+        if (!autoInitArmed.current)
+            return;
+        if (installRun?.state !== 'done')
+            return;
+        // Wait for a report rather than treating "not loaded" as "not indexed".
+        if (report === null || projectPath === null || report.repo?.indexed === true)
+            return;
+        const key = `${projectPath}:${installRun.startedAt}`;
+        if (autoInitDone.current === key)
+            return;
+        autoInitDone.current = key;
+        autoInitArmed.current = false;
+        void startRun(false);
+    }, [installRun, projectPath, report, startRun]);
     React.useEffect(() => {
         if (projectPath === null)
             return undefined;
         const controller = new AbortController();
         setBusy(true);
         setError(null);
-        const query = `/api/gitnexus/coverage?repo=${encodeURIComponent(projectPath)}` + (wantsFresh ? '&refresh=1' : '');
-        fetch(routeUrl(query), {
-            signal: controller.signal,
-        })
-            .then(async (res) => ({ status: res.status, body: await res.json().catch(() => null) }))
-            .then(({ status, body }) => {
-            // `not-indexed` is a state the panel renders, not a failure: the whole
-            // point of leading with the initialize command is that reaching it is
-            // expected on a project that has never been analysed.
-            if (status === 404 && body?.code === 'not-indexed') {
-                setReport({ repo: { indexed: false, path: projectPath } });
-                setMaintenance(null);
-                setReadAt(body?.readAt ?? new Date().toISOString());
-                return;
+        setProgress({ percent: 0, label: '连接索引服务…' });
+        const query = `/api/gitnexus/coverage?repo=${encodeURIComponent(projectPath)}` +
+            (wantsFresh ? '&refresh=1' : '') +
+            '&stream=1';
+        const load = async () => {
+            try {
+                const res = await fetch(routeUrl(query), { signal: controller.signal });
+                const contentType = res.headers.get('content-type') ?? '';
+                if (contentType.includes('application/x-ndjson') && res.body !== null) {
+                    const reader = res.body.getReader();
+                    const decoder = new TextDecoder();
+                    const reports = [];
+                    let buffer = '';
+                    const consume = (line) => {
+                        if (line.trim() === '' || controller.signal.aborted)
+                            return;
+                        let message;
+                        try {
+                            message = JSON.parse(line);
+                        }
+                        catch {
+                            return;
+                        }
+                        if (message.type === 'progress') {
+                            const raw = typeof message.percent === 'number' ? message.percent : 0;
+                            const percent = Math.max(0, Math.min(100, Math.round(raw)));
+                            const label = typeof message.label === 'string' ? message.label : '读取索引…';
+                            setProgress({ percent, label });
+                            return;
+                        }
+                        if (message.type === 'report') {
+                            reports.push(message);
+                            return;
+                        }
+                        if (message.type === 'error') {
+                            throw new Error(typeof message.message === 'string' ? message.message : '读取索引失败。');
+                        }
+                    };
+                    for (;;) {
+                        const chunk = await reader.read();
+                        if (chunk.done)
+                            break;
+                        buffer += decoder.decode(chunk.value, { stream: true });
+                        let newline = buffer.indexOf('\n');
+                        while (newline >= 0) {
+                            const line = buffer.slice(0, newline);
+                            buffer = buffer.slice(newline + 1);
+                            consume(line);
+                            newline = buffer.indexOf('\n');
+                        }
+                    }
+                    buffer += decoder.decode();
+                    if (buffer.trim() !== '')
+                        consume(buffer);
+                    const payload = reports[0];
+                    if (payload === undefined)
+                        throw new Error('读取中断：没有收到完整报告。');
+                    if (controller.signal.aborted)
+                        return;
+                    setReport(payload.report);
+                    setMaintenance(payload.maintenance ?? null);
+                    setReadAt(typeof payload.readAt === 'string' ? payload.readAt : new Date().toISOString());
+                    return;
+                }
+                // An older host ignores `stream=1` and answers plain JSON. Drop the numeric
+                // channel and let the native progress element go indeterminate rather than
+                // leaving a frozen 0%.
+                setProgress(null);
+                const body = (await res.json().catch(() => null));
+                // `not-indexed` is a state the panel renders, not a failure: the whole
+                // point of leading with the initialize command is that reaching it is
+                // expected on a project that has never been analysed.
+                if (res.status === 404 && body?.code === 'not-indexed') {
+                    setReport({ repo: { indexed: false, path: projectPath } });
+                    setMaintenance(null);
+                    setReadAt(body?.readAt ?? new Date().toISOString());
+                    return;
+                }
+                if (!body?.ok || body.report === undefined) {
+                    throw new Error(body?.message ?? `请求失败 (${res.status})`);
+                }
+                setReport(body.report);
+                setMaintenance(body.maintenance ?? null);
+                setReadAt(typeof body.readAt === 'string' ? body.readAt : new Date().toISOString());
             }
-            if (!body?.ok)
-                throw new Error(body?.message ?? `请求失败 (${status})`);
-            setReport(body.report);
-            setMaintenance(body.maintenance ?? null);
-            setReadAt(typeof body.readAt === 'string' ? body.readAt : new Date().toISOString());
-        })
-            .catch((cause) => {
-            if (cause?.name !== 'AbortError')
-                setError(String(cause?.message ?? cause));
-        })
-            .finally(() => setBusy(false));
+            catch (cause) {
+                if (controller.signal.aborted)
+                    return;
+                const error = cause;
+                if (error?.name === 'AbortError')
+                    return;
+                setError(String(error?.message ?? cause));
+            }
+            finally {
+                if (!controller.signal.aborted) {
+                    setBusy(false);
+                    setProgress(null);
+                }
+            }
+        };
+        void load();
         return () => controller.abort();
     }, [projectPath, reloadToken]);
     const fallbackMaintenance = React.useMemo(() => (maintenance === null && projectPath !== null ? { commands: [], rationale: [] } : maintenance), [maintenance, projectPath]);
@@ -1524,6 +2333,7 @@ function CoveragePanel(props) {
         projectPath,
         context: projectPath === null ? contextDiagnostic(props) : null,
         busy,
+        progress,
         error,
         readAt,
         run,
@@ -1533,12 +2343,39 @@ function CoveragePanel(props) {
         // otherwise looks frozen.
         now: Date.now() + tick * 0,
         onRefresh: () => setReloadToken((n) => n + 1),
-        onStartRun: () => void startRun(),
+        onStartRun: (force) => void startRun(force),
         onCancelRun: () => void cancelRun(),
         installRun,
         installError,
         onInstall: () => void startInstall(),
         onCancelInstall: () => void cancelInstall(),
+        search: {
+            query: searchQuery,
+            onQueryChange: (value) => {
+                // Invalidate an in-flight search for the previous text: otherwise its
+                // response can land after the edit and repopulate a list that no longer
+                // matches the box. The sequence bump also makes its `finally` a no-op, so
+                // the spinner is cleared here.
+                searchSeq.current += 1;
+                setSearching(false);
+                setSearchQuery(value);
+                setSearchError(null);
+                setSearchResults(null);
+                setSearchMode(null);
+            },
+            onSubmit: () => void runSearch(),
+            onClear: clearSearch,
+            searching,
+            error: searchError,
+            mode: searchMode,
+            results: searchResults,
+            total: searchTotal,
+            truncated: searchTruncated,
+            warning: searchWarning,
+            copied: searchCopied,
+            onOpen: openSearchHit,
+            onCopy: copySearchHit,
+        },
     });
 }
 /** The tab chip's live title. */
@@ -1570,7 +2407,10 @@ function apply(ctx) {
     };
     safe('sidebarRightTabs', () => {
         ctx.inject(['sidebarRightTabs'], (svcCtx) => {
-            ctx.effect(() => svcCtx.sidebarRightTabs.register({
+            const tabs = svcCtx.sidebarRightTabs;
+            if (tabs === undefined)
+                return;
+            ctx.effect(() => tabs.register({
                 id: PLUGIN_ID,
                 kind: TAB_KIND,
                 title: () => 'GitNexus',
@@ -1589,6 +2429,20 @@ function apply(ctx) {
             }), `${PLUGIN_ID}: tab type`);
         });
     });
+    // The navigation controller the chat and the file strip already use. Optional:
+    // a profile without a right column simply leaves the module-level openers null,
+    // and a search-result click falls back to copying `path:line`.
+    safe('sidebarRight', () => {
+        ctx.inject(['sidebarRight'], (svcCtx) => {
+            const service = svcCtx.sidebarRight;
+            if (service === undefined || typeof service.openResource !== 'function')
+                return;
+            openResource = (address, options) => service.openResource(address, options);
+            if (typeof service.openResourceIn === 'function') {
+                openResourceIn = (sessionId, address, options) => service.openResourceIn?.(sessionId, address, options);
+            }
+        });
+    });
     safe('sidebar.right.pane.tab', () => {
         ctx.slots.inject('sidebar.right.pane.tab', () => ctx.slots.register({ name: 'sidebar.right.pane.tab', key: PLUGIN_ID }, CoveragePanel));
     });
@@ -1603,6 +2457,7 @@ module.exports = {
         PLUGIN_ID,
         TAB_KIND,
         routeUrl,
+        fileResourceAddress,
         formatBytes,
         fileSize,
         percent,
@@ -1628,6 +2483,7 @@ module.exports = {
         MetricGrid,
         Histogram,
         GitActivitySection,
+        FileHistorySection,
         ProvenanceBlock,
         MaintenanceSection,
         CapabilityStrip,