Superpowers-zh：为中文开发者深度本地化的开源游戏引擎解决方案-平芜编程栈

1. 项目概述：一个为中文开发者量身定制的“超能力”工具箱

如果你是一名中文开发者，或者对游戏开发、交互式应用创作感兴趣，那么你很可能听说过“Superpowers”这个开源项目。它是一个功能强大的实时协作2D/3D游戏引擎和IDE，以其直观的界面和强大的脚本系统而闻名。然而，对于母语是中文的开发者来说，直接使用英文原版总会遇到一些门槛：文档理解需要时间、社区讨论需要翻译、一些深层的概念需要反复琢磨。这就是jnMetaCode/superpowers-zh这个项目诞生的核心原因。它不是一个简单的语言包替换，而是一个深度本地化的、旨在为中文社区提供“超能力”的完整解决方案。

简单来说，superpowers-zh是 Superpowers 引擎及其生态的中文增强版本。它的目标非常明确：降低中文开发者的学习和使用门槛，将 Superpowers 的强大能力无缝地、更接地气地交付给每一位中文用户。这个项目不仅仅是将界面文字翻译成中文，更包含了中文文档的整理、社区资源的本地化整合，以及针对中文开发环境的一些适配和优化。你可以把它理解为一个“开箱即用”的中文超级工具箱，里面装满了经过精心打磨的工具和说明书，让你能更快地投入到创意实现中，而不是在语言障碍和环境配置上耗费精力。

这个项目适合谁呢？首先，当然是所有对 Superpowers 引擎感兴趣的中文开发者，无论你是想制作独立游戏、交互式艺术装置，还是教育类应用。其次，它也适合那些对游戏开发感兴趣，但被 Unity 或 Unreal Engine 的庞大和复杂所劝退的初学者。Superpowers 的轻量化和友好性，加上superpowers-zh的中文支持，形成了一个极佳的学习和实践入口。最后，对于教育工作者和团队协作来说，一个全中文的环境能显著提升沟通和教学效率。接下来，我将为你深度拆解这个项目的核心价值、实现思路以及如何最大化地利用它。

2. 项目核心价值与设计思路拆解

2.1 为什么需要深度本地化，而非简单翻译？

很多开源项目的本地化工作止步于界面文字的替换，这固然有用，但远远不够。superpowers-zh项目的设计思路显然走得更深。它认识到，对于开发工具而言，真正的障碍往往存在于三个层面：操作界面、学习资料和社区生态。

首先，操作界面的翻译需要结合开发语境。例如，“Sprite”翻译成“精灵”是游戏开发圈的共识，但“Shader”是译作“着色器”还是保留原文？superpowers-zh需要做出符合中文开发者习惯的统一选择，并在整个UI中保持一致，避免术语混乱。其次，学习资料是更大的挑战。Superpowers 的官方教程、API文档、示例项目都是英文的。superpowers-zh的价值在于系统地整理、翻译甚至重写这些资料，使其更符合中文学习者的思维习惯，补充必要的背景知识。最后是社区生态，包括问题解答、插件分享、最佳实践等。项目通过建立中文社区（如GitHub讨论区、可能的QQ群或论坛），将分散的中文用户聚集起来，形成知识沉淀和互助的良性循环。

注意：深度本地化意味着巨大的工作量，不仅仅是文本转换，更是文化和思维习惯的适配。这要求维护者不仅英语好，更要精通 Superpowers 引擎本身和游戏开发。

2.2 技术实现路径：从代码仓库到可执行程序

jnMetaCode/superpowers-zh作为一个GitHub仓库，其技术实现路径清晰且务实。它并非从零重写引擎，而是以官方 Superpowers 项目为基础，进行“覆盖式”或“注入式”的改造。

