dsh-multi-chat 0.5.2 → 0.6.1

package/README.md

@@ -1,6 +1,13 @@
 # 💬 dsh-multi-chat —— 多对话，一屏驾驭
 
-> **在 DeepSeek Harness 里同时开 N 个对话，并排盯住每一个 Agent 的实时进度，还能用手机躺着看。** 一个浏览器，从「一次一个对话」升级成「全景多对话驾驶舱」。
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-multi-chat"><img src="https://img.shields.io/npm/v/dsh-multi-chat" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/dsh-multi-chat"><img src="https://img.shields.io/npm/dm/dsh-multi-chat" alt="npm downloads"></a>
+  <a href="https://github.com/daetz-coder/dsh-multi-chat/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="license"></a>
+  <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/dsh-plugin-✓-brightgreen" alt="dsh-plugin"></a>
+</p>
+
+> **在 DeepSeek Harness 里同时开 N 个对话，并排盯住每一个 Agent 的实时进度，还能用手机/平板躺着看。** 一个浏览器，从「一次一个对话」升级成「全景多对话驾驶舱」。
 
 给 [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) 官方 Web 界面装上一面**多窗口墙**：在一张网格里同时显示 N 个正在运行的 DSH 对话实例（每个实例独立跑一个任务），所有 Agent 的实时进度、对话、输出**一眼尽收**，不用在无数标签页/窗口之间切来切去。
 
@@ -8,7 +15,7 @@
 
 | 能力 | 说明 |
 |------|------|
-| 📺 **多窗口墙** | 侧边栏一键进入，右侧对话区原位变成窗口网格，一个端口一格，并排看全部任务 |
+| 📺 **多窗口** | 侧边栏一键进入，右侧对话区原位变成窗口网格，一个端口一格，并排看全部任务 |
 | 🔍 **自动发现** | 扫描端口区间自动发现正在运行的 DSH 实例，也可手动管理 |
 | ➕ **一键新建窗口** | 墙内直接启动全新 DSH 实例，凑成你的多对话矩阵 |
 | 📱 **手机访问** | 点「手机访问」自动起一个**内置带口令认证的局域网网关**，手机打开 URL、输入口令即可看进度 |
@@ -16,6 +23,20 @@
 
 > **多对话 = 多端口。** 启动 N 个 `dsh web --port <n>`，每个实例独立跑一个对话/任务；在任意一个实例里打开多窗口墙，即可并排看到全部。
 
+## 📸 运行效果
+
+**🖥️ Windows · 双对话并排** —— 两个正在运行的 DSH 实例并排列出，每格都是完整的官方对话界面，带实时在线状态点与单窗控制（放大 / 刷新 / 新标签页 / 移除）：
+
+![Windows 双对话：两个 DSH 实例并排显示](assets/01-windows-dual-chat.png)
+
+**📱 iPad · 双对话移动端** —— 同一局域网内，iPad 打开带口令认证的网关地址，即可在平板上一屏并排盯住两个 Agent 的实时进度：
+
+![iPad 双对话：平板端并排显示两个 DSH 实例](assets/02-ipad-dual-chat.png)
+
+**🖥️ Windows · 三对话全景** —— 3 列网格并排显示 3 个正在运行的实例，一屏尽收全部 Agent，把「一次一个对话」升级成「全景多对话驾驶舱」：
+
+![Windows 三对话：3 列网格并排显示 3 个 DSH 实例](assets/03-windows-triple-chat.png)
+
 ## 🚀 30 秒上手
 
 ```bash
@@ -25,7 +46,7 @@ npx dsh-multi-chat install
 # 2. 启动几个实例
 npx dsh-multi-chat start --ports 3080,3081,3082
 
-# 3. 打开任意实例，点侧边栏底部「多窗口墙」→ 完成 🎉
+# 3. 打开任意实例，点侧边栏底部「多窗口」→ 完成 🎉
 ```
 
 ## 为什么这样做
@@ -60,7 +81,7 @@ harness-src/                       # 官方 deepseek-harness 源码（开发/构
 
 # 2) 重启 dsh web，打开任意实例
 dsh web --port 3084
