dsh-multipane 1.0.2 → 1.0.3

package/README.md

@@ -1,4 +1,4 @@
-# dsh-split-view
+# dsh-multipane（多栏视图）
 
 Hermes 式多栏工作区，接管 DSH 主区：每栏一条自己的标签条、拖拽分栏、可关闭，最多四栏。
 
@@ -6,18 +6,22 @@ Hermes 式多栏工作区，接管 DSH 主区：每栏一条自己的标签条
 
 需要 DSH `0.2.1-rc.5` 及以上。装完**重启 DSH** 才会生效。
 
+> **名字必须三处一致**：`package.json` 的 `name`、`cordis.patch.yml` 的 `name`、`lib/client.js` 里的模块 `id`
+> 三者要完全相同，否则 DSH 会静默不加载（控制台报 `import failed` / `duplicate factory registration`）。
+> 所以本项目**不做发布期改名**，本地开发名和 npm 包名就是同一个 `dsh-multipane`。
+
 ### 方式一（推荐）：npm
 
 在 DSH「设置 → 添加插件」里粘贴包名：
 
 ```
-@weiaisuyansjd/dsh-split-view
+dsh-multipane
 ```
 
 或者命令行：
 
 ```sh
-npx @deepseek-ai/dsh plugin --profile desktop add @weiaisuyansjd/dsh-split-view
+npx @deepseek-ai/dsh plugin --profile desktop add dsh-multipane
 ```
 
 npm 走公共 registry，有国内镜像可用，比 GitHub 稳。
@@ -30,24 +34,31 @@ npm 走公共 registry，有国内镜像可用，比 GitHub 稳。
 npx @deepseek-ai/dsh plugin --profile desktop add github:weiaisuyan/dsh-split-view
 ```
 
-### ⚠️ 不要和 npm 上的 `dsh-split-view` 混装
+仓库名仍是 `dsh-split-view`，但包名取自 `package.json`，装下来同样叫 `dsh-multipane`。
+
+### ⚠️ 别和作者 luckybilly 的 `dsh-split-view` 同时启用
 
-npm 上有一个**同名不同源**的插件 `dsh-split-view`（作者 luckybilly），它也是给 DSH 做多会话分屏的，但实现路线完全不同（每栏跑一个 iframe 客户端）。两者装名会撞车：
+npm 上另有一个插件 `dsh-split-view`（作者 luckybilly），也是给 DSH 做多会话分屏，实现路线完全不同（每栏跑一个 iframe 客户端）。
 
 | 来源 | 安装名 |
 | --- | --- |
-| 本插件（npm） | `@weiaisuyansjd/dsh-split-view` |
-| 本插件（GitHub 直装） | `dsh-split-view`（取自仓库 package.json） |
+| 本插件（npm / GitHub 装法都一样） | `dsh-multipane` |
 | 另一个作者的插件 | `dsh-split-view` |
 
-也就是说 **GitHub 直装的版本和 luckybilly 那个包同名**。两个都装会互相覆盖，表现出来是「插件时有时无、改了没反应」。装之前先确认机器上没有另一个 `dsh-split-view`。
+两者**名字不同、不会互相覆盖**，但都在抢主区，同时启用会互相打架（栏结构错乱、设置页串台）。只留一个，装前先确认：
+
+```sh
+npx @deepseek-ai/dsh plugin list | grep split-view
+```
+
+如果你装过本插件的旧版本（`@weiaisuyansjd/dsh-split-view`，或 GitHub 直装的 `dsh-split-view`），先按下面的命令卸掉再装新版。
 
 ### 卸载
 
 ```sh
-# npm 装的
+npx @deepseek-ai/dsh plugin --profile desktop remove dsh-multipane
+# 旧版本（如果装过）
 npx @deepseek-ai/dsh plugin --profile desktop remove @weiaisuyansjd/dsh-split-view