核心路径一：资源文件替换与构建流程整合。Superpowers 的客户端界面是基于 Web 技术（HTML/CSS/JS）构建的。本地化的核心工作之一，就是找到所有包含用户界面文本的资源文件（通常是.json语言文件或直接写在.html/.ts中的字符串），将其替换为中文版本。superpowers-zh项目仓库里，最核心的资产就是这些翻译好的资源文件。为了便于用户使用，项目通常会提供几种交付方式：

预编译二进制包：最用户友好的方式。维护者定期拉取官方最新代码，将中文资源合并进去，然后执行完整的构建流程（通常涉及 Node.js, Gulp 等工具链），生成针对 Windows、macOS、Linux 的安装包或绿色版可执行文件。用户下载后直接解压运行，无需关心背后过程。
构建脚本与指南：为高级用户和贡献者准备。仓库中会提供详细的构建脚本（如build.ps1,build.sh）和文档，指导用户如何克隆官方源码、替换中文资源、安装依赖并自行构建。这种方式保证了透明度和可复现性。
插件化语言包（如果引擎支持）：这是一种更优雅但依赖引擎架构的方式。如果 Superpowers 引擎设计时支持动态加载语言包，那么superpowers-zh可以打包成一个插件，用户只需在已安装的官方版中启用该插件即可切换语言。这需要与官方架构深度契合。

核心路径二：文档与生态建设。这部分工作独立于代码构建，但同样重要。项目会在docs或wiki目录下维护结构化的中文文档，可能包括：

安装与启动指南：针对不同操作系统，图文并茂。
核心概念教程：场景（Scene）、游戏对象（Game Object）、组件（Component）、脚本（Script）等概念的详细中文阐释。
API 参考手册：对内置的 TypeScript API 进行翻译和注释，这是开发者最常查阅的资料。
示例项目解析：对官方示例进行汉化，并添加中文注释，讲解关键实现逻辑。
常见问题解答（FAQ）：收集整理中文社区中的典型问题。

通过这两条路径的结合，superpowers-zh将一个英文开源项目，转化成了一个对中文用户而言“可接近、可学习、可使用”的完整产品。

3. 核心模块与功能深度解析

3.1 客户端界面汉化：细节决定体验

客户端的汉化是用户最直接的感知点。superpowers-zh在这方面需要处理成千上万个字符串，涵盖主编辑器、资源管理器、属性检查器、动画编辑器、脚本编辑器等所有面板。

菜单与工具栏：这是最高频的操作区域。翻译必须准确且符合软件操作惯例。例如，“File”译为“文件”，“Edit”译为“编辑”，“View”译为“视图”，“Project”译为“项目”，“Window”译为“窗口”，“Help”译为“帮助”。工具栏图标提示（Tooltip）的翻译也很关键，需要简洁明了地说明功能。

对话框与提示信息：包括创建新项目的向导、保存确认对话框、错误警告提示等。这里的翻译需要特别注意语气和清晰度。例如，错误信息“Failed to compile script”翻译为“脚本编译失败”是准确的，但如果能补充可能的原因，如“脚本编译失败，请检查第X行语法”，则体验更佳。这要求本地化团队对引擎的报错机制有深入了解。

属性检查器（Inspector）：这是配置游戏对象和组件的核心面板。每个属性的名称（如“Transform.position.x”）和提示文本都需要翻译。难点在于一些专业术语和引擎特定概念。例如，“Prefab”可能译为“预制体”，“Rigidbody”译为“刚体”，“Collider”译为“碰撞体”。保持与行业通用译法一致非常重要，能减少开发者的认知负担。

脚本编辑器与智能感知：对于使用 TypeScript 编写游戏逻辑的开发者来说，代码编辑器的体验至关重要。superpowers-zh可能需要对代码智能感知（IntelliSense）中的描述文本进行汉化。例如，当鼠标悬停在一个 API 上时，弹出的文档说明如果是中文的，将极大提升学习效率。这涉及到对 TypeScript 声明文件（.d.ts）中注释的翻译。

实操心得：

