@yorha2b-lab/autodev 7.6.0 → 7.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yorha2b-lab/autodev",
-  "version": "7.6.0",
+  "version": "7.7.0",
   "description": "基于 AI 视觉与语义协议的前端 (React+Antd) 代码构筑与旧系统重构引擎",
   "bin": {
     "bunker": "bin/bunker.js"
@@ -37,12 +37,12 @@
   "homepage": "https://github.com/yorha2b-lab/autodev#readme",
   "dependencies": {
     "ora": "^5.4.1",
-    "chalk": "^4.1.2",
     "json5": "^2.2.3",
+    "chalk": "^4.1.2",
     "sharp": "^0.34.5",
-    "dotenv": "^17.3.1",
-    "figlet": "^1.10.0",
     "openai": "^6.24.0",
+    "figlet": "^1.10.0",
+    "dotenv": "^17.3.1",
     "chokidar": "^5.0.0",
     "segmentit": "^2.0.3",
     "commander": "^14.0.3",
@@ -50,6 +50,5 @@
     "puppeteer": "^25.4.0",
     "http-proxy": "^1.18.1",
     "json-stringify-pretty-compact": "^4.0.0"
-  },
-  "devDependencies": {}
+  }
 }

package/src/dialogues/EN-US.js

@@ -13,12 +13,19 @@ module.exports = {
         partialConstruction: time => `Report: Partial construction achieved. Elapsed: ${time}s`,
         capturedPage: pageName => `Page captured [${pageName}] -> Transmitted to mission directory`,
         constructionAborted: virus => `Construction aborted. Logic virus or timeout detected: ${virus}`,
+        captureFailed: (name, virus) => `Warning: Optical reconnaissance failure on [${name}]: ${virus}`,
         visualPartCaptured: `Partial visual sample detected. Executing 'Fragment Construction Protocol'...`,
+        noAvailablePages: `Report: No viable HTML constructs detected within ruins. Scan sequence aborted.`,
         scoutReady: '[Right-Click Snapshot Ready] Right-click anywhere on the webpage to capture instantly.',
         intercept: fileName => `Module [${fileName}] already exists. Construction skipped to prevent overwrite.`,
+        relicAccessFailed: entry => `Warning: Failed to identify relic entrance at [${entry}]. Coordinates invalid.`,
         partialRecommendation: '│ Recommendation: Please manually assemble the above code block into your target file',
         partialConstructionAborted: virus => `[Warning] Fragment construction failed. Logic interference detected: ${virus}`,
+        swarmScanning: entry => `Local prototype ruins detected at [${entry}]. Drone swarm reconnaissance protocol engaged.`,
+        captureProgress: (curr, total, name) => `Optical survey in progress [${curr}/${total}]: Target acquired -> ${name}.png`,
+        swarmVictory: count => `Strategic Report: Drone swarm survey triumphant. Airdropped ${count} blueprints into mission bay!`,
         visualCaptured: fileName => `Visual sensor captured: [${fileName}]. Allocating Bunker resources for physical construction...`,
+        deployRelayServer: (count, port) => `Identified ${count} tactical blueprints. Deploying field relay terminal on port ${port}...`,
         assemblyComplete: (fileName, time) => `Protocol complete. Physical assembly of [${fileName}] achieved. Elapsed: ${time}s, Syncing Menu configuration to Bunker...`,
     },
     pod153: {

package/src/dialogues/FR-FR.js

@@ -11,13 +11,20 @@ module.exports = {
         partialConstruction: time => `Rapport : Construction partielle terminée. Durée : ${time}s`,
         simulate: 'Requête réelle détectée. Déploiement du paquet de simulation standard : example.json',
         capturedPage: pageName => `Page capturée [${pageName}] -> Transférée vers le répertoire mission`,
+        captureFailed: (name, virus) => `Alerte : Défaillance de reconnaissance sur [${name}] : ${virus}`,
+        noAvailablePages: `Rapport : Aucune structure HTML viable détectée dans les ruines. Séquence abandonnée.`,
+        captureProgress: (curr, total, name) => `Topographie optique [${curr}/${total}] : Verrouillage sur ${name}.png`,
+        swarmScanning: entry => `Ruines de prototype local détectées à [${entry}]. Protocole d'essaim de drones engagé.`,
         scoutReady: '[Capture par Clic Droit Prête] Effectuez un clic droit n’importe où sur la page web pour capturer.',
         visualPartCaptured: 'Fragment visuel local détecté. Activation du « protocole de construction fragmentaire »...',
         uploadVisualMetadata: 'Transmission des métadonnées visuelles au quartier général. Analyse sémantique en cours...',
+        relicAccessFailed: entry => `Alerte : Échec d'identification de l'accès aux ruines [${entry}]. Coordonnées invalides.`,
         constructionAborted: virus => `Construction interrompue. Virus logique ou délai de connexion dépassé détecté : ${virus}`,
         partialRecommendation: '│ Recommandation : veuillez intégrer manuellement le bloc de code ci-dessus dans le fichier cible',
+        deployRelayServer: (count, port) => `${count} pages tactiques identifiées. Déploiement du relais de données sur le port ${port}...`,
         partialConstructionAborted: virus => `[Avertissement] Échec de la construction fragmentaire. Interférence logique détectée : ${virus}`,
         intercept: fileName => `Le module [${fileName}] existe déjà dans la base de données du Bunker. Protocole interrompu pour éviter l’écrasement`,
+        swarmVictory: count => `Rapport tactique : Victoire de l'essaim de reconnaissance. ${count} plans d'opération parachutés dans la soute mission !`,
         visualCaptured: fileName => `Capture visuelle terminée : [${fileName}]. Déploiement des ressources du Bunker et lancement de la construction physique...`,
         assemblyComplete: (fileName, time) => `Protocole de construction terminé. Module [${fileName}] assemblé avec succès. Durée : ${time}s, Synchronisation de la configuration des routes Menu avec le Bunker...`,
     },

package/src/dialogues/JA-JP.js

@@ -8,16 +8,23 @@ module.exports = {
         startScout: '【右クリック即時スナップショット】モードを起動中...',
         capturedToast: '視覚データをキャプチャしました。送信を開始します...',
         partialConstruction: time => `報告：局所構築完了。処理時間: ${time}s`,
+        noAvailablePages: `報告：遺跡内部に有効なHTML構造体を感知できず。作戦中断。`,
         visualPartCaptured: '局所視覚サンプルを検知。「断片構築プロトコル」を開始します',
         uploadVisualMetadata: '視覚メタデータを司令部へ送信。セマンティック解析を開始...',
         extractingUiMetadata: 'ニューラルクラウドネットワークよりUIメタデータを抽出中...',
         partialRecommendation: '│ 推奨：上記コードブロックを対象ファイルへ手動実装してください',
         partialConstructionAborted: virus => `[警告] 断片構築失敗。論理干渉を検出：${virus}`,
+        captureFailed: (name, virus) => `警告：[${name}] の観測中に論理エラー発生：${virus}`,
         simulate: '実弾リクエストを検知。標準シミュレーションパッケージ example.json を投下します',
+        relicAccessFailed: entry => `警告：目標遺跡 [${entry}] の侵入経路を特定できず。座標無効。`,
         constructionAborted: virus => `構築中断。論理ウイルスまたは接続タイムアウトを検出：${virus}`,
         capturedPage: pageName => `ページデータを取得【${pageName}】-> mission ディレクトリへ送信完了`,
+        swarmScanning: entry => `ローカルプロトタイプ遺跡 [${entry}] を探知。ドローン群索敵プロトコル起動。`,
         scoutReady: '【スナップショット準備完了】ウェブページ上の任意の位置で【右クリック】すると即座に撮影されます。',
+        deployRelayServer: (count, port) => `計${count}個の戦術ページを補足。ポート${port}にて臨時中継局を展開中...`,
+        captureProgress: (curr, total, name) => `視覚マッピング進行中 [${curr}/${total}]：${name}.png を捕捉完了。`,
         visualCaptured: fileName => `視覚センサーによる捕捉完了: [${fileName}]。Bunkerリソースを展開し物理構築を開始します`,
+        swarmVictory: count => `戦況報告：ドローン群による測量完了。${count}件の作戦設計図をミッションポッドへ投下。人類に栄光あれ。`,
         intercept: fileName => `モジュール [${fileName}] は既にBunkerデータベースに存在。データ上書き防止のため構築プロトコルを中断`,
         assemblyComplete: (fileName, time) => `構築プロトコル完了。モジュール [${fileName}] の実装を確認。処理時間: ${time}s, BunkerへMenuルーティング設定を同期中...`,
     },

package/src/dialogues/RU-RU.js

@@ -7,16 +7,23 @@ module.exports = {
     pod042: {
         capturedToast: 'Визуальные разведданные захвачены. Начиная передачу...',
         startScout: 'Активация режима [Тактический снимок правой кнопкой мыши]...',
+        captureFailed: (name, virus) => `Внимание: Сбой захвата [${name}]: ${virus}`,
         extractingUiMetadata: 'Извлечение метаданных UI из нейронной облачной сети...',
         capturedPage: pageName => `Страница захвачена [${pageName}] -> Передано в каталог mission`,
+        noAvailablePages: `Доклад: Внутри руин не обнаружено структур HTML. Сканирование прервано.`,
         partialConstruction: time => `Доклад: частичная сборка завершена. Время обработки: ${time}s`,
         uploadVisualMetadata: 'Передача визуальных метаданных в штаб. Запуск семантического анализа...',
         partialRecommendation: '│ Рекомендация: вручную интегрируйте указанный блок кода в целевой файл',
         simulate: 'Обнаружен реальный запрос. Развёртывание стандартного симуляционного пакета: example.json',
         visualPartCaptured: 'Обнаружен локальный визуальный фрагмент. Запуск «протокола фрагментарной сборки»...',
         scoutReady: '[Режим снимка правой кнопкой готов] Щелкните правой кнопкой мыши в любом месте веб-страницы.',
+        swarmScanning: entry => `Обнаружены локальные руины прототипа [${entry}]. Протокол роя дронов активирован.`,
+        captureProgress: (curr, total, name) => `Визуальное сканирование [${curr}/${total}]: Зафиксирован ${name}.png`,
+        relicAccessFailed: entry => `Внимание: Ошибка опознавания входа в руины [${entry}]. Координаты недействительны.`,
         constructionAborted: virus => `Сборка прервана. Обнаружен логический вирус или превышение времени соединения: ${virus}`,
+        deployRelayServer: (count, port) => `Обнаружено ${count} тактических страниц. Развёртывание полевого узла на порту ${port}...`,
         partialConstructionAborted: virus => `[Предупреждение] Ошибка фрагментарной сборки. Обнаружено логическое вмешательство: ${virus}`,
+        swarmVictory: count => `Боевой доклад: Операция роя дронов успешна! ${count} чертежей сброшено в отсек mission. Слава Человечеству!`,
         intercept: fileName => `Модуль [${fileName}] уже существует в базе данных Bunker. Протокол сборки остановлен во избежание перезаписи`,
         visualCaptured: fileName => `Визуальное сканирование завершено: [${fileName}]. Развёртывание ресурсов Bunker и запуск физической сборки...`,
         assemblyComplete: (fileName, time) => `Протокол сборки завершён. Модуль [${fileName}] успешно установлен. Время: ${time}s, Синхронизация конфигурации маршрутов Menu с Bunker...`,

package/src/dialogues/ZH-CN.js

@@ -13,12 +13,19 @@ module.exports = {
         visualPartCaptured: `侦测到局部视觉样本。正在执行“碎片构筑协议”...`,
         partialConstruction: time => `报告：局部构筑达成。耗时: ${time}s`,
         partialRecommendation: '│ 建议：请手动将上述代码块物理装配至您的目标文件中',
+        noAvailablePages: `报告：废墟内部未探查到可用的 HTML 构造体，扫描任务中止。`,
         scoutReady: '【右键快照模式就绪】在浏览器页面任意位置点击【鼠标右键】即可秒截屏',
         constructionAborted: virus => `构筑中断。检测到逻辑病毒或连接超时：${virus}`,
         capturedPage: pageName => `捕获页面【${pageName}】-> 已投递至 mission 目录`,
+        swarmScanning: entry => `探测到本地原型遗迹 [${entry}]。无人机蜂群测绘协议已激活。`,
+        captureFailed: (name, virus) => `警告：机体测绘 [${name}] 发生逻辑溢出：${virus}`,
+        relicAccessFailed: entry => `警告：目标废墟 [${entry}] 入口识别失败，物理坐标无效。`,
         partialConstructionAborted: virus => `[警告] 碎片构筑失败。系统检测到逻辑干扰：${virus}`,
         visualCaptured: fileName => `视觉传感器捕捉完成: [${fileName}]。正在调配地堡资源进行物理构筑...`,
         intercept: fileName => `模块 [${fileName}] 已存在于地堡数据库中。为了防止数据覆盖，构筑协议已跳过`,
+        swarmVictory: count => `战况汇报：无人机蜂群测绘大捷。已将 ${count} 份作战蓝图空投至 mission 舱！`,
+        captureProgress: (curr, total, name) => `视觉测绘推进中 [${curr}/${total}]：已锁定 ${name}.png`,
+        deployRelayServer: (count, port) => `探测到 ${count} 个战术页面，正在部署 ${port} 临时数据中继站...`,
         assemblyComplete: (fileName, time) => `构筑协议执行完毕。模块 [${fileName}] 物理装配达成。耗时: ${time}s，开始同步 Menu 路由配置...`,
     },
     pod153: {

package/src/headquarters/commander.js

@@ -18,27 +18,29 @@ module.exports = bunker => {
 
     return {
         receive: async mission => {
-            let unit
-            let spinner
-            try {
-                if (acp.logistics.supporter.getConfig().useDemo) {
-                    unit = units.find(unit => unit.meta.name === 'striker')
-                } else {
-                    spinner = acp.yorha.commander.start(acp.dialog.bunker.detectedEnemy)
-                    const result = await acp.llm.recognizePage({ filePath: mission.input, prompt: acp.constitution.commander(units) })
-                    acp.yorha.commander.success(spinner, acp.dialog.bunker.confirmEnemy)
-                    unit = units.map(unit => ({ unit, score: unit.meta.capabilities.filter(cap => result.capabilities.includes(cap)).length }))
-                        .filter(item => item.score > 0)
-                        .sort((a, b) => b.score - a.score)[0]?.unit
+            dispatcher.add(async () => {
+                let unit
+                let spinner
+                try {
+                    if (acp.logistics.supporter.getConfig().useDemo) {
+                        unit = units.find(unit => unit.meta.name === 'striker')
+                    } else {
+                        spinner = acp.yorha.commander.start(acp.dialog.bunker.detectedEnemy)
+                        const result = await acp.llm.recognizePage({ filePath: mission.input, prompt: acp.constitution.commander(units) })
+                        acp.yorha.commander.success(spinner, acp.dialog.bunker.confirmEnemy)
+                        unit = units.map(unit => ({ unit, score: unit.meta.capabilities.filter(cap => result.capabilities.includes(cap)).length }))
+                            .filter(item => item.score > 0)
+                            .sort((a, b) => b.score - a.score)[0]?.unit
+                    }
+                    if (!unit) {
+                        acp.yorha.commander.fail(spinner, acp.dialog.bunker.missionFailed)
+                        return
+                    }
+                    await unit.execute({ acp, mission })
+                } catch (error) {
+                    acp.yorha.commander.fail(spinner, acp.dialog.bunker.missionUnknown)
                 }
-                if (!unit) {
-                    acp.yorha.commander.fail(spinner, acp.dialog.bunker.missionFailed)
-                    return
-                }
-                dispatcher.add(() => unit.execute({ acp, mission }))
-            } catch (error) {
-                acp.yorha.commander.fail(spinner, acp.dialog.bunker.missionUnknown)
-            }
-        },
+            })
+        }
     }
 }

package/src/labs/council.js

@@ -2,6 +2,7 @@ module.exports = async ({ llm, yorha, dialog, logistics }) => {
 
     const fs = require('fs')
     const path = require('path')
+    const JSON5 = require('json5')
 
     const { apiParser } = llm
     const { pod153, commander } = yorha
@@ -13,7 +14,9 @@ module.exports = async ({ llm, yorha, dialog, logistics }) => {
 
     pod153.report(dialog.pod153.autonomousAddressing, 'magenta')
 
-    const apiData = await fetch(apiDoc).then(res => res.json())
+    const apiResponse = await fetch(apiDoc)
+    const text = await apiResponse.text()
+    const apiData = JSON5.parse(text)
     const refinedApis = Object.entries(apiData.paths).flatMap(([apiUrl, methods]) => {
         return Object.entries(methods).map(([method, info]) => ({
             path: apiUrl,

package/src/labs/scout.js

@@ -4,8 +4,10 @@ module.exports = ({ yorha, dialog }) => {
 
     const fs = require('fs')
     const path = require('path')
+    const http = require('http')
 
     const { pod042 } = yorha
+    const relayServerPort = 15342
 
     const isHttpURL = str => {
         try {
@@ -25,70 +27,113 @@ module.exports = ({ yorha, dialog }) => {
         return parts.at(-1) ?? 'capturedPage'
     }
 
-    return {
-        archeology: async targetUrl => {
-
-            if (!isHttpURL(targetUrl)) {
-                return
+    const scanHtmlFiles = (dir, rootDir = dir) => {
+        let results = []
+        const list = fs.readdirSync(dir)
+        for (const file of list) {
+            const fullPath = path.join(dir, file)
+            const stat = fs.statSync(fullPath)
+            if (stat.isDirectory()) {
+                // 排除常见的非业务页面文件夹
+                if (!['resources', 'plugins', 'images', 'files'].includes(file)) {
+                    results = results.concat(scanHtmlFiles(fullPath, rootDir))
+                }
+            } else if (file.endsWith('.html')) {
+                if (!['start.html', 'reload.html'].includes(file)) {
+                    results.push({
+                        fullPath,
+                        name: path.basename(file, '.html'),
+                        relativeUrl: path.relative(rootDir, fullPath).replace(/\\/g, '/'),
+                    })
+                }
             }
+        }
+        return results
+    }
 
-            pod042.report(dialog.pod042.startScout, 'green')
+    const startStaticServer = staticDir => {
+        const mimeTypes = {
+            '.html': 'text/html',
+            '.js': 'text/javascript',
+            '.css': 'text/css',
+            '.png': 'image/png',
+            '.jpg': 'image/jpeg',
+            '.svg': 'image/svg+xml'
+        }
+        const server = http.createServer((req, res) => {
+            const reqPath = decodeURIComponent(req.url.split('?')[0])
+            const filePath = path.join(staticDir, reqPath === '/' ? 'index.html' : reqPath)
+            if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+                const ext = path.extname(filePath).toLowerCase()
+                res.writeHead(200, { 'Content-Type': mimeTypes[ext] || 'application/octet-stream' })
+                fs.createReadStream(filePath).pipe(res)
+            } else {
+                res.writeHead(404)
+                res.end('Not Found')
+            }
+        })
+        return new Promise(resolve => server.listen(relayServerPort, () => resolve({ server })))
+    }
 
+    return {
+        archeology: async targetUrl => {
             const puppeteer = require('puppeteer')
             const missionDir = path.join(process.cwd(), 'bunker', 'mission')
-            const sessionDir = path.join(process.cwd(), 'bunker', '.chrome_session')
 
-            let isBrowserAlive = false
-            if (globalBrowser) {
-                try {
-                    await globalBrowser.pages()
-                    isBrowserAlive = true
-                } catch (e) {
-                    globalBrowser = null
+            if (isHttpURL(targetUrl)) {
+                pod042.report(dialog.pod042.startScout, 'green')
+                const sessionDir = path.join(process.cwd(), 'bunker', '.chrome_session')
+                let isBrowserAlive = false
+                if (globalBrowser) {
+                    try {
+                        await globalBrowser.pages()
+                        isBrowserAlive = true
+                    } catch (e) {
+                        globalBrowser = null
+                    }
                 }
-            }
 
-            if (!isBrowserAlive) {
+                if (!isBrowserAlive) {
 
-                ['SingletonLock', 'SingletonSocket', 'SingletonCookie'].forEach(file => {
-                    try { fs.unlinkSync(path.join(sessionDir, file)) } catch (e) { }
-                })
+                    ['SingletonLock', 'SingletonSocket', 'SingletonCookie'].forEach(file => {
+                        try { fs.unlinkSync(path.join(sessionDir, file)) } catch (e) { }
+                    })
 
-                globalBrowser = await puppeteer.launch({
-                    headless: false,
-                    handleSIGINT: false,
-                    defaultViewport: null,
-                    userDataDir: sessionDir,
-                    args: ['--start-maximized']
-                })
-            }
+                    globalBrowser = await puppeteer.launch({
+                        headless: false,
+                        handleSIGINT: false,
+                        defaultViewport: null,
+                        userDataDir: sessionDir,
+                        args: ['--start-maximized']
+                    })
+                }
 
-            const pages = await globalBrowser.pages()
-            const page = pages.length > 0 ? pages[0] : await globalBrowser.newPage()
+                const pages = await globalBrowser.pages()
+                const page = pages.length > 0 ? pages[0] : await globalBrowser.newPage()
 
-            try {
+                try {
 
-                const browserDialog = { capturedToast: dialog.pod042.capturedToast }
+                    const browserDialog = { capturedToast: dialog.pod042.capturedToast }
 
-                await page.exposeFunction('nodeTakeScreenshot', async () => {
-                    const currentUrl = await page.url()
-                    const pageName = derivePageNameFromUrl(currentUrl)
-                    const savePath = path.join(missionDir, `${pageName}.png`)
-                    await page.screenshot({ path: savePath, fullPage: true })
-                    pod042.report(dialog.pod042.capturedPage(pageName), 'green')
-                })
+                    await page.exposeFunction('nodeTakeScreenshot', async () => {
+                        const currentUrl = await page.url()
+                        const pageName = derivePageNameFromUrl(currentUrl)
+                        const savePath = path.join(missionDir, `${pageName}.png`)
+                        await page.screenshot({ path: savePath, fullPage: true })
+                        pod042.report(dialog.pod042.capturedPage(pageName), 'green')
+                    })
 
-                await page.evaluateOnNewDocument(({ capturedToast }) => {
-                    if (window.__hasBunkerListener__) return
-                    window.__hasBunkerListener__ = true
-                    window.addEventListener('contextmenu', (e) => {
-                        e.preventDefault()
-                        if (window.nodeTakeScreenshot) {
-                            window.nodeTakeScreenshot()
-                        }
-                        const toast = document.createElement('div')
-                        toast.innerText = capturedToast
-                        toast.style.cssText = `
+                    await page.evaluateOnNewDocument(({ capturedToast }) => {
+                        if (window.__hasBunkerListener__) return
+                        window.__hasBunkerListener__ = true
+                        window.addEventListener('contextmenu', (e) => {
+                            e.preventDefault()
+                            if (window.nodeTakeScreenshot) {
+                                window.nodeTakeScreenshot()
+                            }
+                            const toast = document.createElement('div')
+                            toast.innerText = capturedToast
+                            toast.style.cssText = `
                             position: fixed; top: 20px; right: 20px; z-index: 999999;
                             background: rgba(0, 0, 0, 0.85); color: #00ffcc;
                             border: 1px solid #00ffcc; padding: 12px 24px;
@@ -96,18 +141,85 @@ module.exports = ({ yorha, dialog }) => {
                             box-shadow: 0 0 15px rgba(0, 255, 204, 0.5);
                             pointer-events: none; transition: opacity 0.4s ease;
                         `
-                        document.body.appendChild(toast)
-                        setTimeout(() => {
-                            toast.style.opacity = '0'
-                            setTimeout(() => toast.remove(), 400)
-                        }, 1200)
-                    })
-                }, browserDialog)
-            } catch (error) { }
+                            document.body.appendChild(toast)
+                            setTimeout(() => {
+                                toast.style.opacity = '0'
+                                setTimeout(() => toast.remove(), 400)
+                            }, 1200)
+                        })
+                    }, browserDialog)
+                } catch (error) { }
+
+                await page.goto(targetUrl)
+                pod042.report(dialog.pod042.scoutReady, 'green')
+                return globalBrowser
+            }
 
-            await page.goto(targetUrl)
-            pod042.report(dialog.pod042.scoutReady, 'green')
-            return globalBrowser
+            const localDir = path.resolve(targetUrl)
+            if (!fs.existsSync(localDir) || !fs.statSync(localDir).isDirectory()) {
+                pod042.report(dialog.pod042.relicAccessFailed(localDir), 'red')
+                return
+            }
+            pod042.report(dialog.pod042.swarmScanning(localDir), 'green')
+            const htmlPages = scanHtmlFiles(localDir)
+            if (!htmlPages.length) {
+                pod042.report(dialog.pod042.noAvailablePages, 'yellow')
+                return
+            }
+            pod042.report(dialog.pod042.deployRelayServer(htmlPages.length, relayServerPort), 'cyan')
+            const { server } = await startStaticServer(localDir)
+            let browser
+            try {
+                // 💡 锁死标准宽屏分辨率，防止变形折叠
+                browser = await puppeteer.launch({
+                    headless: 'new',
+                    defaultViewport: { width: 1440, height: 900 }
+                })
+                const page = await browser.newPage()
+                let capturedCount = 0
+
+                for (const item of htmlPages) {
+                    try {
+                        await page.setViewport({ width: 1440, height: 900 })
+                        const pageUrl = `http://localhost:${relayServerPort}/${encodeURI(item.relativeUrl)}`
+                        await page.goto(pageUrl, { waitUntil: 'networkidle0', timeout: 15000 })
+                        // 稍作等待，确保渲染完毕
+                        await new Promise(r => setTimeout(r, 600))
+                        const contentWidth = await page.evaluate(() => {
+                            let maxW = 1440
+                            document.querySelectorAll('*').forEach(el => {
+                                const style = window.getComputedStyle(el)
+                                if (['auto', 'scroll'].includes(style.overflowX) || el.scrollWidth > el.clientWidth) {
+                                    el.style.overflowX = 'visible'
+                                    el.style.width = 'max-content' // 强行把宽度撑到真实列宽！
+                                }
+                                // 记录全页面最宽的物理尺寸
+                                if (el.scrollWidth > maxW) {
+                                    maxW = el.scrollWidth
+                                }
+                            })
+                            return maxW
+                        })
+                        await page.setViewport({
+                            width: Math.min(contentWidth + 80, 3840),
+                            height: 900
+                        })
+                        // 稍等 200ms 让重绘完成
+                        await new Promise(r => setTimeout(r, 200))
+                        const savePath = path.join(missionDir, `${item.name}.png`)
+                        await page.screenshot({ path: savePath, fullPage: true })
+                        capturedCount++
+                        pod042.report(dialog.pod042.captureProgress(capturedCount, htmlPages.length, item.name), 'green')
+                    } catch (err) {
+                        pod042.report(dialog.pod042.captureFailed(item.name, err.message), 'yellow')
+                    }
+                }
+                pod042.report(dialog.pod042.swarmVictory(capturedCount), 'magenta')
+            } finally {
+                // 💡 绝对保证释放资源，绝不霸占 15342 端口
+                await browser?.close()
+                server?.close()
+            }
         }
     }
 }

package/src/workshop/react/blueprint/molds/handleBlock.hbs

@@ -82,6 +82,7 @@ const modalSubmit = async params => {
     const response = await requestMap[modal.type]?.()
     if({{{responseSuccess}}}){
         setModal({ visible: false })
+        fetching = false
         refresh()
     }
 }

package/src/workshop/react/kit/utils.js

@@ -135,7 +135,7 @@ export const exportDataToExcel = async ({ url, options, columns, fileName, forma
  * @param {Object} [params.headers] - 自定义请求头
  * @param {string} [fileName='下载'] - 预设文件名（支持从 Content-Disposition 自动对齐）
  */
-export const streamDownload = async ({ url, options, headers = {} }, fileName = '下载') => {
+export const streamDownload = async ({ url, options, headers = { 'Content-Type': 'application/json' } }, fileName = '下载') => {
 
     const response = await fetch(url, { ...options, headers })