dsh-meili-search 0.2.0 → 1.0.0

package/README.md

@@ -26,16 +26,27 @@
 
 ## 数据模型
 
-索引 `dsh_sessions`(固定)的文档 = 每条 user/assistant 消息按 ≤4000 码元切块:
+索引 `dsh_sessions`(固定)的文档 = 消息/思考/工具调用按 ≤4000 码元切块:
 
 ```
-{ id: "<sessionId>-<chunk>", sessionId, workspace, seq, mseq, role, text }
+{ id: "<sessionId>-<chunk>", sessionId, workspace, seq, mseq, role, subagent, text }
 ```
 
 - `mseq`: 消息在会话 zstd 日志中的顶层行 seq(客户端跳转定位用)
-- `role`: user | assistant
+- `role`: `user` | `assistant` | `reasoning` | `tool`(四桶可配置, 见下)
+- `subagent`: 该分块所属会话是否为 subagent 会话(委托深度>0 / origin=subagent / 无 `session-` 前缀目录)
 - 检索开启 `attributesToHighlight`(`«»` 标记)与 `showMatchesPosition`(`_matchesPosition` 为 UTF-8 字节偏移)
 
+### 索引范围(可配置)
+
+- 默认只收 **user(用户输入) + assistant(agent 回复正文)**; `reasoning`(agent 思考块)与 `tool`(工具调用名+参数)为**备选桶**, 默认不收。
+- 配置: `Settings → General` 或 `PUT /dsh-meili/v1/settings` 提交
+  `{"indexScope": ["user","assistant","reasoning","tool"], "includeSubagents": true}`;
+  环境变量 `MEILI_SCOPE="user,assistant,reasoning,tool"`、`MEILI_INCLUDE_SUBAGENTS=false` 亦可。
+- `includeSubagents` 默认 true(subagent 会话也纳入索引); false 则扫描时跳过。
+- 修改范围/开关后会自动清空同步游标并全量重灌, 使旧角色文档退出索引。
+- `role`/`subagent` 为 filterable, 可在检索时过滤(如排除思考、只查 subagent)。
+
 ## 同步机制
 
 ```

package/client.js

@@ -14,7 +14,7 @@ window.__ModuleLoader__.load({
     var exports = module.exports;
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     const React = require("react");
-    const { useState, useEffect, useRef } = React;
+    const { useState, useEffect, useRef, useLayoutEffect } = React;
 
     const API = "/dsh-meili/v1/search";
     const INDEX = "dsh_sessions";
@@ -260,11 +260,11 @@ window.__ModuleLoader__.load({
       return s <= 0 ? `${n}${unit}前` : `${n}${unit}后`;
     }
     function settingsRow(label, hint, control) {
-      return React.createElement("div", { style: { display: "flex", gap: 12, alignItems: "flex-start", padding: "10px 0", borderTop: "1px solid rgba(128,132,148,.18)" } },
-        React.createElement("div", { style: { flex: "0 0 190px" } },
-          React.createElement("div", { style: { fontWeight: 600 } }, label),
-          hint ? React.createElement("div", { style: { color: "var(--dsh-text-secondary, #8a90a5)", fontSize: 12, marginTop: 2 } }, hint) : null),
-        React.createElement("div", { style: { flex: 1, minWidth: 0 } }, control));
+      return React.createElement("div", { style: { display: "flex", alignItems: "flex-start", justifyContent: "space-between", gap: 24, padding: "16px 0", borderBottom: "1px solid var(--dsw-alias-border-l2, rgba(128,132,148,.18))" } },
+        React.createElement("div", { style: { flex: 1, minWidth: 0 } },
+          React.createElement("div", { style: { fontSize: 14, lineHeight: "22px", color: "var(--dsw-alias-label-primary)" } }, label),
+          hint ? React.createElement("div", { style: { color: "var(--dsh-text-secondary, #8a90a5)", fontSize: 12, lineHeight: "18px", marginTop: 4 } }, hint) : null),
+        React.createElement("div", { style: { flex: "none", minWidth: 0, maxWidth: "72%", paddingTop: 1 } }, control));
     }
     function MeiliSettingsCard() {
       const [cfg, setCfg] = useState(null);
@@ -273,10 +273,53 @@ window.__ModuleLoader__.load({
       const [keyText, setKeyText] = useState("");
       const keyDirty = useRef(false);
       const [stat, setStat] = useState(null);
+      const [hist, setHist] = useState([]); // 文档数历史 [[ts,docs],...]
       const [busy, setBusy] = useState(false);
       const [saved, setSaved] = useState(false);
       const [reidx, setReidx] = useState({ busy: false, msg: "" });
+      const [scope, setScope] = useState(null);        // null=未加载; 数组=当前选中的 role 桶
+      const [subInc, setSubInc] = useState(true);      // 是否包含 subagent 会话
+      const [scopeDirty, setScopeDirty] = useState(false);
+      const [scopeMsg, setScopeMsg] = useState("");
+      const [scopeTick, setScopeTick] = useState(0); // 每次范围变更 +1
+      const [throttleMs, setThrottleMs] = useState(250); // 批次间停顿(写入限速); 0=不限速
+      const [throttleText, setThrottleText] = useState("250"); // 数字框可编辑文本
+      const [fx, setFx] = useState([]);              // 方向性进出场瞬态动画层
+      const fxId = useRef(0);
+      const scopeMirror = useRef(["user", "assistant"]); // scope 的同步镜像, 供 toggle 计算方向
+      const lastScope = useRef(null);
+      const lastSub = useRef(true);
       const saveTimer = useRef(null);
+      const barRef = useRef(null);
+      const [barW, setBarW] = useState(0);   // 轨道实际像素宽(决定格子/蓝块几何, 全数值化避免 calc 误差)
+      const labelW = useRef(null);           // 各标签 13px 600 实测宽度: {user: px, ...}
+      useLayoutEffect(() => {
+        const el = barRef.current;
+        if (!el) return undefined;
+        const upd = () => setBarW(el.offsetWidth || 0);
+        upd();
+        const ro = new ResizeObserver(upd);
+        ro.observe(el);
+        return () => ro.disconnect();
+      }, []);
+      useEffect(() => {
+        try {
+          const c = document.createElement("canvas");
+          const ctx = c.getContext("2d");
+          const m = {};
+          SCOPE_ITEMS.forEach((it) => { ctx.font = "600 13px ui-sans-serif, system-ui, sans-serif"; m[it.k] = Math.ceil(ctx.measureText(it.label).width); });
+          labelW.current = m;
+        } catch { labelW.current = {}; }
+        // 触发一次重绘使用实测宽度
+        setBarW((w) => w || 336);
+      }, []);
+      const SCOPE_ITEMS = [
+        { k: "user", label: "user" },
+        { k: "assistant", label: "assistant" },
+        { k: "reasoning", label: "reasoning" },
+        { k: "tool", label: "tool" },
+      ];
+      const GAP = 25; // 角色间距 = 3.5 × 字母 a 宽(12px 字号 a≈7px)
 
       useEffect(() => {
         (async () => {
@@ -287,16 +330,26 @@ window.__ModuleLoader__.load({
               setCfg(b.settings);
               setAutoText(String(b.settings.autoSyncMs));
               setUrlText(b.settings.url || "");
+              if (Number.isFinite(b.settings.throttleMs)) { setThrottleMs(b.settings.throttleMs); setThrottleText(String(b.settings.throttleMs)); }
+              if (Array.isArray(b.settings.indexScope)) { setScope(b.settings.indexScope.slice()); scopeMirror.current = b.settings.indexScope.slice(); }
+              if (typeof b.settings.includeSubagents === "boolean") { setSubInc(b.settings.includeSubagents); lastSub.current = b.settings.includeSubagents; }
             }
           } catch {}
         })();
-        const t = setInterval(async () => {
+        const poll = async () => {
           try {
             const r = await fetch(STATUS_API);
             const b = await r.json();
             if (b.ok) setStat(b);
           } catch {}
-        }, 3000);
+          try {
+            const r2 = await fetch("/dsh-meili/v1/docs-history");
+            const b2 = await r2.json();
+            if (b2.ok && Array.isArray(b2.points)) setHist(b2.points);
+          } catch {}
+        };
+        poll(); // 挂载立即拉一次, 避免首帧长时间处于“…”占位
+        const t = setInterval(poll, 3000);
         return () => { clearInterval(t); clearTimeout(saveTimer.current); };
       }, []);
 
@@ -336,9 +389,89 @@ window.__ModuleLoader__.load({
         } catch (e) { setReidx({ busy: false, msg: "失败: " + String((e && e.message) || e) }); }
       };
 
+      const toggleScope = (k) => {
+        const prev = scopeMirror.current;                       // 点击前的真实选中集
+        const next = prev.slice();
+        const i = next.indexOf(k);
+        const added = i < 0;
+        if (added) next.push(k); else if (next.length > 1) next.splice(i, 1); // 最少保留一格
+        lastScope.current = prev;
+        scopeMirror.current = next;
+        setScope(next);
+        setScopeDirty(true);
+        setScopeMsg("");
+        setScopeTick((t) => t + 1);
+        // 方向性进出场: 邻左→从左延伸/收缩; 邻右→从右; 两侧→两边向中间; 孤立→淡入淡出
+        const idx = SCOPE_ITEMS.findIndex((it) => it.k === k);
+        const hasL = (arr) => idx > 0 && arr.includes(SCOPE_ITEMS[idx - 1].k);
+        const hasR = (arr) => idx < SCOPE_ITEMS.length - 1 && arr.includes(SCOPE_ITEMS[idx + 1].k);
+        const l = hasL(next), r = hasR(next);
+        const dir = (!l && !r) ? "I" : (l && r ? "B" : (l ? "L" : "R"));
+        const id = ++fxId.current;
+        setFx((f) => [...f, { id, idx, mode: added ? "in" : "out", dir }]);
+        setTimeout(() => setFx((f) => f.filter((x) => x.id !== id)), 380);
+      };
+      const saveScope = async () => {
+        const cur = (scope && scope.length) ? scope : ["user", "assistant"];
+        setBusy(true);
+        try {
+          const r = await fetch(SETTINGS_API, { method: "PUT", headers: { "content-type": "application/json" }, body: JSON.stringify({ indexScope: cur, includeSubagents: subInc }) });
+          const b = await r.json();
+          if (b.ok && b.settings) {
+            setCfg(b.settings);
+            if (Array.isArray(b.settings.indexScope)) { setScope(b.settings.indexScope.slice()); scopeMirror.current = b.settings.indexScope.slice(); }
+            if (typeof b.settings.includeSubagents === "boolean") setSubInc(b.settings.includeSubagents);
+            setScopeDirty(false);
+            setScopeMsg("已自动保存，10 秒无操作后更新索引");
+          } else setScopeMsg("保存失败: " + (b && b.error || r.status));
+        } catch (e) { setScopeMsg("保存失败: " + String((e && e.message) || e)); }
+        finally { setBusy(false); }
+      };
+      // 自动保存: 范围/subagent 变化后 600ms 防抖 PUT(索引变更由服务端按角色差集 + 10s 防抖执行)
+      const scopeSaveTimer = useRef(null);
+      useEffect(() => {
+        if (scopeDirty && scope !== null) {
+          if (scopeSaveTimer.current) clearTimeout(scopeSaveTimer.current);
+          scopeSaveTimer.current = setTimeout(() => saveScope(), 600);
+          setScopeMsg("将自动保存…");
+        }
+        return () => { if (scopeSaveTimer.current) clearTimeout(scopeSaveTimer.current); };
+      }, [scope, subInc, scopeDirty]);
+
+      // ---- 写入限速滑杆: 批次间停顿 ms(p)=2250*(1-p)^2 → p=2/3 处恰 250ms(本机推荐); 右端 0ms=不限速 ----
+      const THROTTLE_MAX = 2250;
+      const msFromP = (p) => Math.round(THROTTLE_MAX * Math.pow(1 - Math.min(1, Math.max(0, p)), 2));
+      const pFromMs = (ms) => 1 - Math.sqrt(Math.min(THROTTLE_MAX, Math.max(0, ms)) / THROTTLE_MAX);
+      const saveThrottle = async (v) => {
+        try {
+          await fetch(SETTINGS_API, { method: "PUT", headers: { "content-type": "application/json" }, body: JSON.stringify({ throttleMs: v }) });
+        } catch {}
+      };
+      const throttleTimer = useRef(null);
+      const applyThrottle = (ms) => {
+        const v = Math.max(0, Math.min(THROTTLE_MAX, Math.round(ms)));
+        setThrottleMs(v);
+        setThrottleText(String(v));
+        if (throttleTimer.current) clearTimeout(throttleTimer.current);
+        throttleTimer.current = setTimeout(() => saveThrottle(v), 800); // 停手 800ms 后自动保存
+      };
+      const onThrottleText = (raw) => {
+        setThrottleText(raw);
+        if (raw === "" || !Number.isFinite(Number(raw))) return; // 编辑中/非法: 等失焦
+        applyThrottle(Number(raw));
+      };
+      const commitThrottleText = () => {
+        const n = Number(throttleText);
+        applyThrottle(Number.isFinite(n) ? n : throttleMs); // 失焦时提交或回退
+      };
+      useEffect(() => () => { if (throttleTimer.current) clearTimeout(throttleTimer.current); }, []);
+
       const idx = (cfg && cfg.index) || INDEX;
       const docs = stat && stat.indexes ? stat.indexes[idx] : undefined;
-      const meiliOk = typeof docs === "number" && docs >= 0;
+      const loading = stat === null; // 首帧/加载中: 未拿到 /status 前不渲染“失败”
+      const meiliOk = !loading && typeof docs === "number" && docs >= 0;
+      const docsView = loading ? "…" : (typeof docs === "number" ? (docs >= 0 ? String(docs) : "连接失败") : "—");
+      const docsColor = meiliOk || loading ? "inherit" : "var(--dsh-state-error-primary, #e5534b)";
 
       const autoControl = React.createElement("div", null, [
         React.createElement("div", { key: "row", style: { display: "flex", gap: 8, alignItems: "center", flexWrap: "wrap" } },
@@ -347,13 +480,49 @@ window.__ModuleLoader__.load({
         React.createElement("div", { key: "hint", style: { color: "var(--dsh-text-secondary, #8a90a5)", fontSize: 12, marginTop: 4 } },
           busy ? "保存中…" : (saved ? "已保存 ✓" : "增量同步周期(ms); 0 = 关闭(仅手动)。改动约 0.5s 后自动保存并热生效。")),
       ]);
-      const statusControl = React.createElement("div", { style: { ...monoStyle, color: "var(--dsh-text-secondary, #8a90a5)", display: "grid", gridTemplateColumns: "auto 1fr", gap: "2px 14px" } }, [
-        React.createElement("span", { key: "a" }, "文档数"), React.createElement("span", { key: "b", style: { color: meiliOk ? "inherit" : "var(--dsh-state-error-primary, #e5534b)" } }, meiliOk ? String(docs) : "连接失败"),
-        React.createElement("span", { key: "c" }, "会话游标"), React.createElement("span", { key: "d" }, stat ? String(stat.stateFiles) : "…"),
-        React.createElement("span", { key: "e" }, "上次同步"), React.createElement("span", { key: "f" }, fmtWhen(stat && stat.lastSync)),
-        React.createElement("span", { key: "g" }, "下次同步"), React.createElement("span", { key: "h" }, stat ? (stat.autoSyncMs > 0 ? fmtWhen(stat.nextRunAt) : "已关闭") : "…"),
-        React.createElement("span", { key: "i" }, "同步状态"), React.createElement("span", { key: "j" }, stat ? (stat.syncing ? "同步中…" : (meiliOk ? "正常" : "Meili 不可达")) : "…"),
-      ]);
+      const rate = stat && stat.lastRound ? stat.lastRound : null;
+      const rateColor = !rate ? "var(--dsh-text-secondary, #8a90a5)" : (rate.docsPerSec > 50 ? "var(--dsh-state-success-primary, #4bc17c)" : (rate.docsPerSec > 0 ? "var(--dsh-state-warn-label, #d9a406)" : "var(--dsh-text-secondary, #8a90a5)"));
+      const rateView = loading ? "…" : rate ? `${rate.docsPerSec} docs/s · +${rate.added} (${rate.kind === "delta" ? "回填" : "同步"}, ${Math.round(rate.seconds)}s)` : "—";
+      const metricRows = [
+        ["文档数", React.createElement("span", { key: "v", style: { color: docsColor, fontWeight: 600 } }, docsView)],
+        ["会话游标", React.createElement("span", { key: "v" }, loading ? "…" : (stat ? String(stat.stateFiles) : "—"))],
+        ["最近一轮", React.createElement("span", { key: "v", style: { color: rateColor, fontWeight: rate ? 600 : 400 } }, rateView)],
+        ["上次同步", React.createElement("span", { key: "v" }, loading ? "…" : fmtWhen(stat && stat.lastSync))],
+        ["下次同步", React.createElement("span", { key: "v" }, stat ? (stat.autoSyncMs > 0 ? fmtWhen(stat.nextRunAt) : "已关闭") : (loading ? "…" : "—"))],
+        ["同步状态", React.createElement("span", { key: "v", style: { color: stat && stat.syncing ? "var(--dsh-state-warn-label, #d9a406)" : "var(--dsh-state-success-primary, #4bc17c)" } }, loading ? "…" : (stat ? (stat.syncing ? "同步中…" : (meiliOk ? "正常" : "Meili 不可达")) : "—"))],
+        ["限速", React.createElement("span", { key: "v" }, stat ? `${stat.throttleMs ?? 250} ms/批 ${stat.addBatch ?? 200}` : (loading ? "…" : "—"))],
+      ];
+      const statusControl = React.createElement("div", { style: { display: "flex", flexDirection: "column", justifyContent: "space-between", width: 180, height: 155, flex: "none" } }, metricRows.map(([, node], i) =>
+        React.createElement("div", { key: i, style: { ...monoStyle, fontSize: 12, overflow: "hidden" } },
+          React.createElement("span", { style: { float: "left", width: 62, color: "var(--dsh-text-secondary, #8a90a5)", whiteSpace: "nowrap" } }, metricRows[i][0]),
+          React.createElement("div", { style: { display: "block", textAlign: "right", color: "var(--dsh-text-secondary, #8a90a5)" } }, node))));
+      // ---- 文档数趋势曲线(设计器参数: H155/线2.5/alpha.12/放缩0.19/fs12/圆角/千分位; 当前值右上, 初始值左下) ----
+      const histControl = (() => {
+        if (!hist || hist.length < 2) {
+          return React.createElement("div", { style: { ...monoStyle, color: "var(--dsh-text-secondary, #8a90a5)", fontSize: 12, height: 155, display: "flex", alignItems: "center" } }, "采集文档数趋势中…(≥2 个采样点后显示)");
+        }
+        const vals = hist.map((p) => Number(p[1]));
+        const W = 560, H = 155, px = 8, pt = 8, pb = 2, expand = 0.19;
+        let lo = Math.min(...vals), hi = Math.max(...vals), mid = (lo + hi) / 2;
+        if (hi - lo < Math.max(1, mid * expand)) { lo = mid - (mid * expand) / 2; hi = mid + (mid * expand) / 2; }
+        const sp = Math.max(1, hi - lo);
+        const x = (i) => px + (W - 2 * px) * (i / (vals.length - 1));
+        const y = (v) => (H - pb) - (H - pb - pt) * ((v - lo) / sp);
+        const line = vals.map((v, i) => `${x(i).toFixed(1)},${y(v).toFixed(1)}`).join(" ");
+        const area = `${x(0).toFixed(1)},${H - pb} ${line} ${x(vals.length - 1).toFixed(1)},${H - pb}`;
+        const fmtV = (n) => n.toLocaleString();
+        return React.createElement("div", { style: { position: "relative", flex: 1, minWidth: 0, height: 155 } }, [
+          React.createElement("svg", { key: "s", viewBox: `0 0 ${W} ${H}`, preserveAspectRatio: "none", style: { position: "absolute", inset: 0, width: "100%", height: "100%", display: "block" }, role: "img", "aria-label": "文档数趋势" },
+            React.createElement("defs", null,
+              React.createElement("linearGradient", { id: "dshMeiliHistFill", x1: 0, y1: 0, x2: 0, y2: 1 },
+                React.createElement("stop", { offset: "0%", stopColor: "#1f6feb", stopOpacity: 0.12 }),
+                React.createElement("stop", { offset: "100%", stopColor: "#1f6feb", stopOpacity: 0 }))),
+            React.createElement("polygon", { points: area, fill: "url(#dshMeiliHistFill)" }),
+            React.createElement("polyline", { points: line, fill: "none", stroke: "#1f6feb", strokeWidth: 2.5, strokeLinejoin: "round", strokeLinecap: "round" })),
+          React.createElement("div", { key: "cur", style: { position: "absolute", top: 0, right: 2, font: "600 12px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace", color: "var(--dsw-alias-label-primary)" } }, fmtV(vals[vals.length - 1])),
+          React.createElement("div", { key: "ini", style: { position: "absolute", left: 2, bottom: 0, font: "400 12px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace", color: "var(--dsh-text-secondary, #8a90a5)" } }, fmtV(vals[0])),
+        ]);
+      })();
       const actionControl = React.createElement("div", null, [
         React.createElement("div", { key: "b", style: { display: "flex", gap: 8, alignItems: "center" } },
           React.createElement("button", { type: "button", disabled: reidx.busy, onClick: runReindex, style: { ...btnStyle, background: reidx.busy ? "rgba(128,132,148,.4)" : "#1f6feb" } }, reidx.busy ? "同步中…" : "立即同步一轮"),
@@ -361,6 +530,175 @@ window.__ModuleLoader__.load({
         React.createElement("div", { key: "t", style: { color: "var(--dsh-text-secondary, #8a90a5)", fontSize: 12, marginTop: 4 } }, "等于服务端增量同步(按会话日志 seq/时间戳追加新尾部)"),
       ]);
       const keyControl = React.createElement("input", { type: "password", value: keyText, placeholder: cfg && cfg.hasKey ? "已设置(留空并失焦保存可清除)" : "无(未设置)", onChange: (e) => onKeyChange(e.target.value), onBlur: onKeyBlur, style: { ...inpStyle, width: 280 }, spellCheck: false });
+      // ---- 索引范围分段选择(数值像素几何 + 覆盖层连体 + 文字等距内边距) ----
+      // 轨道实测像素宽 bw → 格宽 = (bw - 3*GAP)/4; 蓝块按连段合并跨间距;
+      // 连段内每段宽度 = 文字实测宽 + 2*等宽内边距(pad) → 每个文字左右到蓝块边框距离完全相等。
+      const selScope = () => (scope && scope.length) ? scope : ["user", "assistant"];
+      const bw = Math.max(barW || 0, 336);
+      const cellWpx = (bw - 3 * GAP) / 4;
+      const cellW = `${cellWpx}px`;
+      const leftPx = (i) => i * (cellWpx + GAP);
+      const leftCss = (i) => `${leftPx(i)}px`;
+      const widthCss = (len) => `${len * cellWpx + (len - 1) * GAP}px`;
+      const textW = (k) => (labelW.current && labelW.current[k]) || (k.length * 7.6);
+      // 连段内等边距分配: 每段 = 文字宽 + 2*pad; pad 由剩余空间均分, 最小 8px
+      const runPad = (s, len) => {
+        const items = SCOPE_ITEMS.slice(s, s + len);
+        const sumW = items.reduce((a, it) => a + textW(it.k), 0);
+        const runWpx = len * cellWpx + (len - 1) * GAP;
+        return Math.max(8, (runWpx - sumW) / (2 * len));
+      };
+      const scopeRuns = (() => {
+        const sc = selScope();
+        const runs = [];
+        let cur = null;
+        SCOPE_ITEMS.forEach((it, i) => {
+          const on = sc.includes(it.k);
+          if (on && !cur) cur = { s: i };
+          if (on) cur = { s: cur.s, e: i };
+          if (!on && cur) { runs.push(cur); cur = null; }
+        });
+        if (cur) runs.push(cur);
+        return runs;
+      })();
+      // 标签层: 永远固定在各自格心(文字不固定问题根治; 无 left/width 过渡)
+      const scopeCells = SCOPE_ITEMS.map((it, i) => {
+        const sel = selScope().includes(it.k);
+        return React.createElement("div", {
+          key: it.k,
+          onClick: () => toggleScope(it.k),
+          style: {
+            position: "absolute",
+            top: 0,
+            height: 40,
+            lineHeight: "40px",
+            textAlign: "center",
+            whiteSpace: "nowrap",
+            left: leftPx(i),
+            width: cellWpx,
+            zIndex: 1,
+            color: sel ? "#fff" : "var(--dsh-text-secondary, #8a90a5)",
+            fontWeight: sel ? 600 : 400,
+            fontSize: sel ? 13 : 12.5,
+            cursor: "pointer",
+            userSelect: "none",
+            transition: "color .25s ease",
+          },
+          title: it.k === "user" ? "用户输入" : it.k === "assistant" ? "agent 回复" : it.k === "reasoning" ? "agent 思考" : "工具调用",
+        }, it.label);
+      });
+      // 覆盖层: 每选中格一个独立蓝块(文字在块内左右对称=边距对齐) + 相邻选中在格间补"桥"
+      // → 视觉跨间距连体, 但不侵占文字两侧边距, 文字位置零扰动
+      const selIdx = selScope()
+        .map((k) => SCOPE_ITEMS.findIndex((it) => it.k === k))
+        .filter((i) => i >= 0)
+        .sort((a, b) => a - b);
+      const scopeOverlay = [];
+      selIdx.forEach((i, p) => {
+        const adjL = p > 0 && selIdx[p - 1] === i - 1;
+        const adjR = p < selIdx.length - 1 && selIdx[p + 1] === i + 1;
+        scopeOverlay.push(React.createElement("div", {
+          key: `cell-${i}`,
+          style: {
+            position: "absolute", top: 0, bottom: 0, left: leftPx(i), width: cellWpx,
+            borderTopLeftRadius: adjL ? 0 : 12,
+            borderBottomLeftRadius: adjL ? 0 : 12,
+            borderTopRightRadius: adjR ? 0 : 12,
+            borderBottomRightRadius: adjR ? 0 : 12,
+            background: "#1f6feb", zIndex: 0, pointerEvents: "none",
+          },
+        }));
+        if (adjR) scopeOverlay.push(React.createElement("div", {
+          key: `bridge-${i}`,
+          style: {
+            position: "absolute", top: 0, bottom: 0, left: leftPx(i) + cellWpx, width: GAP,
+            background: "#1f6feb", zIndex: 0, pointerEvents: "none",
+          },
+        }));
+      });
+      // 方向性进出场瞬态层: 覆盖在刚点的那一格上, 播放完消失(底色与运行态一致, 无缝衔接)
+      const fxLayer = fx.map((f) => {
+        const base = { position: "absolute", top: 0, bottom: 0, left: leftCss(f.idx), width: cellW, borderRadius: 12, pointerEvents: "none", overflow: "hidden" };
+        if (f.dir === "B") {
+          const half = { position: "absolute", top: 0, bottom: 0, width: "50%", background: "#1f6feb" };
+          const anim = f.mode === "in" ? "dshMeiliGrow" : "dshMeiliShrink";
+          return React.createElement("div", { key: f.id, style: base }, [
+            React.createElement("div", { key: "l", style: { ...half, left: 0, animation: `${anim} .3s ease forwards`, transformOrigin: "left center" } }),
+            React.createElement("div", { key: "r", style: { ...half, right: 0, animation: `${anim} .3s ease forwards`, transformOrigin: "right center" } }),
+          ]);
+        }
+        const blue = { background: "#1f6feb" };
+        if (f.dir === "I") {
+          return React.createElement("div", { key: f.id, style: { ...base, ...blue, animation: (f.mode === "in" ? "dshMeiliFadeIn" : "dshMeiliOut") + " .3s ease forwards" } });
+        }
+        return React.createElement("div", {
+          key: f.id,
+          style: {
+            ...base, ...blue,
+            animation: (f.mode === "in" ? "dshMeiliGrow" : "dshMeiliShrink") + " .3s ease forwards",
+            transformOrigin: (f.mode === "in") ? (f.dir === "L" ? "left center" : "right center") : (f.dir === "L" ? "right center" : "left center"),
+          },
+        });
+      });
+      const scopeControl = React.createElement("div", null, [
+        React.createElement("div", { key: "bar", ref: barRef, style: { position: "relative", height: 40, minWidth: 336, border: "1px solid rgba(128,132,148,.35)", borderRadius: 12, overflow: "hidden", background: "rgba(12,14,20,.5)" } },
+          scopeCells,
+          scopeOverlay,
+          fxLayer),
+        React.createElement("div", { key: "foot", style: { display: "flex", alignItems: "center", gap: 10, marginTop: 6, minHeight: 22 } },
+          React.createElement("span", { key: "msg", style: { color: "var(--dsh-text-secondary,#8a90a5)", fontSize: 11.5 } }, scopeMsg || (scopeDirty ? "自动保存中…" : `当前: ${selScope().join(" + ")}`)),
+        ),
+      ]);
+      // subagent 包含开关(同款固定坐标+覆盖层; 选中态由 subInc 决定)
+      const subCells = [true, false].map((v, i) => React.createElement("div", {
+        key: i,
+        onClick: () => { lastSub.current = subInc; setSubInc(v); setScopeDirty(true); setScopeMsg(""); setScopeTick((t) => t + 1); },
+        style: {
+          width: "50%",
+          height: 40,
+          lineHeight: "40px",
+          textAlign: "center",
+          position: "relative",
+          zIndex: 1,
+          color: subInc === v ? "#fff" : "var(--dsh-text-secondary, #8a90a5)",
+          fontWeight: subInc === v ? 600 : 400,
+          fontSize: subInc === v ? 13 : 12.5,
+          cursor: "pointer",
+          userSelect: "none",
+          transition: "color .25s ease",
+        },
+      }, v ? "包含" : "排除"));
+      const subOverlay = React.createElement("div", {
+        key: `sub-${subInc}`,
+        style: {
+          position: "absolute",
+          top: 0,
+          bottom: 0,
+          left: subInc ? 0 : "50%",
+          width: "50%",
+          borderRadius: 12,
+          background: "#1f6feb",
+          zIndex: 0,
+          pointerEvents: "none",
+          // 开关: 直接跳边, 不做位移动画
+        },
+      });
+      const subControl = React.createElement("div", { style: { position: "relative", height: 40, width: 186, border: "1px solid rgba(128,132,148,.35)", borderRadius: 12, overflow: "hidden", background: "rgba(12,14,20,.5)" } },
+        React.createElement("div", { style: { display: "flex", height: 40 } }, subCells),
+        subOverlay);
+      // 写入限速滑杆(白块内嵌渐变条; 数字框在左; 释放自动保存)
+      const throttleControl = React.createElement("div", { style: { display: "flex", alignItems: "center", gap: 12 } }, [
+        React.createElement("input", { key: "v", type: "number", min: 0, max: THROTTLE_MAX, step: 10, value: throttleText, onChange: (e) => onThrottleText(e.target.value), onBlur: commitThrottleText, style: { width: 88, font: "700 15px/1.4 ui-monospace,SFMono-Regular,Menlo,monospace", color: "var(--dsw-alias-label-primary)", background: "transparent", border: "1px solid rgba(128,132,148,.35)", borderRadius: 8, padding: "5px 9px", textAlign: "center", outline: "none" }, "aria-label": "写入限速批次间隔 ms" }),
+        React.createElement("div", { key: "bar", style: { position: "relative", flex: 1, minWidth: 260 } }, [
+          React.createElement("input", { key: "i", type: "range", className: "dshMeiliThrottle", min: 0, max: 1000, step: 1, value: Math.round(pFromMs(throttleMs) * 1000), onChange: (e) => applyThrottle(msFromP(e.target.value / 1000)), "aria-label": "写入限速批次间隔 ms" }),
+          React.createElement("div", { key: "l", style: { position: "absolute", left: 10, top: "50%", transform: "translateY(-50%)", fontSize: 10, color: "rgba(255,255,255,.92)", pointerEvents: "none" } }, "最慢"),
+          React.createElement("div", { key: "r", style: { position: "absolute", right: 10, top: "50%", transform: "translateY(-50%)", fontSize: 10, color: "rgba(255,255,255,.92)", pointerEvents: "none" } }, "不限速"),
+        ]),
+      ]);
+
+      const statusBlock = React.createElement("div", { style: { borderTop: "1px solid var(--dsw-alias-border-l2, rgba(128,132,148,.18))", marginTop: 4, paddingTop: 16 } },
+        React.createElement("div", { style: { fontWeight: 700, fontSize: 14, marginBottom: 10 } }, "实时状态"),
+        React.createElement("div", { style: { display: "flex", flexDirection: "row", gap: 16, alignItems: "flex-start" } }, [histControl, statusControl]));
 
       return React.createElement("div", { style: { padding: "2px 0 6px" } },
         React.createElement("div", { style: { display: "flex", alignItems: "baseline", justifyContent: "space-between", marginBottom: 2 } },
@@ -371,12 +709,42 @@ window.__ModuleLoader__.load({
         settingsRow("Meilisearch 地址", "http(s)://host:port; 失焦自动保存并立即生效", React.createElement("input", { type: "text", value: urlText, placeholder: "http://192.168.43.2:7700", onChange: (e) => setUrlText(e.target.value), onBlur: onUrlBlur, style: { ...inpStyle, width: 320 }, spellCheck: false })),
         settingsRow("Master Key", "访问 meili 的密钥(默认无); 留空失焦保存即清除", keyControl),
         settingsRow("索引 (只读)", "当前检索/同步使用的索引", React.createElement("code", { style: { ...monoStyle, color: "var(--dsh-text-secondary,#8a90a5)" } }, idx)),
+        settingsRow("索引内容范围", "点击切换收录角色; 自动保存, 10 秒无操作后按角色增量更新索引(移除秒删/新增后台回填)", scopeControl),
+        settingsRow("包含 subagent 会话", "委托子代理会话是否纳入索引", subControl),
+        settingsRow("写入限速", "0ms=不限速; 2/3 处≈250ms; 拖动自动保存", throttleControl),
         settingsRow("手动同步", "立即触发一轮增量同步", actionControl),
-        settingsRow("实时状态", "文档数 / 游标 / 上次与下次同步(自动刷新)", statusControl));
+        statusBlock);
     }
 
     function apply(ctx) {
       activeCtx = ctx;
+      if (!window.__dshMeiliCssInjected) {
+        window.__dshMeiliCssInjected = true;
+        const st = document.createElement("style");
+        st.textContent = `
+          .dshMeiliSeg { position: relative; }
+          .dshMeiliSegSel { animation: dshMeiliGrow .28s ease; }
+          .dshMeiliSegSelL { transform-origin: left center; }
+          .dshMeiliSegSelR { transform-origin: right center; }
+          .dshMeiliSegSelC { transform-origin: center; }
+          @keyframes dshMeiliGrow { from { transform: scaleX(.25); opacity: .2; } to { transform: scaleX(1); opacity: 1; } }
+          .dshMeiliSegFadeIn { animation: dshMeiliFadeIn .3s ease; }
+          @keyframes dshMeiliFadeIn { from { background-color: transparent; opacity: .15; transform: scale(.85); } to { background-color: #1f6feb; opacity: 1; transform: scale(1); } }
+          .dshMeiliSegFade { animation: dshMeiliFade .35s ease; }
+          @keyframes dshMeiliFade { from { background-color: #1f6feb; color: #fff; opacity: 1; } to { background-color: transparent; opacity: .35; } }
+          .dshMeiliSegFadeIn { animation: dshMeiliFadeIn .3s ease; }
+          @keyframes dshMeiliFadeIn { from { background-color: transparent; opacity: .15; transform: scale(.85); } to { background-color: #1f6feb; opacity: 1; transform: scale(1); } }
+          @keyframes dshMeiliShrink { from { transform: scaleX(1); opacity: 1; } to { transform: scaleX(0); opacity: .15; } }
+          @keyframes dshMeiliOut { from { opacity: 1; transform: scale(1); } to { opacity: 0; transform: scale(.9); } }
+          input.dshMeiliThrottle { -webkit-appearance: none; appearance: none; width: 100%; height: 30px; border-radius: 15px; margin: 0; cursor: pointer; background: transparent; }
+          input.dshMeiliThrottle::-webkit-slider-runnable-track { height: 30px; border-radius: 15px; background: linear-gradient(90deg, #22c55e 0%, #eab308 50%, #ef4444 100%); box-shadow: inset 0 1px 3px rgba(0,0,0,.45); }
+          input.dshMeiliThrottle::-webkit-slider-thumb { -webkit-appearance: none; appearance: none; width: 20px; height: 20px; border-radius: 7px; background: #fff; margin-top: 5px; box-shadow: 0 1px 3px rgba(0,0,0,.4); cursor: pointer; }
+          input.dshMeiliThrottle::-moz-range-track { height: 30px; border-radius: 15px; background: linear-gradient(90deg, #22c55e 0%, #eab308 50%, #ef4444 100%); }
+          input.dshMeiliThrottle::-moz-range-thumb { width: 20px; height: 20px; border: 0; border-radius: 7px; background: #fff; box-shadow: 0 1px 3px rgba(0,0,0,.4); cursor: pointer; }
+          input.dshMeiliThrottle:focus-visible { outline: 1px solid #1f6feb; outline-offset: 2px; }
+        `;
+        document.head.appendChild(st);
+      }
       const patch = (attempt) => {
         let rt = null;
         try { rt = ctx.sessions; } catch { rt = null; }
@@ -407,12 +775,14 @@ window.__ModuleLoader__.load({
       };
       patch(0);
       try {
-        ctx.slots.inject("settings.general.item", () => ctx.slots.register({
-          name: "settings.general.item",
-          id: "dsh-meili-search-settings",
-          order: 642,
+        // 独立设置小节: 注册到 settings.section → Settings 左侧导航出现「会话内容检索」项
+        ctx.slots.inject("settings.section", () => ctx.slots.register({
+          name: "settings.section",
+          id: "dsh-meili-search",
+          order: 700,
+          label: "会话内容检索",
         }, MeiliSettingsCard));
-      } catch (e) { console.warn("[dsh-meili] settings card 注册失败:", String((e && e.message) || e)); }
+      } catch (e) { console.warn("[dsh-meili] settings section 注册失败:", String((e && e.message) || e)); }
     }
     const inject = ["sessions", "slots"];
     exports.apply = apply;

package/cordis.patch.yml

@@ -4,3 +4,7 @@
       config:
         autoSyncMs: 300000   # 增量定时同步周期(ms): 300000=5 分钟; 0=关闭(仅手动 /reindex)
         index: dsh_sessions  # 正式索引
+        indexScope:          # 索引范围(可经 /dsh-meili/v1/settings 热改):
+          - user            #   用户输入
+          - assistant       #   agent 回复(默认含此两者; 加 reasoning=思考, tool=工具调用)
+        includeSubagents: true   # false 则排除 subagent 会话