保持一致性：建立一份术语对照表并严格遵守，避免同一个英文词在不同地方被翻译成不同的中文。
上下文考量：同一个英文单词在不同上下文可能有不同译法。例如，“Asset”在资源管理器中译为“资源”，在“Asset Store”中可能译为“资源商店”或“资产商店”。
测试驱动：每完成一个模块的翻译，都需要启动客户端进行全功能测试，确保翻译没有导致界面布局错乱（文字长度变化可能导致）、功能误解或死链。

3.2 文档体系构建：从入门到精通

如果说界面汉化是“授人以鱼”，那么文档体系建设就是“授人以渔”。superpowers-zh的文档是其核心价值的重要组成部分。

结构化知识库：优秀的文档不是零散文章的堆砌，而是一个有层次的结构。通常可以按以下结构组织：

快速入门：用最短的路径让用户创建一个可运行的项目，看到效果，建立信心。
核心概念详解：深入讲解引擎的架构思想，如实体组件系统（ECS）思想在 Superpowers 中的体现、资源管理流程、场景图（Scene Graph）等。
分模块教程：
- 图形与渲染：精灵、瓦片地图、粒子系统、灯光、摄像机的使用。
- 物理与碰撞：刚体、碰撞体、关节、物理材质的配置与脚本交互。
- 音频系统：音效、背景音乐的导入与控制。
- 用户界面：内置UI系统的使用，制作游戏内的HUD、菜单。
- 脚本编程：TypeScript 基础、引擎API详解、常用设计模式（如状态机、事件系统）。
项目实战：带领用户从头到尾完成一个小型游戏（如打地鼠、平台跳跃），将分散的知识点串联起来。
API 权威参考：以字典形式列出所有可用的类、方法、属性，并附上详细说明、参数列表和代码示例。

形式多样化：纯文本教程是基础，但superpowers-zh可以做得更好。结合截图、GIF动图、甚至录制视频教程，能多维度地降低学习难度。特别是对于动画编辑器、粒子编辑器这类可视化操作，动态演示比文字描述有效得多。

社区化维护：文档的生命力在于更新。可以借助 GitHub 的 Wiki 功能或类似工具，允许社区成员共同维护和修正文档。设立“文档贡献指南”，鼓励用户提交修改建议或翻译补全。

3.3 社区与生态整合：让工具充满活力

一个没有生态的工具是孤独的。superpowers-zh项目的一个重要使命是培育中文社区生态。

问题解答与知识沉淀：在 GitHub Issues 或 Discussions 中设立中文分类，鼓励用户用中文提问。维护者和社区活跃用户用中文解答。久而久之，这里就会形成一个高质量的中文知识库。常见问题可以整理到 FAQ 或文档中。

插件与资源分享：Superpowers 支持插件扩展。可以鼓励中文开发者制作并分享中文插件，或者将优秀的英文插件进行汉化。同样，可以收集和推荐适合中文开发者的免费或付费资源（如音效、美术素材、字体），并注明版权和使用须知。

示例项目库：除了官方示例，社区可以贡献更多贴近中文开发者需求的小例子。比如，如何实现中文文本渲染（处理字体和排版）、如何接入国内常见的第三方服务等。这些示例项目是最好的学习材料。

线上线下活动：如果条件允许，可以组织线上的分享会、代码竞赛，甚至线下的开发者聚会。这能极大地增强社区凝聚力和项目影响力。

实操心得：

树立榜样：维护者需要以身作则，积极、友好地回应社区问题，营造开放、互助的氛围。
设立规则：明确的社区行为准则（如提问前先搜索、提供最小可复现例子）能提升交流效率。
善用工具：利用 GitHub Projects 管理开发路线图，用 Discord 或类似工具建立实时交流频道，用博客分享深度技术文章。

4. 从零开始使用与贡献指南

4.1 普通用户：如何获取与安装

对于绝大多数只想使用中文版 Superpowers 的开发者来说，最关心的就是如何快速上手。

第一步：获取发行版

