dsh-conversation-navigator 0.1.16 → 0.1.18

package/README.md

@@ -7,7 +7,9 @@ Codex 风格的 **DeepSeek Harness(DSH)Web 端会话导航面板**:在对话页*
 ## 功能
 
 - **按轮折叠大纲**:默认只显示"第 N 轮 + 你的问题"列表,长对话一目了然
-- **展开/折叠步次**:点击轮次行右侧的 `▸ N` / `▾` 展开或折叠该轮的步次明细(助手回复、工具调用、命令、压缩点等)
+- **关键词过滤**:点击左上角搜索图标呼出输入框,只按「你的提问 + 助手实际回复文本」过滤(上下文、工具、命令、压缩、推理等不参与匹配),命中词高亮,列表文本自动定位到关键词处
+- **展开/折叠步次**:点击轮次行右侧的箭头按钮(`▸ N`,展开时旋转为 `▾`)平滑展开/折叠该轮的步次明细(助手回复、工具调用、命令、压缩点等)
+- **丝滑动效**:面板开合淡入淡出、步次展开/折叠高度过渡、过滤结果逐条级联淡入、折叠箭头旋转——全部纯 CSS 实现,零依赖
 - **点击定位**:点击轮次主体或步次条目,平滑滚动跳转到对话中对应位置(不改变折叠状态)
 - **加载更早 / 加载全部**:面板顶部两个按钮——「加载更早」向后翻一页、「加载全部」一键把所有历史轮次载入导航,之后可任意跳转(页面默认仍懒加载,只有点按钮才补载)
 - **位置跟踪**:手动滚动对话时,面板自动高亮并跟随当前正在阅读的轮次
@@ -26,7 +28,7 @@ Codex 风格的 **DeepSeek Harness(DSH)Web 端会话导航面板**:在对话页*
 dsh plugin --profile web add dsh-conversation-navigator
 
 # 方式二:GitHub(纯 JS 包无需 prepare/allowBuilds,直接可用)
-dsh plugin --profile web add github:gjj-star/dsh-conversation-navigato
+dsh plugin --profile web add github:gjj-star/dsh-conversation-navigator
 
 # 方式三:本地 tarball
 pnpm pack
@@ -48,6 +50,7 @@ dsh plugin --profile web add ./dsh-conversation-navigator-<version>.tgz
 - 历史补载:通过 `sessions` 服务的 `binding(sessionId).session.loadOlder()` 分页向后加载,「加载全部」循环至 `hasMore=false`
 - 跳转定位:复用 DSH 聊天视图自身的稳定 DOM 锚点 `[data-chat-anchor-key]`(与产品内部 paging/scroll 定位同源),`scrollIntoView` 平滑滚动
 - 位置跟踪:捕获 `[data-conversation-scroll]` 滚动容器的 scroll 事件(节流 120ms),计算视口顶部首个可见节点
+- 关键词过滤:仅为 `user` 与 `assistant-step` 节点提取检索文本(`dialogueText`),大小写不敏感匹配,命中片段以 `<mark>` 高亮并按首个命中位置截取显示窗口
 - 样式:按钮/图标复用 `@deepseek-ai/dsh-client-ui-primitives`;面板容器自建 `<style>` 注入,颜色使用 `--dsw-*` 主题 token;插件卸载时随 fiber 清理
 
 ## 兼容性说明

package/lib/client.js

