dsh-manage-session 0.5.3 → 0.5.6-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/client.js CHANGED
@@ -914,17 +914,6 @@ window.__ModuleLoader__.load({
914
914
  scope.set("enabled", checked);
915
915
  }
916
916
  })
917
- }), (0, react.createElement)(Row$1, {
918
- key: "history",
919
- title: translate(t, "card.history"),
920
- desc: translate(t, "card.history.desc"),
921
- control: (0, react.createElement)(Toggle$1, {
922
- checked: value.historyFiles ?? DEFAULT_CONFIG.historyFiles,
923
- disabled: !writable,
924
- onChange: (checked) => {
925
- scope.set("historyFiles", checked);
926
- }
927
- })
928
917
  }), (0, react.createElement)(Row$1, {
929
918
  key: "health",
930
919
  title: translate(t, "card.health"),
@@ -1121,317 +1110,6 @@ window.__ModuleLoader__.load({
1121
1110
  };
1122
1111
  }
1123
1112
  //#endregion
1124
- //#region src/client/history-panel.tsx
1125
- /**
1126
- * 养老院(会话历史文件)面板 —— 自 dsh-session-search-toggle `src/client/archive-panel.tsx`
1127
- * **迁入**并适配到本包的方法名。
1128
- *
1129
- * 与迁移前的关键差异(**两个操作刻意分开,不可互换**):
1130
- *
1131
- * | 操作 | 路由 | 改什么 | 可逆 |
1132
- * |---|---|---|---|
1133
- * | 取消归档状态 | `session-history-prune` | 只改归档数组 | ✅ 重启后会话回到侧边栏 |
1134
- * | 清理归档文件 | `session-history-purge` | **真删**转录目录 + 投影缓存 + 两处 id | ❌ 不可逆 |
1135
- *
1136
- * 「删除」一词在本面板**不存在** —— 旧文案承诺「删除」却只改了个数组,
1137
- * 是导致「点了确认没反应」那类误判的一部分。
1138
- * 体积**按行**显示(实测单条可从 0 到 23 MB,报一个总量没有意义),按钮上给所选小计。
1139
- */
1140
- /** 人类可读体积。 */
1141
- function fmtSize(bytes) {
1142
- if (!Number.isFinite(bytes) || bytes <= 0) return "0 B";
1143
- const units = [
1144
- "B",
1145
- "KB",
1146
- "MB",
1147
- "GB",
1148
- "TB"
1149
- ];
1150
- let value = bytes;
1151
- let unit = 0;
1152
- while (value >= 1024 && unit < units.length - 1) {
1153
- value /= 1024;
1154
- unit++;
1155
- }
1156
- return `${unit === 0 || value >= 100 ? Math.round(value) : value.toFixed(1)} ${units[unit]}`;
1157
- }
1158
- /** 养老院面板。 */
1159
- function HistoryPanel({ t, onClose }) {
1160
- const [items, setItems] = (0, react.useState)(null);
1161
- const [source, setSource] = (0, react.useState)("");
1162
- const [degraded, setDegraded] = (0, react.useState)("");
1163
- const [pendingRestart, setPendingRestart] = (0, react.useState)(0);
1164
- const [error, setError] = (0, react.useState)(null);
1165
- const [attempt, setAttempt] = (0, react.useState)(0);
1166
- const [selected, setSelected] = (0, react.useState)(/* @__PURE__ */ new Set());
1167
- const [busy, setBusy] = (0, react.useState)(null);
1168
- const [note, setNote] = (0, react.useState)(null);
1169
- /** 清理失败明细(逐条);空数组表示无失败。 */
1170
- const [failures, setFailures] = (0, react.useState)([]);
1171
- const [editing, setEditing] = (0, react.useState)(false);
1172
- (0, react.useEffect)(() => {
1173
- let cancelled = false;
1174
- setError(null);
1175
- callHostAny$1("session-history-list", {}).then((res) => {
1176
- if (cancelled) return;
1177
- if (res.ok === true && Array.isArray(res.items)) {
1178
- setItems(res.items);
1179
- setSource(typeof res.source === "string" ? res.source : "");
1180
- setDegraded(typeof res.degraded === "string" ? res.degraded : "");
1181
- setPendingRestart(typeof res.pendingRestart === "number" ? res.pendingRestart : 0);
1182
- } else setError(res.error ?? "读取归档列表失败");
1183
- });
1184
- return () => {
1185
- cancelled = true;
1186
- };
1187
- }, [attempt]);
1188
- (0, react.useEffect)(() => {
1189
- const onKey = (event) => {
1190
- if (event.key === "Escape") onClose();
1191
- };
1192
- document.addEventListener("keydown", onKey);
1193
- return () => {
1194
- document.removeEventListener("keydown", onKey);
1195
- };
1196
- }, [onClose]);
1197
- const toggleRow = (sessionId) => {
1198
- setSelected((prev) => {
1199
- const next = new Set(prev);
1200
- if (next.has(sessionId)) next.delete(sessionId);
1201
- else next.add(sessionId);
1202
- return next;
1203
- });
1204
- };
1205
- /** 进出编辑模式;离开时清空选择。 */
1206
- const toggleEditing = () => {
1207
- setEditing((prev) => !prev);
1208
- setSelected(/* @__PURE__ */ new Set());
1209
- setNote(null);
1210
- setFailures([]);
1211
- };
1212
- const toggleAll = () => {
1213
- setSelected((prev) => prev.size === (items?.length ?? 0) ? /* @__PURE__ */ new Set() : new Set((items ?? []).map((item) => item.sessionId)));
1214
- };
1215
- const selectedRows = (items ?? []).filter((item) => selected.has(item.sessionId));
1216
- const selectedBytes = selectedRows.reduce((sum, item) => sum + item.bytes + item.cacheBytes, 0);
1217
- const totalBytes = (items ?? []).reduce((sum, item) => sum + item.bytes + item.cacheBytes, 0);
1218
- /** 确认弹窗里的逐条摘要(清理时带体积,取消归档时不带)。 */
1219
- const summarise = (rows, withSize) => {
1220
- const lines = rows.slice(0, 5).map((row) => {
1221
- const label = row.title || translate(t, "panel.untitled");
1222
- const size = fmtSize(row.bytes + row.cacheBytes);
1223
- return withSize ? `· ${label} — ${size}` : `· ${label}`;
1224
- });
1225
- if (rows.length > 5) lines.push(`… 共 ${rows.length} 个`);
1226
- return lines.join("\n");
1227
- };
1228
- const confirm = (message) => typeof window !== "undefined" && typeof window.confirm === "function" ? window.confirm(message) : false;
1229
- /** 提交一次操作:确认 → 调用 → 刷新列表(列表以存储文件为准,因此立刻可见变化)。 */
1230
- const run = (kind, method, confirmText) => {
1231
- const rows = selectedRows;
1232
- if (rows.length === 0) return;
1233
- if (!confirm(confirmText)) return;
1234
- setBusy(kind);
1235
- setNote(null);
1236
- setFailures([]);
1237
- callHostAny$1(method, { sessionIds: rows.map((row) => row.sessionId) }, 6e4).then((res) => {
1238
- if (res.ok === true) {
1239
- if (kind === "unarchive") setNote(translate(t, "history.restartHint", {
1240
- removed: res.removed ?? rows.length,
1241
- remaining: res.remaining ?? "?"
1242
- }));
1243
- else {
1244
- const freed = fmtSize(res.freedBytes ?? 0);
1245
- const failed = res.failures?.length ?? 0;
1246
- setNote(failed === 0 ? translate(t, "history.purgeResult", {
1247
- purged: res.purged ?? rows.length,
1248
- size: freed
1249
- }) : translate(t, "history.purgePartial", {
1250
- purged: res.purged ?? rows.length,
1251
- size: freed,
1252
- failed
1253
- }));
1254
- setFailures(res.failures ?? []);
1255
- }
1256
- setSelected(/* @__PURE__ */ new Set());
1257
- setAttempt((n) => n + 1);
1258
- } else setNote(res.error ?? "操作失败");
1259
- }).catch((err) => setNote(`操作失败:${String(err instanceof Error ? err.message : err)}`)).finally(() => setBusy(null));
1260
- };
1261
- const unarchiveSelected = () => {
1262
- run("unarchive", "session-history-prune", translate(t, "history.confirmUnarchive", {
1263
- n: selectedRows.length,
1264
- summary: summarise(selectedRows, false)
1265
- }));
1266
- };
1267
- const purgeSelected = () => {
1268
- run("purge", "session-history-purge", translate(t, "history.confirmPurge", {
1269
- n: selectedRows.length,
1270
- summary: summarise(selectedRows, true),
1271
- size: fmtSize(selectedBytes)
1272
- }));
1273
- };
1274
- const children = [];
1275
- if (error !== null) children.push((0, react.createElement)("div", {
1276
- key: "err",
1277
- className: "dss_error"
1278
- }, [(0, react.createElement)("div", { key: "msg" }, error === "请求超时" ? "读取归档列表超时:Host 可能正忙,稍后重试。" : error), (0, react.createElement)("button", {
1279
- key: "retry",
1280
- type: "button",
1281
- className: "dss_actBtn",
1282
- style: { marginTop: "6px" },
1283
- onClick: () => {
1284
- setAttempt((n) => n + 1);
1285
- }
1286
- }, "重试")]));
1287
- else if (items === null) children.push((0, react.createElement)("div", {
1288
- key: "loading",
1289
- className: "dss_status"
1290
- }, translate(t, "history.loading")));
1291
- else if (items.length === 0) children.push((0, react.createElement)("div", {
1292
- key: "empty",
1293
- className: "dss_empty"
1294
- }, translate(t, "history.empty")));
1295
- else {
1296
- const allSelected = selected.size === items.length;
1297
- if (editing) children.push((0, react.createElement)("div", {
1298
- key: "manage",
1299
- className: "dss_btnRow",
1300
- style: { padding: "4px 10px 0" }
1301
- }, [
1302
- (0, react.createElement)("button", {
1303
- key: "all",
1304
- type: "button",
1305
- className: "dss_actBtn",
1306
- onClick: toggleAll
1307
- }, allSelected ? translate(t, "history.unselectAll") : translate(t, "history.selectAll")),
1308
- (0, react.createElement)("button", {
1309
- key: "unarchive",
1310
- type: "button",
1311
- className: "dss_actBtn",
1312
- disabled: busy !== null || selected.size === 0,
1313
- onClick: unarchiveSelected
1314
- }, busy === "unarchive" ? translate(t, "history.unarchiving") : translate(t, "history.unarchive", { n: selected.size })),
1315
- (0, react.createElement)("button", {
1316
- key: "purge",
1317
- type: "button",
1318
- className: "dss_actBtn dss_dangerBtn",
1319
- disabled: busy !== null || selected.size === 0,
1320
- onClick: purgeSelected
1321
- }, busy === "purge" ? translate(t, "history.purging") : translate(t, "history.purge", {
1322
- n: selected.size,
1323
- size: fmtSize(selectedBytes)
1324
- }))
1325
- ]));
1326
- children.push((0, react.createElement)("ul", {
1327
- key: "list",
1328
- className: "dss_list",
1329
- role: "list",
1330
- "aria-label": translate(t, "history.source.registry")
1331
- }, items.map((item) => (0, react.createElement)("li", {
1332
- key: item.sessionId,
1333
- className: "dss_row"
1334
- }, [
1335
- editing && (0, react.createElement)("label", {
1336
- key: "sel",
1337
- className: "dss_check"
1338
- }, [(0, react.createElement)("input", {
1339
- type: "checkbox",
1340
- checked: selected.has(item.sessionId),
1341
- onChange: () => {
1342
- toggleRow(item.sessionId);
1343
- }
1344
- })]),
1345
- (0, react.createElement)("span", {
1346
- key: "t",
1347
- className: "dss_rowTitle"
1348
- }, [(0, react.createElement)("span", {
1349
- key: "x",
1350
- className: "dss_titleText"
1351
- }, item.title || translate(t, "panel.untitled")), item.updatedAt > 0 && (0, react.createElement)("span", {
1352
- key: "tag",
1353
- className: "dss_tag"
1354
- }, fmtTime$2(item.updatedAt))]),
1355
- (0, react.createElement)("span", {
1356
- key: "size",
1357
- className: "dss_meta dss_size"
1358
- }, item.bytes + item.cacheBytes > 0 ? translate(t, "history.size", {
1359
- t: fmtSize(item.bytes),
1360
- c: fmtSize(item.cacheBytes)
1361
- }) : translate(t, "history.sizeUnknown")),
1362
- item.cwd !== "" && (0, react.createElement)("span", {
1363
- key: "c",
1364
- className: "dss_meta"
1365
- }, item.cwd),
1366
- (0, react.createElement)("span", {
1367
- key: "id",
1368
- className: "dss_meta dss_uuid"
1369
- }, item.sessionId)
1370
- ]))));
1371
- }
1372
- return (0, react.createElement)("div", { className: "dss_tabBody" }, [
1373
- note !== null && (0, react.createElement)("div", {
1374
- key: "note",
1375
- className: "dss_status"
1376
- }, note),
1377
- failures.length > 0 && (0, react.createElement)("div", {
1378
- key: "fail",
1379
- className: "dss_status dss_error"
1380
- }, [(0, react.createElement)("div", { key: "h" }, translate(t, "history.purgeFailures")), ...failures.slice(0, 10).map((failure, index) => (0, react.createElement)("div", {
1381
- key: `f${index}`,
1382
- className: "dss_meta"
1383
- }, `${failure.sessionId.slice(0, 22)}… — ${failure.reason}`))]),
1384
- editing && (0, react.createElement)("div", {
1385
- key: "hint",
1386
- className: "dss_status"
1387
- }, translate(t, "history.editingHint")),
1388
- degraded !== "" && (0, react.createElement)("div", {
1389
- key: "degraded",
1390
- className: "dss_status dss_warnText"
1391
- }, degraded),
1392
- pendingRestart > 0 && (0, react.createElement)("div", {
1393
- key: "pending",
1394
- className: "dss_status dss_warnText"
1395
- }, translate(t, "history.pendingRestart", { n: pendingRestart })),
1396
- source !== "" && (0, react.createElement)("div", {
1397
- key: "source",
1398
- className: "dss_metaLine"
1399
- }, translate(t, source === "registry" ? "history.source.registry" : source === "storage-file" ? "history.source.storage-file" : "history.source.none")),
1400
- items !== null && error === null && (0, react.createElement)("div", {
1401
- key: "count",
1402
- className: "dss_metaLine"
1403
- }, translate(t, "history.count", {
1404
- n: items.length,
1405
- size: fmtSize(totalBytes)
1406
- })),
1407
- (0, react.createElement)("div", {
1408
- key: "headBtns",
1409
- className: "dss_btnRow"
1410
- }, [(0, react.createElement)("button", {
1411
- key: "edit",
1412
- type: "button",
1413
- className: `dss_actBtn${editing ? " dss_editActive" : ""}`,
1414
- onClick: toggleEditing
1415
- }, editing ? translate(t, "history.done") : translate(t, "history.edit"))]),
1416
- ...children
1417
- ]);
1418
- }
1419
- /** 时间格式化(与迁移前一致)。 */
1420
- function fmtTime$2(ms) {
1421
- if (!ms || typeof ms !== "number") return "";
1422
- try {
1423
- const date = new Date(ms);
1424
- const now = /* @__PURE__ */ new Date();
1425
- const pad = (n) => String(n).padStart(2, "0");
1426
- const sameDay = date.getFullYear() === now.getFullYear() && date.getMonth() === now.getMonth() && date.getDate() === now.getDate();
1427
- const time = `${pad(date.getHours())}:${pad(date.getMinutes())}`;
1428
- if (sameDay) return time;
1429
- return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${time}`;
1430
- } catch {
1431
- return "";
1432
- }
1433
- }
1434
- //#endregion
1435
1113
  //#region src/client/health-panel.tsx
1436
1114
  /**
1437
1115
  * 体检面板:体检(五门)→ 处方(命令清单)→ 出院(可逆处置 + before/after 对照)。
@@ -3313,25 +2991,28 @@ window.__ModuleLoader__.load({
3313
2991
  //#endregion
3314
2992
  //#region src/client/panel.tsx
3315
2993
  /**
3316
- * 会话管家面板壳:一个侧边栏入口,两个页签(养老院 / 体检)。
2994
+ * 会话管家面板壳:一个侧边栏入口,两个页签(管理=主页面 / 体检=备用)。
2995
+ *
2996
+ * 2026-10-20 页面调整(用户定标):「养老院」页签取消——管理台已覆盖其全部
2997
+ * 动作面(archive/unarchive/purge + 归档域筛选),独立页签属重复入口;
2998
+ * 历史文件组件(history-panel.tsx)随摘除,宿主侧 history 路由与配置字段
2999
+ * (historyFiles)保留不动,字典键留用以备回迁。
3317
3000
  *
3318
- * 页签可见性由开关决定:`historyFiles=false` 时「养老院」消失,`healthCheck=false`
3319
- * 时「体检」消失;两者都关时进入面板直接显示空壳提示(客户端也会隐藏入口)。
3001
+ * 页签可见性由开关决定:`search=false` 时「管理」消失(退到体检),
3002
+ * `healthCheck=false` 时「体检」消失;两者都关时进入面板直接显示空壳提示
3003
+ * (客户端也会隐藏入口)。
3320
3004
  */
3321
3005
  /** 页签 id(导出供测试断言)。 */
3322
- const TAB_HISTORY = "dss-tab-history";
3323
3006
  const TAB_HEALTH = "dss-tab-health";
3324
3007
  const TAB_MANAGE = "dss-tab-manage";
3325
3008
  /** 会话管家对话框。 */
3326
- function StewardPanel({ t, historyFiles, healthCheck, searchEnabled = false, openSession, onClose }) {
3327
- const [tab, setTab] = (0, react.useState)(historyFiles ? "history" : healthCheck ? "health" : "manage");
3009
+ function StewardPanel({ t, healthCheck, searchEnabled = false, openSession, onClose }) {
3010
+ const [tab, setTab] = (0, react.useState)(searchEnabled ? "manage" : "health");
3328
3011
  (0, react.useEffect)(() => {
3329
- if (tab === "history" && !historyFiles && (healthCheck || searchEnabled)) setTab(healthCheck ? "health" : "manage");
3330
- if (tab === "health" && !healthCheck && (historyFiles || searchEnabled)) setTab(historyFiles ? "history" : "manage");
3331
- if (tab === "manage" && !searchEnabled && historyFiles) setTab("history");
3012
+ if (tab === "manage" && !searchEnabled && healthCheck) setTab("health");
3013
+ if (tab === "health" && !healthCheck && searchEnabled) setTab("manage");
3332
3014
  }, [
3333
3015
  tab,
3334
- historyFiles,
3335
3016
  healthCheck,
3336
3017
  searchEnabled
3337
3018
  ]);
@@ -3345,16 +3026,16 @@ window.__ModuleLoader__.load({
3345
3026
  };
3346
3027
  }, [onClose]);
3347
3028
  const tabs = [];
3348
- if (historyFiles) tabs.push((0, react.createElement)("button", {
3349
- key: TAB_HISTORY,
3350
- id: TAB_HISTORY,
3029
+ if (searchEnabled) tabs.push((0, react.createElement)("button", {
3030
+ key: TAB_MANAGE,
3031
+ id: TAB_MANAGE,
3351
3032
  type: "button",
3352
- className: `dss_tab${tab === "history" ? " dss_tabActive" : ""}`,
3353
- "aria-selected": tab === "history",
3033
+ className: `dss_tab${tab === "manage" ? " dss_tabActive" : ""}`,
3034
+ "aria-selected": tab === "manage",
3354
3035
  onClick: () => {
3355
- setTab("history");
3036
+ setTab("manage");
3356
3037
  }
3357
- }, translate(t, "panel.tab.history")));
3038
+ }, translate(t, "panel.tab.manage")));
3358
3039
  if (healthCheck) tabs.push((0, react.createElement)("button", {
3359
3040
  key: TAB_HEALTH,
3360
3041
  id: TAB_HEALTH,
@@ -3365,28 +3046,15 @@ window.__ModuleLoader__.load({
3365
3046
  setTab("health");
3366
3047
  }
3367
3048
  }, translate(t, "panel.tab.health")));
3368
- if (searchEnabled) tabs.push((0, react.createElement)("button", {
3369
- key: TAB_MANAGE,
3370
- id: TAB_MANAGE,
3371
- type: "button",
3372
- className: `dss_tab${tab === "manage" ? " dss_tabActive" : ""}`,
3373
- "aria-selected": tab === "manage",
3374
- onClick: () => {
3375
- setTab("manage");
3376
- }
3377
- }, translate(t, "panel.tab.manage")));
3378
- const body = tab === "history" && historyFiles ? (0, react.createElement)(HistoryPanel, {
3379
- t,
3380
- onClose
3381
- }) : tab === "health" && healthCheck ? (0, react.createElement)(HealthPanel, {
3382
- t,
3383
- onClose
3384
- }) : tab === "manage" && searchEnabled ? (0, react.createElement)("div", { style: {
3049
+ const body = tab === "manage" && searchEnabled ? (0, react.createElement)("div", { style: {
3385
3050
  display: "flex",
3386
3051
  flexDirection: "column",
3387
3052
  flex: "1 1 auto",
3388
3053
  minHeight: 0
3389
- } }, (0, react.createElement)(ManageConsole, { open: openSession ?? (() => {}) })) : (0, react.createElement)("div", { className: "dss_empty" }, translate(t, "card.enabled.desc"));
3054
+ } }, (0, react.createElement)(ManageConsole, { open: openSession ?? (() => {}) })) : tab === "health" && healthCheck ? (0, react.createElement)(HealthPanel, {
3055
+ t,
3056
+ onClose
3057
+ }) : (0, react.createElement)("div", { className: "dss_empty" }, translate(t, "card.enabled.desc"));
3390
3058
  return (0, react_dom.createPortal)((0, react.createElement)("div", { key: "steward-root" }, [(0, react.createElement)("div", {
3391
3059
  key: "backdrop",
3392
3060
  className: "dss_backdrop",
@@ -3439,6 +3107,269 @@ window.__ModuleLoader__.load({
3439
3107
  }, props.label) : null]);
3440
3108
  }
3441
3109
  //#endregion
3110
+ //#region src/client/search/locate.ts
3111
+ /** DRS fenced 路由(同源相对路径,与 dsh-reference-session-collector DRS_API_PATH 字面一致)。 */
3112
+ const DRS_ROUTE = "/api/dsh-reference-session-collector";
3113
+ /** 定位总超时(打开会话后 DOM 渲染窗口)。 */
3114
+ const LOCATE_TIMEOUT_MS = 8e3;
3115
+ /** 高亮驻留时长后自动摘除。 */
3116
+ const FLASH_MS = 6e3;
3117
+ /** needle 下限——短于此值的行("好的")歧义面太大,不值得定位。 */
3118
+ const MIN_NEEDLE_CHARS = 12;
3119
+ /** needle 上限——取前缀足够唯一,过长整串匹配反而更易被渲染差异打断。 */
3120
+ const MAX_NEEDLE_CHARS = 80;
3121
+ /** 驻留确认窗口:目标行在视口内稳定停留这么久才算跳转成功。 */
3122
+ const STICK_MS = 900;
3123
+ /** 翻页上限:24 页 × 宿主页宽足够任何真机会话;防无限拉页。 */
3124
+ const MAX_OLDER_PAGES = 24;
3125
+ /** 硬封顶:带翻页的定位窗口上限。 */
3126
+ const HARD_DEADLINE_MS = 3e4;
3127
+ /** 巡逻间隔:会话重渲染会换 DOM 节点,每轮重新定位。 */
3128
+ const TICK_MS = 350;
3129
+ /** 定位行在视口内的判定余量(顶部允许略出屏,代码块开头行高度不定)。 */
3130
+ const VISIBILITY_SLACK = 40;
3131
+ /** markdown 结构符与空白——DOM 渲染后不含这些,两侧同抹才能对上。 */
3132
+ const MATCH_NOISE_RE = /[\s`*_~#>|[\]()!,。:;、"'\\{}-]+/gu;
3133
+ /** 归一化比对文本:去空白与 markdown 噪声字符。 */
3134
+ function normalizeForMatch(text) {
3135
+ return text.replace(MATCH_NOISE_RE, "");
3136
+ }
3137
+ /**
3138
+ * 从段行选一条可定位 needle(按纯函数导出,供单测)。
3139
+ * @returns 归一化 needle;null=该行不可定位(被替换原文/无有效文本/过短歧义)。
3140
+ */
3141
+ function resolveNeedle(row) {
3142
+ if (row === void 0) return null;
3143
+ if (Number(row.on_surface ?? 1) === 0) return null;
3144
+ const sources = Number(row.compressed ?? 0) === 1 ? [
3145
+ row.surface_text,
3146
+ row.search_text,
3147
+ row.text
3148
+ ] : [row.search_text, row.text];
3149
+ for (const source of sources) {
3150
+ if (typeof source !== "string" || source === "") continue;
3151
+ const needle = normalizeForMatch(source.split("\n").find((line) => line.trim() !== "") ?? source).slice(0, MAX_NEEDLE_CHARS);
3152
+ if (needle.length >= MIN_NEEDLE_CHARS) return needle;
3153
+ const whole = normalizeForMatch(source).slice(0, MAX_NEEDLE_CHARS);
3154
+ if (whole.length >= MIN_NEEDLE_CHARS) return whole;
3155
+ }
3156
+ return null;
3157
+ }
3158
+ /** 正文候选标签:只取消息渲染会用的块级/内联代码标签——不含 div/span,
3159
+ * 否则搜索面板自己的结果行(dsws_snippet 的 span,文本就含 needle 前缀)会抢先命中。 */
3160
+ const MESSAGE_TAGS = "p, li, pre, blockquote, h1, h2, h3, h4, td, code";
3161
+ /** 阅读线偏移(dsh-tidy-display conversation-scroll.ts READING_LINE_OFFSET_PX 同值)。 */
3162
+ const READING_LINE_OFFSET_PX = 24;
3163
+ /** 有布局才叫可见:未挂载页签(display:none)的 rect 全 0,旧视口判定会误判驻留。 */
3164
+ function hasLayout(el) {
3165
+ return el.offsetHeight > 0 || el.offsetWidth > 0;
3166
+ }
3167
+ /** 祖先滚动盒(tidy-display 官方选择子);缺席时退化窗口滚动。 */
3168
+ function scrollerOf(el) {
3169
+ return el.closest("[data-conversation-scroll]");
3170
+ }
3171
+ /** 在滚动窗口坐标系里把行着陆到顶部偏读线位——**绝不 scrollIntoView**
3172
+ * (dsh-tidy-display 实锤:它会爬祖先 scroller 把 sticky composer 抬离底部,
3173
+ * 随后宿主回贴 = 「还停在底部」);与阅读模式 landTurn 同款 scrollTop 数学。 */
3174
+ function landRow(el, offsetPx = READING_LINE_OFFSET_PX) {
3175
+ const html = el;
3176
+ const port = scrollerOf(html) ?? el.ownerDocument.scrollingElement ?? html;
3177
+ if (port === html) {
3178
+ html.scrollIntoView({
3179
+ block: "start",
3180
+ behavior: "auto"
3181
+ });
3182
+ return;
3183
+ }
3184
+ port.scrollTop += html.getBoundingClientRect().top - port.getBoundingClientRect().top - offsetPx;
3185
+ }
3186
+ /** 行在**其滚动窗口**内是否已就位(驻留判定也用窗口系,不用视口系)。 */
3187
+ function landedInPort(el) {
3188
+ const html = el;
3189
+ if (!hasLayout(html)) return false;
3190
+ const port = scrollerOf(html);
3191
+ if (port === null) {
3192
+ const rect = html.getBoundingClientRect();
3193
+ const vh = html.ownerDocument.defaultView?.innerHeight ?? 0;
3194
+ return rect.top >= -40 && rect.bottom <= vh + VISIBILITY_SLACK;
3195
+ }
3196
+ const flow = html.getBoundingClientRect().top - port.getBoundingClientRect().top;
3197
+ return flow >= -40 && flow <= port.clientHeight + VISIBILITY_SLACK;
3198
+ }
3199
+ /** 阅读模式优先:命中行若落在 [data-reader-turn] 段内,直接返该段(turn 级
3200
+ * 锚点由插件自标,比文本匹配稳);env.turn 给定时还能直接按 turn 号选段。 */
3201
+ function findReaderRow(root, needle, turn) {
3202
+ if (turn !== void 0 && turn > 0) {
3203
+ const direct = root.querySelector(`[data-reader-turn="${String(turn)}"]`);
3204
+ if (direct !== null && hasLayout(direct)) return direct;
3205
+ }
3206
+ for (const el of Array.from(root.querySelectorAll(MESSAGE_TAGS))) {
3207
+ if (!hasLayout(el)) continue;
3208
+ if (el.closest("[class*=\"dsws_\"], [role=\"dialog\"]") !== null) continue;
3209
+ const text = el.textContent;
3210
+ if (text === null || !normalizeForMatch(text).includes(needle)) continue;
3211
+ const section = el.closest("[data-reader-turn]");
3212
+ if (section !== null && hasLayout(section)) return section;
3213
+ return el;
3214
+ }
3215
+ return null;
3216
+ }
3217
+ /**
3218
+ * 找正文行:多义时取 DOM 最深者(段落本体而非包裹层);**排除插件自家
3219
+ * 子树**(dsws_ 前缀类与任何 role=dialog 弹层)——面板行/管理台行都是
3220
+ * 目标文本的镜像,绝不允许当作跳转目的地。
3221
+ */
3222
+ function findMessageElement(root, needle, turn) {
3223
+ const reader = findReaderRow(root, needle, turn);
3224
+ if (reader !== null) return reader;
3225
+ let best = null;
3226
+ let bestDepth = -1;
3227
+ for (const el of Array.from(root.querySelectorAll(MESSAGE_TAGS))) {
3228
+ if (!hasLayout(el)) continue;
3229
+ const text = el.textContent;
3230
+ if (text === null) continue;
3231
+ if (el.closest("[class*=\"dsws_\"], [role=\"dialog\"]") !== null) continue;
3232
+ if (!normalizeForMatch(text).includes(needle)) continue;
3233
+ if (el.closest("[data-reader-turn]") !== null) continue;
3234
+ let depth = 0;
3235
+ for (let n = el.parentElement; n !== null; n = n.parentElement) depth += 1;
3236
+ if (depth > bestDepth) {
3237
+ best = el;
3238
+ bestDepth = depth;
3239
+ }
3240
+ }
3241
+ return best;
3242
+ }
3243
+ /** 瞬时高亮:类切换(不写 inline 样式——真机教训:prepend 历史后 React 复用
3244
+ * 节点,定时器迟到把旧样式写在不相干元素上)。首次使用时惰性注入样式表。 */
3245
+ const FLASH_CLASS = "dss-located-flash";
3246
+ let flashCssReady = false;
3247
+ function ensureFlashCss(doc) {
3248
+ if (flashCssReady) return;
3249
+ flashCssReady = true;
3250
+ const style = doc.createElement("style");
3251
+ style.textContent = `.${FLASH_CLASS}{outline:2px solid var(--dsw-alias-accent,#4a9eff);outline-offset:2px;transition:outline 120ms ease}`;
3252
+ doc.head.appendChild(style);
3253
+ }
3254
+ function flashElement(el) {
3255
+ if (el.ownerDocument !== null) ensureFlashCss(el.ownerDocument);
3256
+ el.setAttribute("data-dss-located", "1");
3257
+ el.classList.add(FLASH_CLASS);
3258
+ setTimeout(() => {
3259
+ el.classList.remove(FLASH_CLASS);
3260
+ el.removeAttribute("data-dss-located");
3261
+ }, FLASH_MS);
3262
+ }
3263
+ let injectedDeps = {};
3264
+ /** 接线点:client apply 调一次;未接线时定位退化为 v3 纯 DOM 巡逻。 */
3265
+ function configureLocator(deps) {
3266
+ injectedDeps = deps;
3267
+ }
3268
+ /** 目标行是否基本完整落在**其滚动窗口**内由 landedInPort 判定;旧视口函数已废弃。 */
3269
+ /**
3270
+ * 主管线:拉 DRS 段行 → 选 needle → 巡逻宿主 DOM 补滚 → 驻留后高亮。
3271
+ * fire-and-forget 语义:任何一步不满足都 resolve(false),从不抛。
3272
+ */
3273
+ async function locateSearchHit(hit, env = {}) {
3274
+ const fetchImpl = env.fetchImpl ?? globalThis.fetch;
3275
+ const doc = env.doc ?? (typeof document === "undefined" ? void 0 : document);
3276
+ if (doc === void 0) return false;
3277
+ const win = env.win ?? doc.defaultView ?? (typeof window === "undefined" ? void 0 : window);
3278
+ if (win === void 0) return false;
3279
+ const log = env.log ?? ((message) => {
3280
+ console.debug(`[dsh-manage-session] ${message}`);
3281
+ });
3282
+ try {
3283
+ const response = await fetchImpl(`${DRS_ROUTE}?op=session&session=${encodeURIComponent(hit.sessionId)}`);
3284
+ if (!response.ok) {
3285
+ log(`locate: drs http ${String(response.status)}`);
3286
+ return false;
3287
+ }
3288
+ const body = await response.json();
3289
+ if (body.ok !== true || !Array.isArray(body.rows)) {
3290
+ log("locate: drs envelope shape");
3291
+ return false;
3292
+ }
3293
+ const row = body.rows.find((r) => Number(r.seq) === Number(hit.seq));
3294
+ const needle = resolveNeedle(row);
3295
+ if (needle === null) {
3296
+ log(`locate: skip row seq=${String(hit.seq)} (shadowed/短文本/无行)`);
3297
+ return false;
3298
+ }
3299
+ const targetTurn = typeof row?.turn === "number" ? row.turn : void 0;
3300
+ const startedAt = Date.now();
3301
+ let deadline = startedAt + (env.timeoutMs ?? LOCATE_TIMEOUT_MS);
3302
+ const hardDeadline = startedAt + HARD_DEADLINE_MS;
3303
+ let lastScrollAt = 0;
3304
+ let userTookOver = false;
3305
+ const pullOlder = env.loadOlder ?? injectedDeps.loadOlder;
3306
+ let pagesPulled = 0;
3307
+ let pullInFlight = false;
3308
+ let lastPullAt = 0;
3309
+ const USER_EVENTS = [
3310
+ "wheel",
3311
+ "touchstart",
3312
+ "keydown",
3313
+ "pointerdown"
3314
+ ];
3315
+ const onUser = () => {
3316
+ userTookOver = true;
3317
+ };
3318
+ return await new Promise((resolve) => {
3319
+ const finish = (ok, why) => {
3320
+ clearInterval(ticker);
3321
+ for (const ev of USER_EVENTS) win.removeEventListener(ev, onUser);
3322
+ log(`${why}: seq=${String(hit.seq)} ${hit.sessionId.slice(0, 12)} +${String(Date.now() - startedAt)}ms`);
3323
+ resolve(ok);
3324
+ };
3325
+ for (const ev of USER_EVENTS) win.addEventListener(ev, onUser, {
3326
+ passive: true,
3327
+ once: true
3328
+ });
3329
+ const ticker = setInterval(() => {
3330
+ if (userTookOver) {
3331
+ finish(false, "yield user");
3332
+ return;
3333
+ }
3334
+ if (Date.now() >= deadline) {
3335
+ finish(false, `locate timeout (pages=${String(pagesPulled)})`);
3336
+ return;
3337
+ }
3338
+ const el = findMessageElement(doc.body ?? doc, needle, targetTurn);
3339
+ if (el === null) {
3340
+ if (pullOlder !== void 0 && !pullInFlight && pagesPulled < MAX_OLDER_PAGES && deadline < hardDeadline && Date.now() - lastPullAt >= TICK_MS * 2) {
3341
+ pullInFlight = true;
3342
+ lastPullAt = Date.now();
3343
+ Promise.resolve().then(() => pullOlder()).then((pulled) => {
3344
+ if (pulled) {
3345
+ pagesPulled += 1;
3346
+ deadline = Math.min(hardDeadline, Date.now() + 2e3 + (env.timeoutMs ?? LOCATE_TIMEOUT_MS) / 2);
3347
+ } else deadline = Math.min(deadline, Date.now());
3348
+ }).catch(() => {}).finally(() => {
3349
+ pullInFlight = false;
3350
+ });
3351
+ }
3352
+ return;
3353
+ }
3354
+ if (landedInPort(el)) {
3355
+ if (lastScrollAt === 0 || Date.now() - lastScrollAt >= STICK_MS) {
3356
+ flashElement(el);
3357
+ finish(true, "located");
3358
+ }
3359
+ return;
3360
+ }
3361
+ if (Date.now() - lastScrollAt >= TICK_MS) {
3362
+ landRow(el);
3363
+ lastScrollAt = Date.now();
3364
+ }
3365
+ }, TICK_MS);
3366
+ });
3367
+ } catch (err) {
3368
+ log(`locate error(silent): ${String(err instanceof Error ? err.message : err)}`);
3369
+ return false;
3370
+ }
3371
+ }
3372
+ //#endregion
3442
3373
  //#region src/client/search/platform.ts
3443
3374
  /**
3444
3375
  * Resolve the running platform string, three tiers deep.
@@ -3748,6 +3679,7 @@ window.__ModuleLoader__.load({
3748
3679
  const [archivedFilter, setArchivedFilter] = (0, react.useState)("all");
3749
3680
  const [dateFrom, setDateFrom] = (0, react.useState)("");
3750
3681
  const [dateTo, setDateTo] = (0, react.useState)("");
3682
+ const [locateStatus, setLocateStatus] = (0, react.useState)({});
3751
3683
  const [sortBy, setSortByState] = (0, react.useState)(readStoredSort);
3752
3684
  const setSortBy = (next) => {
3753
3685
  writeStoredSort(next);
@@ -4034,6 +3966,16 @@ window.__ModuleLoader__.load({
4034
3966
  className: "dsws_row",
4035
3967
  onClick: () => {
4036
3968
  open(item.sessionId);
3969
+ setLocateStatus((s) => ({
3970
+ ...s,
3971
+ [item.sessionId]: "pending"
3972
+ }));
3973
+ locateSearchHit(item).then((ok) => {
3974
+ setLocateStatus((s) => ({
3975
+ ...s,
3976
+ [item.sessionId]: ok ? "ok" : "fail"
3977
+ }));
3978
+ });
4037
3979
  }
4038
3980
  }, [(0, react.createElement)("span", {
4039
3981
  key: "t",
@@ -4050,7 +3992,12 @@ window.__ModuleLoader__.load({
4050
3992
  (0, react.createElement)("span", {
4051
3993
  key: "time",
4052
3994
  className: "dsws_tag"
4053
- }, fmtTime(item.updatedAt))
3995
+ }, fmtTime(item.updatedAt)),
3996
+ ...locateStatus[item.sessionId] === void 0 ? [] : [(0, react.createElement)("span", {
3997
+ key: "loc",
3998
+ className: "dsws_tag",
3999
+ title: locateStatus[item.sessionId] === "pending" ? "定位巡逻中" : locateStatus[item.sessionId] === "ok" ? "已跳转到命中行" : "未能定位(行未渲染/文本被拆分/超时)"
4000
+ }, locateStatus[item.sessionId] === "pending" ? "⏳" : locateStatus[item.sessionId] === "ok" ? "✓" : "✗")]
4054
4001
  ]), (0, react.createElement)("span", {
4055
4002
  key: "s",
4056
4003
  className: "dsws_snippet"
@@ -4901,23 +4848,14 @@ window.__ModuleLoader__.load({
4901
4848
  .dss_tabBody{display:flex;flex-direction:column;gap:8px;padding-top:8px}
4902
4849
  .dss_actBtn{border:1px solid var(--dsw-alias-border-l2,#e5e7eb);background:transparent;border-radius:8px;padding:4px 10px;cursor:pointer;font-size:12px;color:var(--dsw-alias-label-primary,#111827)}
4903
4850
  .dss_actBtn:disabled{opacity:.5;cursor:default}
4904
- .dss_dangerBtn{border-color:var(--dsw-alias-state-error-primary,#dc2626);color:var(--dsw-alias-state-error-primary,#dc2626)}
4905
- .dss_editActive{background:var(--dsw-alias-interactive-bg-active,rgba(63,99,216,.12))}
4906
4851
  .dss_btnRow{display:flex;gap:6px;flex-wrap:wrap;align-items:center}
4907
4852
  .dss_list{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:4px}
4908
4853
  .dss_row{display:flex;gap:8px;align-items:center;padding:5px 8px;border-radius:8px;border:1px solid transparent}
4909
4854
  .dss_row:hover{border-color:var(--dsw-alias-border-l2,#e5e7eb)}
4910
- .dss_rowTitle{display:flex;gap:6px;align-items:center;flex:1 1 auto;min-width:0}
4911
- .dss_titleText{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
4912
- .dss_tag{font-size:11px;color:var(--dsw-alias-label-tertiary,#9ca3af)}
4913
4855
  .dss_meta{font-size:11px;color:var(--dsw-alias-label-tertiary,#9ca3af)}
4914
- .dss_metaLine{font-size:11px;color:var(--dsw-alias-label-tertiary,#9ca3af)}
4915
4856
  .dss_uuid{font-family:var(--ds-font-family-code,monospace)}
4916
4857
  /* 按行的磁盘占用:右对齐、不参与标题压缩,方便纵向比对「哪条最占地方」。 */
4917
- .dss_size{flex:none;font-variant-numeric:tabular-nums;white-space:nowrap}
4918
- .dss_check{display:inline-flex;align-items:center}
4919
4858
  .dss_status{font-size:12px;color:var(--dsw-alias-label-secondary,#6b7280)}
4920
- .dss_warnText{color:var(--dsw-alias-state-warning-primary,#d97706)}
4921
4859
  .dss_error{font-size:12px;color:var(--dsw-alias-state-error-primary,#dc2626)}
4922
4860
  .dss_empty{font-size:12px;color:var(--dsw-alias-label-tertiary,#9ca3af);padding:10px 2px}
4923
4861
  .dss_gateList{display:flex;flex-direction:column;gap:6px}
@@ -4994,6 +4932,16 @@ window.__ModuleLoader__.load({
4994
4932
  const openSearchHit = (sessionId) => {
4995
4933
  openSessionThrough((name) => ctx.get(name), sessionId);
4996
4934
  };
4935
+ configureLocator({ loadOlder: async () => {
4936
+ try {
4937
+ const conv = ctx.get("conversation");
4938
+ if (conv === void 0 || typeof conv.loadOlder !== "function") return false;
4939
+ await conv.loadOlder();
4940
+ return true;
4941
+ } catch {
4942
+ return false;
4943
+ }
4944
+ } });
4997
4945
  slots.inject("sidebar.footer.action", () => slots.register({
4998
4946
  name: "sidebar.footer.action",
4999
4947
  id: "dsh-search-index",
@@ -5126,10 +5074,9 @@ window.__ModuleLoader__.load({
5126
5074
  ...DEFAULT_CONFIG,
5127
5075
  ...snapshot.value ?? {}
5128
5076
  };
5129
- const historyFiles = config.historyFiles !== false;
5130
5077
  const healthCheck = config.healthCheck !== false;
5131
5078
  const searchEnabled = config.search !== false;
5132
- const visible = config.enabled !== false && (historyFiles || healthCheck || searchEnabled);
5079
+ const visible = config.enabled !== false && (healthCheck || searchEnabled);
5133
5080
  const wide = props.wide === true;
5134
5081
  const label = translate(void 0, "panel.title");
5135
5082
  if (!visible) return (0, react.createElement)("span", { className: "dss_entryWrap" });
@@ -5143,7 +5090,6 @@ window.__ModuleLoader__.load({
5143
5090
  }
5144
5091
  }), open ? (0, react.createElement)(StewardPanel, {
5145
5092
  key: "panel",
5146
- historyFiles,
5147
5093
  healthCheck,
5148
5094
  searchEnabled,
5149
5095
  openSession: props.openSession,
@@ -5173,7 +5119,6 @@ window.__ModuleLoader__.load({
5173
5119
  exports.STEWARD_SETTINGS_NAMESPACE = STEWARD_SETTINGS_NAMESPACE;
5174
5120
  exports.StewardEntry = StewardEntry;
5175
5121
  exports.TAB_HEALTH = TAB_HEALTH;
5176
- exports.TAB_HISTORY = TAB_HISTORY;
5177
5122
  exports.apply = apply;
5178
5123
  exports.inject = inject;
5179
5124
  exports.translate = translate;