访问jnMetaCode/superpowers-zh的 GitHub 仓库页面。
在仓库的Releases（发布）页面，找到最新的稳定版本。通常维护者会提供编译好的程序包。
根据你的操作系统，下载对应的压缩包（如superpowers-zh-win64-v1.0.0.zip用于 Windows，superpowers-zh-macos-v1.0.0.dmg用于 macOS，superpowers-zh-linux64-v1.0.0.tar.gz用于 Linux）。

第二步：安装与运行

Windows：解压下载的 ZIP 文件到任意目录（建议路径不要有中文或空格）。进入解压后的文件夹，直接双击Superpowers.exe即可运行。你可以为其创建桌面快捷方式。
macOS：打开下载的.dmg文件，将Superpowers.app拖拽到“应用程序”文件夹中。之后可以从启动台或应用程序文件夹中打开它。首次打开可能需要在“系统偏好设置”->“安全性与隐私”中允许运行。
Linux：解压 TAR.GZ 文件，进入目录，在终端中执行./Superpowers脚本文件来启动程序。你可能需要先赋予该文件执行权限：chmod +x Superpowers。

第三步：首次运行与项目创建

首次启动会要求你选择一个文件夹作为“服务器数据目录”，用于存放你的所有项目、设置和缓存。选择一个空间充足的磁盘位置即可。
进入主界面后，点击“新建项目”，选择模板（如“Empty Project”空项目或“2D Platformer”2D平台游戏示例），输入项目名称和位置，即可开始创作。

提示：如果从 Releases 下载的预编译版本遇到问题（如启动崩溃），请首先检查是否安装了必要的运行时环境（如 Windows 的 VC++ Redistributable）。详细说明通常会在 Release 的说明文本或项目的 Wiki 中给出。

4.2 进阶用户：如何从源码构建

如果你想体验最新特性，或者希望为项目贡献代码，就需要从源码构建。这需要一些开发环境准备。

环境准备：

Git：用于克隆代码仓库。
Node.js 和 npm：Superpowers 的构建系统基于 Node.js。请安装 LTS 版本。
平台特定工具：
- Windows：可能需要安装 Python 2.7 和 Visual Studio Build Tools（包含 C++ 编译环境）。
- macOS：需要安装 Xcode Command Line Tools（在终端运行xcode-select --install）。
- Linux：需要安装 GCC、G++、Make 等基础开发工具，以及可能需要的库（如 libudev, libpng 等）。

构建步骤：

克隆仓库：打开终端或命令行，执行git clone https://github.com/jnMetaCode/superpowers-zh.git克隆主仓库。如果需要特定版本，可以切换分支或标签。
获取子模块：Superpowers 可能依赖一些子模块。进入克隆的目录，执行git submodule update --init --recursive。
安装依赖：运行npm install来安装所有 Node.js 依赖包。这个过程可能需要一些时间。
执行构建：运行项目提供的构建脚本。根据仓库说明，可能是npm run build、gulp build或一个特定的脚本文件（如scripts/build.js）。构建脚本会自动处理资源合并、代码编译和打包。
生成可执行文件：构建成功后，输出通常会在build或dist目录下，里面就是可以运行的 Superpowers 程序。

踩坑记录：

网络问题：npm install可能会因为网络原因失败，特别是某些包托管在外部。可以尝试配置 npm 镜像源（如淘宝镜像）。
原生模块编译失败：如果依赖了需要编译的原生 Node 模块（如node-gyp），请确保你的平台编译工具链（如 Windows 的 VS Build Tools）已正确安装且版本匹配。
路径与权限：确保构建路径没有特殊字符，并且在 Linux/macOS 下有足够的文件操作权限。

4.3 贡献者：如何参与翻译与改进

superpowers-zh是一个开源项目，欢迎所有人的贡献。即使你不懂编程，也可以参与翻译工作。

参与翻译：