@@ -5,7 +5,7 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		const React = require("react");
-		const { Button, Tooltip, IconCloseOutline16 } = require("@deepseek-ai/dsh-client-ui-primitives");
+		const { Button, Tooltip, IconCloseOutline16, IconSearchOutline16 } = require("@deepseek-ai/dsh-client-ui-primitives");
 
 		/* ---------- custom icons (DSH outline style, unique to this panel) ---------- */
 		function ToggleIcon() {
@@ -79,24 +79,27 @@ window.__ModuleLoader__.load({
   font-size: 12px;
   color: var(--dsw-alias-label-primary, #222);
   overflow: hidden;
+  transition: opacity .18s ease, transform .18s ease;
 }
+.cnvnav-panel-hidden { opacity: 0; transform: translateY(-6px) scale(.985); pointer-events: none; }
 .cnvnav-head {
   display: flex; align-items: center; gap: 8px;
   padding: 10px 12px;
   border-bottom: 1px solid var(--dsw-alias-border-l1, rgba(128,128,128,.35));
 }
-.cnvnav-title { font-family: var(--dsw-font-family, -apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', sans-serif); font-size: 16px; font-weight: 700; line-height: 22px; }
 .cnvnav-count { color: var(--dsw-alias-label-secondary, #888); font-size: 11px; }
+.cnvnav-search { flex: none; display: flex; }
 .cnvnav-close { margin-left: auto; }
 .cnvnav-list {
   overflow-y: auto; padding: 6px; min-height: 0;
   display: flex; flex-direction: column; gap: 2px;
   scrollbar-width: thin;
 }
-.cnvnav-group { display: flex; flex-direction: column; gap: 2px; margin-bottom: 2px; }
+.cnvnav-group { display: flex; flex-direction: column; margin-bottom: 2px; }
 .cnvnav-group-row {
   display: flex; align-items: stretch;
   border-radius: 8px; overflow: hidden;
+  transition: background .16s ease;
 }
 .cnvnav-group-row:hover { background: var(--dsw-alias-bg-layer-2, rgba(128,128,128,.12)); }
 .cnvnav-group-row-active { background: var(--dsw-alias-bg-layer-2, rgba(128,128,128,.12)); }
@@ -109,7 +112,7 @@ window.__ModuleLoader__.load({
   padding: 5px 0 5px 8px;
   color: var(--dsw-alias-label-primary, #222);
 }
-.cnvnav-group-title { font-family: var(--dsw-font-family, -apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', sans-serif); font-size: 14px; font-weight: 700; line-height: 20px; white-space: nowrap; }
+.cnvnav-group-title { font-family: var(--dsw-font-family, -apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', sans-serif); font-size: 14px; font-weight: 700; line-height: 20px; white-space: nowrap; transition: color .16s ease; }
 .cnvnav-group-sub {
   color: var(--dsw-alias-label-secondary, #888);
   overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
@@ -117,19 +120,29 @@ window.__ModuleLoader__.load({
 }
 .cnvnav-chevron-wrap { flex: none; display: flex; }
 .cnvnav-chevron {
-  min-width: 30px; width: 100%;
-  display: flex; align-items: center; justify-content: center;
+  min-width: 30px; align-self: stretch;
+  display: flex; align-items: center; justify-content: center; gap: 3px;
   border: none; background: transparent; cursor: pointer;
   color: var(--dsw-alias-label-secondary, #888);
   font-size: 11px; line-height: 1; padding: 0 8px;
   white-space: nowrap;
+  transition: color .16s ease, background .16s ease;
 }
 .cnvnav-chevron:hover { color: var(--dsw-alias-brand-primary, #4f46e5); background: var(--dsw-alias-bg-layer-2, rgba(128,128,128,.12)); }
+.cnvnav-chevron-icon { flex: none; display: block; transition: transform .2s cubic-bezier(.4, 0, .2, 1); }
+.cnvnav-chevron[aria-expanded="true"] .cnvnav-chevron-icon { transform: rotate(90deg); }
+.cnvnav-chevron-count { font-size: 11px; line-height: 1; }
+.cnvnav-steps { display: grid; grid-template-rows: 1fr; margin-top: 2px; transition: grid-template-rows .24s cubic-bezier(.4, 0, .2, 1), margin-top .24s cubic-bezier(.4, 0, .2, 1); }
+.cnvnav-steps-collapsed { grid-template-rows: 0fr; margin-top: 0; }
+.cnvnav-steps-inner { overflow: hidden; min-height: 0; display: flex; flex-direction: column; gap: 2px; }
+.cnvnav-fade-item { animation: cnvnav-fade-up .2s ease-out backwards; }
+@keyframes cnvnav-fade-up { from { opacity: 0; transform: translateY(4px); } to { opacity: 1; transform: translateY(0); } }
 .cnvnav-item {
   display: flex; align-items: center; gap: 8px; width: 100%; text-align: left;
   border: none; background: transparent; cursor: pointer;
   padding: 5px 8px 5px 22px; border-radius: 8px; position: relative;
   color: var(--dsw-alias-label-primary, #222);
+  transition: background .16s ease;
 }
 .cnvnav-item:hover { background: var(--dsw-alias-bg-layer-2, rgba(128,128,128,.12)); }
 .cnvnav-item-active { background: var(--dsw-alias-bg-layer-2, rgba(128,128,128,.12)); }
@@ -162,10 +175,13 @@ window.__ModuleLoader__.load({
 .cnvnav-item-time {
   flex: none; color: var(--dsw-alias-label-secondary, #888); font-size: 10px; opacity: .8;
 }
+.cnvnav-hl {
+  background: color-mix(in srgb, var(--dsw-alias-state-warn-primary, #f59e0b) 30%, transparent);
+  color: inherit; border-radius: 2px; padding: 0 1px; font-weight: 600;
+}
 .cnvnav-empty { padding: 18px 10px; text-align: center; color: var(--dsw-alias-label-secondary, #888); }
-.cnvnav-filter-row { padding: 6px 6px 0; }
 .cnvnav-filter {
-  width: 100%; box-sizing: border-box;
+  flex: 1; min-width: 0; box-sizing: border-box;
   height: 28px; padding: 0 8px;
   border: 1px solid var(--dsw-alias-border-l1, rgba(128,128,128,.35));
   border-radius: 8px;
@@ -173,9 +189,14 @@ window.__ModuleLoader__.load({
   color: var(--dsw-alias-label-primary, #222);
   font-family: var(--dsw-font-family, -apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', sans-serif);
   font-size: 12px; outline: none;
+  animation: cnvnav-search-in .16s ease-out;
 }
 .cnvnav-filter::placeholder { color: var(--dsw-alias-label-secondary, #888); }
 .cnvnav-filter:focus { border-color: var(--dsw-alias-brand-primary, #4f46e5); }
+@keyframes cnvnav-search-in {
+  from { opacity: 0; transform: translateX(4px); }
+  to { opacity: 1; transform: translateX(0); }
+}
 .cnvnav-topbar { display: flex; gap: 6px; margin: 6px 6px 0; }
 .cnvnav-footer { display: flex; gap: 6px; margin: 0 6px 6px; }
 .cnvnav-bar-btn { flex: 1; display: block; }
@@ -265,6 +286,23 @@ window.__ModuleLoader__.load({
 				}
 				return null;
 			}
+			/* Searchable dialogue text: user questions + agent actual dialogue only
+			   (excludes context, tool calls, commands, compaction, reasoning, etc.) */
+			function dialogueText(node) {
+				const d = node && node.data;
+				if (!d || typeof d !== "object") return null;
+				if (node.kind === "user") return firstText(d.content);
+				if (node.kind === "assistant-step") {
+					if (!Array.isArray(d.blocks)) return null;
+					const parts = [];
+					for (const b of d.blocks) {
+						if (!b || typeof b !== "object") continue;
+						if ((b.type === "text" || b.kind === "text") && typeof b.text === "string" && b.text.trim() !== "") parts.push(b.text.trim());
+					}
+					return parts.length > 0 ? parts.join(" ") : null;
+				}
+				return null;
+			}
 			function previewFor(node) {
 				const d = node && node.data;
 				if (!d || typeof d !== "object") return null;
@@ -355,6 +393,7 @@ window.__ModuleLoader__.load({
 						label: meta.label,
 						cls: meta.cls,
 						preview: previewFor(node),
+						search: dialogueText(node),
 						time: fmtTime(timeOf(node)),
 					};
 					const turn = turnOf(node);
@@ -481,6 +520,11 @@ window.__ModuleLoader__.load({
 			function Panel() {
 				const snap = useStore();
 				const [filter, setFilter] = React.useState("");
+				const [searchOpen, setSearchOpen] = React.useState(false);
+				function toggleSearch() {
+					if (searchOpen) setFilter("");
+					setSearchOpen(!searchOpen);
+				}
 
 				React.useEffect(() => {
 					if (!snap.open) return;
@@ -525,7 +569,7 @@ window.__ModuleLoader__.load({
 				React.useEffect(() => {
 					if (!snap.open || snap.activeKey === null) return;
 					let target = itemEls[snap.activeKey];
-					if (target === undefined || target === null) {
+					if (target === undefined || target === null || (typeof target.closest === "function" && target.closest(".cnvnav-steps-collapsed") !== null)) {
 						const gid = snap.outline !== null ? snap.outline.byKey[snap.activeKey] : undefined;
 						if (gid !== undefined) target = groupEls[gid];
 					}
@@ -535,13 +579,11 @@ window.__ModuleLoader__.load({
 						const er = target.getBoundingClientRect();
 						const rel = er.top - lr.top + list.scrollTop;
 						if (rel < list.scrollTop || rel + er.height > list.scrollTop + list.clientHeight) {
-							list.scrollTop = Math.max(0, rel - list.clientHeight / 2);
+							list.scrollTo({ top: Math.max(0, rel - list.clientHeight / 2), behavior: "smooth" });
 						}
 					}
 				}, [snap.open, snap.activeKey]);
 
-				if (!snap.open) return null;
-
 				const groups = snap.outline !== null ? snap.outline.groups : [];
 				const count = snap.outline !== null ? snap.outline.count : 0;
 
@@ -550,24 +592,63 @@ window.__ModuleLoader__.load({
 				function hit(text) {
 					return typeof text === "string" && text !== "" && text.toLowerCase().indexOf(kw) !== -1;
 				}
-				function renderItem(item) {
+				/* Split text into nodes, wrapping every case-insensitive keyword match in a <mark>. */
+				function highlightedNodes(text, kw) {
+					if (typeof text !== "string" || kw === "") return [text];
+					const lower = text.toLowerCase();
+					const out = [];
+					let i = 0;
+					let m = 0;
+					for (;;) {
+						const idx = lower.indexOf(kw, i);
+						if (idx === -1) { if (i < text.length) out.push(text.slice(i)); break; }
+						if (idx > i) out.push(text.slice(i, idx));
+						out.push(React.createElement("mark", { key: "m" + (m++), className: "cnvnav-hl" }, text.slice(idx, idx + kw.length)));
+						i = idx + kw.length;
+					}
+					return out;
+				}
+				/* Window the text around the first keyword match (so the keyword is visible,
+				   not hidden behind head-truncation), then highlight every occurrence. */
+				function snippetNodes(text, kw, before, after) {
+					if (typeof text !== "string") return [text];
+					const idx = text.toLowerCase().indexOf(kw);
+					if (idx === -1) return highlightedNodes(text, kw);
+					const start = Math.max(0, idx - before);
+					const end = Math.min(text.length, idx + kw.length + after);
+					const s = text.slice(start, end);
+					const parts = [];
+					if (start > 0) parts.push("…");
+					parts.push(...highlightedNodes(s, kw));
+					if (end < text.length) parts.push("…");
+					return parts;
+				}
+				function renderItem(item, staggerMs) {
+					const useSnippet = filtering && hit(item.search);
+					const preview = useSnippet ? snippetNodes(item.search, kw, 20, 50) : item.preview;
+					const hasPreview = preview !== null && preview !== "" && (!Array.isArray(preview) || preview.length > 0);
 					return React.createElement("button", {
 						key: item.key,
 						type: "button",
 						ref: (el) => { itemEls[item.key] = el; },
-						className: "cnvnav-item" + (item.key === snap.activeKey ? " cnvnav-item-active" : ""),
+						className: "cnvnav-item" + (item.key === snap.activeKey ? " cnvnav-item-active" : "") + (staggerMs !== undefined ? " cnvnav-fade-item" : ""),
+						style: staggerMs !== undefined ? { animationDelay: staggerMs + "ms" } : undefined,
 						onClick: () => jumpTo(item.key),
 					},
 						React.createElement("span", { className: "cnvnav-badge cnvnav-badge-" + item.cls }, item.label),
-						item.preview !== null && item.preview !== ""
-							? React.createElement("span", { className: "cnvnav-item-preview" }, item.preview)
+						hasPreview
+							? React.createElement("span", { className: "cnvnav-item-preview" }, preview)
 							: null,
 						item.time !== ""
 							? React.createElement("span", { className: "cnvnav-item-time" }, item.time)
 							: null,
 					);
 				}
-				function renderGroupHead(g, groupActive) {
+				function renderGroupHead(g, groupActive, chevron) {
+					const headSearch = g.items.length > 0 ? g.items[0].search : null;
+					const useSnippet = filtering && hit(headSearch);
+					const sub = useSnippet ? snippetNodes(headSearch, kw, 15, 40) : g.subtitle;
+					const hasSub = sub !== "" && (!Array.isArray(sub) || sub.length > 0);
 					return React.createElement("div", {
 						ref: (el) => { groupEls[g.gid] = el; },
 						className: "cnvnav-group-row" + (groupActive ? " cnvnav-group-row-active" : ""),
@@ -584,12 +665,13 @@ window.__ModuleLoader__.load({
 									onClick: () => jumpTo(g.headKey),
 								},
 									React.createElement("span", { className: "cnvnav-group-title" }, g.title),
-									g.subtitle !== ""
-										? React.createElement("span", { className: "cnvnav-group-sub" }, g.subtitle)
+									hasSub
+										? React.createElement("span", { className: "cnvnav-group-sub" }, sub)
 										: null,
 								),
 							),
 						),
+						chevron !== undefined ? chevron : null,
 					);
 				}
 
@@ -597,14 +679,27 @@ window.__ModuleLoader__.load({
 				if (filtering) {
 					groupNodes = [];
 					for (const g of groups) {
-						const subtitleHit = hit(g.subtitle);
-						const hitItems = g.items.filter((it) => hit(it.preview) || hit(it.label));
-						if (!subtitleHit && hitItems.length === 0) continue;
-						const rows = subtitleHit ? g.items : hitItems;
+						const headHit = g.headIsUser && g.items.length > 0 && hit(g.items[0].search);
+						const hits = g.items.filter((it, i) =>
+							(it.kind === "user" || it.kind === "assistant-step") &&
+							hit(it.search) &&
+							!(i === 0 && g.headIsUser)
+						);
+						if (!headHit && hits.length === 0) continue;
 						const groupActive = g.items.some((it) => it.key === snap.activeKey);
-						groupNodes.push(React.createElement("div", { key: g.gid, className: "cnvnav-group" },
-							renderGroupHead(g, groupActive),
-							rows.map(renderItem),
+						groupNodes.push(React.createElement("div", {
+							key: g.gid,
+							className: "cnvnav-group cnvnav-fade-item",
+							style: { animationDelay: (groupNodes.length * 18) + "ms" },
+						},
+							renderGroupHead(g, groupActive, null),
+							hits.length > 0
+								? React.createElement("div", { className: "cnvnav-steps" },
+									React.createElement("div", { className: "cnvnav-steps-inner" },
+										hits.map((it, i) => renderItem(it, i * 20)),
+									),
+								)
+								: null,
 						));
 					}
 				} else {
@@ -614,44 +709,83 @@ window.__ModuleLoader__.load({
 						const stepItems = isTurnGroup ? (g.headIsUser ? g.items.slice(1) : g.items) : [];
 						const hasSteps = stepItems.length > 0;
 						const groupActive = g.items.some((it) => it.key === snap.activeKey);
+						const chevron = hasSteps
+							? React.createElement(Tooltip, {
+								label: expanded ? "折叠步次" : "展开步次",
+								side: "top",
+								delayMs: 500,
+							},
+								React.createElement("span", { className: "cnvnav-chevron-wrap" },
+									React.createElement("button", {
+										type: "button",
+										className: "cnvnav-chevron",
+										"aria-expanded": expanded,
+										onClick: (e) => {
+											e.stopPropagation();
+											setState({ expanded: Object.assign({}, state.expanded, { [g.gid]: !expanded }) });
+										},
+									},
+										React.createElement("svg", {
+										className: "cnvnav-chevron-icon",
+										viewBox: "0 0 12 12", width: 12, height: 12, fill: "none",
+										stroke: "currentColor", strokeWidth: 1.5, strokeLinecap: "round", strokeLinejoin: "round",
+										"aria-hidden": true,
+									},
+										React.createElement("path", { d: "M4.5 2.5 8 6l-3.5 3.5" }),
+									),
+									expanded ? null : React.createElement("span", { className: "cnvnav-chevron-count" }, String(stepItems.length)),
+									),
+								),
+							)
+							: null;
 						return React.createElement("div", { key: g.gid, className: "cnvnav-group" },
-							renderGroupHead(g, groupActive),
+							renderGroupHead(g, groupActive, chevron),
 							hasSteps
-								? React.createElement(Tooltip, {
-									label: expanded ? "折叠步次" : "展开步次",
-									side: "top",
-									delayMs: 500,
+								? React.createElement("div", {
+									className: "cnvnav-steps" + (expanded ? "" : " cnvnav-steps-collapsed"),
+									"aria-hidden": !expanded,
 								},
-									React.createElement("span", { className: "cnvnav-chevron-wrap" },
-										React.createElement("button", {
-											type: "button",
-											className: "cnvnav-chevron",
-											"aria-expanded": expanded,
-											onClick: (e) => {
-												e.stopPropagation();
-												setState({ expanded: Object.assign({}, state.expanded, { [g.gid]: !expanded }) });
-											},
-										},
-											expanded ? "▾" : "▸ " + stepItems.length,
-										),
+									React.createElement("div", { className: "cnvnav-steps-inner" },
+										stepItems.map(renderItem),
 									),
 								)
 								: null,
-							expanded && hasSteps
-								? stepItems.map(renderItem)
-								: null,
 						);
 					});
 				}
 
 				return React.createElement("div", {
 					ref: (el) => { panelEl = el; },
-					className: "cnvnav-panel",
+					className: "cnvnav-panel" + (snap.open ? "" : " cnvnav-panel-hidden"),
 					role: "complementary",
 					"aria-label": "会话导航",
+					"aria-hidden": !snap.open,
 				},
 					React.createElement("div", { className: "cnvnav-head" },
-						React.createElement("span", { className: "cnvnav-title" }, "会话导航"),
+						React.createElement(Tooltip, {
+							label: searchOpen ? "收起搜索" : "搜索关键词",
+							side: "bottom",
+							delayMs: 500,
+						},
+							React.createElement("span", { className: "cnvnav-search" },
+								React.createElement(Button, {
+									variant: "ghost",
+									size: "sm",
+									icon: React.createElement(IconSearchOutline16, { size: 14 }),
+									onClick: () => toggleSearch(),
+								}),
+							),
+						),
+						searchOpen
+							? React.createElement("input", {
+								type: "text",
+								className: "cnvnav-filter",
+								placeholder: "请输入关键词",
+								value: filter,
+								autoFocus: true,
+								onChange: (e) => setFilter(e.target.value),
+							})
+							: null,
 						React.createElement("span", { className: "cnvnav-count" }, (filtering ? groupNodes.length + " / " : "") + String(count) + " 条"),
 						React.createElement(Tooltip, {
 							label: "收起面板",
@@ -668,15 +802,6 @@ window.__ModuleLoader__.load({
 							),
 						),
 					),
-					React.createElement("div", { className: "cnvnav-filter-row" },
-						React.createElement("input", {
-							type: "text",
-							className: "cnvnav-filter",
-							placeholder: "过滤提问 / 回复…",
-							value: filter,
-							onChange: (e) => setFilter(e.target.value),
-						}),
-					),
 					React.createElement("div", { className: "cnvnav-topbar" },
 						React.createElement(Tooltip, {
 							label: "加载更早的一批轮次",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-conversation-navigator",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Codex 风格的 DSH(DeepSeek Harness)会话导航插件:按轮折叠的对话大纲面板,支持节点点击跳转、滚动位置高亮与轨迹视图同款配色。",
   "keywords": [
     "dsh",