主题
常见问题 FAQ
需求相关
Q: 我写的需求越多越好吗？
A: 不是越多越好，而是越清晰、具体越好。
好的需求应该：
- 明确功能点（不要说"管理文章"，而是说"可以发布、编辑、删除文章"）
- 描述用户角色
- 说明业务规则
- 控制在 3~5 个主要模块
Q: AI 能理解中文需求吗？
A: 可以！系统完全支持中文需求描述，你可以用日常语言描述功能。
Q: 需求可以修改吗？
项目生成后，可以通过以下方式修改：
- 继续修改（3 次免费）：描述你想改什么
- 添加需求（按页计费）：添加新功能、新页面
- UI 优化（按页计费）：优化界面效果
Q: 生成过程中可以向 AI 发指令吗？
可以。在 Live Workstation 中可以直接向 AI 发送指令。但注意，生成过程中的修改可能影响全局规划质量。
项目生成相关
Q: 项目生成需要多长时间？
通常 2~5 小时，取决于项目复杂度和是否高峰期。你不需要一直盯着页面，可以关闭浏览器稍后回来查看进度。
Q: 生成的代码质量如何？
- 遵循最佳实践和设计模式
- 模块化清晰，易于扩展
- 包含完整的 CRUD 操作
- 有基础的错误处理
- 前后端类型完全对齐
但生成的是基础版本，复杂业务逻辑可能需要手动补充。
Q: 生成的代码可以商用吗？
代码完全属于你，可以自由使用，包括商业用途。
Q: 支持哪些技术栈？
- 后端：NestJS、Spring Boot、FastAPI、Django、Express、Mock Server
- 前端：Vue 3、React
- 数据库：MySQL、PostgreSQL、SQLite
- 自由项目：无技术栈限制
Q: 可以同时生成多个前端吗？
可以。在技术栈选择时点击"新增前端"，每个前端可以独立选择框架和 UI 库。
Q: 生成过程中可以取消吗？
不要中途取消！
生成或修改过程中，请勿点击取消按钮。中途取消可能导致任务卡住无法继续。请耐心等待生成完成。
Q: 选择"真实接口"还是"模拟接口"？
| 选项 | 说明 |
|---|---|
| 模拟接口 | AI 生成模拟数据，开箱即用，推荐大多数用户选择 |
| 真实接口 | 需要你提供第三方平台的 API 密钥（如支付、地图等） |
如果你没有第三方平台的 API 接口凭证，请选择模拟接口。模拟接口不影响项目功能和展示，后续需要时可以手动替换。
运行与部署相关
Q: 在自己电脑上部署还是学生电脑上部署？
在自己的电脑上部署的项目，只能在你的电脑上运行。 如果要交给学生使用，需要：
- 在你的电脑上完成项目生成和修改
- 生成完成后，点击"一键部署"获取部署命令
- 将部署命令发给学生，让学生在自己的电脑上执行
这样项目就运行在学生的电脑上，学生可以随时使用。
Q: 怎么把项目交给学生？
项目生成完成后：
- 点击任务详情页右上角的"一键部署"按钮
- 复制部署命令
- 将命令发送给学生（通过微信/QQ 等）
- 学生在自己的 Windows 电脑上以管理员身份打开 PowerShell，粘贴命令执行即可
脚本会自动下载代码、安装环境和依赖、启动服务。学生无需任何编程基础。
Q: 一键部署支持哪些系统？
目前仅支持 Windows，使用 PowerShell 脚本执行。需要以管理员身份运行 PowerShell。
Q: 端口被占用怎么办？
macOS/Linux:
bash
lsof -i :3000Windows:
cmd
netstat -ano | findstr :3000然后关闭对应的进程，或者修改项目配置使用其他端口。
Q: 后端启动报数据库连接错误
检查以下几点：
- 数据库是否启动（MySQL/PostgreSQL 需要独立服务）
.env文件中的数据库配置是否正确- 数据库是否已创建
如果使用 SQLite，确保路径正确且有写入权限。
Q: 前端报 CORS 错误
常见原因：
- 后端没有启动
- 前端 API 地址配置错误
- 后端 CORS 配置不匹配
解决方法：确保后端已启动，检查前端环境变量中的 API 地址。
Q: 安装依赖时报错
常见解决方法：
- 删除 node_modules 重装：
rm -rf node_modules && pnpm install - 清除缓存：
pnpm store prune - 检查 Node.js 版本是否 >= 18
Q: 一键部署解压失败怎么办？
可能原因和解决方法：
- 磁盘空间不足：检查 C 盘剩余空间，确保至少有 5GB 可用
- 杀毒软件拦截：暂时关闭 Windows Defender 或其他杀毒软件后重试
- 网络问题导致下载不完整：重新执行部署命令
Q: 后端启动报 Maven 错误（No plugin found for prefix 'spring-boot'）
这说明你执行命令的位置不对。请确保：
- 在项目根目录（包含
pom.xml的目录）执行 Maven 命令 - 不要在项目子目录中执行
- 如果使用一键部署脚本，脚本会自动定位到正确目录
Q: 后端启动报找不到依赖 / 依赖下载失败
通常是网络问题，建议：
- 配置国内镜像源（阿里云镜像等）加速下载
- 一键部署脚本已内置国内镜像配置，优先使用一键部署
- 手动部署时参考对应技术栈文档配置镜像
计费相关
Q: 项目生成多少钱？
项目生成采用按页计费，每页固定积分。不同模型方案价格不同。在选择技术栈时会显示费用预估。
Q: 修改要收费吗？
- 继续修改：前 3 次免费，之后固定积分/次
- 添加需求/UI优化：按页计费
Q: 论文生成多少钱？
论文费用 = 基础费用 + 可选增值服务（联网搜索、降AIGC +5积分、自动截图 +10积分）。
Q: 在哪里充值？
个人中心 → 充值页面。
Q: 余额最低充值多少？
充值页面提供多个固定档位，同时也有自定义金额选项，可以根据需要输入任意金额。
Q: 未生成内容会扣费吗？
不会。如果生成过程中出现异常导致内容未成功生成，不会扣除积分。
论文相关
Q: 先生成代码还是先生成论文？
必须先生成项目代码，然后才能生成论文。 论文是基于你生成的代码来撰写的。流程：
- 先完成 AI 对话 → 选择技术栈 → 生成项目代码
- 项目代码生成完成后，在任务详情页找到"生成论文"功能
Q: 论文在哪里查看和下载？
- 在任务列表中找到对应的论文任务
- 点击进入论文详情页
- 论文生成完成后，会出现下载按钮
- 如果还没有下载按钮，说明论文还在生成中，请耐心等待
Q: 显示完成了但内容还在等待中？
这是正常现象。系统状态显示"完成"表示论文框架已生成，但各章节内容仍在逐步填充中。请耐心等待，内容会陆续生成，生成完成后才会出现下载按钮。
Q: 论文可以导出几次？
只有一次。请确认论文内容满意后再导出。
Q: 论文生成后还能修改吗？
可以通过论文助手继续和 AI 对话完善内容、生成图表。但整体文档只能导出一次。
Q: 可以用自己写的代码生成论文吗？
可以。使用"从已有代码生成论文"功能，上传你的代码即可。
Q: 降 AIGC 检测有用吗？
开启后 AI 会对内容进行改写润色，可以降低检测率，但不能保证完全通过检测。建议生成后再自行修改润色。
调试相关
Q: 如何调试 API 接口？
如果是 NestJS 项目，启动后访问 http://localhost:3000/api 查看 Swagger 文档，可以直接在页面测试接口。
Q: 如何查看数据库数据？
- NestJS (Prisma)：执行
pnpm prisma studio打开数据库可视化管理界面 - Spring Boot：使用数据库客户端（如 Navicat、DBeaver）连接
- SQLite：使用 DB Browser for SQLite 等工具打开
.db文件
Q: 如何查看后端日志？
后端日志直接在终端中输出。如果使用一键部署，日志会在启动后端的 PowerShell 窗口中显示。
Q: 如何调试前端？
使用浏览器的开发者工具（F12），在 Console 和 Network 面板查看错误和网络请求。