找到翻译文件：界面文本通常存放在src/locales/或assets/locales/目录下，可能是.json或.po格式。文档则存放在docs/目录下，是 Markdown 文件。
Fork 仓库：在 GitHub 上点击 Fork 按钮，创建你自己账户下的副本。
创建分支：在你的副本中，为你的修改创建一个新的分支（如zh-translation-fix）。
进行修改：使用文本编辑器修改对应的翻译文件。对于.json文件，只修改"value"字段后面的字符串，保持键名不变。确保翻译准确、通顺、符合上下文。
提交与推送：将修改提交到你的分支，并推送到你的 GitHub 仓库。
发起 Pull Request：在你的仓库页面，点击“Compare & pull request”，向原jnMetaCode/superpowers-zh仓库的主分支发起合并请求。在 PR 描述中清晰说明你修改了哪些内容以及原因。

报告问题与建议：

使用 GitHub Issues 功能。在提交前，先搜索是否已有类似问题。
清晰描述问题：包括操作系统版本、Superpowers-zh 版本、复现步骤、期望结果和实际结果。如果能附上截图或错误日志，将极大帮助维护者定位问题。
对于新功能建议，可以先在 Discussions 中讨论，获得社区反馈后再考虑是否提交 Issue。

实操心得：

从小处着手：第一次贡献可以从修正一个错别字、翻译一两个文件开始，熟悉流程。
沟通很重要：在 Issues 或 PR 中友好地讨论，尊重维护者和社区其他成员的意见。
保持同步：在开始大量翻译工作前，先拉取最新的上游代码，避免与别人的工作产生冲突。

5. 实战应用：用 Superpowers-zh 快速创建你的第一个2D游戏

理论说得再多，不如动手做一遍。让我们用一个最简单的“点击得分”游戏作为例子，全程使用 Superpowers-zh 中文版，体验其完整的工作流。

项目目标：创建一个场景，屏幕上有一个可点击的精灵（比如一个宝石）。每次点击它，得分增加，并且精灵会随机移动到屏幕的新位置。

第一步：创建项目与熟悉界面

启动 Superpowers-zh，创建一个新的“Empty 2D”项目，命名为“ClickGem”。
主界面分为几个主要面板：左上角是“资源管理器”，显示项目文件树；中间是“场景编辑器”和“游戏预览”视图；右侧是“属性检查器”；底部可能有“控制台”和“动画编辑器”。花几分钟时间，将鼠标悬停在各个按钮和菜单上，熟悉中文界面。

第二步：导入资源与创建精灵

准备一张宝石的图片（PNG格式，带透明背景），或者从免费资源网站找一个。将其拖拽到资源管理器的assets文件夹内，完成导入。
在资源管理器中右键点击assets，选择“新建 -> 精灵”。命名为“GemSprite”。
在属性检查器中，点击“纹理”旁边的选择按钮，选择你刚导入的宝石图片。系统会自动根据纹理创建精灵的帧。
调整“原点”（Origin）为精灵的中心（如0.5, 0.5），这样旋转和缩放会以中心为基准。

第三步：构建游戏场景

在资源管理器中，右键点击scenes文件夹，选择“新建 -> 场景”，命名为“Main”。
双击“Main”场景，在场景编辑器中打开它。
从资源管理器中将“GemSprite”拖拽到场景编辑器中。你会在左侧的“场景树”中看到一个名为“GemSprite”的实体。
选中这个实体，在属性检查器中，将其重命名为“Gem”。你可以在这里调整它的位置（Transform）。

第四步：添加交互逻辑（编写脚本）

在资源管理器中，右键点击scripts文件夹，选择“新建 -> 脚本”，命名为“GemBehavior”。
双击打开脚本，你会看到一个基于 TypeScript 的类模板。Superpowers-zh 的脚本编辑器应该提供了中文的API提示。

编写以下逻辑：

