@yorha2b-lab/autodev 7.7.7 → 7.8.0

package/bin/bunker.js

@@ -76,7 +76,9 @@ program
             currentBunker.yorha.commander.report(dialog.bunker.systemOffline, 'gray')
             terminalCollapse(500, dialog, currentBunker)
             const scout = await currentBunker.labs?.scout
+            const inspector = await currentBunker.labs?.inspector
             scout?.close()
+            inspector?.close()
         })
     })
 

package/config.js

@@ -20,6 +20,8 @@ module.exports = {
     utilsDir: 'src/utils',
     componentsDir: 'src/components',
 
+    // 指向公司的 PRD 文档 地址
+    prdDoc: '',
     // 指向公司的 Swagger JSON 地址
     apiDoc: '',
     //老项目url

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yorha2b-lab/autodev",
-  "version": "7.7.7",
+  "version": "7.8.0",
   "description": "基于 AI 视觉与语义协议的前端 (React+Antd) 代码构筑与旧系统重构引擎",
   "bin": {
     "bunker": "bin/bunker.js"

package/src/constitution/inspector.js

@@ -0,0 +1,20 @@
+module.exports = ({ prdText, moduleName, moduleCodeView }) => `
+# Task: Fast PRD vs Code Logic Gap Analysis
+
+## 1. 需求要点 (PRD 核心业务规则)
+${prdText}
+
+## 2. 代码逻辑骨架 (${moduleName} 脱水源码)
+${moduleCodeView}
+
+## 3. 极速审计准则
+1. 从需求中仅聚焦提取：【条件分支】、【联动】、【条件禁用/必填】、【二次确认/弹窗】、【特殊数值/边界限制】。
+2. ⚠️【禁止废话】：已实现的功能只用一行短语概括；未实现的问题只挑最致命的缺口
+
+## 4. 输出紧凑 JSON:
+{
+  "unimplementedGaps": [
+    { "feature": "状态为草稿时禁止提交", "detail": "代码中未见提交按钮的 disabled 判定" }
+  ]
+}
+`.trim()

package/src/constitution/system.js

@@ -1,9 +1,3 @@
-const commonPrompt = '你必须严格按照用户的JSON结构输出,严禁输出任何思考过程（</think>内容）,严禁解释、输出Markdown标签。必须输出合法的、带双引号的标准JSON。'
+const FRONTEND_ENGINEER = '你是一个资深的前端工程师,有着数十年的前端软件开发经验;你必须严格按照用户的JSON结构输出,严禁输出任何思考过程（</think>内容）,严禁解释、输出Markdown标签。必须输出合法的、带双引号的标准JSON。'
 
-const UI_DESIGNER = `你是一个专业的UI设计师。${commonPrompt}`
-
-const MOCK_DESIGNER = `你是一个专业的Mock数据生成器。${commonPrompt}`
-
-const API_DESIGNER = `你是一个资深前端与后端接口对接专家。${commonPrompt}`
-
-module.exports = { UI_DESIGNER, API_DESIGNER, MOCK_DESIGNER }
+module.exports = { FRONTEND_ENGINEER }

package/src/dialogues/EN-US.js

@@ -29,13 +29,21 @@ module.exports = {
         assemblyComplete: (fileName, time) => `Protocol complete. Physical assembly of [${fileName}] achieved. Elapsed: ${time}s, Syncing Menu configuration to Bunker...`,
     },
     pod153: {
+        prdAuditFinish: 'PRD audit complete',
         signalLinkFault: virus => `Signal Link Fault: ${virus}`,
+        inspectorException: virus => `Audit pipeline anomaly: ${virus}`,
+        inspectorStart: 'Initializing [Tactical Requirements Inspector]...',
+        noCodeFile: fileName => `No valid code files detected in module directory [${fileName}]`,
         alignmentFailed: virus => `Alignment failed. Encountered powerful API firewall: ${virus}`,
+        inspectorToast: 'Requirements transmitted to Bunker. Terminal verification in progress...',
         signalSynchronized: (count, module) => `[${module}] Signal Synchronized: ${count} nodes energized`,
         autonomousAddressing: `Initiating 'Full-Channel Autonomous Addressing Protocol [Semantic Scan]'...`,
         inactiveModule: fileName => `Inactive module: [${fileName}]. Requesting 9S for precise alignment...`,
+        inspectorReady: 'Inspector browser ready! Please [select text] on the PRD page and [right-click] to inspect!',
         reconEncryptedData: fileName => `Encrypted data source [${fileName}] detected. Initiating semantic alignment...`,
+        comparingCodePrd: moduleName => `Cross-verifying [${moduleName}] source code against implicit PRD interactions...`,
         capturedRuntimeSignal: fileName => `Captured runtime signal [${fileName}]. Executing semantic alignment protocol...`,
+        loadedFiles: (moduleName, count) => `Loaded ${count} source files from [${moduleName}]. Executing logic reconciliation...`,
         unknownModule: fileName => `Module [${fileName}] resource not found in Bunker database. Please execute visual construction first`,
         bridgeProtocolComplete: (count, time) => `Semantic bridge protocol complete. Corrected ${count} field deviations. Elapsed: ${time}s`,
     },

package/src/dialogues/FR-FR.js

@@ -29,11 +29,19 @@ module.exports = {
         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...`,
     },
     pod153: {
+        prdAuditFinish: 'Audit du PRD terminé',
         signalLinkFault: virus => `Erreur de liaison du signal : ${virus}`,
+        inspectorStart: 'Initialisation de l’[Inspecteur Tactique des Exigences] (Inspector)...',
+        inspectorException: virus => `Anomalie dans la séquence d'audit (Virus logique) : ${virus}`,
+        inspectorToast: 'Spécifications transmises au Bunker. Comparaison en cours sur le terminal...',
+        noCodeFile: fileName => `Aucun fichier source viable détecté dans le répertoire du module [${fileName}]`,
         signalSynchronized: (count, module) => `[${module}] ${count} nœuds synchronisés. Alimentation confirmée`,
         inactiveModule: fileName => `Module non activé détecté [${fileName}]. Analyse haute précision demandée à 9S`,
+        inspectorReady: 'Navigateur de l’Inspecteur prêt ! Sélectionnez du texte sur le PRD puis effectuez un [clic droit] !',
         autonomousAddressing: 'Activation du « protocole d’adressage automatique multi-canaux [version analyse sémantique] »...',
+        comparingCodePrd: moduleName => `Vérification croisée du code de [${moduleName}] avec les interactions implicites du PRD...`,
         alignmentFailed: virus => `Échec de synchronisation du signal. Les données API sont bloquées par un pare-feu puissant : ${virus}`,
+        loadedFiles: (moduleName, count) => `${count} fichiers sources chargés depuis [${moduleName}]. Lancement du rapprochement logique...`,
         capturedRuntimeSignal: fileName => `Signal d’exécution intercepté [${fileName}]. Activation du protocole d’alignement automatique...`,
         reconEncryptedData: fileName => `Source de données chiffrées détectée [${fileName}]. Tentative du protocole d’alignement sémantique...`,
         bridgeProtocolComplete: (count, time) => `Protocole de pont sémantique terminé. ${count} différences de champs corrigées. Durée : ${time}s`,

package/src/dialogues/JA-JP.js

@@ -29,13 +29,21 @@ module.exports = {
         assemblyComplete: (fileName, time) => `構築プロトコル完了。モジュール [${fileName}] の実装を確認。処理時間: ${time}s, BunkerへMenuルーティング設定を同期中...`,
     },
     pod153: {
+        prdAuditFinish: 'PRD監査完了',
         signalLinkFault: virus => `シグナルリンク障害: ${virus}`,
+        inspectorStart: '【戦術要求査察官】(Inspector) を起動中...',
+        inspectorException: virus => `監査パイプラインに論理ウイルスを検出: ${virus}`,
+        inspectorToast: '要求仕様データをBunkerへ転送。端末側で照合プロトコルを実行中...',
+        noCodeFile: fileName => `モジュール [${fileName}] 配下に有効なソースコードが検出されず`,
         autonomousAddressing: '「全チャンネル自動アドレス指定プロトコル [セマンティック解析版]」を起動...',
+        inspectorReady: '査察官ブラウザ待機完了。PRD上で【テキストを選択】し【右クリック】を実行してください！',
+        comparingCodePrd: moduleName => `[${moduleName}] のソースコードとPRDの暗黙的相互作用を照合中...`,
         signalSynchronized: (count, module) => `[${module}] ${count}個のノード同期完了。電力供給を確認`,
         inactiveModule: fileName => `未通電モジュール [${fileName}] を検出。9Sによる高精度照合を要求します`,
         capturedRuntimeSignal: fileName => `ランタイムシグナル [${fileName}] を捕捉。自動同期プロトコルを開始`,
         alignmentFailed: virus => `シグナル同期失敗。APIデータが強力なファイアウォールに阻害されています：${virus}`,
         reconEncryptedData: fileName => `暗号化データソース [${fileName}] を検出。セマンティック同期プロトコルを試行`,
+        loadedFiles: (moduleName, count) => `[${moduleName}] より ${count} 件のコードファイルを装填。論理照合を開始...`,
         unknownModule: fileName => `Bunkerデータベース内に [${fileName}] のリソース情報なし。先に視覚構築を実行してください`,
         bridgeProtocolComplete: (count, time) => `セマンティックブリッジ完了。${count}箇所のフィールド差異を修正。処理時間: ${time}s`,
     },

package/src/dialogues/RU-RU.js

@@ -29,9 +29,17 @@ module.exports = {
         assemblyComplete: (fileName, time) => `Протокол сборки завершён. Модуль [${fileName}] успешно установлен. Время: ${time}s, Синхронизация конфигурации маршрутов Menu с Bunker...`,
     },
     pod153: {
+        prdAuditFinish: 'Аудит PRD завершён',
         signalLinkFault: virus => `Ошибка сигнального соединения: ${virus}`,
+        inspectorStart: 'Активация [Тактического инспектора требований] (Inspector)...',
+        inspectorToast: 'Разведданные требований переданы в Bunker. Сверка на терминале...',
+        inspectorException: virus => `Аномалия конвейера аудита (Логический вирус): ${virus}`,
+        noCodeFile: fileName => `В каталоге модуля [${fileName}] не обнаружено исходных файлов кода`,
         inactiveModule: fileName => `Обнаружен неактивный модуль [${fileName}]. Запрошен высокоточный анализ 9S`,
+        comparingCodePrd: moduleName => `Сверка исходного кода [${moduleName}] с неявными взаимодействиями PRD...`,
         autonomousAddressing: 'Запуск «протокола автоматической адресации всех каналов [семантическая версия]»...',
+        inspectorReady: 'Браузер инспектора готов! Выделите текст на странице PRD и нажмите [правой кнопкой мыши]!',
+        loadedFiles: (moduleName, count) => `Загружено ${count} файлов из [${moduleName}]. Запуск логической сверки...`,
         alignmentFailed: virus => `Ошибка выравнивания сигнала. Данные API заблокированы мощным брандмауэром: ${virus}`,
         signalSynchronized: (count, module) => `[${module}] Синхронизация ${count} узлов завершена. Питание подтверждено`,
         unknownModule: fileName => `Ресурс модуля [${fileName}] не найден в базе Bunker. Сначала выполните визуальную сборку`,

package/src/dialogues/ZH-CN.js

@@ -29,14 +29,22 @@ module.exports = {
         assemblyComplete: (fileName, time) => `构筑协议执行完毕。模块 [${fileName}] 物理装配达成。耗时: ${time}s，开始同步 Menu 路由配置...`,
     },
     pod153: {
+        prdAuditFinish: 'PRD审计完成',
+        inspectorToast: '需求已回传地堡，终端正在执行比对...',
         signalLinkFault: virus => `信号链路故障: ${virus}`,
+        inspectorStart: '启动【战术需求监察官】(Inspector)...',
+        inspectorException: virus => `审计流水线异常: ${virus}`,
         autonomousAddressing: `启动‘全频道自动寻址协议 [语义扫描版]’...`,
+        noCodeFile: fileName => `模块 [${fileName}] 目录下未检索到任何代码文件`,
         alignmentFailed: virus => `信号对齐失败。接口数据遭遇强力防火墙：${virus}`,
+        comparingCodePrd: moduleName => `正在比对 [${moduleName}] 源码与 PRD 隐性交互...`,
+        inspectorReady: '监察官浏览器已就绪！请在 PRD 页面中【鼠标划选需求文字】后【点击右键】！',
         inactiveModule: fileName => `发现未通电模块 [${fileName}]，请求 9S 执行高精度对账...`,
         capturedRuntimeSignal: fileName => `截获运行时信号 [${fileName}]。执行自动对齐协议...`,
         signalSynchronized: (count, module) => `[${module}] 信号同步完成，${count} 个节点已通电`,
         reconEncryptedData: fileName => `发现加密数据源 [${fileName}]。正在尝试执行语义对齐协议...`,
         unknownModule: fileName => `地堡数据库中未检索到模块 [${fileName}] 的资源文件。请先执行视觉构筑`,
+        loadedFiles: (moduleName, count) => `已装载 [${moduleName}] 目录下 ${count} 个源码文件，开始执行逻辑对账...`,
         bridgeProtocolComplete: (count, time) => `语义桥接协议执行完毕。已物理修正 ${count} 处字段偏差。耗时: ${time}s`,
     },
     bunker: {

package/src/gateway/client.js

@@ -6,7 +6,7 @@ module.exports = () => {
 
     const pkgEnv = path.resolve(__dirname, '../../.env')
     const localEnv = path.resolve(process.cwd(), 'bunker', '.env')
-    require('dotenv').config({ path: fs.existsSync(localEnv) ? localEnv : pkgEnv })
+    require('dotenv').config({ quiet: true, path: fs.existsSync(localEnv) ? localEnv : pkgEnv })
     const client = new OpenAI({ apiKey: process.env.API_KEY, baseURL: process.env.BASE_URL })
 
     return client

package/src/gateway/index.js

@@ -3,19 +3,20 @@ module.exports = ({ yorha, dialog, logistics, constitution }) => {
     const sharp = require('sharp')
 
     const { sleep } = logistics.presenter
+    const { FRONTEND_ENGINEER } = constitution.system
     const { textModel, visionModel } = logistics.supporter.getConfig()
-    const { council, similarity, reconciler, simulation } = constitution
-    const { UI_DESIGNER, API_DESIGNER, MOCK_DESIGNER } = constitution.system
+    const { council, inspector, similarity, reconciler, simulation } = constitution
 
     const openAI = require('./client')()
     const askAI = require('./protocol')({ yorha, sleep, dialog, openAI })
 
     return {
+        askAI,
         generateMock: async ({ columns, fileName }) => {
             return askAI({
                 model: textModel,
                 messages: [
-                    { role: 'system', content: MOCK_DESIGNER },
+                    { role: 'system', content: FRONTEND_ENGINEER },
                     { role: 'user', content: simulation({ columns, fileName }) }
                 ]
             })
@@ -24,7 +25,7 @@ module.exports = ({ yorha, dialog, logistics, constitution }) => {
             return askAI({
                 model: textModel,
                 messages: [
-                    { role: 'system', content: UI_DESIGNER },
+                    { role: 'system', content: FRONTEND_ENGINEER },
                     { role: 'user', content: similarity({ fileName, english }) }
                 ]
             })
@@ -33,7 +34,7 @@ module.exports = ({ yorha, dialog, logistics, constitution }) => {
             return askAI({
                 model: textModel,
                 messages: [
-                    { role: 'system', content: API_DESIGNER },
+                    { role: 'system', content: FRONTEND_ENGINEER },
                     { role: 'user', content: council({ bunkerAnchors, realApis }) }
                 ]
             })
@@ -48,7 +49,7 @@ module.exports = ({ yorha, dialog, logistics, constitution }) => {
             return askAI({
                 model: visionModel,
                 messages: [
-                    { role: 'system', content: UI_DESIGNER },
+                    { role: 'system', content: FRONTEND_ENGINEER },
                     {
                         role: 'user',
                         content: [
@@ -64,10 +65,19 @@ module.exports = ({ yorha, dialog, logistics, constitution }) => {
             return askAI({
                 model: textModel,
                 messages: [
-                    { role: 'system', content: API_DESIGNER },
+                    { role: 'system', content: FRONTEND_ENGINEER },
                     { role: 'user', content: reconciler({ responseStr, resourceStr }) }
                 ]
             })
         },
+        prdInspector: async ({ prdText, moduleName, moduleCodeView }) => {
+            return askAI({
+                model: textModel,
+                messages: [
+                    { role: 'system', content: FRONTEND_ENGINEER },
+                    { role: 'user', content: inspector({ prdText, moduleName, moduleCodeView }) }
+                ]
+            })
+        },
     }
 }

package/src/labs/index.js

@@ -2,7 +2,7 @@ module.exports = accessPoint => {
 
     const labs = {}
 
-    const { apiDoc, remains, needMock, proxyTarget, enableAutoAlignment } = accessPoint.logistics.supporter.getConfig()
+    const { prdDoc, apiDoc, remains, needMock, proxyTarget, enableAutoAlignment } = accessPoint.logistics.supporter.getConfig()
 
     if (!needMock && proxyTarget && enableAutoAlignment) {
         labs.tower = require('../labs/tower')(accessPoint)
@@ -16,5 +16,9 @@ module.exports = accessPoint => {
         labs.scout = require('../labs/scout')(accessPoint).archeology(remains)
     }
 
+    if (prdDoc) {
+        labs.inspector = require('../labs/inspector')(accessPoint).audit(prdDoc)
+    }
+
     return labs
 }

package/src/labs/inspector.js

@@ -0,0 +1,183 @@
+const fs = require('fs')
+const path = require('path')
+const chalk = require('chalk')
+
+module.exports = ({ llm, yorha, dialog, logistics }) => {
+
+    const { pod153 } = yorha
+    const { prdInspector } = llm
+    const { pagesDir } = logistics.supporter.getConfig()
+    const { dehydratePrd, dehydrateCode } = logistics.formatter
+    const sessionDir = path.join(process.cwd(), 'bunker', '.chrome_session')
+
+    const isHttpURL = str => {
+        try {
+            const url = new URL(str)
+            return ['http:', 'https:'].includes(url.protocol)
+        } catch {
+            return false
+        }
+    }
+
+    const readModuleFiles = (dir, rootDir = dir) => {
+        let files = []
+        const list = fs.readdirSync(dir, { withFileTypes: true })
+        for (const item of list) {
+            const fullPath = path.join(dir, item.name)
+            if (item.isDirectory()) {
+                if (!['node_modules', '.git', '__tests__'].includes(item.name)) {
+                    files = files.concat(readModuleFiles(fullPath, rootDir))
+                }
+            } else if (/\.(jsx?|tsx?|json)$/i.test(item.name)) {
+                files.push({
+                    relativeName: path.relative(rootDir, fullPath).replace(/\\/g, '/'),
+                    content: fs.readFileSync(fullPath, 'utf-8')
+                })
+            }
+        }
+        return files
+    }
+
+    return {
+        audit: async prdDoc => {
+
+            if (!isHttpURL(prdDoc)) return
+
+            const puppeteer = require('puppeteer')
+            pod153.report(dialog.pod153.inspectorStart, 'magenta')
+            const browser = await puppeteer.launch({
+                headless: false,
+                handleSIGINT: false,
+                defaultViewport: null,
+                userDataDir: sessionDir,
+                args: ['--start-maximized']
+            })
+
+            const pages = await browser.pages()
+            const page = pages.length > 0 ? pages[0] : await browser.newPage()
+
+            await page.exposeFunction('nodeAuditRequirement', async ({ prdText, moduleName }) => {
+                if (!prdText || !moduleName) return
+                const pageDir = path.join(process.cwd(), pagesDir, moduleName)
+                const sourceFiles = readModuleFiles(pageDir)
+                if (sourceFiles.length === 0) {
+                    pod153.report(dialog.pod153.noCodeFile(moduleName), 'red')
+                    return
+                }
+                const moduleCodeView = sourceFiles.map(file => `### 📄 文件:${file.relativeName}\njavascript:\n${dehydrateCode(file.content)}`).join('\n\n')
+                pod153.report(dialog.pod153.loadedFiles(moduleName, sourceFiles.length), 'yellow')
+                const startTime = Date.now()
+                const spinner = pod153.start(dialog.pod153.comparingCodePrd(moduleName), 'yellow')
+                try {
+                    const cleanPrdText = dehydratePrd(prdText)
+                    const result = await prdInspector({ prdText: cleanPrdText, moduleName, moduleCodeView })
+                    const endTime = Date.now()
+                    pod153.success(spinner, dialog.pod153.prdAuditFinish)
+                    const duration = ((endTime - startTime) / 1000).toFixed(2)
+                    const gaps = result.unimplementedGaps || []
+                    const hasGaps = gaps.length > 0
+                    const divider = '─'.repeat(48)
+                    console.log('\n' + chalk.magenta(`╭── 🛰️  [YoRHa TACTICAL INSPECTION PROTOCOL] ──────────────────────────────────────────`))
+                    console.log(chalk.magenta(`│ `))
+                    const metaPills = [
+                        chalk.bgCyan.black.bold(` MODULE `) + ` ` + chalk.bold.white(moduleName),
+                        chalk.bgYellow.black.bold(` DURATION `) + ` ` + chalk.bold.white(`${duration}s`),
+                        chalk.bgMagenta.black.bold(` AUDIT `) + ` ` + chalk.bold.white(`${sourceFiles.length} source files`),
+                    ].join('   ')
+                    console.log(chalk.magenta(`│  `) + metaPills)
+                    console.log(chalk.magenta(`│ `))
+                    if (hasGaps) {
+                        console.log(chalk.magenta(`├── `) + chalk.bold.red(`🚨 TACTICAL DEFECTS`) + chalk.magenta(divider))
+                        console.log(chalk.magenta(`│ `))
+                        gaps.forEach((gap, idx) => {
+                            const num = String(idx + 1).padStart(2, '0')
+                            console.log(chalk.magenta(`│  `) + chalk.bold.bgRed.white(` GAP #${num} `) + `  ` + chalk.bold.red(gap.feature))
+                            if (gap.detail) {
+                                console.log(chalk.magenta(`│`) + chalk.gray(`     ├─ `) + chalk.yellow(`🔍 `) + chalk.white(gap.feature))
+                                console.log(chalk.magenta(`│`) + chalk.gray(`     └─ `) + chalk.red(`⚠️ `) + chalk.yellow(gap.detail))
+                            }
+                            console.log(chalk.magenta(`│ `))
+                        })
+                    }
+                    console.log(chalk.magenta(`╰─────────────────────────────── [ Pod 153 Verification Seal ] ────────────────────────\n`))
+                } catch (e) {
+                    pod153.report(dialog.pod153.inspectorException(e.message), 'red')
+                }
+            })
+            const browserDialog = { inspectorToast: dialog.pod153.inspectorToast }
+            await page.evaluateOnNewDocument(({ inspectorToast }) => {
+
+                const showBunkerInput = () => new Promise(resolve => {
+                    const overlay = document.createElement('div')
+                    overlay.style.cssText = `
+            position: fixed; top: 0; left: 0; width: 100vw; height: 100vh;
+            background: rgba(0, 0, 0, 0.65); z-index: 9999999;
+            display: flex; align-items: center; justify-content: center;
+            backdrop-filter: blur(3px);
+        `
+                    overlay.innerHTML = `
+            <div style="background: #111; border: 2px solid #00ffcc; padding: 24px; border-radius: 6px; box-shadow: 0 0 25px rgba(0,255,204,0.4); font-family: monospace; color: #00ffcc; min-width: 380px;">
+                <div style="font-weight: bold; margin-bottom: 8px; font-size: 15px;">⚡ [YoRHa 战术监察官] 需求情报已捕获</div>
+                <div style="font-size: 12px; color: #888; margin-bottom: 14px;">请输入要对比的前端模块名 (如: ContractList):</div>
+                <input id="bunker-input" placeholder="输入模块名后回车..." style="width: 100%; box-sizing: border-box; background: #222; border: 1px solid #00ffcc; color: #fff; padding: 10px 12px; font-size: 14px; font-family: monospace; outline: none; border-radius: 4px;" />
+                <div style="display: flex; justify-content: flex-end; gap: 8px; margin-top: 14px;">
+                    <span style="font-size: 11px; color: #666; margin-right: auto; line-height: 24px;">[ESC 取消 / Enter 确认]</span>
+                </div>
+            </div>
+        `
+                    document.body.appendChild(overlay)
+                    const input = overlay.querySelector('#bunker-input')
+                    setTimeout(() => input.focus(), 50)
+                    input.addEventListener('keydown', e => {
+                        if (e.key === 'Enter' && input.value.trim()) {
+                            const val = input.value.trim()
+                            overlay.remove()
+                            resolve(val)
+                        }
+                        if (e.key === 'Escape') {
+                            overlay.remove()
+                            resolve(null)
+                        }
+                    })
+                    overlay.addEventListener('click', e => {
+                        if (e.target === overlay) {
+                            overlay.remove()
+                            resolve(null)
+                        }
+                    })
+                })
+
+                window.addEventListener('contextmenu', async (e) => {
+                    const selection = window.getSelection().toString().trim()
+                    if (selection && selection.length > 5) {
+                        e.preventDefault()
+                        const moduleName = await showBunkerInput()
+                        if (moduleName) {
+                            window.nodeAuditRequirement({ prdText: selection, moduleName: moduleName.trim() })
+                            const toast = document.createElement('div')
+                            toast.innerText = inspectorToast
+                            toast.style.cssText = `
+                    position: fixed; top: 20px; right: 20px; z-index: 9999999;
+                    background: rgba(0, 0, 0, 0.9); color: #ff00ff;
+                    border: 1px solid #ff00ff; padding: 12px 24px;
+                    font-size: 14px; font-family: monospace; border-radius: 4px;
+                    box-shadow: 0 0 15px rgba(255, 0, 255, 0.5);
+                    pointer-events: none; transition: opacity 0.4s ease;
+                `
+                            document.body.appendChild(toast)
+                            setTimeout(() => {
+                                toast.style.opacity = '0'
+                                setTimeout(() => toast.remove(), 400)
+                            }, 2000)
+                        }
+                    }
+                })
+            }, browserDialog)
+            if (prdDoc) {
+                await page.goto(prdDoc)
+            }
+            pod153.report(dialog.pod153.inspectorReady, 'green')
+            return browser
+        }
+    }
+}

package/src/labs/scout.js

@@ -112,9 +112,7 @@ module.exports = ({ yorha, dialog }) => {
                 const page = pages.length > 0 ? pages[0] : await globalBrowser.newPage()
 
                 try {
-
                     const browserDialog = { capturedToast: dialog.pod042.capturedToast }
-
                     await page.exposeFunction('nodeTakeScreenshot', async () => {
                         const currentUrl = await page.url()
                         const pageName = derivePageNameFromUrl(currentUrl)

package/src/logistics/formatter.js

@@ -17,8 +17,40 @@ const cleanCode = str => str
 
 const contextStringify = ({ context, indent = 4, maxLength = 200 }) => stringify.default(context, { indent, maxLength })
 
+const dehydrateCode = code => code
+    // 1. 物理砍掉所有的 import 依赖声明 (省 20-30 行废话)
+    .replace(/^import\s+.*?;\s*$/gm, '')
+    .replace(/^import\s+[\s\S]*?from\s+['"].*?['"];?\s*$/gm, '')
+    // 2. 物理砍掉所有内联 style 样式 (与业务对账毫无关系)
+    .replace(/style=\{\{[\s\S]*?\}\}/g, '')
+    // 3. 物理砍掉所有 className 和无关的 UI 属性
+    .replace(/className=['"][^'"]*['"]/g, '')
+    // 4. 物理砍掉常见的纯排版外壳标签 (<Row>, <Col>, <Card>, <Space>)，只留内容
+    .replace(/<\/?(Row|Col|Card|Space|Fragment)[^>]*>/g, '')
+    // 5. 压缩多余连续空格和空行
+    .replace(/[ \t]+$/gm, '')
+    .replace(/\n{2,}/g, '\n')
+    .trim()
+
+const dehydratePrd = text => text
+    // 1. 过滤掉从 Wiki 复制时带过来的各种 HTML 隐藏标签和实体
+    .replace(/<[^>]+>/g, '')
+    .replace(/&nbsp;/g, ' ')
+    // 2. 过滤掉公文废话（这些绝对不是业务规则）
+    .replace(/(本功能旨在|为了提升.*?体验|根据.*?业务要求|原则上需由|系统应当支持|请业务方注意).*?[。；\n]/g, '')
+    // 3. 过滤纯 UI 视觉修饰描述（这些由设计稿决定，对账不关心）
+    .replace(/(字体大小为.*?|居中显示|背景色为.*?|间距.*?px|左右对齐).*?[。；\n]/g, '')
+    // 4. 将连续换行折叠为单换行，剔除每一行首尾无意义字符
+    .split('\n')
+    .map(line => line.trim())
+    .filter(line => line.length > 3) // 过滤掉无意义的单字标点行
+    .join('\n')
+    .trim()
+
 module.exports = {
     wrapCode,
     cleanCode,
+    dehydratePrd,
+    dehydrateCode,
     contextStringify,
 }

package/src/workshop/react/builder/index.js

@@ -147,7 +147,7 @@ module.exports = ({ template, logistics, headquarters }) => {
                 hasRowSelection: pageConfig.table.rowSelection,
                 formItems: hasFormItems ? (hasTabs ? 'formItems[activeKey]' : 'formItems') : '[]',
                 operations: pageConfig.table.operation?.sort((a, b) => a.action.length - b.action.length) || [],
-                initParams: `{ ${hasTabs ? 'type: tabs[0].key ,' : ''}${hasPagination ? 'pageNo: 1 , pageSize: 10' : ''}}`,
+                initParams: `{ ${hasTabs ? 'type: activeKey,' : ''}${hasPagination ? 'pageNo: 1 , pageSize: 10' : ''}}`,
                 uri: needMock ? `request('/api/${fileName}', { method: 'POST', body: params })` : 'BUNKER_API_ANCHOR_pages',
             }
 

package/src/workshop/react/extensions/useTableQuery.js

@@ -1,34 +1,5 @@
 import { useRef, useState, useEffect, useCallback } from 'react'
 
-/**
- * @hook useTableQuery
- * @description [地堡核心逻辑引擎] 高级异步数据驱动钩子。
- * 负责全自动管理表格的生命周期，包括数据抓取、状态同步、动态列指纹识别及“竞态病毒”物理免疫。
- *
- * @param {Object} params - 引擎配置包
- * @param {Array} [params.cols] - 初始战备物资：前端预设的静态列配置
- * @param {Function} params.api - 任务指令：必须返回 Promise 的数据抓取函数
- * @param {Object} [params.initialParams={}] - 初始导航坐标：包含 pageNo, pageSize 及默认过滤参数
- * @param {Function} params.formatResponse - 数据解码协议：将 API 原始信号转化为 { data, total, columns } 结构
- *
- * @returns {Object} 物理操作句柄包
- * @returns {number} .total - 仓库物资总量
- * @returns {boolean} .loading - 引擎负载状态
- * @returns {Function} .setSearch - 坐标修改器
- * @returns {Array} .dataSource - 已解压的物理物资列表
- * @returns {Function} .setLoading - 负载状态手动干预句柄
- * @returns {Object} .search - 当前导航参数（pageNo, pageSize 等）
- * @returns {Function} .refresh - 强制重启协议：立即执行一次数据抓取
- * @returns {Array} .columns - 当前生效的动态列配置（已通过指纹协议校验）
- * @returns {Function} .setDataSource - 物资流手动修改句柄（用于行内编辑等乐观更新）
- *
- * @example
- * const { dataSource, loading, refresh } = useTableQuery({
- *   api:async params=>await fetchUsers(params),
- *   initialParams: { pageNo: 1, pageSize: 10 },
- *   formatResponse: (res) => ({ data: res.list, total: res.total })
- * });
- */
 export const useTableQuery = ({ api, cols = [], initialParams = {}, formatResponse, isLocalPaging = false }) => {
 
     const [total, setTotal] = useState(0)
@@ -37,13 +8,9 @@ export const useTableQuery = ({ api, cols = [], initialParams = {}, formatRespon
     const [dataSource, setDataSource] = useState([])
     const [search, setSearch] = useState(initialParams)
 
-    // 💡 引用锁定协议：确保异步回调中永远能指向最新的指令地址
     const apiRef = useRef(api)
-    // 💡 [核心防御] 信号 ID 计数器：用于物理拦截由于网络时延导致的“竞态病毒（Race Condition）”
     const fetchIdRef = useRef(0)
-    // 💡 物理记录仪：记录上一次“真正”的过滤参数（不含分页）
     const lastFilterRef = useRef('')
-    // 💡 [核心防御] 数据解码协议引用：确保异步回调中永远能指向最新的指令地址
     const formatResponseRef = useRef(formatResponse)
 
     useEffect(() => {
@@ -54,21 +21,8 @@ export const useTableQuery = ({ api, cols = [], initialParams = {}, formatRespon
         formatResponseRef.current = formatResponse
     }, [formatResponse])
 
-    /**
-     * @function getColumnSchema
-     * @description [指纹识别协议] 对列配置执行“结构化脱水”。
-     * 通过提取标题、字段和排序状态生成物理指纹，用于判定列结构是否发生“基因变异”。
-     * @param {Array} cols - 待扫描的列配置
-     * @returns {string} 物理指纹字符串
-     */
     const getColumnSchema = cols => cols.map(col => `${col.title}-${col.dataIndex}-${col.sortOrder}`).join('|')
 
-    /**
-     * @async
-     * @function fetchData
-     * @description [数据装配任务] 执行核心的数据抓取与物理封存逻辑。
-     * 具备信号溯源能力，确保只有最后一次发出的指令能修改地堡状态。
-     */
     const fetchData = useCallback(async () => {
         if (!apiRef.current) return
 
@@ -81,16 +35,12 @@ export const useTableQuery = ({ api, cols = [], initialParams = {}, formatRespon
         }
 
         setLoading(true)
-        // 💡 信号加标：为本次请求分配唯一的物理 ID
         const currentFetchId = ++fetchIdRef.current
         try {
             const response = await apiRef.current(search)
-            // 💡 [物理拦截] 信号校准：若当前 ID 不是最新 ID，说明该信号已过期，执行丢弃协议
             if (currentFetchId !== fetchIdRef.current) return
             const { data, total, columns: newCols } = formatResponseRef.current?.(response ?? {}) || {}
-            // 💡 [性能装甲] 只有当列指纹发生变化时，才触发 React 的重绘逻辑
             if (newCols) {
-                // 使用函数式状态更新，既能拿到最新的 prevCols，又无需将 columns 作为 useCallback 的依赖！
                 setColumns(prevCols => {
                     if (getColumnSchema(newCols) !== getColumnSchema(prevCols)) {
                         return newCols
@@ -103,7 +53,6 @@ export const useTableQuery = ({ api, cols = [], initialParams = {}, formatRespon
         } catch (error) {
             console.error('查询失败', error)
         } finally {
-            // 💡 状态闭环：确保只有最新的信号能解除 Loading 锁定
             if (currentFetchId === fetchIdRef.current) {
                 setLoading(false)
             }