-# 浏览器打开 http://127.0.0.1:3084 ，侧边栏底部出现「多窗口墙」按钮
+# 浏览器打开 http://127.0.0.1:3084 ，侧边栏底部出现「多窗口」按钮
 ```
 
 或手动：
@@ -74,7 +95,7 @@ dsh plugin --profile web add <tarball>                  # 装进 profile
 ## 使用
 
 1. 先启动若干实例：`.\scripts\start-multi.ps1 -Ports "3080,3081,3082,3084"`（或手动 `dsh web --port <n>`）。
-2. 打开任意实例，点侧边栏底部的「多窗口墙」快捷入口（或点对话区头部的「多窗口墙」标签页）。
+2. 打开任意实例，点侧边栏底部的「多窗口」快捷入口（或点对话区头部的「多窗口」标签页）。
 3. 墙视图内：自动发现实例（自动排除自身端口）、列数切换（自动/1/2/3/4/6，默认横向铺满）、点标题放大、⟳ 单独刷新、↗ 新标签页打开、✕ 从视图移除、全部刷新、实时在线状态点。布局保存在 localStorage。
 4. 退出墙：点工具栏**右上角的「退出」按钮**，一键切回对话视图。
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-multi-chat",
-  "version": "0.5.2",
-  "description": "DSH 多对话：在官方 DeepSeek Harness Web 界面里并排运行和监控多个对话实例（多窗口墙），并内置带口令认证的手机访问网关。npx dsh-multi-chat install|start|stop",
+  "version": "0.6.1",
+  "description": "DSH 多对话：在官方 DeepSeek Harness Web 界面里以多窗口网格并排运行、监控多个对话实例，一屏盯住所有 Agent 的实时进度；内置带口令认证的局域网网关，手机/平板也能看。npx dsh-multi-chat install|start|stop|gateway",
   "license": "MIT",
   "type": "module",
   "bin": {
@@ -21,6 +21,8 @@
     "deepseek",
     "multi-chat",
     "multi-conversation",
+    "multi-window",
+    "multi-agent",
     "client-plugin",
     "gateway",
     "phone-access"
@@ -29,6 +31,7 @@
     "bin/",
     "scripts/",
     "patches/",
+    "assets/",
     "plugin/dsh-client-ui-multi-wall/package.json",
     "plugin/dsh-client-ui-multi-wall/README.md",
     "plugin/dsh-client-ui-multi-wall/lib/index.js",

package/plugin/dsh-client-ui-multi-wall/lib/client.js

@@ -242,27 +242,27 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var WallView_module_css_default = {
-			"danger": "ouhzTG_danger",
-			"action": "ouhzTG_action",
-			"confirm": "ouhzTG_confirm",
-			"field": "ouhzTG_field",
+			"paneActions": "ouhzTG_paneActions",
+			"linkBar": "ouhzTG_linkBar",
 			"wall": "ouhzTG_wall",
-			"grid": "ouhzTG_grid",
+			"action": "ouhzTG_action",
+			"danger": "ouhzTG_danger",
+			"paneBody": "ouhzTG_paneBody",
+			"title": "ouhzTG_title",
 			"hint": "ouhzTG_hint",
+			"empty": "ouhzTG_empty",
+			"zoomed": "ouhzTG_zoomed",
+			"field": "ouhzTG_field",
+			"paneHead": "ouhzTG_paneHead",
 			"status": "ouhzTG_status",
 			"paneTitle": "ouhzTG_paneTitle",
-			"controls": "ouhzTG_controls",
-			"linkText": "ouhzTG_linkText",
-			"paneHead": "ouhzTG_paneHead",
-			"paneBody": "ouhzTG_paneBody",
-			"empty": "ouhzTG_empty",
+			"grid": "ouhzTG_grid",
 			"dot": "ouhzTG_dot",
-			"toolbar": "ouhzTG_toolbar",
-			"linkBar": "ouhzTG_linkBar",
-			"title": "ouhzTG_title",
 			"pane": "ouhzTG_pane",
-			"paneActions": "ouhzTG_paneActions",
-			"zoomed": "ouhzTG_zoomed"
+			"confirm": "ouhzTG_confirm",
+			"toolbar": "ouhzTG_toolbar",
+			"controls": "ouhzTG_controls",
+			"linkText": "ouhzTG_linkText"
 		};
 		//#endregion
 		//#region src/client/WallView.tsx
@@ -294,6 +294,27 @@ window.__ModuleLoader__.load({
 		/** Embed flag appended to every pane URL; such pages register no wall UI. */
 		const EMBED_FLAG = "multi-wall=embed";
 		/**
+		* Whether this wall is being viewed through the phone gateway (a non-loopback
+		* host) rather than on the machine running DSH. When remote, pane iframes must
+		* load through the gateway's `/gw/<port>` route — a phone's `127.0.0.1` points
+		* at the phone itself, not the host.
+		*/
+		function isRemoteViewer() {
+			const host = typeof window !== "undefined" ? window.location.hostname : "";
+			return host !== "localhost" && host !== "127.0.0.1" && host !== "::1";
+		}
+		/**
+		* The iframe URL for a pane. Local viewers embed the loopback instance
+		* directly; remote (phone) viewers route through the gateway that is already
+		* serving this page, appending the port so the gateway proxies to it.
+		* @param port - target DSH instance port.
+		* @returns the pane URL.
+		*/
+		function paneUrl(port) {
+			if (isRemoteViewer()) return `${window.location.origin}/gw/${port}/?${EMBED_FLAG}`;
+			return `http://127.0.0.1:${port}/?${EMBED_FLAG}`;
+		}
+		/**
 		* One pane: header (port, liveness dot, zoom/refresh/open/stop/remove) plus
 		* the embedded original DSH UI.
 		*/