// GemBehavior.ts // 这个脚本将附加到宝石精灵上，处理点击事件 // 定义一个组件类，继承自Sup.Behavior class GemBehavior extends Sup.Behavior { // 得分变量，声明为公开属性，方便在编辑器里调整（可选） score: number = 0; // awake方法在组件被创建时调用一次 awake() { // 初始化时，可以在这里做一些设置 } // update方法在每一帧都会被调用 update() { // 检查鼠标左键是否在这一帧被按下 if (Sup.Input.wasMouseButtonJustPressed(0)) { // 获取鼠标在屏幕上的位置 let mousePosition = Sup.Input.getMousePosition(); // 将屏幕坐标转换为场景中的世界坐标（假设使用正交相机） let worldPosition = Sup.App.getCurrentScene().camera.screenToWorld(mousePosition); // 获取这个精灵实体的轴对齐包围盒 let actor = this.actor; let aabb = actor.getLocalBounds().transform(actor.getGlobalTransform()); // 检查鼠标点击的世界坐标是否在精灵的包围盒内 if (aabb.contains(worldPosition)) { // 点击到了宝石！ this.score += 1; console.log(`得分！当前总分：${this.score}`); // 将宝石移动到屏幕内的一个随机新位置 // 假设游戏视图大小是16x9（单位），我们留出一些边距 let newX = Sup.Math.Random.float(-7, 7); let newY = Sup.Math.Random.float(-4, 4); this.actor.setPosition(newX, newY); } } } } // 将组件注册到引擎，这样才能在编辑器里找到它 Sup.registerBehavior(GemBehavior);

保存脚本。

第五步：关联脚本与测试

回到场景编辑器，选中“Gem”实体。
在属性检查器底部，点击“添加组件”按钮。
在弹出的列表中，你应该能看到“GemBehavior”。选择它，这个脚本组件就被添加到了宝石实体上。
点击编辑器上方的“运行游戏”按钮（一个三角形的播放图标）。
游戏预览窗口会弹出。现在，点击屏幕上的宝石，你会在控制台看到得分增加，并且宝石会随机跳跃到新位置。

第六步：完善与发布

显示得分：目前得分只在控制台显示。我们可以创建一个UI文本来实时显示。使用“新建 -> 用户界面 -> 文本”来创建一个文本实体，并编写脚本在每次得分更新时修改其文本内容。
添加音效：导入一个点击音效，在宝石被点击时播放Sup.Audio.playSound(“clickSound”)。
美化游戏：添加背景图片、粒子效果（点击时迸发火花）等。
构建发布：当游戏完成后，点击主菜单“项目 -> 构建...”，选择目标平台（Web、Windows、macOS等），Superpowers 会打包生成可独立分发的游戏文件。

通过这个简单流程，你可以切身感受到 Superpowers-zh 带来的便利：全中文的界面让你专注于创作逻辑，而不是查找菜单；中文的API提示和文档（如果已整合）让你更快地理解函数用途。这正是jnMetaCode/superpowers-zh项目价值的直接体现。

6. 常见问题与故障排除实录

在实际使用 Superpowers-zh 或参与贡献的过程中，你可能会遇到一些问题。这里记录了一些常见情况及排查思路。

6.1 安装与启动问题

问题1：下载的预编译版启动即崩溃或闪退。

排查思路：
1. 检查运行库：在 Windows 上，确保安装了最新版的 Visual C++ Redistributable。在 macOS 上，检查是否来自未识别的开发者，需要在“安全性与隐私”中允许。在 Linux 上，检查是否有缺失的动态链接库，可以使用ldd Superpowers命令查看。
2. 查看日志：Superpowers 通常会在其数据目录（首次运行时选择的目录）或临时目录下生成日志文件。查找名为log.txt或output_log.txt的文件，里面的错误信息是关键的排查线索。
3. 兼容性模式：尝试以管理员身份运行，或为可执行文件设置兼容性模式（Windows）。
4. 杀毒软件拦截：临时禁用杀毒软件或防火墙，看是否被误判。

