@yorha2b-lab/autodev 3.5.3 → 4.0.0

package/CONTRIBUTING.md

@@ -44,6 +44,16 @@
 4. 推送到分支 (`git push origin feature/AmazingFeature`)
 5. 创建一个 Pull Request
 
+### 贡献许可
+
+提交 Pull Request 即表示您确认：您有权提交该贡献，并同意该贡献在合并后按本项目的 [GNU AGPL v3.0](./LICENSE) 许可证进行授权和分发。
+
+贡献者保留其对原创贡献的版权；本条不构成版权转让。
+
+By submitting a Pull Request, you confirm that you have the right to submit the contribution and agree that, once merged, it will be licensed and distributed under this project's [GNU AGPL v3.0](./LICENSE).
+
+Contributors retain copyright in their original contributions; this does not constitute a copyright assignment.
+
 ## 📋 开发指南
 
 ### 环境准备

package/bin/autodev.js

@@ -57,10 +57,13 @@ program
             return
         }
         bootSequence(pkg.version)
-        require('../src/commands/watch.js')()
+        require('../src/commands/watch')()
         const { config } = bunker.get()
+        if (config.apiDoc && config.enableAutoAlignment) {
+            require('../src/services/api-linker')()
+        }
         if (config.proxyTarget && !config.needMock && config.enableAutoAlignment) {
-            require('../src/services/proxy-tower.js')()
+            require('../src/services/proxy-tower')()
         }
         process.on('SIGINT', () => {
             console.log('\n')

package/config.js

@@ -18,7 +18,10 @@ module.exports = {
     utilsDir: 'src/utils',
     componentsDir: 'src/components',
 
+    // 代理目标
+    proxyTarget: 'http://id:port',
     responseSuccess: `response?.code === 200`,
-    proxyTarget: 'http://id:port',// 代理目标，例如 http://localhost:3000
+    // 指向公司的 Swagger JSON 地址
+    apiDoc: 'http://api.company.com/v2/api-docs',
 
 }

package/example/example.json

@@ -72,14 +72,17 @@
         ],
         "operation": [
             {
+                "uri": "BUNKER_API_ANCHOR_viewByRecord",
                 "label": "查看",
                 "action": "viewByRecord"
             },
             {
+                "uri": "BUNKER_API_ANCHOR_editByRecord",
                 "label": "编辑",
                 "action": "editByRecord"
             },
             {
+                "uri": "BUNKER_API_ANCHOR_deleteByRecord",
                 "label": "删除",
                 "action": "deleteByRecord"
             }
@@ -146,7 +149,7 @@
                 },
                 {
                     "label": "魔法",
-                    "value": "magical"
+                    "value": "magic"
                 }
             ]
         }
@@ -159,11 +162,13 @@
     "functionButton": [
         {
             "btn": "批量删除",
+            "uri": "BUNKER_API_ANCHOR_batchDeleteBySelected",
             "action": "batchDeleteBySelected"
         },
         {
             "btn": "批量导出",
-            "action": "batchExportBySelected"
+            "uri": "BUNKER_API_ANCHOR_exportData",
+            "action": "exportData"
         }
     ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yorha2b-lab/autodev",
-  "version": "3.5.3",
+  "version": "4.0.0",
   "description": "基于视觉大模型的前端(react+Antd)全自动 CRUD 代码生成器",
   "bin": {
     "autodev": "bin/autodev.js"
@@ -48,6 +48,7 @@
     "sharp": "^0.34.5"
   },
   "devDependencies": {
-    "http-proxy": "^1.18.1"
+    "http-proxy": "^1.18.1",
+    "segmentit": "^2.0.3"
   }
 }

package/src/core/context.js

