Skip to content

CONCURRENT_LIMIT_USER_GUIDE.md

Latest commit

 

History

History
219 lines (148 loc) · 5.47 KB

CONCURRENT_LIMIT_USER_GUIDE.md

File metadata and controls

219 lines (148 loc) · 5.47 KB

并发限制功能 - 用户使用指南

📖 功能说明

DrawThings WebUI 现在限制了同时进行的图片生成任务数量，最多允许 5个任务 同时生成。这是为了防止系统过载，确保所有用户都能获得稳定的服务。

🔍 如何查看当前系统负载

方法1：查看状态面板

当您连接到服务器后，在页面顶部会看到状态信息：

✓ 服务器连接成功
当前模型: xxx
🔄 当前有 2 个任务正在生成中... (最多允许5个并发任务)

这个数字会每5秒自动更新，让您随时了解系统负载情况。

方法2：通过API查询

如果您需要通过程序查询，可以使用：

curl http://127.0.0.1:5000/api/status/generating

返回结果：

{
  "success": true,
  "generating_count": 2
}

⚠️ 当达到限制时会发生什么

场景描述

假设当前已经有5个任务正在生成，此时您点击"生成图片"按钮：

  1. 前端提示

    • 会弹出警告对话框
    • 显示错误信息："当前已有 5 个任务正在生成中，请稍后再试（最多允许5个并发任务）"
    • 附加提示："您可以稍等片刻后再次尝试生成。"

  2. 后端响应

    • HTTP 状态码：429 (Too Many Requests)
    • 不会开始新的生成任务
    • 您的请求被礼貌地拒绝

  3. 界面状态

    • 生成按钮恢复正常状态
    • 可以继续操作其他功能
    • 可以稍后重试

💡 使用建议

✅ 推荐做法

  1. 观察负载

    • 在提交新任务前，先查看状态面板
    • 如果已有4-5个任务在运行，建议等待

  2. 合理安排

    • 避免一次性提交多个任务
    • 等待当前任务完成后再提交新的

  3. 错峰使用

    • 如果发现系统经常满载，可以尝试在其他时间段使用
    • 避开高峰时段

  4. 耐心等待

    • 图片生成需要时间，请耐心等待
    • 可以通过状态面板了解进度

❌ 避免的做法

  1. 不要频繁点击

    • 连续快速点击生成按钮没有意义
    • 超出的请求会被拒绝

  2. 不要同时打开多个窗口

    • 多个窗口会共享同一个服务器的负载
    • 可能导致所有窗口都无法生成

  3. 不要忽略提示信息

    • 仔细阅读错误提示
    • 按照提示建议操作

🎯 常见场景

场景1：正常使用时

情况：当前有2个任务在运行，您想生成新图片

操作：

  1. 直接点击"生成图片"
  2. 确认参数
  3. 任务会被接受并开始生成
  4. 状态面板显示：当前有 3 个任务正在生成中...

场景2：系统繁忙时

情况：当前有5个任务在运行，您想生成新图片

操作：

  1. 点击"生成图片"
  2. 收到错误提示
  3. 关闭提示框
  4. 等待几分钟
  5. 再次尝试

场景3：批量生成需求

情况：您需要生成多张图片

推荐策略：

  1. 先生成第1张
  2. 等待完成或至少开始生成
  3. 再生成第2张
  4. 依此类推，保持不超过5个并发

或者：

  1. 一次性提交5个任务
  2. 等待其中一些完成
  3. 再提交剩余的任务

🔧 高级技巧

监控任务进度

您可以通过以下方式了解任务进度：

  1. 状态面板

    • 显示当前运行的任务数量
    • 数字减少表示有任务完成

  2. 生成按钮

    • 显示进度条
    • 显示剩余百分比

  3. 历史记录

    • 查看已完成的任务
    • 了解平均生成时间

预估等待时间

如果您知道：

  • 当前有5个任务在运行
  • 平均每个任务需要30秒

那么您可能需要等待：

  • 最短：等到最快的那个任务完成
  • 最长：等到所有5个任务都完成

通常建议等待30-60秒后再尝试。

❓ 常见问题

Q1: 为什么要有这个限制？

A: 防止服务器过载，确保系统稳定性和响应速度。没有限制的话，大量并发任务会导致：

  • 服务器资源耗尽
  • 生成速度变慢
  • 可能崩溃

Q2: 限制可以调整吗？

A: 当前限制是5个任务。如果需要调整，请联系系统管理员。技术上可以修改，但需要权衡性能和稳定性。

Q3: 我的请求被拒绝了，数据会丢失吗？

A: 不会。被拒绝的请求根本不会开始处理，所以没有任何数据丢失。您可以安全地重试。

Q4: 不同用户的任务是分开计算的吗？

A: 不是。所有限制是针对整个服务器的，所有用户共享这5个并发名额。

Q5: 有没有队列机制？

A: 目前没有。被拒绝的请求需要手动重试。未来可能会添加自动队列功能。

Q6: 如何知道什么时候可以再试？

A:

  • 观察状态面板的数字变化
  • 当数字小于5时就可以尝试
  • 通常等待30-60秒即可

📞 获取帮助

如果您遇到问题：

  1. 查看状态面板

    • 了解当前系统负载

  2. 阅读错误提示

    • 按照提示操作

  3. 查看文档

  4. 联系管理员

    • 如果问题持续存在
    • 如果需要调整限制

🎉 总结

并发限制功能是为了提供更好的用户体验和系统稳定性。虽然偶尔会遇到限制，但通过合理使用和耐心等待，您可以顺利地使用所有功能。

记住三个要点：

  1. 👀 观察：经常查看状态面板
  2. ⏱️ 等待：系统繁忙时耐心等待
  3. 🔄 重试：被拒绝后稍后再试

祝您使用愉快！