velxio/frontend/src/i18n/locales/zh-cn/docs.json

352 lines
20 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
"docs": {
"components": {
"label": "// 参考",
"heading": "组件参考",
"lead": "Velxio 附带 <strong>48 多个交互式电子组件</strong>,由 <a>wokwi-elements</a> 驱动。所有组件均可放置在仿真画布上,通过导线连接,并与您的 Arduino 草图实时交互。",
"addingHeading": "添加组件",
"adding1": "点击仿真画布上的 <strong>+</strong> 按钮。",
"adding2": "在组件选择器中使用 <strong>搜索</strong> 或按 <strong>类别</strong> 浏览。",
"adding3": "点击组件将其放置在画布上。",
"adding4": "<strong>拖动</strong> 以重新定位;点击打开 <strong>属性对话框</strong>。",
"connectingHeading": "连接组件",
"connecting1": "点击任意组件上的 <strong>引脚</strong>,导线从该引脚开始。",
"connecting2": "点击 <strong>目标引脚</strong> 完成连接。",
"connecting3": "导线按信号类型 <strong>颜色编码</strong>:",
"thColor": "颜色",
"thSignalType": "信号类型",
"colorRed": "红色",
"colorBlack": "黑色",
"colorBlue": "蓝色",
"colorGreen": "绿色",
"colorPurple": "紫色",
"colorGold": "金色",
"colorOrange": "橙色",
"colorCyan": "青色",
"sigVcc": "VCC(电源)",
"sigGnd": "GND(地)",
"sigAnalog": "模拟",
"sigDigital": "数字",
"sigPwm": "PWM",
"sigI2c": "I2C(SDA/SCL)",
"sigSpi": "SPI(MOSI/MISO/SCK)",
"sigUsart": "USART(TX/RX)",
"categoriesHeading": "组件类别",
"outputHeading": "输出",
"thComponent": "组件",
"thDescription": "描述",
"compLed": "LED",
"compLedDesc": "单色 LED,颜色可配置",
"compRgbLed": "RGB LED",
"compRgbLedDesc": "三色 LED(红、绿、蓝通道)",
"comp7Seg": "7 段数码管",
"comp7SegDesc": "单数字显示",
"compLcd16x2": "LCD 16x2",
"compLcd16x2Desc": "2 行字符 LCD(I2C 或并行)",
"compLcd20x4": "LCD 20x4",
"compLcd20x4Desc": "4 行字符 LCD",
"compIli9341": "ILI9341 TFT",
"compIli9341Desc": "240x320 彩色 TFT 显示屏(SPI)",
"compBuzzer": "蜂鸣器",
"compBuzzerDesc": "无源压电蜂鸣器",
"compNeoPixel": "NeoPixel",
"compNeoPixelDesc": "独立寻址 RGB LED 灯带",
"inputHeading": "输入",
"compPushButton": "按钮",
"compPushButtonDesc": "瞬时按钮",
"compSlideSwitch": "滑动开关",
"compSlideSwitchDesc": "SPDT 滑动开关",
"compPotentiometer": "电位器",
"compPotentiometerDesc": "模拟分压器(ADC 输入)",
"compRotaryEncoder": "旋转编码器",
"compRotaryEncoderDesc": "增量式旋转编码器",
"compKeypad": "4x4 键盘",
"compKeypadDesc": "16 键矩阵键盘",
"compJoystick": "摇杆",
"compJoystickDesc": "双轴模拟摇杆",
"sensorsHeading": "传感器",
"compHcSr04": "HC-SR04",
"compHcSr04Desc": "超声波距离传感器",
"compDht22": "DHT22",
"compDht22Desc": "温湿度传感器",
"compPir": "PIR 运动",
"compPirDesc": "被动红外运动传感器",
"compPhoto": "光敏电阻",
"compPhotoDesc": "光敏电阻(LDR)",
"compIrRecv": "红外接收头",
"compIrRecvDesc": "38 kHz 红外接收器",
"passiveHeading": "无源组件",
"compResistor": "电阻",
"compResistorDesc": "标准电阻(值可配置)",
"compCapacitor": "电容",
"compCapacitorDesc": "电解电容",
"compInductor": "电感",
"compInductorDesc": "线圈电感",
"propsHeading": "组件属性",
"propsLead": "每个组件都有一个 <strong>属性对话框</strong>,可通过在画布上点击访问:",
"thProperty": "属性",
"propArduinoPin": "Arduino 引脚",
"propArduinoPinDesc": "此组件连接的数字或模拟引脚",
"propColor": "颜色",
"propColorDesc": "视觉颜色(LED、导线)",
"propValue": "值",
"propValueDesc": "组件值(例如,电阻值以欧姆为单位)",
"propRotation": "旋转",
"propRotationDesc": "以 90 度为增量旋转",
"propDelete": "删除",
"propDeleteDesc": "从画布移除组件"
},
"sectionMeta": {
"intro": {
"title": "简介 | Velxio 文档",
"description": "了解 Velxio,一款免费开源的 Arduino 仿真器,具有真实的 AVR8 和 RP2040 CPU 仿真以及 48 多个交互式电子组件。"
},
"gettingStarted": {
"title": "快速入门 | Velxio 文档",
"description": "开始使用 Velxio:使用托管编辑器、使用 Docker 自托管或设置本地开发环境。在几分钟内仿真您的第一个 Arduino 草图。"
},
"emulator": {
"title": "仿真器架构 | Velxio 文档",
"description": "Velxio 如何仿真 AVR8 (ATmega328p)、RP2040 和 RISC-V (ESP32-C3) CPU。涵盖所有支持板的执行循环、外设和引脚映射。"
},
"riscvEmulation": {
"title": "RISC-V 仿真 (ESP32-C3) | Velxio 文档",
"description": "用于 ESP32-C3、XIAO ESP32-C3 和 C3 SuperMini 的浏览器端 RV32IMC 仿真器。涵盖内存映射、GPIO、UART0、ESP32 镜像解析器、RV32IMC ISA 和测试套件。"
},
"esp32Emulation": {
"title": "ESP32 仿真 (Xtensa) | Velxio 文档",
"description": "基于 QEMU 的 ESP32 和 ESP32-S3 (Xtensa LX6/LX7) 仿真。涵盖 lcgamboa 分支、libqemu-xtensa、GPIO、WiFi、I2C、SPI、RMT/NeoPixel 和 LEDC/PWM。"
},
"components": {
"title": "组件参考 | Velxio 文档",
"description": "Velxio 中所有 48 多个交互式电子组件的完整参考:LED、显示器、传感器、按钮、电位器等。包括接线和属性详细信息。"
},
"roadmap": {
"title": "路线图 | Velxio 文档",
"description": "Velxio 的功能路线图:已实现的功能、正在开发的功能以及未来版本计划的功能。"
},
"architecture": {
"title": "项目架构 | Velxio 文档",
"description": "Velxio 系统架构的详细概述:前端、后端、AVR8 仿真流水线、数据流、Zustand 存储和导线系统。"
},
"thirdParty": {
"title": "Wokwi 库 | Velxio 文档",
"description": "Velxio 如何集成官方 Wokwi 开源库:avr8js、wokwi-elements 和 rp2040js。涵盖配置、更新和 48 个可用组件。"
},
"mcp": {
"title": "MCP 服务器 | Velxio 文档",
"description": "Velxio MCP 服务器参考:通过模型上下文协议将 AI 代理(Claude、Cursor)与 Velxio 集成。涵盖工具、传输、电路格式和示例演练。"
},
"setup": {
"title": "项目状态 | Velxio 文档",
"description": "所有已实现的 Velxio 功能的完整状态:AVR 仿真、组件系统、导线系统、代码编辑器、示例项目和后续步骤。"
},
"rp2040Emulation": {
"title": "RP2040 仿真 (Raspberry Pi Pico) | Velxio 文档",
"description": "Velxio 如何使用 rp2040js 仿真 Raspberry Pi Pico 和 Pico W:ARM Cortex-M0+ 133 MHz、GPIO、UART、ADC、I2C、SPI、PWM 和 WFI 优化。"
},
"raspberryPi3Emulation": {
"title": "Raspberry Pi 3 仿真 (QEMU) | Velxio 文档",
"description": "Velxio 如何使用 QEMU raspi3b 仿真完整的 Raspberry Pi 3B:真实的 Raspberry Pi OS、Python + RPi.GPIO 垫片、双通道 UART、VFS 和多板串行桥。"
},
"buildQemu": {
"title": "从源码构建 QEMU | Velxio 文档",
"description": "从 lcgamboa/qemu 分支编译 libqemu-xtensa 和 libqemu-riscv32 的逐步指南。AGPLv3 许可下的完全透明。"
}
},
"rp2040": {
"label": "// arm cortex-m0+",
"heading": "RP2040 仿真 (Raspberry Pi Pico)",
"lead": "Raspberry Pi Pico 和 Pico W 完全在浏览器中使用 <a>rp2040js</a> 仿真,这是一个开源的 ARM Cortex-M0+ 仿真器。无需 QEMU 或后端进程,二进制文件在 Web Worker 中以全速运行。",
"boardsHeading": "支持的板",
"boardPico": "Raspberry Pi Pico",
"altPico": "Raspberry Pi Pico",
"boardPicoW": "Raspberry Pi Pico W",
"altPicoW": "Raspberry Pi Pico W",
"thBoard": "板",
"thFqbn": "FQBN",
"thBuiltinLed": "板载 LED",
"ledGpio25": "GPIO 25",
"ledCyw43": "GPIO 25(通过 CYW43)",
"binaryHeading": "二进制格式",
"binaryBody1": "后端使用 <code>arduino-cli</code> 编译草图,目标为 <code>rp2040:rp2040:rpipico</code>,并返回 base64 编码的原始 ARM 二进制文件 (<code>.bin</code>)。与 AVR 不同,没有 Intel HEX,二进制文件直接加载到 RP2040 闪存的偏移量 0 处。",
"binaryBody2": "后端还在草图前添加 <code>#define Serial Serial1</code>,以便 Arduino <code>Serial</code> 调用重定向到 UART0(流式传输到串行监视器的虚拟串行端口)。",
"peripheralsHeading": "外设",
"thPeripheral": "外设",
"thSupport": "支持",
"thNotes": "备注",
"perGpio": "GPIO(30 个引脚)",
"supFull": "完整",
"perGpioNotes": "数字读/写、上拉/下拉",
"perUart": "UART0 / UART1",
"perUartNotes": "通过 UART0 的串行监视器",
"perAdc": "ADC(通道 0-3)",
"perAdcNotes": "GPIO 26-29;通道 4 = 温度传感器",
"perI2c": "I2C0 / I2C1",
"supPartial": "部分",
"perI2cNotes": "DS1307 RTC、温度传感器、EEPROM 虚拟设备",
"perSpi": "SPI0 / SPI1",
"supLoopback": "回环",
"perSpiNotes": "TX 环回至 RX",
"perPwm": "PWM",
"supFreqOnly": "仅频率",
"perPwmNotes": "无波形输出到组件",
"perTimer": "定时器 / 闹钟",
"perTimerNotes": "由 <code>delay()</code> 和 <code>millis()</code> 使用",
"wfiHeading": "WFI 优化",
"wfiBody": "当 CPU 执行 <strong>WFI</strong>(等待中断)指令时,仿真器将系统时钟快进到下一个预定闹钟,而不是在空闲周期中旋转。这大大减少了 <code>delay()</code> 调用期间的 CPU 使用率。",
"simLoopHeading": "仿真循环",
"simLoopBody": "仿真在 <code>requestAnimationFrame</code> 内以约 60 FPS 运行。每帧执行大约 <strong>2,200,000</strong> 个 CPU 周期(133 MHz / 60 fps)。每当引脚状态改变时,GPIO 监听器触发并更新画布上的视觉组件。",
"limitsHeading": "已知限制",
"limit1": "Pico W 无线芯片 (CYW43439) 未仿真,WiFi/蓝牙将无法工作",
"limit2": "仅 SPI 回环,无真实 SPI 设备仿真",
"limit3": "PWM 产生正确频率,但组件上无视觉波形",
"limit4": "DMA 未仿真",
"limit5": "第二个 CPU 核心(核心 1)未仿真,<code>multicore_launch_core1()</code> 无效",
"fullDocsHeading": "完整文档",
"fullDocsBody": "查看完整技术参考:<a>RP2040_EMULATION.md</a>"
},
"rpi3": {
"label": "// qemu raspi3b",
"heading": "Raspberry Pi 3 仿真 (QEMU)",
"lead": "Raspberry Pi 3B 使用 <strong>QEMU 8.1.3</strong> 和 <code>-M raspi3b</code> 仿真。这是 Velxio 中唯一运行完整操作系统的板,一个真实的 <strong>Raspberry Pi OS (Trixie)</strong> 镜像在仿真器内启动。用户编写 Python 脚本(而非 C++),由虚拟机内的真实 Python 3 解释器执行。",
"boardsHeading": "支持的板",
"boardRpi3": "Raspberry Pi 3B",
"altRpi3": "Raspberry Pi 3B",
"thBoard": "板",
"thQemuMachine": "QEMU 机器",
"thCpu": "CPU",
"boardRpi3Name": "Raspberry Pi 3B",
"cpuBcm": "BCM2837,4x Cortex-A53 @ 1.2 GHz",
"serialHeading": "双通道串行架构",
"serialLead": "QEMU 向后端暴露两个 UART 通道:",
"serialUser": "<strong>ttyAMA0</strong>:用户串行:交互式终端(串行监视器)。用户的 <code>print()</code> 输出显示在此处。",
"serialGpio": "<strong>ttyAMA1</strong>:GPIO 垫片:承载虚拟机内 GPIO 垫片与后端之间的文本协议。",
"shimHeading": "RPi.GPIO 垫片",
"shimBody1": "一个自定义的 <code>RPi.GPIO</code> 垫片被注入到虚拟机内的 <code>/usr/local/lib/python3.11/dist-packages/RPi/GPIO.py</code>。当用户代码调用 <code>GPIO.output(pin, value)</code> 时,垫片向 <strong>ttyAMA1</strong> 写入一行如 <code>GPIO 17 1</code> 的内容。后端读取此行,触发 <code>gpio_change</code> WebSocket 事件,前端更新画布上的视觉组件。",
"shimBody2": "反向操作同样有效:前端可以通过 WebSocket - 后端 - ttyAMA1 - 垫片发送 <code>SET 17 1</code>,用户代码通过 <code>GPIO.input(17)</code> 读取。",
"vfsHeading": "虚拟文件系统 (VFS)",
"vfsBody": "每个 Raspberry Pi 板实例都有自己的 VFS,映射到运行中虚拟机内的文件。默认树为:",
"overlayHeading": "覆盖镜像",
"overlayBody": "基础 Raspberry Pi OS SD 镜像从不修改。每个会话在基础镜像之上创建一个新的 <strong>qcow2 覆盖</strong>,因此所有运行时更改都是隔离的,并在会话结束时丢弃。",
"limitsHeading": "已知限制",
"limit1": "无 I2C 或 SPI 设备仿真",
"limit2": "无 PWM 波形输出到组件",
"limit3": "无网络(WiFi/以太网未仿真)",
"limit4": "会话状态不持久化,覆盖在停止时丢弃",
"limit5": "启动时间慢(约 10-20 秒),因为必须启动完整的操作系统",
"limit6": "需要在服务器上存在约 5.67 GB 的基础 SD 镜像",
"fullDocsHeading": "完整文档",
"fullDocsBody": "查看完整技术参考:<a>RASPBERRYPI3_EMULATION.md</a>"
},
"gettingStarted": {
"label": "// 设置",
"heading": "快速入门",
"lead": "按照以下步骤仿真您的第一个 Arduino 草图。",
"option1Heading": "选项 1:使用托管版本",
"option1Body": "无需安装,前往 <a>https://velxio.dev</a> 立即开始编码。",
"option2Heading": "选项 2:使用 Docker 自托管",
"option2Body": "运行单个 Docker 命令启动完全本地实例:",
"option2After": "然后在浏览器中打开 <strong>http://localhost:3080</strong>。",
"option3Heading": "选项 3:手动设置(开发)",
"option3Prereq": "<strong>先决条件:</strong> Node.js 18+、Python 3.12+、<code>arduino-cli</code>",
"option3Step1": "1. 克隆仓库",
"option3Step2": "2. 启动后端",
"option3Step3": "3. 启动前端",
"option3Step3After": "打开 <strong>http://localhost:5173</strong>。",
"option3Step4": "4. 设置 arduino-cli(首次)",
"firstSimulationHeading": "您的第一次仿真",
"firstSim1": "<strong>打开编辑器</strong> 在 <a>velxio.dev/editor</a>。",
"firstSim2": "<strong>从工具栏选择板</strong>(例如 <em>Arduino Uno</em>)。",
"firstSim3": "<strong>在 Monaco 编辑器中编写 Arduino 代码</strong>,例如:",
"firstSim4": "<strong>点击编译</strong>:后端调用 <code>arduino-cli</code> 并返回 <code>.hex</code> 文件。",
"firstSim5": "<strong>点击运行</strong>:AVR8 仿真器执行编译后的程序。",
"firstSim6": "<strong>使用组件选择器添加组件</strong>(点击画布上的 <strong>+</strong> 按钮)。",
"firstSim7": "<strong>连接导线</strong>:点击一个组件引脚,然后点击另一个引脚。",
"troubleshootingHeading": "故障排除",
"thProblem": "问题",
"thSolution": "解决方案",
"tsArduinoCliMissingProblem": "<code>arduino-cli: command not found</code>",
"tsArduinoCliMissingSolution": "安装 <code>arduino-cli</code> 并将其添加到 PATH。",
"tsLedNoBlinkProblem": "LED 不闪烁",
"tsLedNoBlinkSolution": "检查浏览器控制台是否有端口监听器错误;在组件属性对话框中验证引脚分配。",
"tsSerialEmptyProblem": "串行监视器为空",
"tsSerialEmptySolution": "确保在 <code>setup()</code> 中调用 <code>Serial.begin()</code>,然后再调用任何 <code>Serial.print()</code>。",
"tsCompileErrorsProblem": "编译错误",
"tsCompileErrorsSolution": "检查编辑器底部的编译控制台,查看完整的 <code>arduino-cli</code> 输出。"
},
"thirdParty": {
"label": "// 开源库",
"heading": "Wokwi 库",
"lead": "Velxio 使用官方 Wokwi 开源仓库,本地克隆在 <code>third-party/</code> 中。这为您提供最新、兼容的仿真引擎和视觉组件,无需 npm 注册表依赖。",
"clonedHeading": "克隆的仓库",
"thLibrary": "库",
"thLocation": "位置",
"libElementsDesc": "48 多个 Lit Web 组件(LED、LCD、传感器、按钮...)",
"libAvr8jsDesc": "ATmega328p / ATmega2560 CPU 仿真器,16 MHz",
"libRp2040jsDesc": "Raspberry Pi Pico (RP2040) 仿真器",
"npmIntro": "所有三个库均由 <code>frontend/package.json</code> 直接从 npm 注册表拉取。参考克隆可能位于 <code>third-party/</code> 下,用于致谢和离线修改,但构建不需要它们。",
"updatingHeading": "更新库",
"updatingBody": "编辑 <code>frontend/package.json</code> 中的版本锁定(<code>@wokwi/elements</code>、<code>avr8js</code>、<code>rp2040js</code>),然后在 <code>frontend/</code> 中运行 <code>npm install</code>。",
"afterBumpHeading": "在升级 wokwi-elements 后(仅当添加新组件时)",
"afterBumpBody": "元数据生成器扫描上游的 <code>src/</code>,而 npm 包不包含该目录。将 wokwi-elements 克隆到 <code>third-party/</code> 一次并重新生成:",
"availableHeading": "可用的 Wokwi 组件(48 个)",
"thCategory": "类别",
"thComponents": "组件",
"catBoards": "板",
"catBoardsList": "Arduino Uno、Mega、Nano、ESP32 DevKit",
"catSensors": "传感器",
"catSensorsList": "DHT22、HC-SR04、PIR、光敏电阻、NTC、摇杆",
"catDisplays": "显示器",
"catDisplaysList": "LCD 16x2、LCD 20x4、7 段数码管",
"catInput": "输入",
"catInputList": "按钮、6mm 按钮、滑动开关、8 位 DIP 开关、电位器",
"catOutput": "输出",
"catOutputList": "LED、RGB LED、LED 条形图、蜂鸣器、NeoPixel",
"catMotors": "电机",
"catMotorsList": "舵机、步进电机",
"catPassive": "无源",
"catPassiveList": "电阻、滑动电位器、LED 环、矩阵键盘",
"catOther": "其他",
"catOtherList": "红外接收头、DS1307 RTC、面包板等",
"howAvrHeading": "avr8js 如何驱动仿真",
"fullDetailsCallout": "<strong>完整详情:</strong> 参见仓库中的 <a>docs/WOKWI_LIBS.md</a>。"
},
"mcp": {
"label": "// AI 集成",
"heading": "MCP 服务器",
"lead": "Velxio 暴露了一个 <a>模型上下文协议</a> (MCP) 服务器,允许 AI 代理(Claude、Cursor 等)直接创建电路、生成代码和编译 Arduino 草图。",
"toolsHeading": "可用工具",
"thTool": "工具",
"toolCompileDesc": "编译 Arduino 草图文件 - Intel HEX / 二进制",
"toolRunDesc": "编译并将工件标记为仿真就绪",
"toolImportDesc": "解析 Wokwi <code>diagram.json</code> - Velxio 电路",
"toolExportDesc": "序列化 Velxio 电路 - Wokwi <code>diagram.json</code>",
"toolCreateDesc": "创建新的电路定义",
"toolUpdateDesc": "将更改合并到现有电路",
"toolGenerateDesc": "从电路生成入门 <code>.ino</code> 代码",
"transportHeading": "传输选项",
"stdioHeading": "1. stdio:Claude Desktop / CLI 代理",
"stdioConfigBody": "Claude Desktop 配置(<code>~/.claude/claude_desktop_config.json</code>):",
"sseHeading": "2. SSE / HTTP:Cursor IDE / Web 代理",
"sseConfigBody": "MCP 客户端配置:",
"circuitFormatHeading": "电路数据格式",
"circuitFormatLead": "Velxio 电路是纯 JSON 对象:",
"fqbnHeading": "支持的板 FQBN",
"thFqbn": "FQBN",
"exampleHeading": "示例:从零开始闪烁 LED",
"setupHeading": "设置",
"fullRefCallout": "<strong>完整参考:</strong> 参见仓库中的 <a>docs/MCP.md</a>。"
},
"pagesNav": {
"home": "首页",
"editor": "编辑器",
"examples": "示例"
},
"toggleSidebar": "切换侧边栏",
"viewOnGitHub": "在 GitHub 上查看",
"pageTitle": "文档",
"pages": "页面"
}
}