@@ -15,7 +15,7 @@ module.exports = {
      */
     init: options => {
 
-        const { recognizePage, generateMock, alignResponseFields } = require('../services/llm')
+        const { apiLinker, recognizePage, generateMock, alignResponseFields } = require('../services/llm')
         const { language, getConfig, unwrapSignal, isQuerySignal, getExistingMenus } = require('../utils/utils')
 
         const config = getConfig()
@@ -51,6 +51,7 @@ module.exports = {
         }
 
         const llmCtx = {
+            apiLinker,
             generateMock,
             recognizePage,
             alignResponseFields

package/src/core/react-compiler.js

@@ -64,7 +64,6 @@ const index = ({ config, fileName, indexTpl, pageConfig }) => {
 
     const viewData = {
         hasTabs,
-        fileName,
         pageStruct,
         hasOperate,
         columnsValue,
@@ -80,6 +79,7 @@ const index = ({ config, fileName, indexTpl, pageConfig }) => {
         staticInfoText: pageConfig.staticInfo?.text,
         operations: pageConfig.table.operation || [],
         hasRowSelection: pageConfig.table.rowSelection,
+        uri: config.needMock ? fileName : 'BUNKER_API_ANCHOR_pages',
         formItems: hasFormItems ? (hasTabs ? 'formItems[activeKey]' : 'formItems') : '[]',
         initParams: `{ ${hasTabs ? 'type: tabs[0].key ,' : ''}${hasPagination ? 'pageNo: 1 , pageSize: 10' : ''}}`,
     }

package/src/prompts/react/api-linker.js

@@ -0,0 +1,18 @@
+module.exports = (bunkerAnchors, realApis) => `
+# MISSION: Multi-Point API Alignment
+目标：为地堡生成的多个作战动作匹配真实的后端接口。
+
+## 1. 待匹配指令清单 (Target Anchors)
+${bunkerAnchors}
+
+## 2. 后端情报库 (Swagger Docs)
+${realApis}
+
+## 3. 匹配协议
+- 识别后缀（如 edit, delete, add）。
+- 结合 UI 语义，在 API 库中寻找对应路径。
+- **输出格式**：请只输出一个 JSON 映射表。
+- **例如**：{"BUNKER_API_ANCHOR_editByRecord": "[method] /api/v1/update-user"}
+
+⚠️ 严禁解释，严禁输出 JSON 之外的内容。
+`.trim()

package/src/prompts/react/watch-page.js

@@ -44,10 +44,10 @@ module.exports = `
     - text: 普通文本（默认）
     - tag: 标签列(有背景色的文本)
     - badge: 徽标列(文本前有颜色小圆点)
-    - **行操作 (operation)**: [{label:'操作名', action:'动词ByRecord'}]。
+    - **行操作 (operation)**: [{label:'操作名', action:'动词ByRecord',uri:'BUNKER_API_ANCHOR_动词ByRecord'}]。
 
 ### 全局功能按钮 (FunctionButton)
-- **格式**: [{btn:'显示文本', action:'操作动词BySelected'}]。
+- **格式**: [{btn:'显示文本', action:'操作动词BySelected',uri:'BUNKER_API_ANCHOR_动词BySelected'}]。
 - **导出数据**: action 设为 'exportData' 或 'export+模块名'。
 - **逻辑锁定**: ⚠️只要页面中出现了非查询、非重置的独立操作按钮，必须识别并存入 [functionButton] 数组。
 - **构筑联动**: ⚠️若 [functionButton] 数组不为空，则在下文的 [pageStruct] 中必须包含 "FunctionButtonsBlock"。

package/src/prompts/react/watch-part.js

@@ -12,7 +12,7 @@ module.exports = `
 - ⚠️ 字段白名单: [title, dataIndex, sorter, render, filters, onFilter]
 - 禁止输出:
     - 严禁在 columns 中包含“操作”列。
-    - ***⚠️⚠️⚠️严禁输出formItems,只允许输出coloumns⚠️⚠️⚠️***
+    - ***⚠️⚠️⚠️严禁输出formItems,只允许输出columns⚠️⚠️⚠️***
 - **标准定义 (Columns)**:
     - ⚠️ **操作锁定**: 严禁在 columns 数组中包含“操作”列。
     - enum: 枚举列

package/src/schema/page.json

@@ -82,11 +82,15 @@
                         "items": {
                             "type": "object",
                             "required": [
+                                "uri",
                                 "label",
                                 "action"
                             ],
                             "additionalProperties": false,
                             "properties": {
+                                "uri": {
+                                    "type": "string"
+                                },
                                 "label": {
                                     "type": "string"
                                 },
@@ -113,8 +117,7 @@
                     "type": "object",
                     "required": [
                         "label",
-                        "name",
-                        "type"
+                        "name"
                     ],
                     "additionalProperties": false,
                     "properties": {
@@ -210,6 +213,7 @@
                     "type": "object",
                     "required": [
                         "btn",
+                        "uri",
                         "action"
                     ],
                     "additionalProperties": false,
@@ -217,6 +221,9 @@
                         "btn": {
                             "type": "string"
                         },
+                        "uri": {
+                            "type": "string"
+                        },
                         "action": {
                             "type": "string"
                         }

package/src/services/api-linker.js

@@ -0,0 +1,162 @@
+const fs = require('fs')
+const path = require('path')
+const chalk = require('chalk')
+const { Segment, useDefault } = require('segmentit')
+const segmentit = useDefault(new Segment())
+
+/**
+ * @function getSemanticKeywords
+ * @description [语义精炼厂 2.0] 使用 segmentit 引擎进行物理切片。
+ */
+const getSemanticKeywords = text => {
+    // 💡 物理脱水：确保输入为纯净字符串
+    const content = Array.isArray(text) ? text.join(' ') : (text || '')
+    // 💡 执行分词
+    const result = segmentit.doSegment(content, {
+        simple: true, // 开启简易模式，提升吞吐效率
+        stripPunctuation: true // 物理过滤掉所有的标点符号
+    })
+    // 💡 提取词条并执行“基因筛选”
+    return Array.from(new Set(result.filter(word => word.length >= 2 && !/^[0-9]+$/.test(word))))
+}
+
+/**
+ * @function getLocalScore
+ * @description [战力评估协议] 计算语义重合度。
+ */
+const getLocalScore = (api, pageKeywords, moduleName) => {
+    let score = 0
+    const path = api.path.toLowerCase()
+    const desc = api.desc.toLowerCase()
+    const mod = moduleName.toLowerCase()
+
+    // 💡 权重 A：路径直接包含模块名 (暴击加分 +50)
+    if (path.includes(mod)) score += 50
+
+    // 💡 权重 B：描述包含模块核心词 (中量加分 +10)
+    pageKeywords.forEach(word => {
+        if (desc.includes(word.toLowerCase())) score += 10
+        if (path.includes(word.toLowerCase())) score += 5
+    })
+
+    return score
+}
+
+/**
+ * @module apiLinker
+ * @description [地堡 4.0 核心] 全频道自动寻址协议。
+ */
+module.exports = async () => {
+
+    const { get } = require('../core/context')
+    const { config, options, language, apiLinker } = get()
+    if (!config.apiDoc) return
+
+    console.log(chalk.cyan(language(
+        `\n🤖 Pod 153: 启动‘全频道自动寻址协议 [语义扫描版]’...`,
+        `\n🤖 Pod 153: Initiating "Full-Channel Autonomous Addressing Protocol [Semantic Scan]"...`
+    )))
+
+    try {
+        // 1. 抓取情报
+        const apiData = await fetch(config.apiDoc).then(res => res.json())
+        const refinedApis = Object.entries(apiData.paths).flatMap(([apiUrl, methods]) => {
+            // 💡 适配多方法接口：有的路径下可能既有 GET 也有 POST
+            return Object.entries(methods).map(([method, info]) => ({
+                path: apiUrl,
+                method: method.toUpperCase(),
+                desc: info.summary || info.description || 'N/A'
+            }))
+        })
+
+        // 2. 战场侦察
+        const pagesDir = path.join(process.cwd(), config.pagesDir)
+        const files = fs.readdirSync(pagesDir)
+
+        for (const fileName of files) {
+            const indexPath = path.join(pagesDir, fileName, 'index.js')
+            const resourcePath = path.join(pagesDir, fileName, 'resource.js')
+
+            if (fs.existsSync(indexPath) && fs.existsSync(resourcePath)) {
+                let indexCode = fs.readFileSync(indexPath, 'utf-8')
+
+                // 💡 锁定待通电锚点
+                if (indexCode.includes('BUNKER_API_ANCHOR')) {
+                    const resourceCode = fs.readFileSync(resourcePath, 'utf-8')
+                    const fileName = path.basename(indexPath, path.extname(indexPath))
+                    const bunkerAnchors = indexCode.match(/BUNKER_API_ANCHOR_\w+/g).join('\n')
+
+                    // 💡 执行语义提取流程
+                    const returnMatch = indexCode.match(/return\s*\(([\s\S]*?)\)\s*}/)
+                    const returnStatement = returnMatch ? returnMatch[0] : ''
+
+                    const moduleSemantics = `${returnStatement}${resourceCode}`.match(/[\u4e00-\u9fa5][\u4e00-\u9fa5A-Za-z0-9？。，、：；！（） ]*/g) || []
+                    const pageKeywords = getSemanticKeywords(moduleSemantics)
+
+                    // 💡 物理扫描：执行“语义雷达”过滤
+                    const candidates = refinedApis
+                        .map(api => ({
+                            ...api,
+                            score: getLocalScore(api, pageKeywords, fileName)
+                        }))
+                        .filter(item => item.score > 0)
+                        .sort((a, b) => b.score - a.score)
+                        .slice(0, 20) // 💡 拓宽至前 20 名，给 AI 更多的判别空间
+
+                    const finalCandidates = candidates.map(item => `${item.method} ${item.path} ${item.desc}`).join('\n')
+
+                    console.log(chalk.yellow(language(
+                        ` 🛰️  Inactive module: [${fileName}]. Requesting 9S for precise alignment...`,
+                        ` 🛰️  发现未通电模块 [${fileName}]，请求 9S 执行高精度对账...`
+                    )))
+
+                    // 3. 驱动 9S 最终裁决
+                    const result = await apiLinker(options, bunkerAnchors, finalCandidates)
+
+                    if (result) {
+                        // 💡 执行物理更替
+                        Object.entries(result).forEach(([anchor, fullSignal]) => {
+                            // 💡 1. 信号解压
+                            const parts = fullSignal.split(' ')
+                            const realMethod = parts[0].toUpperCase()
+                            const realPath = parts[1]
+
+                            // 💡 2. 路径清洗：确保路径拼接时不产生双斜杠 //
+                            // 逻辑：如果 realPath 以 / 开头，咱们拼接时就得小心
+                            const cleanPath = realPath.startsWith('/') ? realPath : `/${realPath}`
+
+                            /**
+                             * 💡 3. 物理定位正则表达式
+                             * 我们把 (request\(\s*['"])\/api\/ 这一段作为第一个捕获组 $1
+                             * 这样在替换时，只需在 $1 后面补上新的路径即可，/api/ 会被原样保留！
+                             */
+                            const requestRegex = new RegExp(`(request\\(\\s*['"]\\/api)${anchor}(['"]\\s*,\\s*\\{[^}]*method\\s*:\\s*['"])(.*?)(['"])`, 'g')
+
+                            // 💡 4. 执行“全频道通电”
+                            // $1 现在包含了 request('/api 这一串
+                            indexCode = indexCode.replace(requestRegex, `$1${cleanPath}$2${realMethod}$4`)
+                            // 💡 5. 兜底替换（针对没有 method 配置的简易请求）
+                            // 同样保留 /api/ 前缀
+                            indexCode = indexCode.replaceAll(`/api/${anchor}`, `/api${cleanPath}`)
+                        })
+                        fs.writeFileSync(indexPath, indexCode)
+                        console.log(chalk.green(language(
+                            `✅ 信号同步完成，${Object.keys(result).length} 个节点已通电。`,
+                            `✅ Signal Synchronized: ${Object.keys(result).length} nodes energized.`
+                        )))
+                        // 💡 战术免责补丁：采用橙黄色高亮，提醒指挥官保持警惕
+                        console.log(chalk.yellow(language(
+                            `⚠️ 匹配结果仅供参考，不构成最终决策，各机体需根据实际情况进行调整。`,
+                            `⚠️ Match Result Reference Only. Not Final Decision. Each Unit should adjust based on battlefield conditions.`
+                        )))
+                    }
+                }
+            }
+        }
+    } catch (e) {
+        console.error(chalk.red(language(
+            `\n❌ Pod 153: 信号链路故障: ${e.message}\n`,
+            `\n❌ Pod 153: Signal Link Fault: ${e.message}\n`
+        )))
+    }
+}

package/src/services/llm.js

@@ -73,6 +73,18 @@ module.exports = {
             ]
         })
     },
+    apiLinker: async (options, bunkerAnchors, realApis) => {
+        const config = getConfig()
+        const { API_DESIGNER } = require('../prompts/system.js')
+        const apiPrompt = require(`../prompts/${options.template}/api-linker.js`)
+        return askAI({
+            model: config.textModel,
+            messages: [
+                { role: 'system', content: API_DESIGNER },
+                { role: 'user', content: apiPrompt(bunkerAnchors, realApis) }
+            ]
+        })
+    },
     recognizePage: async (prompt, filePath, taskType = 'page') => {
         const config = getConfig()
         const { UI_DESIGNER } = require('../prompts/system.js')

package/templates/react/handlebars/handleBlock.hbs

@@ -1,6 +1,6 @@
 {{#each operations}}
 const {{this.action}} = async record => {
-    const response = await request('/api')
+    const response = await request('/api/{{this.uri}}',{ method: 'POST', body:{} })
     if({{{../responseSuccess}}}){
         refresh()
     }
@@ -15,7 +15,7 @@ const {{this.action}} = () => {
         centered: true,
         content: '确认{{this.btn}}吗？',
         onOk: async () => {
-            const response = await request('/api')
+            const response = await request('/api/{{this.uri}}',{ method: 'POST', body:{} })
             if({{{../responseSuccess}}}){
                 refresh()
             }
@@ -63,8 +63,9 @@ const showImg = (record, dataIndex) => {
 
 const modalSubmit = async values => {
     let response
+    let body = values
     if(modal.type==='add'){
-        response = await request('/api')
+        response = await request('/api',{ method: 'POST', body })
     }
     if({{{responseSuccess}}}){
         setModal({ visible: false })

package/templates/react/handlebars/hookBlock.hbs

@@ -3,7 +3,7 @@ const initialParams = {{initParams}}
 const query = formatQuery(Object.fromEntries(new URLSearchParams(location.search).entries()),  {{formItems}})
 
 const { total, columns, loading, dataSource, search, setSearch, setDataSource, refresh } = useTableQuery({
-        api: async params => await request('/api/{{fileName}}', { method: 'POST', body: params }),
+        api: async params => await request('/api/{{uri}}', { method: 'POST', body: params }),
         initialParams: { ...initialParams, ...query },
         cols:tableColumns,
         formatResponse: response => {