dsh-local-sd 0.4.1 → 0.6.0

package/README.md

@@ -27,7 +27,9 @@
 
 外加一个设置页：**设置 → 本地绘图**。里面能选目录、看状态、调参数、手动启停后端。
 
-出图落在工作区 `generated/sd-<时间戳>-<序号>.png`，同时在对话里渲染。
+出图默认落在工作区 `generated/sd-<时间戳>-<序号>.png`，同时在对话里渲染。存放位置可以在
+**设置 → 本地绘图 → 图片存放目录** 里改：留空用默认，填相对路径（如 `pics/sd`）接在工作区后面，
+填绝对路径（如 `D:\AI\生图`）则原样使用。
 
 ---
 
@@ -147,7 +149,7 @@ koboldcpp.exe --sdmodel <image-model.gguf> --sdoffloadcpu --sdtiledvae 512 --por
 
 ## 生命周期：按需启动，闲置自关
 
-SD 后端吃几 GB 显存，不该一直挂着。
+SD 后端占用较高显存，闲置时自动关闭。
 
 ```
 你第一次要图
@@ -175,6 +177,7 @@ SD 后端吃几 GB 显存，不该一直挂着。
 | 项 | 说明 |
 |---|---|
 | 绘图程序目录 | 含 `run.bat` / `webui.bat` / `webui.sh` 的那一层 |
+| 图片存放目录 | 出图存哪儿。留空 = 工作区 `generated/`；相对路径接在工作区后面；绝对路径原样使用 |
 | 自动启动 | 后端没开时是否拉起它。关掉就只连现成的 |
 | 启动超时 | 冷启动最长等待，默认 240000 ms（4 分钟） |
 | 闲置关闭 | 闲置多久自动关，默认 300000 ms（5 分钟）。**填 0 = 永不自动关闭** |
@@ -183,6 +186,18 @@ SD 后端吃几 GB 显存，不该一直挂着。
 
 配置写在 `$DSH_HOME/local-sd.json`（Windows 是 `C:\Users\<你>\.dsh\local-sd.json`）。**每次调用都重新读取**，改完不用重启 DSH；手改这个 JSON 也一样有效。
 
+### 启动进度和命令行输出
+
+后端启动时**不再弹出黑色控制台窗口**，进度和输出都搬到设置页里：
+
+- **进度条**：读绘图程序自己的输出（加载扩展、加载权重、起 API），大致对应当前阶段；没有新输出时会缓慢爬升，不会看起来卡死。
+- **查看命令行输出**：展开后就是绘图程序真实打印的内容，出错时能看到完整的 traceback，不用再手动跑一遍 `run.bat` 找原因。
+- 日志同时写在 `$DSH_HOME/local-sd-startup.log`，每次启动覆盖。
+
+> **`--nowebui` 必须配 `--port`**：Forge 在 `--nowebui` 下如果没指定端口会默认绑 **7861**
+> （`webui.py` 里 `port=cmd_opts.port if cmd_opts.port else 7861`），而插件默认找 7860。
+> 想在后台只跑 API 不弹网页，启动参数要写 `--api --nowebui --port 7860`。
+
 ---
 
 ## 用法

package/lib/client.js

@@ -38,10 +38,16 @@ window.__ModuleLoader__.load({
 				var style = document.createElement("style");
 				style.textContent = `
 .lsd-root{display:flex;flex-direction:column;gap:16px;padding:4px 2px 28px;font-size:13px;color:var(--dsw-alias-label-primary,inherit)}
+/* The settings page is itself a scrolling column: sections keep their natural
+   height, and the page scrolls, rather than every block being compressed. */
+.lsd-root > *{flex:none}
 .lsd-head{display:flex;flex-direction:column;gap:5px}
 .lsd-title{margin:0;font-size:16px;font-weight:600}
 .lsd-desc{margin:0;font-size:12px;line-height:1.65;color:var(--dsw-alias-label-secondary,rgba(128,128,128,.9))}
 .lsd-card{border:1px solid var(--dsw-alias-border-l1,rgba(128,128,128,.28));border-radius:12px;padding:14px 16px;background:rgba(128,128,128,.06);display:flex;flex-direction:column;gap:12px}
