@yorha2b-lab/autodev 1.0.25 → 1.0.27

package/README.md

@@ -1,5 +1,7 @@
 # Auto CRUD Copilot
 
+[English](./README_EN.md) | 简体中文
+
 [![NPM Version](https://img.shields.io/npm/v/@yorha2b-lab/autodev.svg?style=flat-square)](https://www.npmjs.com/package/@yorha2b-lab/autodev)
 [![NPM Downloads](https://img.shields.io/npm/dm/@yorha2b-lab/autodev.svg?style=flat-square)](https://www.npmjs.com/package/@yorha2b-lab/autodev)
 [![GitHub Stars](https://img.shields.io/github/stars/yorha2b-lab/auto-crud-copilot.svg?style=flat-square)](https://github.com/yorha2b-lab/auto-crud-copilot/stargazers)

package/README_EN.md

@@ -0,0 +1,194 @@
+# Auto CRUD Copilot
+
+English | [简体中文](./README.md)
+
+[![NPM Version](https://img.shields.io/npm/v/@yorha2b-lab/autodev.svg?style=flat-square)](https://www.npmjs.com/package/@yorha2b-lab/autodev)
+[![NPM Downloads](https://img.shields.io/npm/dm/@yorha2b-lab/autodev.svg?style=flat-square)](https://www.npmjs.com/package/@yorha2b-lab/autodev)
+[![GitHub Stars](https://img.shields.io/github/stars/yorha2b-lab/auto-crud-copilot.svg?style=flat-square)](https://github.com/yorha2b-lab/auto-crud-copilot/stargazers)
+[![License](https://img.shields.io/npm/l/@yorha2b-lab/autodev.svg?style=flat-square)](https://github.com/yorha2b-lab/auto-crud-copilot/blob/main/LICENSE)
+
+An AI-powered frontend CRUD code generator based on vision models (Umi+Antd) 🚀
+
+<video src="https://github.com/user-attachments/assets/6d42fce1-c815-482b-8c6a-4a3b9415ba47.mp4" controls="controls" muted="muted" style="max-width: 100%; display: block; margin: 20px auto;">
+</video>
+
+Say goodbye to repetitive work! Why do you need Auto CRUD Copilot?
+Stop writing Tables/Forms manually: Screenshot to code, boost your development efficiency, and say goodbye to tedious copy-paste.
+Eliminate API integration pain: Automatically read Response data, and let AI help you bridge frontend-backend field naming differences.
+Decoupled architecture: Core logic separated from UI frameworks, supporting React/Vue/Angular.
+
+## ✨ Features
+
+- 🖼️ **Visual Recognition**: Automatically recognize page structures from screenshots and generate corresponding CRUD code
+- 🔧 **Smart Generation**: Support multiple frontend framework templates including React, Vue, and Angular
+- 📊 **Table Components**: Automatically generate editable, sortable, and filterable data tables
+- 📝 **Form Components**: Intelligently generate search forms and modal forms
+- 🔌 **API Alignment**: Automatically align Response interfaces with frontend field mappings
+- 🎨 **UI Components**: Support various UI component types (input, select, date picker, etc.)
+- 📱 **Responsive**: Generated code supports responsive layout
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install -g @yorha2b-lab/autodev
+```
+
+### Environment Setup
+
+Quick start
+
+```bash
+autodev init
+```
+
+Create a `.env` file and configure the following environment variables:
+
+```bash
+# AI Model API Configuration
+API_KEY=your_api_key_here
+BASE_URL=your_api_base_url_here
+```
+
+🚗 **Get API Key**: [Alibaba Cloud Bailian Console](https://bailian.console.aliyun.com/cn-beijing?tab=doc#/doc/)
+
+### Basic Usage
+
+1. **Generate Complete CRUD Pages**
+
+```bash
+# Put page screenshots in the screenShot directory
+autodev watch:page
+```
+
+2. **Generate Partial UI Components**
+
+```bash
+# Put component screenshots in the screenPart directory
+autodev watch:part
+```
+
+3. **Align API Fields**
+
+```bash
+autodev watch:api
+```
+
+## 📖 Detailed Usage Guide
+
+### watch:page Command
+
+Monitor screenshot files in the `screenShot` directory and automatically generate complete CRUD pages.
+
+```bash
+autodev watch:page -t react
+```
+
+Parameters:
+- `-t, --template <type>`: Specify frontend framework template, default is `react`
+
+### watch:part Command
+
+Monitor screenshot files in the `screenPart` directory and automatically generate partial UI components.
+
+```bash
+autodev watch:part -t vue
+```
+
+### watch:api Command
+
+Monitor JSON files in the `response` directory (named after modules) and automatically align real API fields.
+
+```bash
+autodev watch:api
+```
+
+## 📁 Project Structure
+
+```
+your-project/
+├── screenShot/          # Page screenshot directory
+├── screenPart/          # Component screenshot directory
+├── response/            # Response directory
+├── mock/                # Generated Mock data
+├── src/
+│   ├── pages/           # Generated page code
+│   ├── components/      # Generated component code
+│   ├── hooks/           # Generated Hook code
+└── config.js            # Configuration file
+```
+
+## ⚙️ Configuration
+
+You can configure the following options in `config.js`:
+
+```javascript
+module.exports = {
+    // Whether to generate Mock data
+    needMock: false,
+
+    // AI model types to use
+    visionModel: 'qwen3.5-plus',
+    textModel: 'qwen-turbo',
+
+    // Target project directory paths
+    hooksDir: 'src/hooks',
+    pagesDir: 'src/pages',
+    utilsDir: 'src/utils',
+    componentsDir: 'src/components',
+}
+```
+
+## 🎯 Supported UI Components
+
+- Input
+- InputNumber
+- Select
+- Radio
+- Checkbox
+- DatePicker
+- RangePicker
+- Cascader
+- AutoComplete
+- TextArea
+- Upload
+
+## 🤝 Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) to learn how to participate in project development.
+
+## 📄 License
+
+This project is licensed under the [MIT](LICENSE) license.
+
+## 🙏 Acknowledgments
+
+Thanks to the following open-source projects:
+
+- [OpenAI](https://openai.com/) - Providing powerful AI capabilities
+- [Ant Design](https://ant.design/) - Excellent enterprise-level UI design language
+- [UmiJS](https://umijs.org/) - Enterprise-level frontend application framework
+
+## 📞 Contact
+
+If you have any questions or suggestions, feel free to submit an [Issue](https://github.com/yorha2b-lab/auto-crud-copilot/issues).
+
+## 🛠️ FAQ
+
+**Q: Is this tool free?**
+A: The tool itself is open-source and free, but the AI models it calls (such as GPT-4v, Qwen-VL) may require you to configure your own API Key. We recommend using cost-effective models like Alibaba Cloud's Qwen-VL.
+
+---
+
+## ⚖️ Disclaimer
+
+Auto CRUD Copilot is a **fan-made, non-commercial, open-source tool**.
+
+- The themes, names (YoRHa, 2B, etc.), and catchphrases included in this project are inspired by **NieR:Automata**, which is a trademark and copyright of **Square Enix Co., Ltd. / PlatinumGames Inc.**
+- This project is not affiliated with, endorsed by, or representative of Square Enix in any way.
+- Please support the original masterpiece: [NieR:Automata Official Site](https://nierautomata.square-enix-games.com/).
+
+**Glory to Mankind.**
+
+⭐ If this project helps you, please give it a Star to show your support!

package/bin/autodev.js

@@ -5,47 +5,74 @@ const chalk = require('chalk')
 const figlet = require('figlet')
 const { program } = require('commander')
 const pkg = require(path.join(__dirname, '../package.json'))
+const { language } = require(path.join(__dirname, '../src/utils/utils.js'))
 
 console.log(chalk.cyan(figlet.textSync('AutoDev', { horizontalLayout: 'full' })))
 console.log(chalk.gray('Booting System...'))
+console.log(chalk.white(' [System] ') + chalk.green('Locale Detection: ') + chalk.cyan(language('ZH-CN', 'EN-US')))
 console.log(chalk.white(' [System] ') + chalk.green('YoRHa No.2 Type B Unit: ') + chalk.cyan('Online'))
 console.log(chalk.white(' [System] ') + chalk.green('Scanner Type 9S Unit: ') + chalk.cyan('Standby'))
 console.log(chalk.white(' [Mission] ') + chalk.yellow('Frontend Architecture Construction: ') + chalk.cyan('Awaiting Command'))
 console.log(chalk.white(' [Bunker] ') + chalk.magenta('Glory to mankind. (人类荣光永存)'))
 console.log(chalk.gray('--------------------------------------------------\n'))
 
-program.version(pkg.version).description('AI驱动的前端CRUD代码生成器')
-program.option('-t, --template <type>', '指定前端框架模板', 'react')
+// --- Commander 配置 ---
+program
+    .version(pkg.version)
+    .description(language('AI驱动的前端CRUD代码生成器', 'AI-powered frontend CRUD code generator'))
+
+program.option('-t, --template <type>', language('指定前端框架模板', 'Specify frontend framework template'), 'react')
 
 program
     .command('init')
-    .description('在当前目录初始化 .env 和 config.js 配置文件')
+    .description(language('在当前目录初始化 .env 和 config.js 配置文件', 'Initialize .env and config.js in the current directory'))
     .action(() => {
         const tplConfig = path.resolve(__dirname, '../config.js')
         const tplEnv = path.resolve(__dirname, '../.env.example')
         const targetEnv = path.join(process.cwd(), '.env')
         const targetConfig = path.join(process.cwd(), 'config.js')
+
         fs.mkdirSync(path.join(process.cwd(), 'response'), { recursive: true })
         fs.mkdirSync(path.join(process.cwd(), 'screenShot'), { recursive: true })
         fs.mkdirSync(path.join(process.cwd(), 'screenPart'), { recursive: true })
+
+        // .env 处理
         if (fs.existsSync(targetEnv)) {
-            console.log(chalk.yellow('🤖 Pod 042: [警告] 终端已存在 .env 文件，跳过生成以免覆盖数据。'));
+            console.log(chalk.yellow(language(
+                '🤖 Pod 042: [警告] 终端已存在 .env 文件，跳过生成以免覆盖数据。',
+                '🤖 Pod 042: [Warning] .env already exists. Skipping to avoid data overwrite.'
+            )));
         } else {
             fs.copyFileSync(tplEnv, targetEnv);
-            console.log(chalk.green('🤖 Pod 042: [报告] .env 存储完毕。'));
+            console.log(chalk.green(language(
+                '🤖 Pod 042: [报告] .env 存储完毕。',
+                '🤖 Pod 042: [Report] .env storage complete.'
+            )));
         }
+
+        // config.js 处理
         if (fs.existsSync(targetConfig)) {
-            console.log(chalk.yellow('🤖 Pod 042: [警告] 终端已存在 config.js 文件，跳过生成以免覆盖数据。'));
+            console.log(chalk.yellow(language(
+                '🤖 Pod 042: [警告] 终端已存在 config.js 文件，跳过生成以免覆盖数据。',
+                '🤖 Pod 042: [Warning] config.js already exists. Skipping to avoid data overwrite.'
+            )));
         } else {
             fs.copyFileSync(tplConfig, targetConfig)
-            console.log(chalk.green('🤖 Pod 042: [报告] config.js 存储完毕。'));
+            console.log(chalk.green(language(
+                '🤖 Pod 042: [报告] config.js 存储完毕。',
+                '🤖 Pod 042: [Report] config.js storage complete.'
+            )));
         }
-        console.log(chalk.cyan('📡 Operator 6O: 呼叫 2B，环境配置文件已下发至本地终端！'))
+
+        console.log(chalk.cyan(language(
+            '📡 Operator 6O: 呼叫 2B，环境配置文件已下发至本地终端！',
+            '📡 Operator 6O: Calling 2B, environmental config files have been deployed to your local terminal!'
+        )))
     })
 
 program
     .command('watch:page')
-    .description('监听截图，自动生成完整的增删改查页面')
+    .description(language('监听截图，自动生成完整的增删改查页面', 'Watch screenshots and auto-generate complete CRUD pages'))
     .action(() => {
         const watchPage = require('../src/commands/watch-page')
         watchPage(program.opts())
@@ -53,7 +80,7 @@ program
 
 program
     .command('watch:part')
-    .description('监听截图，自动生成局部 UI 组件')
+    .description(language('监听截图，自动生成局部 UI 组件', 'Watch screenshots and auto-generate partial UI components'))
     .action(() => {
         const watchPart = require('../src/commands/watch-part')
         watchPart(program.opts())
@@ -61,7 +88,7 @@ program
 
 program
     .command('watch:api')
-    .description('监听 Response，自动对齐真实接口字段')
+    .description(language('监听 Response，自动对齐真实接口字段', 'Watch responses and auto-align real API fields'))
     .action(() => {
         const watchApi = require('../src/commands/watch-api')
         watchApi()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yorha2b-lab/autodev",
-  "version": "1.0.25",
+  "version": "1.0.27",
   "description": "基于视觉大模型的前端(Umi+Antd)全自动 CRUD 代码生成器",
   "bin": {
     "autodev": "bin/autodev.js"

package/src/commands/watch-api.js

@@ -5,8 +5,8 @@ const chalk = require('chalk')
 const chokidar = require('chokidar')
 
 const watchApi = () => {
-
-    const { getConfig } = require('../utils/utils.js')
+    // 导入配置文件和多语言函数
+    const { getConfig, language } = require('../utils/utils.js')
     const { alignResponseFields } = require('../services/llm.js')
 
     const config = getConfig()
@@ -23,26 +23,44 @@ const watchApi = () => {
     watcher.on('add', async filePath => {
         const startTime = Date.now()
         const fileName = path.basename(filePath, path.extname(filePath))
-        const spinner = ora(chalk.cyan(`🤖 Pod 153: [报告] 侦测到未知的 Response 数据源 [${fileName}]，开始进行语义对齐...`))
+
+        // 使用 language 函数包装 Pod 153 的启动报告
+        const spinner = ora(chalk.cyan(language(
+            `🤖 Pod 153: [报告] 侦测到未知的 Response 数据源 [${fileName}]，开始进行语义对齐...`,
+            `🤖 Pod 153: [Report] Detected unknown Response data source [${fileName}]. Commencing semantic alignment...`
+        )))
         spinner.start()
 
         try {
             const responseStr = fs.readFileSync(filePath, 'utf8')
             let resourceStr = fs.readFileSync(`./${config.pagesDir}/${fileName}/resource.js`, 'utf8')
+
+            // 调用 AI 服务进行字段对齐
             const result = await alignResponseFields(responseStr, resourceStr)
+
             Object.entries(result).forEach(([oldField, newField]) => {
                 if (oldField === newField) return
                 const regex = new RegExp(`(dataIndex|name)\\s*:\\s*['"]${oldField}['"]`, 'g')
                 resourceStr = resourceStr.replace(regex, `$1: '${newField}'`)
             })
+
             fs.writeFileSync(path.join(`./${config.pagesDir}/${fileName}/resource.js`), resourceStr)
             const endTime = Date.now()
-            //fs.unlinkSync(filePath)
-            spinner.succeed(chalk.green(`🤖 Pod 153: [肯定] 字段对齐协议执行完毕：耗时 ${(endTime - startTime) / 1000} 秒。9S 的骇客任务很顺利。`))
+
+            // 成功报告：带上 9S 的骇客梗
+            spinner.succeed(chalk.green(language(
+                `🤖 Pod 153: [肯定] 字段对齐协议执行完毕：耗时 ${(endTime - startTime) / 1000} 秒。9S 的骇客任务很顺利。`,
+                `🤖 Pod 153: [Affirmative] Field alignment protocol executed. Time: ${(endTime - startTime) / 1000}s. 9S's hacking mission was successful.`
+            )))
+
         } catch (error) {
-            console.log(chalk.red(`🤖 Pod 153: [警告] 骇入 [${fileName}] 失败。接口数据遭遇强力防火墙：${error}`))
+            // 失败报告：提到“防火墙”
+            spinner.fail(chalk.red(language(
+                `🤖 Pod 153: [警告] 骇入 [${fileName}] 失败。接口数据遭遇强力防火墙：${error}`,
+                `🤖 Pod 153: [Warning] Hacking into [${fileName}] failed. Encountered a powerful firewall in API data: ${error}`
+            )))
         }
     })
 }
 
-module.exports = watchApi
+module.exports = watchApi

package/src/commands/watch-page.js

@@ -1,132 +1,135 @@
 const fs = require('fs')
-const ora = require('ora') // 命令行加载动画
+const ora = require('ora')
 const path = require('path')
 const chalk = require('chalk')
 
-
 /**
  * 监听截图目录，自动生成 CRUD 页面
  * @param {Object} options - 命令行选项
- * @param {string} options.template - 前端框架模板（react/vue/angular）
+ * @param {string} options.template - 前端框架模板
  */
 const watchPage = options => {
+    const chokidar = require('chokidar')
+    const Handlebars = require('handlebars')
+    const pagePrompt = require('../prompts/watch-page.js')
+    const { createTaskQueue } = require('../core/task-queue')
+    const stringify = require('json-stringify-pretty-compact')
+    const { recognizePage, generateMock } = require('../services/llm.js')
 
-    const chokidar = require('chokidar') // 文件监听库
-    const Handlebars = require('handlebars') // 模板引擎
-    const pagePrompt = require('../prompts/watch-page.js') // 页面识别提示词
-    const { createTaskQueue } = require('../core/task-queue') // 任务队列，控制并发
-    const stringify = require('json-stringify-pretty-compact') // 格式化 JSON
-    const { recognizePage, generateMock } = require('../services/llm.js') // AI 服务
-    const { getConfig, copyTemplateDir, getExistingMenus } = require('../utils/utils.js') // 工具函数
+    const { language, getConfig, copyTemplateDir, getExistingMenus } = require('../utils/utils.js')
 
     const config = getConfig()
 
-    // 根据框架加载对应的编译器（react-compiler.js / vue-compiler.js 等）
     const compilerPath = path.join(__dirname, `../core/${options.template}-compiler.js`)
 
-    // 检查是否支持该框架
+    // 1. 检查框架支持
     if (!fs.existsSync(compilerPath)) {
-        console.error(`\n❌ 糟糕！暂不支持 [${options.template}] 框架的自动生成。`)
-        console.log(`💡 提示：目前仅内置了 react 编译器。`)
-        console.log(`🚀 强烈欢迎社区大佬提 PR 补充 ${options.template}-compiler.js ！\n`)
+        console.error(chalk.red(language(
+            `\n❌ 糟糕！暂不支持 [${options.template}] 框架的自动生成。`,
+            `\n❌ Errors! Automatic generation for [${options.template}] is not supported.`
+        )))
+        console.log(language(
+            `💡 提示：目前仅内置了 react 编译器。`,
+            `💡 Note: Only the react compiler is currently built-in.`
+        ))
+        console.log(language(
+            `🚀 强烈欢迎社区大佬提 PR 补充 ${options.template}-compiler.js ！\n`,
+            `🚀 PRs for ${options.template}-compiler.js are highly welcomed!\n`
+        ))
         return
     }
 
-    // 加载编译器的 index 和 resource 函数
     const { index, resource } = require(compilerPath)
 
     try {
-        // 首次运行时复制模板到目标项目
         copyTemplateDir(options, 'hooks', config.hooksDir)
         copyTemplateDir(options, 'utils', config.utilsDir)
         copyTemplateDir(options, 'components', config.componentsDir)
     } catch (error) {
-        console.error('❌ 程序运行出错:', error)
+        console.error(language('❌ 程序运行出错:', '❌ Runtime error:'), error)
     }
 
-    /**
-     * 创建任务队列，限制并发数为 2。
-     *
-     * 为什么限制并发？
-     * 1. 视觉大模型的 API 计费昂贵且通常有严格的 TPM/RPM (每分钟请求数) 限流。
-     * 2. 如果用户一次性丢入 5 张截图，全量并发极易触发 HTTP 429 Too Many Requests 报错。
-     * 3. 并发设为 2 是实测下来速度与稳定性的最佳平衡点。
-     */
     const queue = createTaskQueue(2)
-
-    // 获取已有的菜单配置
     const menus = getExistingMenus()
 
-    // 加载模板文件
     const tplDir = path.join(__dirname, `../../templates/${options.template}`)
     const indexTpl = Handlebars.compile(fs.readFileSync(path.join(tplDir, 'index.hbs'), 'utf-8'))
     const resourceTpl = Handlebars.compile(fs.readFileSync(path.join(tplDir, 'resource.hbs'), 'utf-8'))
 
-    // 所有任务完成后统一更新菜单配置
+    // 2. 队列空闲时的菜单同步
     queue.onIdle(() => {
-        console.log(chalk.green('🤖 Pod 042: [报告] 所有排队的视觉数据已解析完毕，正在向 Bunker 同步 Menu 路由配置...'))
+        console.log(chalk.green(language(
+            '🤖 Pod 042: [报告] 所有排队的视觉数据已解析完毕，正在向 Bunker 同步 Menu 路由配置...',
+            '🤖 Pod 042: [Report] Queued visual data processed. Syncing Menu configuration to the Bunker...'
+        )))
         const constantDir = path.join(process.cwd(), config.utilsDir)
         if (!fs.existsSync(constantDir)) fs.mkdirSync(constantDir, { recursive: true })
-        // 格式化菜单配置为 JS 代码
         fs.writeFileSync(path.join(constantDir, 'constant.js'), `export const menus = ${stringify.default(menus, { indent: 4, maxLength: 50 })}`)
-        console.log(chalk.green('🤖 Pod 042: [肯定] Menu 配置同步成功。'))
+        console.log(chalk.green(language(
+            '🤖 Pod 042: [肯定] Menu 配置同步成功。',
+            '🤖 Pod 042: [Affirmative] Menu configuration synced successfully.'
+        )))
     })
 
-    // 监听 screenShot 目录
     const watcher = chokidar.watch('./screenShot', {
-        persistent: true, // 持续监听
-        ignored: /(^|[\/\\])\../, // 忽略隐藏文件
-        awaitWriteFinish: { // 等待文件写入完成
-            stabilityThreshold: 500, // 稳定性阈值（毫秒）
-            pollInterval: 100 // 轮询间隔
-        }
+        persistent: true,
+        ignored: /(^|[\/\\])\../,
+        awaitWriteFinish: { stabilityThreshold: 500, pollInterval: 100 }
     })
 
-    // 文件添加事件
+    // 3. 文件添加事件
     watcher.on('add', filePath => {
         queue.add(async () => {
             const startTime = Date.now()
             const mockDir = path.join(process.cwd(), 'mock')
             const fileName = path.basename(filePath, path.extname(filePath))
             const targetDir = path.join(process.cwd(), config.pagesDir, fileName)
-            const spinner = ora(chalk.cyan(`🤖 Pod 042: [报告] 捕获到新的视觉图像 [${fileName}]，开始执行构筑程序...`))
+
+            const spinner = ora(chalk.cyan(language(
+                `🤖 Pod 042: [报告] 捕获到新的视觉图像 [${fileName}]，开始执行构筑程序...`,
+                `🤖 Pod 042: [Report] Captured new visual image [${fileName}]. Initializing construction...`
+            )))
             spinner.start()
+
             try {
-                // 创建必要的目录
                 if (!fs.existsSync(mockDir)) fs.mkdirSync(mockDir, { recursive: true })
                 if (!fs.existsSync(targetDir)) fs.mkdirSync(targetDir, { recursive: true })
 
-                // 1. 识别页面结构（调用视觉大模型）
                 const pageConfig = await recognizePage(pagePrompt, filePath)
-
-                // 2. 生成 resource.js（表格列、表单配置、字典等）
                 fs.writeFileSync(path.join(targetDir, 'resource.js'), resource({ pageConfig, resourceTpl }))
-
-                // 3. 生成 index.js（页面组件）
                 fs.writeFileSync(path.join(targetDir, 'index.js'), index({ fileName, indexTpl, pageConfig }))
 
-                // 4. 如果是新页面，添加到菜单配置
                 if (!menus.find(m => m.key === fileName)) {
                     menus.push({ label: fileName, key: fileName })
                 }
 
-                // 5. 生成 Mock 数据（可选）
+                // 4. 生成 Mock 数据
                 if (config.needMock) {
-                    console.log(chalk.yellow(`🧑‍💻 9S: 交给我吧 2B！正在骇入并伪造 [${fileName}] 的 Mock 数据...`))
+                    console.log(chalk.yellow(language(
+                        `🧑‍💻 9S: 交给我吧 2B！正在骇入并伪造 [${fileName}] 的 Mock 数据...`,
+                        `🧑‍💻 9S: Leave it to me, 2B! Hacking and forging Mock data for [${fileName}]...`
+                    )))
                     const rawContent = await generateMock(pageConfig.table.columns, fileName)
-                    // 格式化 Mock 数据
                     fs.writeFileSync(path.join(mockDir, `${fileName}.js`), `export default ${stringify.default(rawContent, { indent: 4, maxLength: 200 })}`.replaceAll(`"'`, `"`).replaceAll(`'"`, `"`))
-                    console.log(chalk.green(`🤖 Pod 042: [报告] Mock 数据注入完成，耗时: ${(Date.now() - startTime) / 1000} 秒`))
+                    console.log(chalk.green(language(
+                        `🤖 Pod 042: [报告] Mock 数据注入完成，耗时: ${(Date.now() - startTime) / 1000} 秒`,
+                        `🤖 Pod 042: [Report] Mock data injection complete. Elapsed time: ${(Date.now() - startTime) / 1000}s`
+                    )))
                 }
 
                 const endTime = Date.now()
-                //fs.unlinkSync(filePath) // 可选：处理完成后删除截图
-                spinner.succeed(chalk.green(`🤖 Pod 042: [报告] 模块 [${fileName}] 物理装配完成！耗时 ${(endTime - startTime) / 1000} 秒`))
+                spinner.succeed(chalk.green(language(
+                    `🤖 Pod 042: [报告] 模块 [${fileName}] 物理装配完成！耗时 ${(endTime - startTime) / 1000} 秒`,
+                    `🤖 Pod 042: [Report] Module [${fileName}] assembly complete! Elapsed time: ${(endTime - startTime) / 1000}s`
+                )))
             } catch (error) {
-                spinner.fail(chalk.red(`🤖 Pod 042: [警告] 模块 [${fileName}] 构筑失败。原因：${error}`))
+                spinner.fail(chalk.red(language(
+                    `🤖 Pod 042: [警告] 模块 [${fileName}] 构筑失败。原因：${error}`,
+                    `🤖 Pod 042: [Warning] Module [${fileName}] construction failed. Reason: ${error}`
+                )))
             }
         })
     })
 }
 
-module.exports = watchPage
+module.exports = watchPage

package/src/commands/watch-part.js

@@ -5,8 +5,9 @@ const chokidar = require('chokidar')
 const stringify = require('json-stringify-pretty-compact')
 
 const watchPart = () => {
-
+    // 导入核心逻辑和多语言函数
     const { recognizePage } = require('../services/llm.js')
+    const { language } = require('../utils/utils.js')
 
     const watcher = chokidar.watch('./screenPart', {
         persistent: true,
@@ -18,19 +19,28 @@ const watchPart = () => {
     })
 
     watcher.on('add', async filePath => {
-        const spinner = ora(chalk.cyan(`🤖 Pod 042: [报告] 捕获到新的视觉图像，开始执行构筑程序...`))
+        // 使用 language 函数包装 Pod 报告
+        const spinner = ora(chalk.cyan(language(
+            `🤖 Pod 042: [报告] 捕获到新的视觉图像，开始执行构筑程序...`,
+            `🤖 Pod 042: [Report] Captured new visual image. Initializing construction...`
+        )))
         spinner.start()
+
         try {
             const startTime = Date.now()
             const partPrompt = require('../prompts/watch-part.js')
             const pageConfig = await recognizePage(partPrompt, filePath)
+
             const optionDict = pageConfig.optionDict || {}
             delete pageConfig.optionDict
+
+            // 处理配置字符串映射
             let mainConfigStr = stringify.default(pageConfig, { indent: 4, maxLength: 200 })
                 .replace(/"(\w+)":/g, '$1:')
                 .replace(/"/g, "'")
                 .replace(/['"]_CODE_([\s\S]*?)_CODE_['"]/g, '$1')
                 .replace(/_CODE_/g, '')
+
             let optionsCodeStr = ''
             Object.keys(optionDict).forEach(key => {
                 const varName = key.replace('_CODE_', '')
@@ -38,11 +48,22 @@ const watchPart = () => {
                 const arrayItemsStr = optionsArray.map(opt => `    { label: '${opt.label}', value: '${opt.value}' }`).join(',\n')
                 optionsCodeStr += `\nexport const ${varName} = [\n${arrayItemsStr}\n]\n`
             })
+
             const finalResult = `${mainConfigStr}\n${optionsCodeStr}`
             const endTime = Date.now()
-            spinner.succeed(`🤖 Pod 042: [报告] 识别程序结束！耗时 ${(endTime - startTime) / 1000} 秒\n================\n\n${finalResult}\n\n================`)
+
+            // 成功报告
+            spinner.succeed(language(
+                `🤖 Pod 042: [报告] 识别程序结束！耗时 ${(endTime - startTime) / 1000} 秒\n================\n\n${finalResult}\n\n================`,
+                `🤖 Pod 042: [Report] Recognition complete! Elapsed time: ${(endTime - startTime) / 1000}s\n================\n\n${finalResult}\n\n================`
+            ))
+
         } catch (error) {
-            spinner.fail(chalk.red(`🤖 Pod 042: [警告] 识别程序失败。原因：${error}`))
+            // 失败报告
+            spinner.fail(chalk.red(language(
+                `🤖 Pod 042: [警告] 识别程序失败。原因：${error}`,
+                `🤖 Pod 042: [Warning] Recognition failed. Reason: ${error}`
+            )))
         } finally {
             if (fs.existsSync(filePath)) {
                 fs.unlinkSync(filePath)
@@ -51,4 +72,4 @@ const watchPart = () => {
     })
 }
 
-module.exports = watchPart
+module.exports = watchPart

package/src/prompts/watch-api.js

@@ -8,4 +8,5 @@ responseStr是后端的真实响应。
 请只输出一个JSON对象, Key为前端猜测的旧名字, Value为Response里的真实新名字。
 例如：{"key_1": "key1"}
 如果没有找到对应的，请不要包含在结果中。
-`.trim()
+注意：⚠️⚠️如果有语义相近的两个字段优先取中文字段，比如"createByName"和"createBy"，则取"createByName"
+。`.trim()

package/src/services/llm.js

@@ -1,16 +1,15 @@
 const fs = require('fs')
 const path = require('path')
 const JSON5 = require('json5')
-const sharp = require('sharp') // 图片压缩库，用于处理截图
+const sharp = require('sharp')
 const chalk = require('chalk')
 const OpenAI = require('openai')
-const { getConfig } = require('../utils/utils.js')
+const { getConfig, language } = require('../utils/utils.js') // 导入语言助手
 
 let client = null
 
 /**
  * 获取 OpenAI 客户端实例（单例模式）
- * 优先使用项目根目录的 .env 文件，其次使用包内的 .env
  */
 const getOpenAI = () => {
     if (!client) {
@@ -26,18 +25,18 @@ const getOpenAI = () => {
 
 /**
  * 调用 AI 模型并解析响应
- * @param {string} model - 模型名称（如 qwen3.5-plus, qwen-turbo）
- * @param {Array} messages - 对话消息数组
- * @param {number} retryCount - 重试次数
- * @returns {Object} 解析后的 JSON 对象
  */
 const askAI = async (model, messages, retryCount = 0) => {
-    // 最多重试 3 次，避免无限循环
-    if (retryCount > 3) throw new Error('YoRHa 司令部连接中断：请检查网络状态或黑盒共鸣情况。')
+    // 最终重试失败：YoRHa 司令部连接中断
+    if (retryCount > 3) {
+        throw new Error(language(
+            'YoRHa 司令部连接中断：请检查网络状态或黑盒共鸣情况。',
+            'YoRHa Command Link Severed: Check network status or Black Box resonance.'
+        ))
+    }
 
     try {
         const openai = getOpenAI()
-        // 调用 AI 模型，强制返回 JSON 格式
         const response = await openai.chat.completions.create({
             model,
             messages,
@@ -45,21 +44,26 @@ const askAI = async (model, messages, retryCount = 0) => {
         })
 
         let raw = response.choices[0].message.content.trim()
-
-        // 清理可能的 Markdown 标记（```json ... ```）
         raw = raw.replace(/^```json\n?/, '').replace(/\n?```$/, '')
-
-        // 提取 JSON 内容（支持对象和数组）
         const match = raw.match(/[\{\[][\s\S]*[\}\]]/)
-
-        // 使用 JSON5 解析（支持单引号、注释等非标准 JSON）
         return JSON5.parse(match ? match[0] : raw)
+
     } catch (err) {
         const isAuthError = err.message.includes('401') || err.message.includes('402');
         if (isAuthError) {
-            throw new Error('[系统警告] YoRHa 司令部拒绝访问：API Key 无效或额度耗尽，请检查！');
+            // 权限错误：司令部拒绝访问
+            throw new Error(language(
+                '[系统警告] YoRHa 司令部拒绝访问：API Key 无效或额度耗尽，请检查！',
+                '[SYSTEM ALERT] YoRHa Command Center Access Denied: Invalid API Key or quota exhausted!'
+            ));
         }
-        console.warn(chalk.yellow(`[系统警告] 神经云网络连接不稳，正在尝试重新链接... (第 ${retryCount + 1} 次重试)`), err.message)
+
+        // 重试警告：神经云网络连接不稳
+        console.warn(chalk.yellow(language(
+            `[系统警告] 神经云网络连接不稳，正在尝试重新链接... (第 ${retryCount + 1} 次重试)`,
+            `[SYSTEM ALERT] Neural Network instability detected. Attempting to re-establish link... (Retry #${retryCount + 1})`
+        )), err.message)
+
         return askAI(model, messages, retryCount + 1)
     }
 }
@@ -67,9 +71,6 @@ const askAI = async (model, messages, retryCount = 0) => {
 module.exports = {
     /**
      * 生成 Mock 数据
-     * @param {Array} columns - 表格列配置
-     * @param {string} fileName - 文件名
-     * @returns {string} 生成的 Mock 数据字符串
      */
     generateMock: async (columns, fileName) => {
         const config = getConfig()
@@ -85,16 +86,12 @@ module.exports = {
     },
 
     /**
-     * 识别页面截图并提取结构信息
-     * @param {string} prompt - 提示词
-     * @param {string} filePath - 截图文件路径
-     * @returns {Object} 识别后的页面配置对象
+     * 识别页面截图
      */
     recognizePage: async (prompt, filePath) => {
         const config = getConfig()
         const { UI_DESIGNER } = require('../prompts/system.js')
 
-        // 压缩图片到 1280px 宽度（避免超出 token 限制），质量 80%
         const compressedBuffer = await sharp(filePath)
             .resize(1280, null, { withoutEnlargement: true })
             .jpeg({ quality: 80 })
@@ -117,10 +114,7 @@ module.exports = {
     },
 
     /**
-     * 对齐 Response 接口字段与前端字段
-     * @param {string} responseStr - 真实接口响应数据
-     * @param {string} resourceStr - 前端 resource.js 内容
-     * @returns {Object} 字段映射对象 { oldName: newName }
+     * 对齐 Response 接口字段
      */
     alignResponseFields: async (responseStr, resourceStr) => {
         const config = getConfig()

package/src/utils/utils.js

@@ -1,6 +1,9 @@
 const fs = require('fs')
 const path = require('path')
 
+const isCN = Intl.DateTimeFormat().resolvedOptions().locale.includes('zh')
+const language = (zh, en) => (isCN ? zh : en)
+
 /**
  * 获取项目配置信息
  * 优先读取项目根目录的 config.js，如果不存在则使用默认配置
@@ -106,4 +109,4 @@ const copyTemplateDir = (options, templateSubDir, targetSubDir) => {
 }
 
 // 导出工具函数
-module.exports = { getConfig, cleanCode, getExistingMenus, copyTemplateDir, generateSmartImports }
+module.exports = { language, getConfig, cleanCode, getExistingMenus, copyTemplateDir, generateSmartImports }