-# GitHub 装的
 npx @deepseek-ai/dsh plugin --profile desktop remove dsh-split-view
 ```
 
@@ -58,6 +69,8 @@ npx @deepseek-ai/dsh plugin --profile desktop remove dsh-split-view
 - **npm 装**：重跑一次 `add`（或先 `remove` 再 `add`）
 - **GitHub 装**：必须 `remove` 后重新 `add`，否则不会拉到新提交
 
+升级/换装都不会丢布局：栏、标签、栏宽存在 `localStorage`（键名固定为 `dsh-split-view:*`，与包名无关）。
+
 ## 交互
 
 | 动作 | 结果 |

package/lib/client.js

@@ -2602,6 +2602,14 @@ window.__ModuleLoader__.load({
 						actions.setHover(null);
 					},
 					onDrop: (event) => {
+						/* 外部文件拖拽（我们自己的标签/会话都不在拖）：**原样放行**。
+						   宿主的 @deepseek-ai/dsh-client-ui-attachment 在 document 上挂了
+						   dragenter/drop 监听，靠 dragDepth 计数器控制「拖到此处添加」遮罩；
+						   drop 是外部拖拽唯一能把它归零的时刻（window 的 dragend 只对页面内
+						   发起的拖拽触发）。这里一旦 stopPropagation，宿主收不到 drop →
+						   计数器永久卡住 → 遮罩常驻且界面没有任何退出入口。
+						   标签/会话的正常拖拽照旧走下面的 preventDefault + stopPropagation。 */
+						if (drag.sessionId === null && drag.tab === null) return;
 						event.preventDefault();
 						event.stopPropagation();
 						if (drag.tab !== null && drag.tab.paneId === pane.id) {
@@ -2869,6 +2877,9 @@ window.__ModuleLoader__.load({
 						actions.setHover(null);
 					},
 					onDrop: (event) => {
+						/* 同 PaneHeader：外部文件拖拽一律放行，让宿主的 document 级 drop
+						   收到并重置 dragDepth（否则「拖到此处添加」遮罩永久常驻）。 */
+						if (drag.sessionId === null && drag.tab === null) return;
 						event.preventDefault();
 						event.stopPropagation();
 						if (event.target instanceof Element && event.target.closest(".dsv-paneheader") !== null) return;
@@ -6135,53 +6146,53 @@ window.__ModuleLoader__.load({
 			   看到的是同一套项：置顶 / 重命名 / 分叉 / 归档 / 复制会话 ID…（全部由宿主注册表提供，
 			   官方以后新增项自动出现，我们只加「锁定标签」这一条）。
 			   resolve 在 React 之外被调用 → 只能通过 LIVE_STATE / LIVE_APPLY 读状态、写状态。 */
-			ctx.effect(() => {
-				let sub = null;
-				try {
-					/* Cordis 运行时依赖声明：回调里的 inner ctx 才有权访问 contextMenus。
-					   顺手把服务引用存 MENUS，供标签右键直接 open 宿主菜单。 */
-					sub = ctx.inject(["contextMenus"], (inner) => {
-						MENUS = inner.contextMenus;
-						try {
-							inner.contextMenus.register({
-								id: "session.dsv-tab-lock",
-								target: "session",
-								order: 900,
-								resolve: (value) => {
-									const sessionId = value !== null && value !== void 0 ? value.sessionId : void 0;
-									const state = LIVE_STATE;
-									if (typeof sessionId !== "string" || state === null) return [];
-									const hit = findSession(state, sessionId);
-									if (hit === void 0) return [];
-									const locked = hit.tab.locked === true;
-									return [
-										{
-											id: "dsv-tab-lock",
-											label: locked ? "解锁标签" : "锁定标签",
-											separatorBefore: true,
-											run: () => {
-												if (typeof LIVE_APPLY !== "function") return;
-												LIVE_APPLY((prev) => toggleLockTab(prev, hit.pane.id, hit.tab.id));
-											}
-										}
-									];
-								}
-							});
-						} catch (error) {
-							console.warn("[split-view] 注册会话菜单项失败:", error);
-						}
-					});
-				} catch (error) {
-					console.warn("[split-view] contextMenus 注入失败:", error);
-				}
-				return () => {
-					MENUS = null;
-					try {
-						if (sub !== null && typeof sub.dispose === "function") sub.dispose();
-					} catch {
-						/* 忽略 */
-					}
-				};
+			ctx.effect(() => {
+				let sub = null;
+				try {
+					/* Cordis 运行时依赖声明：回调里的 inner ctx 才有权访问 contextMenus。
+					   顺手把服务引用存 MENUS，供标签右键直接 open 宿主菜单。 */
+					sub = ctx.inject(["contextMenus"], (inner) => {
+						MENUS = inner.contextMenus;
+						try {
+							inner.contextMenus.register({
+								id: "session.dsv-tab-lock",
+								target: "session",
+								order: 900,
+								resolve: (value) => {
+									const sessionId = value !== null && value !== void 0 ? value.sessionId : void 0;
+									const state = LIVE_STATE;
+									if (typeof sessionId !== "string" || state === null) return [];
+									const hit = findSession(state, sessionId);
+									if (hit === void 0) return [];
+									const locked = hit.tab.locked === true;
+									return [
+										{
+											id: "dsv-tab-lock",
+											label: locked ? "解锁标签" : "锁定标签",
+											separatorBefore: true,
+											run: () => {
+												if (typeof LIVE_APPLY !== "function") return;
+												LIVE_APPLY((prev) => toggleLockTab(prev, hit.pane.id, hit.tab.id));
+											}
+										}
+									];
+								}
+							});
+						} catch (error) {
+							console.warn("[split-view] 注册会话菜单项失败:", error);
+						}
+					});
+				} catch (error) {
+					console.warn("[split-view] contextMenus 注入失败:", error);
+				}
+				return () => {
+					MENUS = null;
+					try {
+						if (sub !== null && typeof sub.dispose === "function") sub.dispose();
+					} catch {
+						/* 忽略 */
+					}
+				};
 			}, "dsh-split-view: tab lock session menu");
 			SERVICES.sessions = service("sessions");
 			SERVICES.layout = service("layout");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-multipane",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Hermes-style tabbed workspace for the DSH main area: drag sessions in, split into up to four columns, close tabs.",
   "type": "module",
   "main": "lib/index.js",