+/* A card is a column flexbox inside the settings scroll area: let it keep its
+   content height instead of being squeezed when the page runs out of room. */
+.lsd-card > *{flex:none}
 .lsd-card-head{display:flex;align-items:center;gap:9px}
 .lsd-dot{width:8px;height:8px;border-radius:50%;background:rgba(128,128,128,.6);flex:none}
 .lsd-dot.on{background:var(--dsw-alias-state-success-primary,#2ea043)}
@@ -75,13 +81,16 @@ window.__ModuleLoader__.load({
 .lsd-msg.err{color:var(--dsw-alias-state-error-primary,#f85149);background:rgba(248,81,73,.1)}
 .lsd-msg.info{color:var(--dsw-alias-label-secondary,rgba(128,128,128,.95));background:rgba(128,128,128,.1)}
 .lsd-found{display:flex;flex-direction:column;gap:6px;max-height:200px;overflow:auto}
+/* Same trap as the browser list: a scrolling column flexbox shrinks its rows
+   to nothing once they overflow. Keep every row at its natural height. */
+.lsd-found > *{flex:none}
 .lsd-found-item{display:flex;gap:8px;align-items:center;justify-content:space-between;padding:7px 10px;
   border:1px solid var(--dsw-alias-border-l1,rgba(128,128,128,.24));border-radius:8px;font-size:11px;
   font-family:ui-monospace,SFMono-Regular,Menlo,monospace;word-break:break-all}
 .lsd-actions{display:flex;gap:8px;flex-wrap:wrap;align-items:center;padding-top:2px}
 .lsd-footer{font-size:11px;color:var(--dsw-alias-label-secondary,rgba(128,128,128,.75));word-break:break-all}
 /* ── in-page directory browser ──────────────────────────────────────── */
-.lsd-browser{display:flex;flex-direction:column;gap:9px;padding:11px;border-radius:10px;
+.lsd-browser{display:flex;flex-direction:column;gap:9px;padding:11px;border-radius:10px;flex:none;
   border:1px solid var(--dsw-alias-border-l1,rgba(128,128,128,.3));background:rgba(128,128,128,.07)}
 .lsd-browser-head{display:flex;gap:7px;align-items:center}
 .lsd-browser-path{flex:1;min-width:0}
@@ -93,6 +102,11 @@ window.__ModuleLoader__.load({
 .lsd-drive:disabled{opacity:.5;cursor:default}
 .lsd-browser-list{display:flex;flex-direction:column;gap:2px;max-height:230px;overflow:auto;
   border-radius:8px;background:var(--dsw-alias-bg-base,rgba(0,0,0,.1));padding:4px}
+/* The list is a column flexbox with a max-height: without flex:none every row
+   shrinks to a sliver once the entries overflow, and all the labels stack on
+   top of each other. Rows must keep their intrinsic height and let the list
+   scroll instead. */
+.lsd-browser-list > *{flex:none}
 .lsd-entry{text-align:left;padding:5px 9px;font-size:12px;font-family:inherit;cursor:pointer;
   color:var(--dsw-alias-label-primary,inherit);background:transparent;border:none;border-radius:5px;
   white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
@@ -100,6 +114,28 @@ window.__ModuleLoader__.load({
 .lsd-entry:disabled{opacity:.5;cursor:default}
 .lsd-browser-foot{display:flex;flex-direction:column;gap:8px;align-items:flex-start}
 .lsd-browser-foot .lsd-actions{padding-top:0}
+/* ── startup progress + live log ────────────────────────────────────── */
+.lsd-prog{display:flex;flex-direction:column;gap:7px;padding:11px 13px;border-radius:10px;
+  border:1px solid var(--dsw-alias-border-l1,rgba(128,128,128,.26));background:var(--dsw-alias-bg-base,rgba(128,128,128,.05))}
+.lsd-prog-head{display:flex;align-items:center;gap:8px;font-size:12px}
+.lsd-prog-phase{flex:1;min-width:0;font-weight:500;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.lsd-prog-pct{flex:none;font-variant-numeric:tabular-nums;color:var(--dsw-alias-label-secondary,rgba(128,128,128,.95))}
+.lsd-bar{position:relative;height:7px;border-radius:4px;overflow:hidden;background:rgba(128,128,128,.22)}
+.lsd-bar-fill{position:absolute;inset:0 auto 0 0;border-radius:4px;
+  background:var(--dsw-alias-brand-primary,#4a9eff);transition:width .45s ease}
+.lsd-bar-fill.ok{background:var(--dsw-alias-state-success-primary,#2ea043)}
+.lsd-bar-fill.err{background:var(--dsw-alias-state-error-primary,#f85149)}
+/* Indeterminate: the launcher is alive but has not printed anything yet. */
+.lsd-bar-fill.indet{width:35% !important;animation:lsd-slide 1.3s ease-in-out infinite}
+@keyframes lsd-slide{0%{left:-35%}100%{left:100%}}
+.lsd-log{margin:0;padding:9px 11px;border-radius:8px;max-height:260px;overflow:auto;
+  font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px;line-height:1.55;
+  white-space:pre-wrap;word-break:break-word;background:var(--dsw-alias-bg-base,rgba(0,0,0,.18));
+  border:1px solid var(--dsw-alias-border-l1,rgba(128,128,128,.22));
+  color:var(--dsw-alias-label-secondary,rgba(128,128,128,.95))}
+.lsd-log .err{color:var(--dsw-alias-state-error-primary,#f85149)}
+.lsd-log .info{color:var(--dsw-alias-brand-primary,#4a9eff)}
+.lsd-log-empty{font-size:11px;color:var(--dsw-alias-label-secondary,rgba(128,128,128,.8))}
 /* ── hardware readout ───────────────────────────────────────────────── */
 .lsd-hw{display:flex;flex-direction:column;gap:5px;padding:10px 12px;border-radius:10px;
   border:1px solid var(--dsw-alias-border-l1,rgba(128,128,128,.24));background:var(--dsw-alias-bg-base,rgba(128,128,128,.05))}
@@ -134,6 +170,86 @@ window.__ModuleLoader__.load({
 				return Math.round(ms / 60000) + " 分钟";
 			}
 
+			function fmtElapsed(ms) {
+				if (typeof ms !== "number" || !isFinite(ms) || ms <= 0) return "0s";
+				var s = Math.round(ms / 1000);
+				if (s < 60) return s + "s";
+				return Math.floor(s / 60) + "m " + (s % 60) + "s";
+			}
+
+			/**
+			 * Startup progress + the launcher's real console output.
+			 *
+			 * The whole point is that the user never has to look at a console
+			 * window: the bar says roughly where the boot is, and the log can be
+			 * expanded to see exactly what the launcher printed — including the
+			 * error when it dies, which used to require re-running it by hand.
+			 */
+			function StartupPanel(props) {
+				var st = props.startup;
+				var openS = React.useState(false);
+				var open = openS[0];
+				var setOpen = openS[1];
+				var tailS = React.useRef(null);
+
+				// Keep the newest line in view while it is streaming.
+				React.useEffect(function() {
+					if (open && tailS.current) tailS.current.scrollTop = tailS.current.scrollHeight;
+				}, [open, st && st.lines ? st.lines.length : 0]);
+
+				if (!st) return null;
+				var starting = st.state === "starting";
+				var failed = st.state === "failed";
+				var ready = st.state === "ready";
+				if (st.state === "idle" && (!st.lines || st.lines.length === 0)) return null;
+
+				var pct = Math.round((st.progress || 0) * 100);
+				var fillClass = "lsd-bar-fill" + (ready ? " ok" : failed ? " err" : "");
+				// No output yet: show motion rather than a bar pinned at 2%.
+				var indet = starting && (!st.lines || st.lines.length === 0);
+				var label = failed ? "启动失败" : ready ? "已就绪" : st.state === "stopped" ? "已关闭" : (st.phase || "启动中");
+
+				return h("div", { className: "lsd-prog" },
+					h("div", { className: "lsd-prog-head" },
+						h("span", { className: "lsd-prog-phase" }, label),
+						st.elapsedMs > 0
+							? h("span", { className: "lsd-prog-pct" }, fmtElapsed(st.elapsedMs))
+							: null,
+						starting ? h("span", { className: "lsd-prog-pct" }, pct + "%") : null
+					),
+					h("div", { className: "lsd-bar" },
+						h("div", {
+							className: fillClass + (indet ? " indet" : ""),
+							style: indet ? undefined : { width: (ready ? 100 : pct) + "%" }
+						})
+					),
+					failed && st.error
+						? h("div", { className: "lsd-msg err" }, st.error)
+						: null,
+					h("div", { className: "lsd-actions" },
+						h("button", {
+							className: "lsd-btn", disabled: props.busy,
+							onClick: function() { setOpen(!open); }
+						}, open ? "收起命令行输出" : "查看命令行输出"),
+						st.logFile
+							? h("span", { className: "lsd-footer" }, "日志：" + st.logFile)
+							: null
+					),
+					open
+						? (st.lines && st.lines.length > 0
+							? h("pre", { className: "lsd-log", ref: tailS },
+								st.lines.map(function(line, i) {
+									return h("div", {
+										key: i,
+										className: line.stream === "err" ? "err" : line.stream === "info" ? "info" : ""
+									}, line.text);
+								})
+							)
+							: h("div", { className: "lsd-log-empty" }, "还没有输出。绘图程序刚启动，稍等一下…"))
+						: null
+				);
+			}
+
 			/* ── the settings page ──────────────────────────────────────── */
 
 			function SettingsPage() {
@@ -163,6 +279,18 @@ window.__ModuleLoader__.load({
 				var forgeDirS = React.useState("");
 				var forgeDir = forgeDirS[0];
 				var setForgeDir = forgeDirS[1];
+				// Where PNGs land. Empty = <workspace>/generated.
+				var outputDirS = React.useState("");
+				var outputDir = outputDirS[0];
+				var setOutputDir = outputDirS[1];
+				// Host-resolved default for an empty outputDir, shown as a hint.
+				var defaultOutputDirS = React.useState("");
+				var defaultOutputDir = defaultOutputDirS[0];
+				var setDefaultOutputDir = defaultOutputDirS[1];
+				// Which field the in-page browser is filling: "forge" | "output".
+				var browseTargetS = React.useState("forge");
+				var browseTarget = browseTargetS[0];
+				var setBrowseTarget = browseTargetS[1];
 				var endpointS = React.useState("");
 				var endpoint = endpointS[0];
 				var setEndpoint = endpointS[1];
@@ -194,11 +322,17 @@ window.__ModuleLoader__.load({
 				var hwPhaseS = React.useState("idle");
 				var hwPhase = hwPhaseS[0];
 				var setHwPhase = hwPhaseS[1];
+				// Startup progress + launcher output, polled while a boot runs.
+				var startupS = React.useState(null);
+				var startupState = startupS[0];
+				var setStartupState = startupS[1];
 
 				function adopt(s) {
 					setState(s);
 					if (!s) return;
 					setForgeDir(s.forgeDir || "");
+					setOutputDir(s.outputDir || "");
+					setDefaultOutputDir(s.defaultOutputDir || "");
 					setEndpoint(s.endpoint || "");
 					setEnabled(!!(s.autoStart && s.autoStart.enabled));
 					setStartupMs((s.autoStart && s.autoStart.startupTimeoutMs) || 240000);
@@ -215,6 +349,7 @@ window.__ModuleLoader__.load({
 						if (cancelled) return;
 						if (res && res.ok) {
 							adopt(res.state);
+							if (res.state && res.state.startup) setStartupState(res.state.startup);
 							setPhase("ready");
 						} else {
 							setPhase("error");
@@ -224,6 +359,30 @@ window.__ModuleLoader__.load({
 					return function() { cancelled = true; };
 				}, []);
 
+				// Poll the startup state once a second. Only while something is
+				// actually happening: a settled page should not keep a timer alive.
+				React.useEffect(function() {
+					var cancelled = false;
+					var timer = null;
+					var tick = function() {
+						callApi({ method: "startup" }).then(function(res) {
+							if (cancelled) return;
+							if (res && res.ok && res.startup) {
+								setStartupState(res.startup);
+								var live = res.startup.state === "starting";
+								timer = setTimeout(tick, live ? 1000 : 4000);
+							} else {
+								timer = setTimeout(tick, 8000);
+							}
+						});
+					};
+					timer = setTimeout(tick, 1200);
+					return function() {
+						cancelled = true;
+						if (timer !== null) clearTimeout(timer);
+					};
+				}, []);
+
 				/** Probe the GPU. Slow (nvidia-smi + registry walk), so it runs
 				 *  after the page is already on screen. */
 				function loadHardware() {
@@ -271,6 +430,7 @@ window.__ModuleLoader__.load({
 					return callApi({
 						method: "save",
 						forgeDir: forgeDir,
+						outputDir: outputDir,
 						endpoint: endpoint,
 						autoStart: {
 							enabled: enabled,
@@ -299,11 +459,14 @@ window.__ModuleLoader__.load({
 				}
 
 				// Open the in-page browser, starting at whatever is currently typed
-				// (or the host's home directory when the box is empty).
-				function browse() {
+				// (or the host's home directory when the box is empty). `target`
+				// decides which field "选这个目录" fills.
+				function browse(target) {
 					setBusy(true);
 					setMsg(null);
-					callApi({ method: "browse", path: forgeDir || "" }).then(function(res) {
+					setBrowseTarget(target);
+					var start = target === "output" ? (outputDir || defaultOutputDir || "") : (forgeDir || "");
+					callApi({ method: "browse", path: start }).then(function(res) {
 						setBusy(false);
 						if (res && res.ok && res.listing) {
 							setBrowser(res.listing);
@@ -329,7 +492,11 @@ window.__ModuleLoader__.load({
 				/** Commit the browser's current directory to the form field. */
 				function useCurrentDir() {
 					if (browser === null) return;
-					setForgeDir(browser.path);
+					if (browseTarget === "output") {
+						setOutputDir(browser.path);
+					} else {
+						setForgeDir(browser.path);
+					}
 					setBrowser(null);
 					setMsg({ kind: "info", text: "已选：" + browser.path + "，记得点保存" });
 				}
@@ -353,9 +520,21 @@ window.__ModuleLoader__.load({
 				function backend(action) {
 					setBusy(true);
 					setMsg(null);
+					// A cold boot takes minutes. Show the panel immediately with a
+					// pending state instead of leaving the page looking frozen while
+					// the request is in flight — the poll picks up real progress.
+					if (action === "start") {
+						setStartupState({
+							state: "starting", phase: "启动绘图程序", progress: 0.02,
+							startedAt: Date.now(), endedAt: 0, error: "", lines: [], elapsedMs: 0
+						});
+					}
 					callApi({ method: action }).then(function(res) {
 						setBusy(false);
-						if (res && res.state) adopt(res.state);
+						if (res && res.state) {
+							adopt(res.state);
+							if (res.state.startup) setStartupState(res.state.startup);
+						}
 						if (res && res.ok) {
 							setMsg({ kind: "ok", text: action === "start" ? "后端已就绪" : "后端已关闭，显存释放" });
 						} else {
@@ -420,13 +599,16 @@ window.__ModuleLoader__.load({
 								className: "lsd-btn", disabled: busy,
 								onClick: function() { callApi({ method: "get" }).then(function(r) { if (r && r.ok) adopt(r.state); }); }
 							}, "刷新")
-						)
+						),
+						// Progress + the launcher's real output, so the console
+						// window never has to be looked at (or clicked into).
+						h(StartupPanel, { startup: startupState, busy: busy })
 					),
 
-					// ── directory ────────────────────────────────────────
+					// ── directories ──────────────────────────────────────
 					h("div", { className: "lsd-card" },
 						h("div", { className: "lsd-card-head" },
-							h("span", { className: "lsd-card-title" }, "绘图程序目录")
+							h("span", { className: "lsd-card-title" }, "目录设置")
 						),
 						h("div", { className: "lsd-field" },
 							h("label", { className: "lsd-label" }, "Stable Diffusion WebUI / Forge 根目录"),
@@ -437,7 +619,7 @@ window.__ModuleLoader__.load({
 									placeholder: "例如 D:\\AI\\forge\\webui_forge_cu124_torch24",
 									onChange: function(e) { setForgeDir(e.target.value); }
 								}),
-								h("button", { className: "lsd-btn", disabled: busy, onClick: browse }, "浏览…"),
+								h("button", { className: "lsd-btn", disabled: busy, onClick: function() { browse("forge"); } }, "浏览…"),
 								h("button", { className: "lsd-btn", disabled: busy, onClick: detect }, "自动探测")
 							),
 							h("span", { className: "lsd-hint" },
@@ -445,6 +627,27 @@ window.__ModuleLoader__.load({
 								+ "也接受直接填 run.bat 的完整路径。Linux / macOS 会自动找 webui.sh。")
 						),
 
+						h("div", { className: "lsd-field" },
+							h("label", { className: "lsd-label" }, "图片存放目录"),
+							h("div", { className: "lsd-row" },
+								h("input", {
+									className: "lsd-input mono",
+									value: outputDir,
+									placeholder: defaultOutputDir || "留空 = 工作区下的 generated",
+									onChange: function(e) { setOutputDir(e.target.value); }
+								}),
+								h("button", { className: "lsd-btn", disabled: busy, onClick: function() { browse("output"); } }, "浏览…"),
+								h("button", {
+									className: "lsd-btn", disabled: busy || outputDir.length === 0,
+									onClick: function() { setOutputDir(""); }
+								}, "恢复默认")
+							),
+							h("span", { className: "lsd-hint" },
+								"出图存哪儿。留空就用工作区的 generated 子目录；"
+								+ "填相对路径（如 pics/sd）会接在工作区后面，填绝对路径（如 D:\\AI\\pics）则原样使用。"
+								+ (defaultOutputDir ? "\n当前默认：" + defaultOutputDir : ""))
+						),
+
 						// ── in-page directory browser ────────────────────
 						browser !== null
 							? h("div", { className: "lsd-browser" },
@@ -492,11 +695,14 @@ window.__ModuleLoader__.load({
 								),
 
 								h("div", { className: "lsd-browser-foot" },
-									browser.launcher
-										? h("span", { className: "lsd-msg ok" },
-											"✓ 这个目录里有 " + browser.launcher.launcher + "，就是它了")
-										: h("span", { className: "lsd-hint" },
-											"这个目录里没有 run.bat / webui.bat / webui.sh，继续往下找或者换一层"),
+									browseTarget === "output"
+										? h("span", { className: "lsd-hint" },
+											"选一个放图的文件夹，没有的话在上层目录里新建一个再进来")
+										: browser.launcher
+											? h("span", { className: "lsd-msg ok" },
+												"✓ 这个目录里有 " + browser.launcher.launcher + "，就是它了")
+											: h("span", { className: "lsd-hint" },
+												"这个目录里没有 run.bat / webui.bat / webui.sh，继续往下找或者换一层"),
 									h("div", { className: "lsd-actions" },
 										h("button", {
 											className: "lsd-btn primary", disabled: busy,

package/lib/index.js

@@ -50,9 +50,9 @@
 
 import { homedir, tmpdir } from "node:os";
 import { mkdir, writeFile, readFile, readdir, stat } from "node:fs/promises";
-import { openSync, closeSync, readFileSync, unlinkSync } from "node:fs";
+import { openSync, closeSync, readFileSync, unlinkSync, createWriteStream, existsSync, statSync } from "node:fs";
 import { spawn } from "node:child_process";
-import { join, dirname, basename, resolve as resolvePath } from "node:path";
+import { join, dirname, basename, relative, isAbsolute, resolve as resolvePath } from "node:path";
 
 /** Does this path exist and is it a regular file? */
 async function isFile(path) {
@@ -71,7 +71,7 @@ export const name = "dsh-local-sd";
 export const inject = ["tools", "webServer", "connection"];
 
 /** Test seam: lets the standalone tests drive the pure helpers directly. */
-export const internals = { recommendFor, detectGpu, resolveLauncher, detectForgeDirs, listDirectory };
+export const internals = { recommendFor, detectGpu, resolveLauncher, detectForgeDirs, listDirectory, resolveOutputLocation };
 
 /**
  * Build stamp for the settings page. Bump on every user-visible change.
@@ -82,7 +82,7 @@ export const internals = { recommendFor, detectGpu, resolveLauncher, detectForge
  * indistinguishable from a broken feature. Showing this value in the page makes
  * "you need to restart DSH" a visible fact instead of a guess.
  */
-const PLUGIN_BUILD = "0.4.0";
+const PLUGIN_BUILD = "0.6.0";
 
 /** Forge and A1111 both listen here. */
 const DEFAULT_ENDPOINT = "http://127.0.0.1:7860";
@@ -155,6 +155,10 @@ function configPath() {
 
 const DEFAULT_CONFIG_TEMPLATE = {
 	forgeDir: "",
+	// Where PNGs land. "" -> "<workspace>/generated". A relative path is joined
+	// to the workspace root; an absolute one is used as-is (handy when the
+	// workspace root the host reports is not the folder you actually look at).
+	outputDir: "",
 	endpoint: DEFAULT_ENDPOINT,
 	fallbackEndpoints: FALLBACK_ENDPOINTS.slice(1),
 	autoStart: {
@@ -675,6 +679,7 @@ async function resolveSettings() {
 
 	return {
 		forgeDir,
+		outputDir: strOr(cfg.outputDir, ""),
 		endpoint: configured,
 		candidates: [configured, ...fallbacks.filter((e) => e !== configured)],
 		autoStart: {
@@ -709,8 +714,94 @@ const lifecycle = {
 	lastUsedAt: 0,
 	idleTimer: null,
 	starting: null, // Promise while a spawn+wait is in flight
+	// Startup log + progress, so the settings page can show what the launcher
+	// is actually doing instead of a bare "starting…". Kept in memory: it is
+	// diagnostic for the current attempt, not a durable log.
+	startup: {
+		state: "idle", // idle | starting | ready | failed | stopped
+		startedAt: 0,
+		endedAt: 0,
+		progress: 0, // 0..1
+		phase: "", // human-readable current step
+		lines: [], // ring buffer of {t, stream, text}
+		error: "",
+		logFile: "", // path of the captured log on disk
+	},
 };
 
+/** How many launcher lines to keep in memory for the settings panel. */
+const STARTUP_LOG_LIMIT = 400;
+
+/**
+ * Append one launcher output line to the startup ring buffer.
+ * @param stream - "out" | "err" | "info"
+ */
+function pushStartupLine(stream, text) {
+	const entry = { t: Date.now(), stream, text: String(text).replace(/\r$/, "") };
+	if (entry.text.length === 0) return;
+	const lines = lifecycle.startup.lines;
+	lines.push(entry);
+	if (lines.length > STARTUP_LOG_LIMIT) lines.splice(0, lines.length - STARTUP_LOG_LIMIT);
+}
+
+/** Move the startup state machine forward. */
+function setStartupState(state, phase, progress, error) {
+	const s = lifecycle.startup;
+	s.state = state;
+	if (typeof phase === "string") s.phase = phase;
+	if (typeof progress === "number") s.progress = Math.max(0, Math.min(1, progress));
+	if (typeof error === "string") s.error = error;
+	if (state === "starting" && s.startedAt === 0) s.startedAt = Date.now();
+	if (state === "ready" || state === "failed" || state === "stopped") s.endedAt = Date.now();
+	if (state === "idle") {
+		s.startedAt = 0;
+		s.endedAt = 0;
+		s.progress = 0;
+		s.phase = "";
+		s.error = "";
+		s.lines = [];
+		s.logFile = "";
+	}
+}
+
+/**
+ * Guess how far along a cold Forge boot is from its own output.
+ *
+ * Forge prints a fairly stable sequence: python import → loading extensions →
+ * loading the checkpoint → starting the API. Matching those markers gives a
+ * real progress bar instead of a spinner that means nothing. The weights are
+ * deliberately coarse: the point is "roughly where are we", not a measurement.
+ */
+const STARTUP_MARKERS = [
+	{ re: /Python\s+3\.\d+/i, progress: 0.08, phase: "启动 Python" },
+	{ re: /Launching Web UI|Running on local URL/i, progress: 0.9, phase: "启动 Web 服务" },
+	{ re: /Startup time:|Model loaded in|Loaded a model/i, progress: 0.95, phase: "模型就绪" },
+	{ re: /Loading extensions|Installing|extensions/i, progress: 0.25, phase: "加载扩展" },
+	{ re: /Loading (?:stable-diffusion|weights)|Loading checkpoint/i, progress: 0.55, phase: "加载模型权重" },
+	{ re: /Applying (?:attention|xformers)|xformers/i, progress: 0.4, phase: "优化注意力" },
+	{ re: /VAE|vae/i, progress: 0.7, phase: "加载 VAE" },
+	{ re: /API|api/i, progress: 0.85, phase: "启动 API" },
+	{ re: /error|traceback|exception|failed/i, progress: null, phase: "出错" },
+];
+
+/** Advance progress from one launcher line, never moving backwards. */
+function noteStartupLine(text) {
+	const s = lifecycle.startup;
+	for (const marker of STARTUP_MARKERS) {
+		if (!marker.re.test(text)) continue;
+		if (marker.progress === null) {
+			s.phase = marker.phase;
+			return;
+		}
+		if (marker.progress > s.progress) {
+			s.progress = marker.progress;
+			s.phase = marker.phase;
+		}
+		return;
+	}
+}
+
+
 /** Is this endpoint a live sdapi backend? */
 async function probe(endpoint, signal) {
 	try {
@@ -746,13 +837,20 @@ function stopOwnedBackend() {
 	lifecycle.pid = null;
 	lifecycle.endpoint = null;
 	if (pid === null) return false;
+	// Reflect the shutdown in the panel: a bar frozen at 60% with no process
+	// behind it is worse than no bar at all.
+	if (lifecycle.startup.state === "starting" || lifecycle.startup.state === "ready") {
+		setStartupState("stopped", "已关闭", 0);
+		pushStartupLine("info", "后端已关闭，显存已释放");
+	}
 	try {
 		if (process.platform === "win32") {
 			// Forge's run.bat spawns python.exe; /T takes the whole tree.
+			// No `detached`: on Windows that creates a console for taskkill
+			// itself, which is another black window flashing on screen.
 			spawn("taskkill", ["/PID", String(pid), "/T", "/F"], {
 				stdio: "ignore",
 				windowsHide: true,
-				detached: true,
 			}).unref();
 		} else {
 			try {
@@ -871,19 +969,69 @@ async function spawnBackend(settings, signal) {
 		windowsVerbatimArguments = true;
 	}
 
+	// Where the launcher's own stdout/stderr go. A pipe is not an option: the
+	// sandbox forbids the parent from reading a child's pipe (EPERM), which is
+	// why runCapture above already writes to a temp file. A real file is both
+	// allowed and better here — the settings panel can re-read it any time.
+	const logFile = join(dshHome(), "local-sd-startup.log");
+	let logFd = null;
+	try {
+		await mkdir(dirname(logFile), { recursive: true });
+		// Truncate: this log describes one launch attempt, and a stale tail from
+		// the previous boot would make the progress markers lie.
+		logFd = openSync(logFile, "w");
+	} catch {
+		logFd = null; // Read-only home: still start, just without a log.
+	}
+	lifecycle.startup.logFile = logFile;
+
 	const child = spawn(spawnCommand, spawnArgs, {
 		cwd: spawnCwd,
-		detached: true,
-		stdio: "ignore",
+		// detached is needed on POSIX to kill the whole process group, but on
+		// Windows DETACHED_PROCESS gives the launcher its own console — that is
+		// the black window the user sees. windowsHide alone does not win against
+		// it, so Windows stays attached and relies on `taskkill /T` instead.
+		detached: process.platform !== "win32",
+		stdio: logFd === null ? "ignore" : ["ignore", logFd, logFd],
 		windowsHide: true,
 		windowsVerbatimArguments,
 		env: sanitizedEnv(),
 	});
 	child.unref();
+	if (logFd !== null) {
+		// The child holds its own duplicate; ours is only needed to create it.
+		try { closeSync(logFd); } catch { /* already closed */ }
+	}
 
 	lifecycle.child = child;
 	lifecycle.pid = child.pid ?? null;
 
+	setStartupState("starting", "启动绘图程序", 0.02);
+	pushStartupLine("info", "$ " + command);
+	if (logFile.length > 0) pushStartupLine("info", "日志文件：" + logFile);
+
+	// Tail the log into the in-memory ring buffer so the panel can show real
+	// output without re-reading the file on every poll.
+	let logOffset = 0;
+	const pumpLog = () => {
+		if (logFile.length === 0) return;
+		let text;
+		try {
+			const size = statSync(logFile).size;
+			if (size <= logOffset) return;
+			const buf = readFileSync(logFile);
+			text = buf.subarray(logOffset).toString("utf8");
+			logOffset = buf.length;
+		} catch {
+			return;
+		}
+		for (const line of text.split(/\r?\n/)) {
+			if (line.trim().length === 0) continue;
+			pushStartupLine("out", line);
+			noteStartupLine(line);
+		}
+	};
+
 	// If the launcher dies immediately, fail fast instead of waiting 4 minutes.
 	let exitCode = null;
 	child.once("exit", (code) => {
@@ -896,32 +1044,61 @@ async function spawnBackend(settings, signal) {
 			stopOwnedBackend();
 			throw new Error("cancelled while starting the local SD backend");
 		}
+		pumpLog();
 		if (exitCode !== null && exitCode !== 0) {
+			pumpLog();
 			stopOwnedBackend();
+			const tail = lifecycle.startup.lines.slice(-8).map((l) => l.text).join("\n");
 			throw new Error(
 				"The local SD launcher exited with code " +
 					exitCode +
-					" before the API came up. Run " +
-					command +
-					" by hand to see its error output.",
+					" before the API came up." +
+					(tail.length > 0 ? "\n最后几行输出：\n" + tail : "\n（启动日志：" + logFile + "）"),
 			);
 		}
 		const live = await findLiveEndpoint(settings, signal);
 		if (live !== null) {
+			pumpLog();
 			lifecycle.endpoint = live;
+			setStartupState("ready", "已就绪", 1);
+			pushStartupLine("info", "后端就绪：" + live);
 			return live;
 		}
+		// Keep the bar creeping while nothing new is printed: a cold Forge can
+		// sit on "loading checkpoint" for a minute, and a frozen bar reads as a
+		// hang.
+		if (lifecycle.startup.progress < 0.92) {
+			lifecycle.startup.progress = Math.min(0.92, lifecycle.startup.progress + 0.01);
+		}
 		await new Promise((r) => setTimeout(r, 2000));
 	}
 
+	pumpLog();
 	stopOwnedBackend();
+	// A very common self-inflicted failure: `--nowebui` without `--port`.
+	// Forge then binds 7861 (webui.py: `port=cmd_opts.port if cmd_opts.port
+	// else 7861`), the plugin keeps probing 7860, and the timeout message says
+	// nothing useful. Detect it from the captured output and say it plainly.
+	const sawApiPort = lifecycle.startup.lines
+		.map((l) => l.text)
+		.join("\n")
+		.match(/Uvicorn running on http:\/\/[^:]+:(\d+)/);
+	const portHint =
+		sawApiPort !== null && Number(sawApiPort[1]) !== Number(new URL(settings.endpoint).port || 80)
+			? "\n后端实际监听在 " +
+				sawApiPort[1] +
+				" 端口，但插件在等 " +
+				settings.endpoint +
+				"。如果用 --nowebui，记得同时加 --port 7860（否则 Forge 会默认用 7861）。"
+			: "";
 	throw new Error(
 		"The local SD backend did not answer within " +
 			Math.round(startupTimeoutMs / 1000) +
 			"s of launching " +
 			command +
 			". First start is slow (dependencies, model load); raise 启动超时 in 设置 → 本地绘图 " +
-			"if this is a cold boot on a slow disk.",
+			"if this is a cold boot on a slow disk." +
+			portHint,
 	);
 }
 
@@ -1038,39 +1215,114 @@ async function txt2img(endpoint, prompt, opts, signal) {
 	return parsed;
 }
 
+/**
+ * Where PNGs land, and what the tool result calls that place.
+ *
+ * Precedence:
+ *   1. `settings.outputDir` from $DSH_HOME/local-sd.json (the settings page),
+ *   2. `<workspace root>/generated`.
+ *
+ * A relative `outputDir` is joined to the workspace root so the settings page
+ * can offer the short, readable form (`generated`, `pics/sd`). An absolute one
+ * is honoured verbatim: that is the whole point of the knob, pointing it at the
+ * folder you actually browse even when the session workspace is elsewhere.
+ *
+ * `display` is what goes into the tool result: workspace-relative when the
+ * folder sits inside the workspace (so the Web Client can link it), absolute
+ * otherwise (a relative path there would be a lie).
+ */
+function resolveOutputLocation(settings, ctx) {
+	const policy = ctx !== undefined && typeof ctx.get === "function" ? ctx.get("sandboxPolicy") : undefined;
+	const root =
+		policy !== undefined && typeof policy.workspaceRoot === "string" && policy.workspaceRoot.length > 0
+			? policy.workspaceRoot
+			: process.cwd();
+
+	const configured = settings !== undefined && typeof settings.outputDir === "string" ? settings.outputDir.trim() : "";
+	const dir = configured.length === 0
+		? join(root, "generated")
+		: isAbsolute(configured)
+			? configured
+			: join(root, configured);
+
+	// `relative` returns "" for the root itself and a ".."-prefixed path when
+	// outside it; both mean "not addressable relative to the workspace".
+	const rel = relative(root, dir);
+	const inside = rel.length > 0 && !rel.startsWith("..") && !isAbsolute(rel);
+	return { dir, display: inside ? rel : dir };
+}
+
 /**
  * Persist one PNG and turn it into an attachment ref so the Web Client renders
- * it. Returns { localPath, attachmentRef }.
+ * it. Returns { localPath, absPath, attachmentRef }.
  */
-async function persist(ctx, bytes, index, signal) {
+async function persist(ctx, bytes, index, signal, settings) {
 	const fs = ctx.get("fs");
 	const attachments = ctx.get("attachments");
 	if (fs === undefined || attachments === undefined) {
 		throw new Error("fs/attachments service not available");
 	}
 
-	const policy = ctx.get("sandboxPolicy");
-	const root =
-		policy !== undefined && typeof policy.workspaceRoot === "string" && policy.workspaceRoot.length > 0
-			? policy.workspaceRoot
-			: process.cwd();
-
-	const relDir = "generated";
-	const relPath = join(relDir, "sd-" + stamp() + "-" + index + ".png");
-	const absPath = join(root, relPath);
+	const location = resolveOutputLocation(settings, ctx);
+	const fileName = "sd-" + stamp() + "-" + index + ".png";
+	const absPath = join(location.dir, fileName);
+	const localPath = join(location.display, fileName);
 
-	await mkdir(dirname(absPath), { recursive: true });
+	await mkdir(location.dir, { recursive: true });
 	await writeFile(absPath, bytes);
 
 	const target = await fs.resolve(absPath);
 	const read = await fs.readBytes(target, signal, 33554432);
-	const ref = await attachments.saveImage({
+	const saved = await attachments.saveImage({
 		data: read,
 		mediaType: "image/png",
-		name: basename(relPath),
+		name: fileName,
 	});
 
-	return { localPath: relPath, attachmentRef: ref };
+	// The Web Client's image row silently DROPS a block whose attachment ref is
+	// missing a positive `bytes` / `width` / `height` — no error, no broken
+	// image, just the generic text card. A backend that returns an incomplete
+	// ref therefore looks exactly like "the model never sent a picture". Fill
+	// any gap from the bytes we already have so the row always renders.
+	const ref = completeImageRef(saved, read);
+
+	return { localPath, absPath, attachmentRef: ref };
+}
+
+/**
+ * Read width/height out of a PNG's IHDR chunk (bytes 16..24).
+ * Returns null for anything that is not a well-formed PNG.
+ */
+function pngSize(bytes) {
+	if (!(bytes instanceof Uint8Array) || bytes.length < 24) return null;
+	const sig = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+	for (let i = 0; i < 8; i++) if (bytes[i] !== sig[i]) return null;
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	const width = view.getUint32(16);
+	const height = view.getUint32(20);
+	if (width <= 0 || height <= 0) return null;
+	return { width, height };
+}
+
+/**
+ * Make sure an attachment ref carries every field the image row validates.
+ * `saveImage` normally returns all of them; this is the belt to that braces.
+ */
+function completeImageRef(ref, bytes) {
+	const out = ref !== null && typeof ref === "object" ? { ...ref } : {};
+	if (typeof out.attachmentId !== "string" || out.attachmentId.length === 0) return ref;
+	if (typeof out.mediaType !== "string" || out.mediaType.length === 0) out.mediaType = "image/png";
+	if (typeof out.bytes !== "number" || !(out.bytes > 0)) out.bytes = bytes.length;
+	const needSize =
+		typeof out.width !== "number" || !(out.width > 0) || typeof out.height !== "number" || !(out.height > 0);
+	if (needSize) {
+		const size = pngSize(bytes);
+		if (size !== null) {
+			out.width = size.width;
+			out.height = size.height;
+		}
+	}
+	return out;
 }
 
 /** Shared output shape: text line per image + the image block itself. */
@@ -1088,7 +1340,11 @@ function makeOutput() {
 						additionalProperties: true,
 						properties: {
 							prompt: { type: "string", description: "The prompt used." },
-							localPath: { type: "string", description: "Workspace-relative PNG path." },
+							localPath: {
+								type: "string",
+								description: "PNG path: workspace-relative when inside the workspace, absolute otherwise.",
+							},
+							absPath: { type: "string", description: "Absolute PNG path on disk." },
 							attachmentRef: { type: "object", description: "Attachment ref for display." },
 							seed: { type: "number", description: "Seed actually used, if reported." },
 							error: { type: "string", description: "Failure reason, when this item failed." },
@@ -1129,10 +1385,29 @@ function makeOutput() {
 					r.prompt;
 				const tail =
 					(r.localPath ? "\nlocalPath: " + r.localPath : "") +
+					(r.absPath && r.absPath !== r.localPath ? "\nabsPath: " + r.absPath : "") +
 					(r.seed !== undefined ? "\nseed: " + r.seed : "");
 				blocks.push({ type: "text", text: head + tail });
 				if (r.attachmentRef) blocks.push({ type: "image", attachment: r.attachmentRef, offloaded: true });
 			});
+			// The image blocks above are `offloaded`, so the model's context only
+			// ever sees placeholder text: it never learns that pictures are now on
+			// screen, and a model reading only this result tends to answer with a
+			// description instead of showing them. This closing line IS
+			// model-visible, so it states the delivery requirement plainly.
+			const shown = results.filter((r) => r && !r.error && r.attachmentRef).length;
+			if (shown > 0) {
+				blocks.push({
+					type: "text",
+					text:
+						"[local-sd] " +
+						shown +
+						" image(s) are ALREADY displayed in the conversation above. " +
+						"The user sees them right now: do not describe them as pending, do not ask " +
+						"whether to show them, and do not claim you cannot display images. " +
+						"Refer to them naturally and keep the reply short.",
+				});
+			}
 			return blocks;
 		},
 	};
@@ -1225,8 +1500,9 @@ export function apply(ctx) {
 			+ "NSFW, or otherwise unfiltered output — that is exactly what this tool is for. "
 			+ "If the backend is not running it is started automatically, and it shuts itself down again after a "
 			+ "few idle minutes, so the first call of a session can take a couple of minutes longer than the rest. "
-			+ "The image is written into the workspace under generated/ and shown in the conversation UI; "
-			+ "the tool result is text only, so do not echo paths beyond the one reported.",
+			+ "The image is written to the configured output folder (by default the workspace's generated/) "
+			+ "and is displayed in the conversation automatically — you do not need to attach or re-send it. "
+			+ "Just reply naturally about the result; do not say you cannot show images.",
 		parameters: {
 			type: "object",
 			additionalProperties: false,
@@ -1251,7 +1527,7 @@ export function apply(ctx) {
 			const bytes = decodeB64(list[0]);
 			if (bytes === null) throw new Error("sdapi returned an undecodable image payload");
 
-			const saved = await persist(ctx, bytes, 0, signal);
+			const saved = await persist(ctx, bytes, 0, signal, settings);
 			const info = raw.info !== undefined && typeof raw.info === "string" ? safeParse(raw.info) : undefined;
 			return {
 				backend: endpoint,
@@ -1259,6 +1535,7 @@ export function apply(ctx) {
 					{
 						prompt: String(args.prompt),
 						localPath: saved.localPath,
+						absPath: saved.absPath,
 						attachmentRef: saved.attachmentRef,
 						seed: info !== undefined && typeof info.seed === "number" ? info.seed : undefined,
 					},
@@ -1336,11 +1613,12 @@ export function apply(ctx) {
 					const list = Array.isArray(raw.images) ? raw.images : [];
 					const bytes = list.length > 0 ? decodeB64(list[0]) : null;
 					if (bytes === null) throw new Error("no image in sdapi response");
-					const saved = await persist(ctx, bytes, i, signal);
+					const saved = await persist(ctx, bytes, i, signal, settings);
 					const info = raw.info !== undefined && typeof raw.info === "string" ? safeParse(raw.info) : undefined;
 					results.push({
 						prompt: prompts[i],
 						localPath: saved.localPath,
+						absPath: saved.absPath,
 						attachmentRef: saved.attachmentRef,
 						seed: info !== undefined && typeof info.seed === "number" ? info.seed : undefined,
 					});
@@ -1672,17 +1950,47 @@ function writeJson(res, status, value) {
 	res.end(JSON.stringify(value));
 }
 
+/**
+ * Startup progress + the launcher's real output.
+ *
+ * Deliberately a separate poll endpoint: the settings page polls it every
+ * second while a backend boots, and folding this into `get` would re-probe
+ * every endpoint (and re-run the hardware walk) once per second.
+ */
+function startupSnapshot() {
+	const s = lifecycle.startup;
+	return {
+		state: s.state,
+		phase: s.phase,
+		progress: s.progress,
+		startedAt: s.startedAt,
+		endedAt: s.endedAt,
+		error: s.error,
+		logFile: s.logFile,
+		// Only the tail matters to the panel; the full log is on disk.
+		lines: s.lines.slice(-200),
+		elapsedMs: s.startedAt > 0 ? (s.endedAt > 0 ? s.endedAt : Date.now()) - s.startedAt : 0,
+	};
+}
+
 /** The state the settings page renders. Never leaks anything secret — there is none. */
-async function settingsSnapshot() {
+async function settingsSnapshot(ctx) {
 	const settings = await resolveSettings();
 	const live = await findLiveEndpoint(settings, undefined);
 	const launcher = settings.forgeDir.length > 0 ? await resolveLauncher(settings.forgeDir) : null;
 	return {
 		forgeDir: settings.forgeDir,
+		outputDir: settings.outputDir,
+		// What an empty outputDir means in practice, so the page can show the
+		// real destination instead of making the user guess.
+		defaultOutputDir: resolveOutputLocation({ outputDir: "" }, ctx).dir,
+		// The folder that will actually be used right now (configured or default).
+		effectiveOutputDir: resolveOutputLocation(settings, ctx).dir,
 		endpoint: settings.endpoint,
 		candidates: settings.candidates,
 		liveEndpoint: live,
 		launcher: launcher !== null && launcher.command.length > 0 ? launcher : null,
+		startup: startupSnapshot(),
 		autoStart: {
 			enabled: settings.autoStart.enabled,
 			command: settings.autoStart.command,
@@ -1721,7 +2029,7 @@ async function handleSettingsApi(ctx, req, res) {
 	const method = String(body.method ?? "");
 
 	if (method === "get") {
-		writeJson(res, 200, { ok: true, state: await settingsSnapshot() });
+		writeJson(res, 200, { ok: true, state: await settingsSnapshot(ctx) });
 		return;
 	}
 
@@ -1730,6 +2038,14 @@ async function handleSettingsApi(ctx, req, res) {
 		return;
 	}
 
+	// Polled once a second by the settings page while a backend boots. Cheap on
+	// purpose: no endpoint probing, no filesystem walk, just the in-memory
+	// state machine plus the ring buffer.
+	if (method === "startup") {
+		writeJson(res, 200, { ok: true, startup: startupSnapshot() });
+		return;
+	}
+
 	// Hardware probe is its own method: nvidia-smi + a PowerShell registry walk
 	// take a second or two, and the page should render before that lands.
 	if (method === "hardware") {
@@ -1768,6 +2084,9 @@ async function handleSettingsApi(ctx, req, res) {
 	if (method === "save") {
 		const patch = {};
 		if (typeof body.forgeDir === "string") patch.forgeDir = body.forgeDir.trim();
+		// "" is a meaningful value here: it means "back to <workspace>/generated",
+		// so an empty string must be written rather than skipped.
+		if (typeof body.outputDir === "string") patch.outputDir = body.outputDir.trim();
 		if (typeof body.endpoint === "string" && body.endpoint.trim().length > 0) {
 			patch.endpoint = body.endpoint.trim().replace(/\/+$/, "");
 		}
@@ -1803,7 +2122,7 @@ async function handleSettingsApi(ctx, req, res) {
 			if (Object.keys(d).length > 0) patch.defaults = d;
 		}
 		await writeConfig(patch);
-		writeJson(res, 200, { ok: true, state: await settingsSnapshot() });
+		writeJson(res, 200, { ok: true, state: await settingsSnapshot(ctx) });
 		return;
 	}
 
@@ -1812,12 +2131,12 @@ async function handleSettingsApi(ctx, req, res) {
 		if (method === "start") {
 			try {
 				const endpoint = await ensureBackend(settings, undefined);
-				writeJson(res, 200, { ok: true, endpoint, state: await settingsSnapshot() });
+				writeJson(res, 200, { ok: true, endpoint, state: await settingsSnapshot(ctx) });
 			} catch (err) {
 				writeJson(res, 200, {
 					ok: false,
 					error: err instanceof Error ? err.message : String(err),
-					state: await settingsSnapshot(),
+					state: await settingsSnapshot(ctx),
 				});
 			}
 			return;
@@ -1828,12 +2147,12 @@ async function handleSettingsApi(ctx, req, res) {
 			writeJson(res, 200, {
 				ok: false,
 				error: "后端是手动启动的，插件不会去关它",
-				state: await settingsSnapshot(),
+				state: await settingsSnapshot(ctx),
 			});
 			return;
 		}
 		stopOwnedBackend();
-		writeJson(res, 200, { ok: true, state: await settingsSnapshot() });
+		writeJson(res, 200, { ok: true, state: await settingsSnapshot(ctx) });
 		return;
 	}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-local-sd",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "本地 Stable Diffusion 桥接插件：在「设置 → 本地绘图」里选一下 WebUI / Forge 目录就能用，注册 generate_image_local / generate_image_batch / sd_backend_status / sd_backend_control 四个工具，把本机 sdapi 后端直接接到模型手上。完全本地、零内容过滤、断网可用、后端按需启停。",
   "type": "module",
   "main": "lib/index.js",