问题2：从源码构建失败，报错关于node-gyp或原生模块。

排查思路：
1. 确认环境：严格按构建说明检查 Node.js 版本、Python 版本（可能需要 2.7）以及平台编译工具（Windows: VS Build Tools, macOS: Xcode CLT, Linux: build-essential）是否已安装且版本匹配。
2. 清理缓存：运行npm cache clean --force，然后删除node_modules文件夹，重新执行npm install。
3. 网络代理：如果使用代理，确保 npm 已正确配置代理设置。
4. 查看详细错误：构建命令后添加--verbose参数获取更详细的错误输出。

6.2 使用过程中的问题

问题3：脚本编辑器中的中文API提示不完整或没有。

可能原因：本地化工作尚未覆盖全部的.d.ts声明文件，或者你的项目使用的是旧版本的引擎核心。
解决方案：
1. 确保你使用的是最新的superpowers-zh发行版。
2. 检查项目设置中引用的 TypeScript 定义文件路径是否正确。
3. 如果自行构建，确认在构建过程中，中文的声明文件是否被正确复制到了输出目录的相应位置。

问题4：导入的图片或音效资源在游戏中不显示或无法播放。

排查思路：
1. 资源格式：检查资源文件格式是否受支持（如图片 PNG/JPG，音效 WAV/OGG/MP3）。注意某些格式可能需要特定编码。
2. 导入设置：在资源管理器中选中该资源，查看属性检查器。对于图片，检查“过滤模式”、“包裹模式”是否合适；对于音效，检查是否被正确标记为“流式”或“静态”。
3. 引用路径：在脚本中引用资源时，路径字符串是否正确？例如Sup.load(“assets/myImage”, ...)。
4. 文件损坏：尝试重新导入或使用另一个文件测试。

问题5：游戏在构建发布后运行效果与编辑器内预览不一致。

排查思路：
1. 分辨率与缩放：发布版有固定的窗口或画布大小，而编辑器预览可能是自由缩放的。检查相机（Camera）的尺寸和渲染设置。
2. 资源路径：发布后资源路径发生变化。确保所有资源都是通过Sup.load等引擎API加载，而不是使用绝对路径或相对路径直接访问文件系统。
3. 外部依赖：如果使用了第三方 JavaScript 库，需要确保它们被正确打包进发布版本中。

6.3 贡献与开发问题

问题6：翻译提交后，在构建的界面中不生效。

排查思路：
1. 文件位置：确认翻译文件被放在了正确的源目录（如src/locales/zh/），而不是构建输出目录。
2. 文件格式：检查 JSON 文件格式是否正确，无语法错误（如缺少逗号、引号不匹配）。可以使用在线 JSON 校验工具。
3. 键名对应：确保你修改的是对应语言文件的正确键值对，键名必须与英文原版完全一致。
4. 构建流程：确认你的修改是否被构建流程正确处理。有时需要清理构建缓存（gulp clean或删除build文件夹）后重新构建。

问题7：想添加新功能或修复 bug，但不知道从何入手。

建议步骤：
1. 精确定位：首先在官方 Superpowers 仓库和superpowers-zh仓库的 Issues 中搜索，看是否已有相关讨论或报告。
2. 理解架构：花时间阅读官方文档和源码，理解引擎的核心模块（如SupCore,SupClient,SupEngine）是如何协作的。
3. 小范围修改：从一个非常具体、范围明确的问题开始尝试修改，例如修复一个明显的 UI 错位或文本溢出。
4. 寻求指导：在项目的 Discussions 或 Issues 中发起讨论，描述你发现的问题和初步的解决思路，维护者和其他贡献者可能会提供宝贵的指导。

维护一个像superpowers-zh这样的项目，不仅是技术工作，更是社区建设。耐心、细致的沟通和持续的热情，是解决大多数“人”的问题的关键。遇到难题时，别忘了你背后有一个正在成长的中文社区可以求助。