dsh-conversation-navigator 0.1.20 → 0.1.22

package/README.md

@@ -4,6 +4,10 @@ Codex 风格的 **DeepSeek Harness(DSH)Web 端会话导航面板**:在对话页*
 
 纯浏览器插件(无宿主行为)、纯 JavaScript、零构建、零 npm 依赖(按钮/Tooltip 复用 DSH 内核 seed 的官方 primitives)。
 
+![会话导航面板](https://raw.githubusercontent.com/gjj-star/dsh-conversation-navigator/main/assets/screenshots/01-main.png)
+
+> 完整截图见 [assets/screenshots](./assets/screenshots)。其中「社区皮肤适配」两张为第三方皮肤下的效果(动漫女仆主题与君の名は主题),非插件自带。
+
 ## 功能
 
 - **按轮折叠大纲**:默认只显示"第 N 轮 + 你的问题"列表,长对话一目了然

package/lib/client.js

@@ -92,6 +92,7 @@ window.__ModuleLoader__.load({
   transition: opacity .18s ease, transform .18s ease;
 }
 .cnvnav-panel-hidden { opacity: 0; transform: translateY(-6px) scale(.985); pointer-events: none; }
+.cnvnav-panel-unplaced { visibility: hidden; }
 .cnvnav-head {
   display: flex; align-items: center; gap: 8px;
   padding: 10px 12px;
@@ -571,23 +572,59 @@ window.__ModuleLoader__.load({
 
 				React.useEffect(() => {
 					if (!snap.open) return;
+					let lastKey = null;
+					let stableTicks = 0;
+					let misses = 0;
 					function place() {
 						const panel = panelEl;
-						if (panel === null) return;
+						if (panel === null) return false;
 						const vw = document.documentElement.clientWidth || 1000;
 						const vh = document.documentElement.clientHeight || 800;
 						const sp = document.querySelector("[data-conversation-scroll]");
-						const rect = sp !== null ? sp.getBoundingClientRect() : { top: 60, height: vh - 90 };
 						const width = 288;
-						const left = Math.max(8, vw - width - 12);
-						panel.style.left = Math.round(left) + "px";
-						panel.style.top = Math.max(8, Math.round(rect.top + 8)) + "px";
-						panel.style.maxHeight = Math.round(Math.min(rect.height - 24, vh - 40)) + "px";
+						if (sp === null) {
+							/* 会话视图可能尚未挂载(刷新/重启/切会话时面板先就位);
+							   非会话页(设置页等)则永远没有该容器。
+							   连续 15 次(约 6s)仍未出现才回退到视口定位, 否则保持隐藏等待校准。 */
+							misses += 1;
+							if (misses >= 15) {
+								panel.style.left = Math.max(8, vw - width - 12) + "px";
+								panel.style.top = Math.max(8, 60) + "px";
+								panel.style.maxHeight = Math.round(vh - 90) + "px";
+								panel.classList.remove("cnvnav-panel-unplaced");
+								return true;
+							}
+							return false;
+						}
+						const r = sp.getBoundingClientRect();
+						const key = [Math.round(r.top), Math.round(r.height), Math.round(vw), Math.round(vh)].join("|");
+						if (key !== lastKey) {
+							lastKey = key;
+							panel.style.left = Math.max(8, vw - width - 12) + "px";
+							panel.style.top = Math.max(8, Math.round(r.top + 8)) + "px";
+							panel.style.maxHeight = Math.round(Math.min(r.height - 24, vh - 40)) + "px";
+						}
+						panel.classList.remove("cnvnav-panel-unplaced");
+						return true;
 					}
 					place();
+					/* 每 400ms 复查: 容器出现即校准; 布局连续 3 次无变化后停止 */
+					let id = setInterval(() => {
+						const before = lastKey;
+						if (!place()) return;
+						if (lastKey !== null && lastKey === before) {
+							stableTicks += 1;
+							if (stableTicks >= 3) clearInterval(id);
+						} else {
+							stableTicks = 0;
+						}
+					}, 400);
 					window.addEventListener("resize", place);
-					return () => window.removeEventListener("resize", place);
-				}, [snap.open]);
+					return () => {
+						clearInterval(id);
+						window.removeEventListener("resize", place);
+					};
+				}, [snap.open, snap.sessionId]);
 
 				React.useEffect(() => {
 					if (!snap.open) return;
@@ -821,7 +858,7 @@ window.__ModuleLoader__.load({
 
 				return React.createElement("div", {
 					ref: (el) => { panelEl = el; },
-					className: "cnvnav-panel" + (snap.open ? "" : " cnvnav-panel-hidden"),
+					className: "cnvnav-panel cnvnav-panel-unplaced" + (snap.open ? "" : " cnvnav-panel-hidden"),
 					role: "complementary",
 					"aria-label": "会话导航",
 					"aria-hidden": !snap.open,

package/package.json

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