开发过程中常见问题的快速解答，涵盖环境配置、项目启动、开发流程等各个方面。
💡 提示：关于环境配置的详细说明和常见问题，请参考 环境搭建指南 - 常见问题。
A: 不需要！ N.E.K.O 项目使用 uv 管理 Python 依赖，uv 可以自动安装和管理 Python 版本。详见 环境搭建指南 - 常见问题。
A: 如果你使用 uv 管理的 Python，可以通过虚拟环境或 uv run 命令使用。详见 环境搭建指南 - 常见问题。
A: 检查安装和 PATH 配置。详见 环境搭建指南 - 常见问题。
A: 检查网络连接、配置镜像或磁盘空间。详见 环境搭建指南 - 常见问题。
A: Windows 可能需要设置执行策略，macOS/Linux 确保使用正确的路径。详见 环境搭建指南 - 常见问题。
A: 最低支持 Node.js 18.x，推荐使用 Node.js 20.x 或 22.x（最新 LTS 版本）。详见 环境搭建指南。
💡 提示：关于服务器启动的详细说明，请参考 环境搭建指南 - 启动服务器。
A: 至少需要启动两个服务器：记忆服务器（端口 48912）和主服务器（端口 48911）。详见 环境搭建指南 - 启动服务器。
A: 修改配置文件中的端口设置，或关闭占用端口的程序。
A: 检查服务器状态、端口配置、防火墙设置和访问地址。默认访问地址：http://localhost:48911。
A: N.E.K.O 项目支持 Docker 部署，使用 docker-compose 可以一键启动所有服务。详见项目 README 中的 Docker 部署章节。
💡 提示：关于开发流程的详细说明，请参考 开发实战入门。
A: 在 main_server.py 中添加 FastAPI 路由。详见 开发实战入门 - 第一个任务：添加一个简单的 API 端点 和 后端开发教程 - API 开发指南。
A: 编辑 config/prompts_chara.py 文件，修改角色提示词。修改后需要重启服务器才能生效。
A: 将模型文件复制到 static/ 目录，在 Web 界面中通过 Live2D 管理页面配置。
A: 后端使用 FastAPI，前端使用 React 19 + Vite 7 + TypeScript。详见 项目架构与目录结构 - 项目概览。
💡 提示：关于 Git 和 GitHub 的详细操作指南，请参考 Git 与 GitHub 完整指南。
A: 推荐在 GitHub 上同步，或通过命令行同步。详见 Git 与 GitHub 完整指南 - 同步 Fork。
A: 使用 git reset --soft HEAD~1（保留变更）或 git reset --hard HEAD~1（完全撤销）。详见 Git 与 GitHub 完整指南 - 撤销和重写历史。
⚠️ 注意：这是进阶操作，如果已经推送到远程，撤销后需要强制推送，可能会影响其他协作者。
A: 手动解决冲突标记，暂存文件后完成合并。详见 Git 与 GitHub 完整指南 - 常见问题。
A: Fork 项目、创建功能分支、提交代码、推送到 Fork，然后在 GitHub 上创建 PR。详见 Git 与 GitHub 完整指南 - 基本开发流程。
A: 启动项目后访问 http://localhost:48911/api_key 在 Web 界面中配置，或通过环境变量配置（Docker 部署时）。
💡 注意：核心配置（API Key 等）通过环境变量或 Docker 配置管理，不再使用
core_config.json文件。详见 项目架构与目录结构 - Config 模块。
A: 查看 config/api_providers.json 了解支持的服务商。详见 项目架构与目录结构 - 配置文件说明。
A: 本地开发通过 Web 界面配置，Docker 部署通过环境变量配置。注意不要将包含 API Key 的配置文件提交到 Git。
💡 提示：关于前端开发的详细说明，请参考 前端开发教程。
A: 进入 frontend/ 目录，运行 npm install 和 npm run dev:web。详见 前端开发教程 - React 前端开发。
A: 在 frontend/packages/components/src/ 目录下创建组件文件并导出。详见 前端开发教程 - 创建新组件。
A: React 组件使用同名 CSS 文件或内联样式，传统前端修改 static/ 目录下的 CSS 文件。详见 前端开发教程 - 样式和 UI。
A: 使用 npm workspaces 管理多个子包（components、request、common）。详见 项目架构与目录结构 - 前端模块。
💡 提示：关于后端开发的详细说明，请参考 后端开发教程。
A: 在 utils/ 目录下创建新的 Python 模块。详见 项目架构与目录结构 - Utils 模块。
A: 编辑 main_helper/core.py 文件。详见 项目架构与目录结构 - Main Helper 模块。
A: 在 brain/ 目录下添加新的模块，或修改现有模块。详见 项目架构与目录结构 - Brain 模块。
A: FastAPI（不是 Flask）。所有路由使用 @app.get()、@app.post() 等装饰器，支持异步处理。详见 后端开发教程 - FastAPI 服务器开发。
A: 记忆服务器运行在独立端口，通过 HTTP 请求访问。可以使用 main_helper.cross_server 模块简化跨服务器通信。详见 后端开发教程 - 记忆系统使用。
💡 提示：关于文档维护的详细说明和提示词模板，请参考 文档维护与同步指南。
A: 推荐使用 Cursor 等 AI 编辑器，通过关键提示词模板快速更新文档。详见 文档维护与同步指南。
A: 使用文档维护指南中的提示词模板，根据 N.E.K.O 项目更新相关文档。详见 文档维护与同步指南 - 关键提示词模板。
A: MIT 许可证。查看项目根目录的 LICENSE 文件。
A:
详细流程参考 Git 与 GitHub 完整指南。
A:
A: 建议按照以下顺序学习：
详见 README - 学习路径。
没有找到答案？ 在 GitHub Issues 提交你的问题！