@linxin666/dsh-ssh 0.2.0 → 0.2.2

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: f9476df50bac571b567512cfa5272b5a64a1c3d6
+README.zh.md: ec991222c0a38f2376acdd21ae52fe185facd0c2

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
@@ -48,12 +48,12 @@ After installing, **restart `dsh web`**: a "SSH" entry appears in the sidebar; t
 
 ## Configuration
 
-The settings panel (plugin config) toggles `announceToAgent` (whether to announce the plugin to the Agent) and `enabled` (master switch).
+The settings panel (plugin config) toggles `announceToAgent` (whether to announce the plugin to the Agent) and `enabled` (master switch), and sets `terminalFontFamily` (the web terminal font; empty defers to the CSS chain: `--dsh-ssh-terminal-font` → the official `--ds-font-family-code` token → the built-in monospace stack). The terminal font is fixed in the xterm constructor, so a plain stylesheet cannot override it; to render powerline / Nerd Font glyphs, enter a Nerd Font stack here (e.g. `"SauceCodePro Nerd Font", monospace`). Changes re-apply to open terminals live, no reconnect needed.
 
 ## 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
@@ -48,12 +48,12 @@ dsh plugin --profile web add link:$(pwd)/packages/dsh-ssh
 
 ## 配置
 
-设置面板（插件配置）可开关 `announceToAgent`（是否向 Agent 宣告插件）与 `enabled`（总开关）。
+设置面板（插件配置）可开关 `announceToAgent`（是否向 Agent 宣告插件）与 `enabled`（总开关），并可设置 `terminalFontFamily`（Web 终端字体，留空则按 CSS 链解析：`--dsh-ssh-terminal-font` → 官方 `--ds-font-family-code` token → 内置 monospace 栈）。终端字体写死在 xterm 构造参数里，CSS 无法直接覆盖；要渲染 powerline / Nerd Font 图标，请在此填入对应 Nerd Font 栈（如 `"SauceCodePro Nerd Font", monospace`），修改对已打开的终端即时生效，无需重连。
 
 ## 数据
 
 - 主机配置：`~/.dsh/dsh-ssh.json`（版本化 JSON，原子写入）
-- 传输暂存：`os.tmpdir()/dsh-ssh-uploads/`
+- 传输暂存：`os.tmpdir()/dsh-ssh-uploads/`（目录 0700，传输中的文件 0600）
 
 ## 开发
 

package/lib/client.js

