dsh-comfyui-gateway 0.4.3 → 0.4.7

package/client.js

@@ -51,12 +51,14 @@ window.__ModuleLoader__.load({
             restart: '重启',
             remove: '解绑',
             controlNone: '不受网关托管（只能派发，不能启停）',
-            controlSpawn: '本机托管：网关启动/停止该进程',
-            controlSsh: '远程托管：通过 ssh 启停',
-            command: '启动命令',
-            commandHint: '整条命令行，例如 E:\\ComfyUI\\python_embeded\\python.exe -s E:\\ComfyUI\\ComfyUI\\main.py --port 8190',
-            cwd: '工作目录（可空）',
-            sshHost: 'SSH 目标（如 user@192.168.3.253）',
+            controlSpawn: '本机托管：网关启动/停止这个 bat 文件',
+            controlSsh: '远程托管：通过 ssh 启停（已停用）',
+            batPath: 'bat 文件',
+            batHint: '填 .bat 的完整路径，网关启动时执行它；停止时连同它的子进程一起杀掉。',
+            batPlaceholder: 'E:\\ComfyUI\\启动.bat',
+            batMissing: '填一个存在的 .bat 文件路径',
+            batPicked: '已选文件',
+            cwd: '工作目录（可空，默认 bat 所在目录）',
             apply: '应用',
             probe: '刷新状态',
             healthy: '在线',
@@ -95,8 +97,8 @@ window.__ModuleLoader__.load({
             advancedHint: '填了启动命令，面板上的“启动/停止”才会真正作用于本机进程。',
             controlType: '托管方式',
             noneOpt: '不托管',
-            spawnOpt: '本机命令',
-            sshOpt: 'SSH 远程',
+            spawnOpt: '启动 bat 文件',
+            sshOpt: 'SSH 远程（旧配置）',
             applyFirst: '先保存实例修改',
             changed: '有未保存的修改',
             refresh: '自动刷新 2s',
@@ -117,6 +119,13 @@ window.__ModuleLoader__.load({
             noSessions: '当前无人登录',
             revokeAll: '踢掉全部会话',
             remotePort: '远程端口',
+            remotePortHint: '只服务浏览器；改完点“重启网关”生效。',
+            instancePort: '端口',
+            editPort: '改端口',
+            savePort: '保存端口',
+            portRange: '端口 1–65535',
+            portSame: '两个端口不能相同',
+            baseUrlHint: 'http://主机:端口，不带尾斜杠',
             gatewayPort: '网关端口',
             sectionRemote: '远程控制',
             sectionRemoteHint: '另一台电脑/手机访问的页面：账号、等级、配对码。',
@@ -184,12 +193,14 @@ window.__ModuleLoader__.load({
             restart: 'Restart',
             remove: 'Unbind',
             controlNone: 'Not owned (dispatch only)',
-            controlSpawn: 'Host-owned: the gateway starts and stops it',
-            controlSsh: 'Remote-owned over ssh',
-            command: 'Start command',
-            commandHint: 'Full command line, e.g. E:\\ComfyUI\\python_embeded\\python.exe -s E:\\ComfyUI\\ComfyUI\\main.py --port 8190',
-            cwd: 'Working directory (optional)',
-            sshHost: 'SSH target (user@host)',
+            controlSpawn: 'Host-owned: the gateway starts and stops this bat file',
+            controlSsh: 'Remote-owned over ssh (retired)',
+            batPath: 'Bat file',
+            batHint: 'Full path to a .bat file. The gateway runs it on start and kills its whole tree on stop.',
+            batPlaceholder: 'E:\\ComfyUI\\start.bat',
+            batMissing: 'Point at an existing .bat file',
+            batPicked: 'Picked',
+            cwd: 'Working directory (optional, defaults to the bat folder)',
             apply: 'Apply',
             probe: 'Refresh',
             healthy: 'online',
@@ -229,7 +240,7 @@ window.__ModuleLoader__.load({
             controlType: 'Control',
             noneOpt: 'None',
             spawnOpt: 'Local command',
-            sshOpt: 'SSH remote',
+            sshOpt: 'SSH remote (legacy)',
             applyFirst: 'Save instance changes first',
             changed: 'unsaved changes',
             refresh: 'auto refresh 2s',
@@ -250,6 +261,13 @@ window.__ModuleLoader__.load({
             noSessions: 'Nobody is logged in',
             revokeAll: 'Revoke all sessions',
             remotePort: 'Remote port',
+            remotePortHint: 'Serves browsers only; press Restart gateway to apply.',
+            instancePort: 'Port',
+            editPort: 'Edit port',
+            savePort: 'Save port',
+            portRange: 'Port 1–65535',
+            portSame: 'The two ports must differ',
+            baseUrlHint: 'http://host:port, no trailing slash',
             gatewayPort: 'Gateway port',
             sectionRemote: 'Remote console',
             sectionRemoteHint: 'The page other machines open: accounts, tiers, pairing code.',
@@ -376,6 +394,47 @@ window.__ModuleLoader__.load({
             return data;
         }
 
+        /**
+         * Status rows and writable rows are not the same shape, and mixing them up is
+         * what made the 托管方式 dropdown snap back to 不托管:
+         *
+         *   status row:  { control: 'spawn',   controlDetail: { type:'spawn', command, cwd } }
+         *   writable:    { control: { type:'spawn', command, cwd } }
+         *
+         * The card seeds its draft from the status row, so `draft.control` is the
+         * *string* "spawn" and `draft.control.type` is undefined. The select then
+         * reads undefined → falls back to 'none', and writing `{...draft.control}`
+         * spreads a string, producing `{ type: 'ssh' }` with no command at all. After
+         * the next 2 s poll the entry is unchanged on the server, the draft is
+         * reseeded from the status row, and the choice visibly jumps back.
+         *
+         * One converter, used by the card and by every full-list write, so there is
+         * exactly one place that knows the difference.
+         */
+        function writableInstance(entry) {
+            const detail = entry.controlDetail;
+            const control =
+                detail !== undefined && detail !== null && typeof detail === 'object'
+                    ? { ...detail }
+                    : { type: typeof entry.control === 'string' && entry.control !== '' ? entry.control : 'none' };
+            // A status row always reports a detail object; keep the bat path even when
+            // the type is 'none' so switching back and forth does not lose it.
+            return {
+                id: entry.id,
+                label: entry.label,
+                baseUrl: entry.baseUrl,
+                weight: entry.weight ?? 1,
+                maxConcurrent: entry.maxConcurrent ?? 1,
+                enabled: entry.enabled !== false,
+                autoStart: entry.autoStart === true,
+                control: {
+                    type: control.type === 'script' ? 'script' : 'none',
+                    batPath: typeof control.batPath === 'string' ? control.batPath : '',
+                    cwd: typeof control.cwd === 'string' ? control.cwd : '',
+                },
+            };
+        }
+
         const STATE_LABEL = {
             queued: 'queued',
             running: 'running',
@@ -411,11 +470,33 @@ window.__ModuleLoader__.load({
         /** One instance card: identity, live numbers, and its process controls. */
         function InstanceCard({ entry, t, onAction, onPatch, onRemove, busy }) {
             const [open, setOpen] = useState(false);
-            const [draft, setDraft] = useState(entry);
-            useEffect(() => setDraft(entry), [entry]);
+            // Seed from the *writable* shape, never from the status row: see
+            // writableInstance() for why spreading a status row loses the choice.
+            const [draft, setDraft] = useState(() => writableInstance(entry));
+            // The URL is the one field a person actually needs to fix from the card
+            // head (a port moved, a host changed), so it gets its own inline editor
+            // with its own save. Everything else lives behind "advanced".
+            const [editingUrl, setEditingUrl] = useState(false);
+            const [urlDraft, setUrlDraft] = useState(String(entry.baseUrl ?? ''));
+            const [urlError, setUrlError] = useState(null);
+            /**
+             * Reseed only when the *saved* configuration actually changed.
+             *
+             * Depending on `entry` reseeds on every poll: the status payload is rebuilt
+             * every 2 s, so `entry` is a new object each tick, the effect fires, and the
+             * draft is thrown away — the dropdown visibly snaps back to 不托管 even
+             * though nobody saved anything. The signature below changes only when the
+             * server really has different values (after Apply, or an external edit).
+             */
+            const savedSignature = JSON.stringify(writableInstance(entry));
+            useEffect(() => {
+                setDraft(JSON.parse(savedSignature));
+            }, [savedSignature]);
+            // The URL field is seeded when the editor opens, not on every status
+            // poll: polling would overwrite what the person is typing.
             const dirty = useMemo(
-                () => JSON.stringify(draft) !== JSON.stringify(entry),
-                [draft, entry],
+                () => JSON.stringify(draft) !== savedSignature,
+                [draft, savedSignature],
             );
             const device = (entry.devices ?? [])[0];
             const vramText =
@@ -423,6 +504,42 @@ window.__ModuleLoader__.load({
                     ? `${Math.round((device.vramTotal - (device.vramFree ?? 0)) / 1048576)} / ${Math.round(device.vramTotal / 1048576)} MiB`
                     : '—';
             const owned = entry.control !== 'none';
+            /**
+             * A bare port number is accepted as a shorthand: "8190" keeps the host
+             * the instance already has, which is what somebody changing a port means.
+             */
+            const normalizeUrl = (raw) => {
+                const text = String(raw ?? '').trim();
+                if (text === '') return '';
+                if (/^\d+$/.test(text)) {
+                    const host = /^[a-z]+:\/\/([^/:]+)/i.exec(String(entry.baseUrl ?? ''))?.[1];
+                    return host === undefined ? '' : `http://${host}:${text}`;
+                }
+                const withScheme = /^https?:\/\//i.test(text) ? text : `http://${text}`;
+                try {
+                    const url = new URL(withScheme);
+                    const port = Number(url.port);
+                    if (!Number.isFinite(port) || port < 1 || port > 65535) return '';
+                    return `${url.protocol}//${url.host}`;
+                } catch {
+                    return '';
+                }
+            };
+            const saveUrl = () => {
+                const next = normalizeUrl(urlDraft);
+                if (next === '') {
+                    setUrlError(t('portRange'));
+                    return;
+                }
+                setUrlError(null);
+                setEditingUrl(false);
+                // Only identity + the field being edited travel: the status entry
+                // carries display-only keys (`control` is the string "spawn" there,
+                // while the writable shape wants `control.type`). Spreading the whole
+                // entry would send the display string back and wipe the process
+                // settings.
+                onPatch({ id: entry.id, baseUrl: next });
+            };
             return h(
                 'div',
                 { className: 'cgw-card' },
@@ -431,13 +548,51 @@ window.__ModuleLoader__.load({
                     { className: 'cgw-card-head' },
                     h('span', { className: `cgw-dot cgw-dot--${entry.healthy ? 'ok' : entry.starting ? 'warn' : 'bad'}` }),
                     h('span', { className: 'cgw-section-title' }, entry.label || entry.id),
-                    h('span', { className: 'cgw-meta cgw-mono' }, entry.baseUrl),
+                    editingUrl
+                        ? h(
+                              'span',
+                              { className: 'cgw-row' },
+                              h('input', {
+                                  className: 'cgw-input cgw-mono',
+                                  style: { width: 190 },
+                                  placeholder: t('baseUrlHint'),
+                                  value: urlDraft,
+                                  onChange: (event) => setUrlDraft(event.target.value),
+                              }),
+                              h(
+                                  'button',
+                                  { className: 'cgw-btn cgw-btn--primary', disabled: busy, onClick: () => saveUrl() },
+                                  t('savePort'),
+                              ),
+                              h(
+                                  'button',
+                                  { className: 'cgw-btn cgw-btn--ghost', disabled: busy, onClick: () => setEditingUrl(false) },
+                                  '×',
+                              ),
+                          )
+                        : h('span', { className: 'cgw-meta cgw-mono' }, entry.baseUrl),
                     h('span', { className: 'cgw-grow' }),
                     entry.starting ? h('span', { className: 'cgw-meta' }, t('starting')) : null,
                     entry.stopping ? h('span', { className: 'cgw-meta' }, t('stopping')) : null,
+                    h(
+                        'button',
+                        {
+                            className: 'cgw-btn cgw-btn--ghost',
+                            disabled: busy || editingUrl,
+                            title: t('baseUrlHint'),
+                            onClick: () => {
+                                setUrlDraft(String(entry.baseUrl ?? ''));
+                                setUrlError(null);
+                                setEditingUrl(true);
+                            },
+                        },
+                        t('editPort'),
+                    ),
                     h('span', { className: 'cgw-badge' }, entry.healthy ? t('healthy') : t('unhealthy')),
                     entry.pid ? h('span', { className: 'cgw-badge cgw-mono' }, `pid ${entry.pid}`) : null,
                 ),
+                urlError === null ? null : h('div', { className: 'cgw-error' }, urlError),
+
                 h(
                     'div',
                     { className: 'cgw-kv' },
@@ -534,8 +689,10 @@ window.__ModuleLoader__.load({
                                           setDraft({ ...draft, control: { ...(draft.control ?? {}), type: event.target.value } }),
                                   },
                                   h('option', { value: 'none' }, t('noneOpt')),
-                                  h('option', { value: 'spawn' }, t('spawnOpt')),
-                                  h('option', { value: 'ssh' }, t('sshOpt')),
+                                  h('option', { value: 'script' }, t('spawnOpt')),
+                                  // Legacy rows that still say 'ssh' keep an option so the
+                                  // select does not show a blank line; saving normalizes it.
+                                  draft.control?.type === 'ssh' ? h('option', { value: 'ssh' }, t('sshOpt')) : null,
                               ),
                           ),
                           (draft.control?.type ?? 'none') === 'none'
@@ -543,31 +700,31 @@ window.__ModuleLoader__.load({
                               : h(
                                     'div',
                                     { style: { display: 'flex', flexDirection: 'column', gap: 6 } },
-                                    draft.control?.type === 'ssh'
-                                        ? h('input', {
-                                              className: 'cgw-input',
-                                              placeholder: t('sshHost'),
-                                              value: draft.control?.sshHost ?? '',
-                                              onChange: (event) =>
-                                                  setDraft({ ...draft, control: { ...(draft.control ?? {}), sshHost: event.target.value } }),
-                                          })
-                                        : null,
-                                    h('input', {
-                                        className: 'cgw-input',
-                                        placeholder: t('commandHint'),
-                                        value: draft.control?.command ?? '',
-                                        onChange: (event) =>
-                                            setDraft({ ...draft, control: { ...(draft.control ?? {}), command: event.target.value } }),
-                                    }),
-                                    draft.control?.type === 'spawn'
-                                        ? h('input', {
-                                              className: 'cgw-input',
-                                              placeholder: t('cwd'),
-                                              value: draft.control?.cwd ?? '',
-                                              onChange: (event) =>
-                                                  setDraft({ ...draft, control: { ...(draft.control ?? {}), cwd: event.target.value } }),
-                                          })
-                                        : null,
+                                    h(
+                                        'div',
+                                        { className: 'cgw-row' },
+                                        h('span', { className: 'cgw-meta' }, t('batPath')),
+                                        h('input', {
+                                            className: 'cgw-input cgw-input--wide cgw-mono',
+                                            placeholder: t('batPlaceholder'),
+                                            value: draft.control?.batPath ?? '',
+                                            onChange: (event) =>
+                                                setDraft({ ...draft, control: { ...(draft.control ?? {}), batPath: event.target.value } }),
+                                        }),
+                                    ),
+                                    h('div', { className: 'cgw-meta' }, t('batHint')),
+                                    h(
+                                        'div',
+                                        { className: 'cgw-row' },
+                                        h('span', { className: 'cgw-meta' }, t('cwd')),
+                                        h('input', {
+                                            className: 'cgw-input cgw-input--wide cgw-mono',
+                                            placeholder: t('cwd'),
+                                            value: draft.control?.cwd ?? '',
+                                            onChange: (event) =>
+                                                setDraft({ ...draft, control: { ...(draft.control ?? {}), cwd: event.target.value } }),
+                                        }),
+                                    ),
                                 ),
                           h(
                               'div',
@@ -594,7 +751,7 @@ window.__ModuleLoader__.load({
         }
 
         /** Remote-access control: the pairing code, accounts, sessions, leases. */
-        function RemoteCard({ t, status, busy, act }) {
+        function RemoteCard({ t, status, busy, act, portDraft, onPortDraft, onSavePort }) {
             const [code, setCode] = useState(null);
             const [name, setName] = useState('');
             const [password, setPassword] = useState('');
@@ -718,6 +875,23 @@ window.__ModuleLoader__.load({
                     h('span', { className: 'cgw-meta' }, remote.listening ? t('remoteOn') : t('remoteOff')),
                 ),
                 remote.enabled === true ? null : h('div', { className: 'cgw-meta' }, t('remoteOffHint')),
+                h(
+                    'div',
+                    { className: 'cgw-row' },
+                    h('span', { className: 'cgw-meta' }, t('remotePort')),
+                    h('input', {
+                        className: 'cgw-input cgw-input--num',
+                        value: portDraft,
+                        onChange: (event) => onPortDraft(String(event.target.value).replace(/[^0-9]/g, '')),
+                    }),
+                    h(
+                        'button',
+                        { className: 'cgw-btn', disabled: busy, onClick: () => void onSavePort() },
+                        t('save'),
+                    ),
+                    h('span', { className: 'cgw-grow' }),
+                    h('span', { className: 'cgw-meta' }, t('remotePortHint')),
+                ),
                 h('div', { className: 'cgw-meta' }, t('requireCodeHint')),
                 h(
                     'div',
@@ -947,80 +1121,66 @@ window.__ModuleLoader__.load({
 
             const instanceAction = (action, id) => act('/comfyui-gateway/instances', { action, id });
 
+            /** Every full-list write goes through the one shape converter. */
+            const writableList = () => (status?.instances ?? []).map((entry) => writableInstance(entry));
+
             /** Apply one instance patch: replace that row, keep the rest verbatim. */
             const patchInstance = (patch) => {
-                const current = status?.instances ?? [];
-                const raw = current.map((entry) => ({
-                    id: entry.id,
-                    label: entry.label,
-                    baseUrl: entry.baseUrl,
-                    weight: entry.weight ?? 1,
-                    maxConcurrent: entry.maxConcurrent ?? 1,
-                    enabled: entry.enabled !== false,
-                    autoStart: entry.autoStart === true,
-                    control: entry.controlDetail ?? { type: entry.control === 'none' ? 'none' : entry.control },
-                }));
+                const raw = writableList();
                 const index = raw.findIndex((entry) => entry.id === patch.id);
                 if (index < 0) return;
-                raw[index] = { ...raw[index], ...patch, id: patch.id };
+                // Merge into the converted row, so a patch carrying only `{id, baseUrl}`
+                // still sends the row's real control block instead of dropping it.
+                raw[index] = { ...raw[index], ...patch, id: patch.id, control: patch.control ?? raw[index].control };
                 return act('/comfyui-gateway/instances', { action: 'apply', instances: raw });
             };
 
             const addInstance = async () => {
                 const url = newUrl.trim();
                 if (url === '') return;
-                const current = status?.instances ?? [];
-                const raw = current.map((entry) => ({
-                    id: entry.id,
-                    label: entry.label,
-                    baseUrl: entry.baseUrl,
-                    weight: entry.weight ?? 1,
-                    maxConcurrent: entry.maxConcurrent ?? 1,
-                    enabled: entry.enabled !== false,
-                    autoStart: entry.autoStart === true,
-                    control: entry.controlDetail ?? { type: entry.control === 'none' ? 'none' : entry.control },
-                }));
+                const raw = writableList();
                 raw.push({ baseUrl: url, enabled: true, maxConcurrent: 1, weight: 1, control: { type: 'none' } });
                 const data = await act('/comfyui-gateway/instances', { action: 'apply', instances: raw });
                 if (data?.ok !== false) setNewUrl('');
             };
 
             const removeInstance = (id) => {
-                const raw = (status?.instances ?? [])
-                    .filter((entry) => entry.id !== id)
-                    .map((entry) => ({
-                        id: entry.id,
-                        label: entry.label,
-                        baseUrl: entry.baseUrl,
-                        weight: entry.weight ?? 1,
-                        maxConcurrent: entry.maxConcurrent ?? 1,
-                        enabled: entry.enabled !== false,
-                        autoStart: entry.autoStart === true,
-                        control: entry.controlDetail ?? { type: entry.control === 'none' ? 'none' : entry.control },
-                    }));
+                const raw = writableList().filter((entry) => entry.id !== id);
                 return act('/comfyui-gateway/instances', { action: 'apply', instances: raw });
             };
 
             const toggleDynamic = (on) => act('/comfyui-gateway/pool', { action: 'dynamic', enabled: on });
 
-            /** Both ports save the same way: validate, write, say a restart is due. */
-            const savePorts = async () => {
-                const port = Number(draftPort);
+            /**
+             * Each port is saved from the card that owns it: the gateway port from
+             * the gateway card, the remote port from the remote card. Splitting the
+             * form is the whole point — a person editing the console port is looking
+             * at console settings, not at the gateway listener. They still share one
+             * validation because they must not collide.
+             */
+            const commitPort = async (port) => {
                 const remotePort = Number(draftRemotePort);
-                for (const value of [port, remotePort]) {
-                    if (!Number.isFinite(value) || value < 1 || value > 65535) {
-                        setNotice({ kind: 'error', text: '端口 1–65535' });
-                        return;
-                    }
+                const gatewayPort = Number(draftPort);
+                const other = port === gatewayPort ? remotePort : gatewayPort;
+                if (!Number.isFinite(port) || port < 1 || port > 65535) {
+                    setNotice({ kind: 'error', text: t('portRange') });
+                    return;
                 }
-                if (port === remotePort) {
-                    setNotice({ kind: 'error', text: '两个端口不能相同' });
+                if (Number.isFinite(other) && port === other) {
+                    setNotice({ kind: 'error', text: t('portSame') });
                     return;
                 }
-                await act('/comfyui-gateway/settings', { listen: { port }, remote: { port: remotePort } });
+                if (port === gatewayPort) {
+                    await act('/comfyui-gateway/settings', { listen: { port } });
+                } else {
+                    await act('/comfyui-gateway/settings', { remote: { port } });
+                }
                 setNotice({ kind: 'info', text: t('remoteRestart') });
             };
 
+            const saveGatewayPort = () => commitPort(Number(draftPort));
+            const saveRemotePort = () => commitPort(Number(draftRemotePort));
+
 
 
             const restartGateway = async () => {
@@ -1091,7 +1251,15 @@ window.__ModuleLoader__.load({
                         h('span', { className: 'cgw-group-title' }, t('sectionRemote')),
                         h('span', { className: 'cgw-meta' }, t('sectionRemoteHint')),
                     ),
-                    h(RemoteCard, { t, status, busy, act }),
+                    h(RemoteCard, {
+                        t,
+                        status,
+                        busy,
+                        act,
+                        portDraft: draftRemotePort,
+                        onPortDraft: setDraftRemotePort,
+                        onSavePort: saveRemotePort,
+                    }),
                 ),
                 h(
                     'div',
@@ -1145,16 +1313,8 @@ window.__ModuleLoader__.load({
                                 onChange: (event) => setDraftPort(event.target.value.replace(/[^0-9]/g, '')),
                             },
                         ),
-                        h('span', { className: 'cgw-meta' }, t('remotePort')),
-                        h(
-                            'input',
-                            {
-                                className: 'cgw-input cgw-input--num',
-                                value: draftRemotePort,
-                                onChange: (event) => setDraftRemotePort(event.target.value.replace(/[^0-9]/g, '')),
-                            },
-                        ),
-                        h('button', { className: 'cgw-btn', disabled: busy, onClick: () => void savePorts() }, t('save')),
+                        h('button', { className: 'cgw-btn', disabled: busy, onClick: () => void saveGatewayPort() }, t('save')),
+                        h('span', { className: 'cgw-grow' }),
                         h('code', { className: 'cgw-mono cgw-meta' }, String(status.settings?.listen?.host ?? '0.0.0.0')),
                     ),
                     h(

package/lib/config.js

@@ -85,7 +85,7 @@ export function defaultSettings() {
                 maxConcurrent: 1,
                 enabled: true,
                 autoStart: false,
-                control: { type: 'none', command: '', cwd: '', sshHost: '', stopTimeoutMs: 15000, readyTimeoutMs: 300000 },
+                control: { type: 'none', batPath: '', cwd: '', stopTimeoutMs: 15000, readyTimeoutMs: 300000 },
             },
             {
                 id: 'p8189',
@@ -96,7 +96,7 @@ export function defaultSettings() {
                 maxConcurrent: 1,
                 enabled: true,
                 autoStart: false,
-                control: { type: 'none', command: '', cwd: '', sshHost: '', stopTimeoutMs: 15000, readyTimeoutMs: 300000 },
+                control: { type: 'none', batPath: '', cwd: '', stopTimeoutMs: 15000, readyTimeoutMs: 300000 },
             },
         ],
     };

package/lib/gateway.js

@@ -483,7 +483,13 @@ export class GatewayServer {
                 maxConcurrent: runtime.instance.maxConcurrent,
                 weight: runtime.instance.weight,
                 control: runtime.instance.control.type,
-                /** The full control block, so the panel can edit command/cwd/sshHost. */
+                /**
+                 * The full control block, so the panel can edit batPath/cwd.
+                 *
+                 * `control` above is the *type string* — the panel must never spread it
+                 * into an object (that is what made the 托管方式 dropdown snap back to
+                 * 不托管: `{...'spawn'}` yields `{}` with no type). Read this one instead.
+                 */
                 controlDetail: runtime.instance.control,
                 pid: runtime.pid,
                 starting: runtime.starting,