@@ -338,7 +359,7 @@ window.__ModuleLoader__.load({
 									className: WallView_module_css_default.action,
 									title: t("openTab"),
 									onClick: () => {
-										window.open(`http://127.0.0.1:${port}/`, "_blank");
+										window.open(paneUrl(port), "_blank");
 									},
 									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRightUpOutline16, { size: 14 })
 								}),
@@ -363,7 +384,7 @@ window.__ModuleLoader__.load({
 					className: WallView_module_css_default.paneBody,
 					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("iframe", {
 						title: `DSH :${port}`,
-						src: `http://127.0.0.1:${port}/?${EMBED_FLAG}`,
+						src: paneUrl(port),
 						loading: "lazy"
 					})
 				})]
@@ -660,8 +681,8 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var WallToggle_module_css_default = {
-			"label": "bmjS6q_label",
-			"row": "bmjS6q_row"
+			"row": "bmjS6q_row",
+			"label": "bmjS6q_label"
 		};
 		//#endregion
 		//#region src/client/WallToggle.tsx

package/plugin/dsh-client-ui-multi-wall/lib/index.js

@@ -170,11 +170,13 @@ function injectPolyfill(body) {
 * `127.0.0.1:<target-port>` so the DSH `/api` browser-trust fence sees a local
 * request. Non-upgrade requests get `connection: close` (fresh connection per
 * request keeps keep-alive from smuggling unrewritten Host headers); upgrades
-* (WebSocket) keep `connection: Upgrade`.
+* (WebSocket) keep `connection: Upgrade`. When `pathOverride` is set (a
+* `/gw/<port>` route), the request line's path becomes the de-prefixed path.
 */
-function rewriteHead(parsed, targetPort) {
+function rewriteHead(parsed, targetPort, pathOverride) {
 	const upgrade = parsed.map.upgrade !== void 0;
-	const lines = [`${parsed.method} ${parsed.target} ${parsed.version}`];
+	const requestTarget = pathOverride !== void 0 ? pathOverride : parsed.target;
+	const lines = [`${parsed.method} ${requestTarget} ${parsed.version}`];
 	for (const [name, value] of parsed.headers) if (name === "host") lines.push(`host: 127.0.0.1:${targetPort}`);
 	else if (name === "origin") lines.push(`origin: http://127.0.0.1:${targetPort}`);
 	else if (name === "connection" || name === "proxy-connection") {} else lines.push(`${name}: ${value}`);
@@ -187,7 +189,8 @@ function rewriteHead(parsed, targetPort) {
 * @returns a handle with the assigned port and token, and a close().
 */
 function startGateway(options) {
-	const { targetPort, port: requestedPort, token, name, maxAgeHours = 12, log = () => {} } = options;
+	const { targetPort, port: requestedPort, token, name, maxAgeHours = 12, routedPorts, log = () => {} } = options;
+	const allowedRouted = new Set(routedPorts ?? []);
 	const hmac = (data) => createHmac("sha256", token).update(data).digest("hex");
 	const signSession = (exp) => {
 		const payload = Buffer.from(JSON.stringify({ exp })).toString("base64url");
@@ -412,6 +415,19 @@ connection: close\r
 				handleLogin(socket, parsed, buffer.subarray(parsed.headBytes));
 				return;
 			}
+			let routePort = null;
+			let routePath;
+			const routeMatch = /^\/gw\/(\d+)(\/.*)?$/.exec(path);
+			if (routeMatch !== null) {
+				const candidate = Number(routeMatch[1]);
+				if (!Number.isInteger(candidate) || candidate <= 0 || !allowedRouted.has(candidate)) {
+					respondPlain(socket, "403", "port not routable");
+					return;
+				}
+				routePort = candidate;
+				routePath = routeMatch[2] && routeMatch[2] !== "" ? routeMatch[2] : "/";
+			}
+			const effectivePort = routePort ?? targetPort;
 			const kind = authKind(parsed);
 			if (kind === "none") {
 				respondLogin(socket, name, path === "/" ? "/" : path);
@@ -421,19 +437,19 @@ connection: close\r
 				respondSessionRedirect(socket, parsed, `dsh_gw_session=${signSession(Date.now() + maxAgeHours * 36e5)}; Path=/; HttpOnly; SameSite=Strict; Max-Age=${maxAgeHours * 3600}`);
 				return;
 			}
-			const target = connect(targetPort, "127.0.0.1");
+			const target = connect(effectivePort, "127.0.0.1");
 			const rest = buffer.subarray(parsed.headBytes);
 			let connected = false;
 			target.on("connect", () => {
 				connected = true;
-				target.write(rewriteHead(parsed, targetPort));
+				target.write(rewriteHead(parsed, effectivePort, routePath));
 				if (rest.length > 0) target.write(rest);
 				proxying = true;
 				socket.pipe(target);
 				relayTarget(socket, target);
 			});
 			target.on("error", (error) => {
-				if (!connected) respondPlain(socket, "502", `cannot reach target 127.0.0.1:${targetPort}: ${error.message}`);
+				if (!connected) respondPlain(socket, "502", `cannot reach target 127.0.0.1:${effectivePort}: ${error.message}`);
 				socket.destroy();
 			});
 			socket.on("error", () => target.destroy());
@@ -817,7 +833,8 @@ function lanAddresses() {
 			if (virtual) continue;
 			candidates.push({
 				address: iface.address,
-				physical
+				physical,
+				virtual: false
 			});
 		}
 	}
@@ -960,11 +977,15 @@ function apply(ctx, config = {}) {
 				const token = config.gatewayToken && config.gatewayToken !== "" ? config.gatewayToken : randomBytes(6).toString("hex");
 				const gatewayPort = config.gatewayPort && config.gatewayPort !== 0 ? config.gatewayPort : port + 5e3;
 				gatewayTargetPort = port;
+				const routed = [];
+				for (let p = scanFrom; p <= scanTo; p++) routed.push(p);
+				for (const p of fixedPorts) if (!routed.includes(p)) routed.push(p);
 				return startGateway({
 					targetPort: port,
 					port: gatewayPort,
 					token,
 					name: "DSH",
+					routedPorts: routed,
 					log: (msg) => ctx.logger.info(`multi-wall gateway: ${msg}`)
 				}).then((handle) => {
 					gateway = handle;