@linxin666/dsh-ssh 0.2.0 → 0.2.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   node scripts/verify-docs.mjs --write <dir>
-README.md: 4ea116d416ac311ffde1f1052d9857e46b9c4849
-README.zh.md: d5bec45d8054b999d24832a4a8d103269b2c816d
+README.md: 4f2f068da6af190caeadf8deeffce24d138c6b37
+README.zh.md: d0090dd49663cf397e4980b70127659cb041fea9

package/README.md

@@ -33,10 +33,10 @@ Built on the capability list of [badseal/ssh-skill](https://github.com/badseal/s
 Install the family aggregate package `@linxin666/dsh-web-ui-all` (all plugins and skins in one) or this plugin alone:
 
 ```sh
-### 从 npm 安装（推荐）
-dsh plugin --profile web add @linxin666/dsh-ssh
+### From npm (recommended)
+dsh plugin --profile web add @linxin666/dsh-ssh@latest
 
-### 从仓库安装（开发调试）
+### From the repository (development)
 git clone https://github.com/zhu1090093659/dsh-web-ui.git
 cd dsh-web-ui
 pnpm install && pnpm -r build
@@ -53,7 +53,7 @@ The settings panel (plugin config) toggles `announceToAgent` (whether to announc
 ## Data
 
 - Host config: `~/.dsh/dsh-ssh.json` (versioned JSON, atomic write)
-- Transfer staging: `os.tmpdir()/dsh-ssh-uploads/`
+- Transfer staging: `os.tmpdir()/dsh-ssh-uploads/` (0700 directory, 0600 in-flight files)
 
 ## Development
 

package/README.zh.md

@@ -34,7 +34,7 @@
 
 ```sh
 ### 从 npm 安装（推荐）
-dsh plugin --profile web add @linxin666/dsh-ssh
+dsh plugin --profile web add @linxin666/dsh-ssh@latest
 
 ### 从仓库安装（开发调试）
 git clone https://github.com/zhu1090093659/dsh-web-ui.git
@@ -53,7 +53,7 @@ dsh plugin --profile web add link:$(pwd)/packages/dsh-ssh
 ## 数据
 
 - 主机配置：`~/.dsh/dsh-ssh.json`（版本化 JSON，原子写入）
-- 传输暂存：`os.tmpdir()/dsh-ssh-uploads/`
+- 传输暂存：`os.tmpdir()/dsh-ssh-uploads/`（目录 0700，传输中的文件 0600）
 
 ## 开发
 

package/lib/client.js

@@ -14864,7 +14864,8 @@ window.__ModuleLoader__.load({
 						className: panel_module_css_default.termWrap,
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 							ref: containerRef,
-							className: panel_module_css_default.termContainer
+							className: panel_module_css_default.termContainer,
+							"data-dsh-part": "terminal"
 						}), status.kind === "idle" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 							className: panel_module_css_default.termPlaceholder,
 							children: hosts.length === 0 ? tt("hosts.empty") : tt("terminal.placeholder")
@@ -15534,6 +15535,7 @@ window.__ModuleLoader__.load({
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: panel_module_css_default.tabBar,
 						role: "tablist",
+						"data-dsh-part": "tab-bar",
 						children: TABS.map((tab) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 							type: "button",
 							role: "tab",
@@ -15614,6 +15616,7 @@ window.__ModuleLoader__.load({
 				if (column === void 0) return;
 				container = document.createElement("div");
 				container.dataset.dshSshView = "";
+				container.dataset.dshPlugin = "ssh";
 				container.className = panel_module_css_default.view;
 				column.appendChild(container);
 				root = (0, react_dom_client.createRoot)(container);
@@ -15697,7 +15700,7 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
-		//#region src/client/sidebar-entry.ts
+		//#region src/client/sidebar-entry-core.ts
 		/** Find the sidebar shell root element, or undefined while not yet mounted. */
 		function sidebarRoot() {
 			const column = document.querySelector("[data-pane=\"sidebar\"], [class*=\"sidebarCol\"]");
@@ -15711,28 +15714,30 @@ window.__ModuleLoader__.load({
 			for (const child of root.children) if (child.tagName === "BUTTON") return child;
 		}
 		/** Build the entry row (a detached button; insert once the shell is up). */
-		function createEntry(controller) {
+		function createEntry(options) {
 			const entry = document.createElement("button");
 			entry.type = "button";
-			entry.dataset.dshSshEntry = "";
-			entry.className = panel_module_css_default.entry;
-			entry.setAttribute("aria-label", tt("entry.label"));
-			entry.setAttribute("title", tt("entry.tooltip"));
-			entry.innerHTML = "<span class=\"" + panel_module_css_default.entryIcon + "\"><svg viewBox=\"0 0 16 16\" width=\"14\" height=\"14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.3\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"2\" y=\"2.5\" width=\"12\" height=\"11\" rx=\"1.5\"/><path d=\"M4.5 5.5l2.5 2.5-2.5 2.5\"/><path d=\"M8.5 10.5h3\"/></svg></span><span class=\"" + panel_module_css_default.entryLabel + "\">" + tt("entry.label") + "</span>";
-			entry.addEventListener("click", () => {
-				controller.toggle();
-			});
+			entry.setAttribute(options.rowAttribute, "");
+			if (options.plugin !== void 0) {
+				entry.setAttribute("data-dsh-plugin", options.plugin);
+				entry.setAttribute("data-dsh-part", "sidebar-entry");
+			}
+			entry.className = options.css["entry"] ?? "";
+			entry.setAttribute("aria-label", options.label());
+			if (options.tooltip !== void 0) entry.setAttribute("title", options.tooltip());
+			entry.innerHTML = "<span class=\"" + (options.css["entryIcon"] ?? "") + "\">" + options.icon + "</span><span class=\"" + (options.css["entryLabel"] ?? "") + "\">" + options.label() + "</span>";
+			entry.addEventListener("click", options.onToggle);
 			return entry;
 		}
 		/** Re-insert the entry after the New Session row (before the browser region). */
-		function placeEntry(root, entry) {
+		function placeEntry(root, entry, options) {
 			const button = newSessionButton(root);
 			if (button === void 0) return false;
 			if (entry.parentElement !== root) {
 				const row = button.closest("[class*=\"logoRow\"]");
 				const base = row !== null && row.parentElement === root ? row : button;
-				const family = Array.from(root.children).filter((el) => el instanceof HTMLElement && el.matches("[data-dsh-taskboard-entry], [data-dsh-ssh-entry]"));
-				const anchor = family.length > 0 ? family[family.length - 1].nextElementSibling : base.nextElementSibling;
+				const family = Array.from(root.children).filter((el) => el instanceof HTMLElement && el.matches(options.familySelectors.join(", ")));
+				const anchor = options.position === "before" ? family.length > 0 ? family[0] : base.nextElementSibling : family.length > 0 ? family[family.length - 1].nextElementSibling : base.nextElementSibling;
 				root.insertBefore(entry, anchor);
 			}
 			return true;
@@ -15740,11 +15745,12 @@ window.__ModuleLoader__.load({
 		/**
 		* Mount the sidebar entry, waiting for the shell to render and self-healing
 		* on later React re-renders.
-		* @param controller - the panel controller the entry toggles.
+		* @param options - the row's attribute/icon/copy/action/ordering configuration.
 		* @returns disposer removing the entry and its observers.
 		*/
-		function mountSidebarEntry(controller) {
-			const entry = createEntry(controller);
+		function mountSidebarEntry$1(options) {
+			if (typeof document !== "undefined" && document.querySelector(options.rowSelector) !== null) return () => {};
+			const entry = createEntry(options);
 			let root;
 			let placed = false;
 			const tryPlace = () => {
@@ -15761,7 +15767,7 @@ window.__ModuleLoader__.load({
 				}
 				root ??= sidebarRoot();
 				if (root === void 0) return;
-				placed = placeEntry(root, entry);
+				placed = placeEntry(root, entry, options);
 				if (placed) rootObserver.observe(root, {
 					childList: true,
 					subtree: true
@@ -15780,23 +15786,58 @@ window.__ModuleLoader__.load({
 					tryPlace();
 					return;
 				}
-				if (!root.contains(entry)) placed = placeEntry(root, entry);
+				if (!root.contains(entry)) placed = placeEntry(root, entry, options);
 			});
-			const syncActive = () => {
-				if (controller.getSnapshot().panelOpen) entry.dataset.active = "true";
-				else delete entry.dataset.active;
-			};
-			const unsubscribe = controller.subscribe(syncActive);
-			syncActive();
+			const unsubscribeActive = options.active === void 0 ? void 0 : (() => {
+				const syncActive = () => {
+					if (options.active.isOpen()) entry.dataset.active = "true";
+					else delete entry.dataset.active;
+				};
+				const unsubscribe = options.active.subscribe(syncActive);
+				syncActive();
+				return unsubscribe;
+			})();
 			tryPlace();
 			return () => {
 				waitObserver.disconnect();
 				rootObserver.disconnect();
-				unsubscribe();
+				unsubscribeActive?.();
 				entry.remove();
 			};
 		}
 		//#endregion
+		//#region src/client/sidebar-entry.ts
+		/** Stable data attribute identifying the injected entry row. */
+		const ENTRY_SELECTOR = "[data-dsh-ssh-entry]";
+		/** Inline icon (matches the shell's 16px nav-icon look): a terminal prompt glyph. */
+		const ICON = "<svg viewBox=\"0 0 16 16\" width=\"14\" height=\"14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.3\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><rect x=\"2\" y=\"2.5\" width=\"12\" height=\"11\" rx=\"1.5\"/><path d=\"M4.5 5.5l2.5 2.5-2.5 2.5\"/><path d=\"M8.5 10.5h3\"/></svg>";
+		/**
+		* Mount the sidebar entry, waiting for the shell to render and self-healing
+		* on later React re-renders.
+		* @param controller - the panel controller the entry toggles.
+		* @returns disposer removing the entry and its observers.
+		*/
+		function mountSidebarEntry(controller) {
+			return mountSidebarEntry$1({
+				rowAttribute: "data-dsh-ssh-entry",
+				rowSelector: ENTRY_SELECTOR,
+				plugin: "ssh",
+				icon: ICON,
+				css: panel_module_css_default,
+				label: () => tt("entry.label"),
+				tooltip: () => tt("entry.tooltip"),
+				onToggle: () => {
+					controller.toggle();
+				},
+				position: "after",
+				familySelectors: ["[data-dsh-taskboard-entry]", "[data-dsh-ssh-entry]"],
+				active: {
+					subscribe: (listener) => controller.subscribe(listener),
+					isOpen: () => controller.getSnapshot().panelOpen
+				}
+			});
+		}
+		//#endregion
 		//#region src/client/index.ts
 		/** Locale namespace this plugin owns. */
 		const NS = "dsh-ssh";