@@ -609,6 +609,36 @@ window.__ModuleLoader__.load({
 			if (error instanceof Error) return error.message;
 			return String(error);
 		}
+		/**
+		* The terminal font stack used before issue #577, kept as the last resort
+		* when neither the plugin setting nor a CSS custom property names a font.
+		*/
+		const TERMINAL_FONT_FALLBACK = "Menlo, Consolas, \"Liberation Mono\", monospace";
+		/**
+		* Resolve the xterm `fontFamily` (issue #577). xterm's DOM renderer takes
+		* the font only from constructor/options, so a plain stylesheet rule cannot
+		* retarget it — the value must be read back into the options. The chain,
+		* first non-empty value wins:
+		*   1. `override` — the `terminalFontFamily` plugin setting;
+		*   2. `--dsh-ssh-terminal-font` — dedicated hook for skins and user CSS
+		*      (e.g. a Nerd Font for powerline glyphs);
+		*   3. `--ds-font-family-code` — the official code-font token several skins
+		*      already remap;
+		*   4. {@link TERMINAL_FONT_FALLBACK}.
+		*/
+		function resolveTerminalFontFamily(override) {
+			const trimmed = override?.trim();
+			if (trimmed !== void 0 && trimmed !== "") return trimmed;
+			if (typeof getComputedStyle === "function" && typeof document !== "undefined") {
+				const target = document.body ?? document.documentElement;
+				const style = getComputedStyle(target);
+				for (const name of ["--dsh-ssh-terminal-font", "--ds-font-family-code"]) {
+					const value = style.getPropertyValue(name).trim();
+					if (value !== "") return value;
+				}
+			}
+			return TERMINAL_FONT_FALLBACK;
+		}
 		//#endregion
 		//#region \0dsh-css:packages/dsh-ssh/src/client/panel/panel.module.css.mjs
 		const css = "[data-pane=conversation],[class*=centerCol]{position:relative}[data-dsh-ssh-view]{z-index:60;background:var(--dsw-alias-bg-base);display:none;position:absolute;inset:0}html[data-dsh-ssh-active]:not([data-dsh-taskboard-active]) [data-dsh-ssh-view]{display:block}html[data-dsh-ssh-active]:not([data-dsh-taskboard-active]) [data-pane=conversation]>:not([data-dsh-ssh-view]),html[data-dsh-ssh-active]:not([data-dsh-taskboard-active]) [class*=centerCol]>:not([data-dsh-ssh-view]){display:none!important}.mL8Uca_entry{width:100%;height:32px;color:var(--dsw-alias-label-secondary);cursor:pointer;white-space:nowrap;background:0 0;border:none;border-radius:8px;align-items:center;gap:8px;padding:0 12px;font-size:13px;display:flex}.mL8Uca_entry:hover{background:var(--dsw-specific-sidebar-nav-item-hover);color:var(--dsw-alias-label-primary)}.mL8Uca_entry[data-active]{background:var(--dsw-specific-sidebar-nav-item-active);color:var(--dsw-alias-label-primary);font-weight:600}.mL8Uca_entryIcon{flex:none;justify-content:center;align-items:center;display:inline-flex}.mL8Uca_entryLabel{text-overflow:ellipsis;overflow:hidden}[data-dsh-frame][data-sidebar-collapsed] .mL8Uca_entry{justify-content:center;width:100%;padding:0}[data-dsh-frame][data-sidebar-collapsed] .mL8Uca_entryLabel{display:none}.mL8Uca_view{overflow:hidden}.mL8Uca_panel{background:var(--dsw-alias-bg-base);min-width:0;height:100%;min-height:0;color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family);flex-direction:column;gap:10px;padding:14px 16px 16px;display:flex}.mL8Uca_panelHeader{flex:none;align-items:center;gap:10px;display:flex}.mL8Uca_panelTitle{color:var(--dsw-alias-label-primary);white-space:nowrap;flex:1;margin:0;font-size:16px;font-weight:700}.mL8Uca_backButton{align-items:center;gap:4px;display:inline-flex}.mL8Uca_tabBar{border-bottom:1px solid var(--dsw-alias-border-l1);flex:none;gap:2px;display:flex}.mL8Uca_tab{color:var(--dsw-alias-label-secondary);cursor:pointer;white-space:nowrap;background:0 0;border:none;border-bottom:2px solid #0000;border-radius:6px 6px 0 0;padding:7px 14px;font-size:13px}.mL8Uca_tab:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}.mL8Uca_tab[data-active]{color:var(--dsw-alias-label-primary);border-bottom-color:var(--dsw-alias-state-business-primary);font-weight:600}.mL8Uca_panelContent{flex-direction:column;flex:1;min-height:0;display:flex;overflow:hidden}.mL8Uca_tabBody{flex-direction:column;flex:1;gap:10px;min-height:0;display:flex;overflow-y:auto}.mL8Uca_fillBody{flex-direction:column;flex:1;gap:10px;min-height:0;display:flex;overflow:hidden}.mL8Uca_toolbar,.mL8Uca_controls{flex-wrap:wrap;flex:none;align-items:center;gap:8px;display:flex}.mL8Uca_controls .mL8Uca_input{flex:0 260px;min-width:150px}.mL8Uca_toolbarSpacer{flex:1}.mL8Uca_search{min-width:120px;color:var(--dsw-alias-label-primary);background:var(--dsw-specific-input-major);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;outline:none;flex:0 260px;padding:6px 10px;font-size:13px}.mL8Uca_search::placeholder{color:var(--dsw-alias-label-tertiary)}.mL8Uca_groupBySelect{color:var(--dsw-alias-label-primary);background:var(--dsw-specific-input-major);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;outline:none;padding:6px 8px;font-size:13px}.mL8Uca_groupSection+.mL8Uca_groupSection{border-top:1px solid var(--dsw-alias-border-l1)}.mL8Uca_groupHeader{background:var(--dsw-alias-bg-base,var(--dsw-specific-input-major));align-items:center;gap:8px;padding:4px 8px;display:flex;position:sticky;top:0}.mL8Uca_groupToggle{min-width:0;color:var(--dsw-alias-label-primary);cursor:pointer;text-align:left;background:0 0;border:none;border-radius:6px;flex:1;align-items:center;gap:6px;padding:4px 6px;font-size:12.5px;font-weight:500;display:flex}.mL8Uca_groupToggle:hover{background:var(--dsw-alias-interactive-bg-hover)}.mL8Uca_groupChevron{border-right:1.5px solid var(--dsw-alias-label-tertiary);border-bottom:1.5px solid var(--dsw-alias-label-tertiary);flex:none;width:7px;height:7px;margin-bottom:2px;transition:transform .12s;transform:rotate(45deg)}.mL8Uca_groupChevron[data-collapsed]{margin-bottom:0;transform:rotate(-45deg)}.mL8Uca_groupName{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.mL8Uca_groupCount{color:var(--dsw-alias-label-tertiary);flex:none;font-weight:400}.mL8Uca_tableWrap{border:1px solid var(--dsw-alias-border-l1);border-radius:10px;flex:1;min-height:0;overflow:auto}.mL8Uca_table{border-collapse:collapse;width:100%;font-size:12.5px}.mL8Uca_table th{z-index:1;text-align:left;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-secondary);border-bottom:1px solid var(--dsw-alias-border-l1);white-space:nowrap;padding:8px 10px;font-weight:600;position:sticky;top:0}.mL8Uca_table td{border-bottom:1px solid var(--dsw-alias-separator-primary);vertical-align:top;padding:7px 10px}.mL8Uca_table tbody tr:last-child td{border-bottom:none}.mL8Uca_table tbody tr:hover td{background:var(--dsw-alias-interactive-bg-hover)}.mL8Uca_mono{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}.mL8Uca_cellMuted{color:var(--dsw-alias-label-tertiary)}.mL8Uca_actions{white-space:nowrap;align-items:center;gap:8px;display:flex}.mL8Uca_inlineTest{color:var(--dsw-alias-label-secondary);align-items:center;gap:6px;font-size:11.5px;display:inline-flex}.mL8Uca_inlineTest[data-status=ok]{color:var(--dsw-alias-state-success-primary)}.mL8Uca_inlineTest[data-status=fail]{color:var(--dsw-alias-state-error-primary)}.mL8Uca_badge{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);white-space:nowrap;border-radius:999px;padding:1px 8px;font-size:11px;line-height:1.6;display:inline-block}.mL8Uca_badge[data-kind=key]{color:var(--dsw-alias-state-business-primary);border-color:var(--dsw-alias-state-business-primary)}.mL8Uca_badge[data-kind=password]{color:var(--dsw-alias-state-warn-primary);border-color:var(--dsw-alias-state-warn-primary)}.mL8Uca_badge[data-status=ok]{color:var(--dsw-alias-state-success-primary);border-color:var(--dsw-alias-state-success-primary)}.mL8Uca_badge[data-status=fail]{color:var(--dsw-alias-state-error-primary);border-color:var(--dsw-alias-state-error-primary)}.mL8Uca_badge[data-status=timeout]{color:var(--dsw-alias-state-warn-primary);border-color:var(--dsw-alias-state-warn-primary)}.mL8Uca_primaryButton{color:var(--dsw-alias-label-primary-foreground);background:var(--dsw-alias-button-info-fill);cursor:pointer;white-space:nowrap;border:none;border-radius:8px;padding:6px 14px;font-size:13px;font-weight:600}.mL8Uca_primaryButton:hover:not(:disabled){background:var(--dsw-alias-button-info-hover)}.mL8Uca_primaryButton:disabled{opacity:.5;cursor:default}.mL8Uca_ghostButton{color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2);cursor:pointer;white-space:nowrap;background:0 0;border-radius:8px;padding:5px 12px;font-size:12px}.mL8Uca_ghostButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.mL8Uca_ghostButton:disabled{opacity:.45;cursor:default}.mL8Uca_iconButton{width:26px;height:26px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;border-radius:6px;justify-content:center;align-items:center;padding:0;font-size:13px;display:inline-flex}.mL8Uca_iconButton:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}.mL8Uca_linkButton{color:var(--dsw-alias-state-business-primary);cursor:pointer;white-space:nowrap;background:0 0;border:none;padding:0;font-size:12px}.mL8Uca_linkButton:hover:not(:disabled){text-decoration:underline}.mL8Uca_linkButton:disabled{opacity:.45;cursor:default}.mL8Uca_linkButton[data-danger]{color:var(--dsw-alias-state-error-primary)}.mL8Uca_spinner{border:2px solid var(--dsw-alias-state-business-primary);vertical-align:-1px;border-top-color:#0000;border-radius:50%;flex:none;width:11px;height:11px;animation:.8s linear infinite mL8Uca_dshSshSpin;display:inline-block}@keyframes mL8Uca_dshSshSpin{to{transform:rotate(360deg)}}.mL8Uca_banner{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);overflow-wrap:anywhere;border-radius:8px;padding:8px 12px;font-size:12.5px;line-height:1.5}.mL8Uca_banner[data-kind=ok]{color:var(--dsw-alias-state-success-primary);border-color:var(--dsw-alias-state-success-primary)}.mL8Uca_banner[data-kind=error]{color:var(--dsw-alias-state-error-primary);border-color:var(--dsw-alias-state-error-primary)}.mL8Uca_banner[data-kind=info]{color:var(--dsw-alias-state-business-primary);border-color:var(--dsw-alias-state-business-primary)}.mL8Uca_empty,.mL8Uca_loading{text-align:center;color:var(--dsw-alias-label-tertiary);padding:28px 12px;font-size:12.5px}.mL8Uca_modalBackdrop{z-index:40;background:var(--dsw-alias-bg-mask-1);justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.mL8Uca_modal{background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l2);width:min(560px,100vw - 48px);max-height:calc(100vh - 96px);box-shadow:var(--dsw-shadow-lv3);color:var(--dsw-alias-label-primary);border-radius:14px;flex-direction:column;gap:12px;padding:18px;display:flex;overflow-y:auto}.mL8Uca_modalTitle{margin:0;font-size:15px;font-weight:700}.mL8Uca_modalFooter{justify-content:flex-end;gap:10px;margin-top:4px;display:flex}.mL8Uca_formError{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px}.mL8Uca_hint{color:var(--dsw-alias-label-tertiary);font-size:11.5px}.mL8Uca_field{flex-direction:column;gap:5px;display:flex}.mL8Uca_fieldLabel{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:600}.mL8Uca_input{color:var(--dsw-alias-label-primary);background:var(--dsw-specific-input-major);border:1px solid var(--dsw-alias-border-l2);resize:vertical;border-radius:8px;outline:none;padding:7px 10px;font-family:inherit;font-size:13px}.mL8Uca_input:focus{border-color:var(--dsw-alias-state-business-primary)}.mL8Uca_input::placeholder{color:var(--dsw-alias-label-tertiary)}.mL8Uca_input:disabled{opacity:.55}.mL8Uca_formRow{grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:10px 12px;display:grid}.mL8Uca_radioRow{align-items:center;gap:16px;display:flex}.mL8Uca_radioLabel{color:var(--dsw-alias-label-primary);cursor:pointer;align-items:center;gap:6px;font-size:13px;display:inline-flex}.mL8Uca_termBody{flex-direction:column;flex:1;gap:8px;min-height:0;display:flex;overflow:hidden}.mL8Uca_termWrap{border:1px solid var(--dsw-alias-border-l1);background:#0b0e14;border-radius:10px;flex:1;min-height:0;position:relative;overflow:hidden}.mL8Uca_termContainer{padding:8px 10px;position:absolute;inset:0}.mL8Uca_termPlaceholder{z-index:2;text-align:center;color:var(--dsw-alias-label-tertiary);background:var(--dsw-alias-bg-base);justify-content:center;align-items:center;padding:0 24px;font-size:12.5px;display:flex;position:absolute;inset:0}.mL8Uca_hiddenFile{display:none}.mL8Uca_browsePanel{border:1px solid var(--dsw-alias-border-l1);border-radius:10px;flex-direction:column;flex:none;display:flex;overflow:hidden}.mL8Uca_browseHeader{background:var(--dsw-alias-bg-layer-2);border-bottom:1px solid var(--dsw-alias-border-l1);align-items:center;gap:8px;padding:8px 10px;display:flex}.mL8Uca_browsePath{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-secondary);flex:1;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12px;overflow:hidden}.mL8Uca_browseList{max-height:240px;overflow-y:auto}.mL8Uca_dirRow{text-align:left;width:100%;font:inherit;color:var(--dsw-alias-label-primary);border:none;border-bottom:1px solid var(--dsw-alias-separator-primary);cursor:pointer;background:0 0;grid-template-columns:minmax(0,1fr) auto auto;gap:12px;padding:5px 10px;font-size:12.5px;display:grid}.mL8Uca_dirRow:hover{background:var(--dsw-alias-interactive-bg-hover)}.mL8Uca_dirRow[data-type=dir] .mL8Uca_dirName{color:var(--dsw-alias-state-business-primary)}.mL8Uca_dirRow[data-up]{color:var(--dsw-alias-label-secondary)}.mL8Uca_dirName{text-overflow:ellipsis;white-space:nowrap;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;overflow:hidden}.mL8Uca_dirType{color:var(--dsw-alias-label-tertiary);white-space:nowrap}.mL8Uca_dirSize{color:var(--dsw-alias-label-tertiary);white-space:nowrap;text-align:right}.mL8Uca_transferBlock{flex-direction:column;flex:none;gap:6px;display:flex}.mL8Uca_progressMeta{color:var(--dsw-alias-label-secondary);flex-wrap:wrap;gap:12px;font-size:12px;display:flex}.mL8Uca_progressTrack{background:var(--dsw-alias-interactive-bg-hover);border-radius:999px;height:8px;overflow:hidden}.mL8Uca_progressBar{background:var(--dsw-alias-state-business-primary);border-radius:999px;height:100%;transition:width .12s linear}.mL8Uca_tunnelList{flex-direction:column;flex:none;gap:8px;display:flex}.mL8Uca_tunnelRow{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);border-radius:10px;align-items:center;gap:10px;padding:8px 12px;display:flex}.mL8Uca_tunnelRow[data-state=forwarding]{border-color:var(--dsw-alias-state-success-primary)}.mL8Uca_tunnelRow[data-state=connecting]{border-color:var(--dsw-alias-state-warn-primary)}.mL8Uca_tunnelRow[data-state=failed]{border-color:var(--dsw-alias-state-error-primary)}.mL8Uca_tunnelLabel{text-overflow:ellipsis;white-space:nowrap;flex:1;min-width:0;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12.5px;overflow:hidden}.mL8Uca_formCard{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:10px;flex-direction:column;flex:none;gap:10px;padding:12px;display:flex}.mL8Uca_clusterForm{flex-direction:column;flex:none;gap:8px;display:flex}.mL8Uca_clusterFilters{grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:10px;display:grid}.mL8Uca_commandInput{min-height:96px;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}.mL8Uca_cellDetails summary{cursor:pointer;color:var(--dsw-alias-label-secondary);font-size:12px}.mL8Uca_cellPre{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);white-space:pre-wrap;word-break:break-all;border-radius:6px;max-height:180px;margin:4px 0 0;padding:6px 8px;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:11.5px;overflow:auto}";
@@ -1300,15 +1330,19 @@ window.__ModuleLoader__.load({
 			const [collapsed, setCollapsed] = (0, react.useState)({});
 			const [testingGroup, setTestingGroup] = (0, react.useState)(null);
 			const seqRef = (0, react.useRef)(0);
+			const mountedRef = (0, react.useRef)(true);
+			(0, react.useEffect)(() => () => {
+				mountedRef.current = false;
+			}, []);
 			const load = (0, react.useCallback)(async (query) => {
 				const seq = ++seqRef.current;
 				try {
 					const list = await api.listHosts(query);
-					if (seq !== seqRef.current) return;
+					if (!mountedRef.current || seq !== seqRef.current) return;
 					setHosts(list);
 					setError(null);
 				} catch (cause) {
-					if (seq !== seqRef.current) return;
+					if (!mountedRef.current || seq !== seqRef.current) return;
 					setError(errorMessage(cause));
 				}
 			}, [api]);
@@ -14677,8 +14711,13 @@ window.__ModuleLoader__.load({
 			style.textContent = XTERM_CSS;
 			document.head.appendChild(style);
 		}
+		/** No-op source stand-in so the hook order stays stable without the prop. */
+		const NO_FONT_SOURCE = {
+			get: () => void 0,
+			subscribe: () => () => void 0
+		};
 		/** The xterm terminal view. */
-		function TerminalTab({ api, presetAlias, requestId }) {
+		function TerminalTab({ api, presetAlias, requestId, terminalFont }) {
 			const [hosts, setHosts] = (0, react.useState)([]);
 			const [alias, setAlias] = (0, react.useState)(presetAlias ?? "");
 			const [status, setStatus] = (0, react.useState)({ kind: "idle" });
@@ -14687,9 +14726,20 @@ window.__ModuleLoader__.load({
 			const fitRef = (0, react.useRef)(null);
 			const connRef = (0, react.useRef)(null);
 			const dataSubRef = (0, react.useRef)(null);
+			const fontSource = terminalFont ?? NO_FONT_SOURCE;
+			const fontOverride = (0, react.useSyncExternalStore)(fontSource.subscribe, fontSource.get);
 			(0, react.useEffect)(() => {
 				ensureXtermCss();
 			}, []);
+			(0, react.useEffect)(() => {
+				const term = termRef.current;
+				if (term === null) return;
+				const next = resolveTerminalFontFamily(fontOverride);
+				if (term.options.fontFamily === next) return;
+				term.options.fontFamily = next;
+				fitRef.current?.fit();
+				connRef.current?.resize(term.cols, term.rows);
+			}, [fontOverride]);
 			(0, react.useEffect)(() => {
 				let disposed = false;
 				(async () => {
@@ -14752,7 +14802,7 @@ window.__ModuleLoader__.load({
 					convertEol: false,
 					cursorBlink: true,
 					fontSize: 13,
-					fontFamily: "Menlo, Consolas, \"Liberation Mono\", monospace",
+					fontFamily: resolveTerminalFontFamily(fontOverride),
 					theme: {
 						background: "#0b0e14",
 						foreground: "#d8dee9",
@@ -14780,7 +14830,7 @@ window.__ModuleLoader__.load({
 				connection.onOutput = (data) => {
 					term.write(data);
 				};
-				connection.onExit = (code, error) => {
+				connection.onExit = (_code, error) => {
 					if (settled) return;
 					settled = true;
 					dataSubRef.current?.dispose();
@@ -14864,7 +14914,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")
@@ -15500,7 +15551,7 @@ window.__ModuleLoader__.load({
 			}
 		];
 		/** The tabbed SSH panel. */
-		function SshPanel({ controller, api }) {
+		function SshPanel({ controller, api, terminalFont }) {
 			const [activeTab, setActiveTab] = (0, react.useState)("hosts");
 			const [connectRequest, setConnectRequest] = (0, react.useState)(null);
 			const handleConnect = (alias) => {
@@ -15534,6 +15585,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",
@@ -15556,7 +15608,8 @@ window.__ModuleLoader__.load({
 							activeTab === "terminal" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TerminalTab, {
 								api,
 								presetAlias: connectRequest?.alias,
-								requestId: connectRequest?.nonce
+								requestId: connectRequest?.nonce,
+								terminalFont
 							}),
 							activeTab === "transfer" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TransferTab, { api }),
 							activeTab === "tunnels" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TunnelsTab, { api }),
@@ -15597,9 +15650,10 @@ window.__ModuleLoader__.load({
 		* to the controller's panelOpen state.
 		* @param controller - the panel controller driving the view.
 		* @param api - the SSH API client the tabs operate through.
+		* @param terminalFont - live terminal-font setting source (issue #577).
 		* @returns disposer unmounting the tree and restoring the column.
 		*/
-		function mountPanel(controller, api) {
+		function mountPanel(controller, api, terminalFont) {
 			let root;
 			let container;
 			const ensure = () => {
@@ -15614,12 +15668,14 @@ 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);
 				root.render(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SshPanel, {
 					controller,
-					api
+					api,
+					terminalFont
 				}));
 			};
 			const waitObserver = new MutationObserver(() => {
@@ -15697,7 +15753,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 +15767,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 +15798,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 +15820,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,28 +15839,69 @@ 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";
+		/** Settings namespace the terminal-font preference lives in (issue #577). */
+		const SETTINGS_NS = "dsh-ssh";
 		/** Required services (fiber inject waiting — the runtime must be up first). */
-		const inject = ["slots", "locale"];
+		const inject = [
+			"slots",
+			"locale",
+			"settingsScope"
+		];
 		/**
 		* Mount the SSH panel.
 		* @param ctx - client root context (locale service).
@@ -15813,10 +15913,18 @@ window.__ModuleLoader__.load({
 			}), "dsh-ssh: dictionaries");
 			const controller = new PanelController();
 			const api = new SshApi();
+			const scope = (ctx.get("webUiSettings") ?? ctx.settingsScope).bind({ namespace: SETTINGS_NS });
+			const terminalFont = {
+				get: () => {
+					const snapshot = scope.getSnapshot();
+					return snapshot.status === "ready" ? snapshot.value?.terminalFontFamily : void 0;
+				},
+				subscribe: (listener) => scope.subscribe(listener)
+			};
 			const disposers = [];
 			try {
 				disposers.push(mountSidebarEntry(controller));
-				disposers.push(mountPanel(controller, api));
+				disposers.push(mountPanel(controller, api, terminalFont));
 			} catch (error) {
 				console.warn("[dsh-ssh] mount failed:", error);
 			}