🧭 X-AnyLabeling FAQ（问题反馈指引）

[CVHub520]

为了更高效地解决您的问题，请在提交 Issue 前，先按照以下步骤自查与排查。

🔍 步骤一：自助排查

1. 查阅文档与资源

   • 📘 用户手册
   • ❓ 常见问题（FAQ）
   • 💬 官方论坛（Issues）

2. 更新版本

   请尝试更新至最新版本后再次确认问题是否仍然存在。

3. 咨询官方 AI 助手

   • 🤖 点击这里提问

[!NOTE] ⌛️使用人数较多时可能需要排队，请耐心等待！ ❤️ 服务显示挂了需要冷启动，请间隔10s再刷新几次。

---

🚨 步骤二：仍未解决？请提交 Issue

若以上步骤仍无法解决您的问题，请在 Issues 页面 新建一个 Issue，并务必提供以下信息：

1. 环境信息

   • 执行命令：

     xanylabeling checks
     

     或在 GUI 客户端中点击：

     帮助 → 关于 → 复制应用信息

   将复制的内容粘贴至 Issue 描述中。

2. 问题描述 请详细描述：

   • 您执行了什么操作；
   • 您期望的结果；
   • 实际发生的情况。

3. 日志与截图

   • 若使用命令行运行，请粘贴完整日志：

     <此处粘贴完整的终端日志>
     

   • 若使用 GUI 客户端，请附上完整截图（尽量包含出错提示窗口）。

4. 附加信息（可选但推荐）

   • 在 GUI 客户端按下 Ctrl + G 可复制标注面板数据；
   • 如问题较复杂，建议附上复现演示视频；
   • 其它您认为有必要提供的附件，如配置文件，onnx文件输入输出节点图等。

✏️ Markdown 编写规范

为了保持 Issue 清晰易读，请遵循以下 Markdown 语法规范：

内容类型	推荐格式	示例
代码片段	```python print("Hello World") ```	python<br>print("Hello World")<br>
日志输出	```bash Traceback (most recent call last): ... ```	bash<br>Traceback (most recent call last):<br>...<br>
配置文件	```yaml version: 1.0 settings: debug: true ```	yaml<br>version: 1.0<br>settings:<br> debug: true<br>
图片	

💡 温馨提示：
提供越完整的信息，开发者就能越快定位并解决您的问题。

[CVHub520]

To resolve your issue more efficiently, please follow the steps below for self-diagnosis and troubleshooting before submitting an Issue.

🔍 Step 1: Self-Troubleshooting

1. Review Documentation & Resources

   • 📘 User Guide
   • ❓ FAQ
   • 💬 Official Issues Forum

2. Update to the Latest Version

   Please try updating to the latest version and verify whether the issue persists.

3. Consult the Official AI Assistant

   • 🤖 Ask here

[!NOTE]
⌛️ The AI assistant may have a queue during peak usage—please be patient!

🚨 Step 2: Still Unresolved? Please Submit an Issue

If the issue remains after following the above steps, please create a new Issue on the Issues page and include the following information:

1. Environment Information

   • Run the command:

     xanylabeling checks
     

     Or in the GUI client, click:

     Help → About → Copy App Info

   Paste the copied information into your Issue description.

2. Issue Description
   Please provide a clear description of:

   • What you did;
   • What you expected to happen;
   • What actually happened.

3. Logs & Screenshots

   • If running from the command line, paste the full log output:

     <Paste the complete terminal log here>
     

   • If using the GUI, include full screenshots (preferably showing any error dialogs).

4. Additional Information (Optional but Recommended)

   • Press Ctrl + G in the GUI to copy annotation panel data;
   • For complex issues, consider attaching a short video demonstrating the problem;
   • Any other helpful attachments, such as config files, ONNX model I/O node graphs, etc.

✏️ Markdown Formatting Guidelines

To keep your Issue clear and readable, please follow these Markdown conventions:

Content Type	Recommended Format	Example
Code snippet	```python print("Hello World") ```	python<br>print("Hello World")<br>
Log output	```bash Traceback (most recent call last): ... ```	bash<br>Traceback (most recent call last):<br>...<br>
Config file	```yaml version: 1.0 settings: debug: true ```	yaml<br>version: 1.0<br>settings:<br> debug: true<br>
Image	

💡 Tip:
The more complete your information, the faster developers can identify and fix your issue.