Feedback & Support

To help the technical team diagnose and resolve issues more efficiently, it is recommended to include detailed usage context, the steps you took, and any related error logs when sending feedback. You can reach us through any of the following channels:

• Feedback Form (Feishu): fill out the feedback form for a one-shot submission with all the details.
• In-app feedback: enter from the avatar menu, an error banner, or the task More menu. See In-app Feedback Entrypoints below.
• GitHub Issues: open an issue at zai-org/feedback — best for issues you want to track over time or discuss with the team in public.
• Discord: join the ZCode Discord community for discussion and quick updates.

In-app Feedback Entrypoints

ZCode uses one unified Feedback panel. You can add the feedback type, feature module, Agent capability, severity, description, screenshots, and full logs when needed.

Avatar Menu

Click the avatar in the lower-left corner, then choose Feedback. This is best for general usage questions, suggestions, and experience issues.

The entry opens the shared feedback panel, where you can fill in the title, details, and additional context. The feedback tool automatically attaches a screenshot of the current screen; the Attach full logs option is checked by default and can be turned off if needed.

Error Banner

When an error banner appears, click Feedback directly in the banner. This entry automatically carries the error summary, recent error details, screenshot attachment, and current Agent context, which is useful for initialization failures and runtime errors.

Task More Menu

Open a task, click the ... More menu in the title bar, then choose Feedback. This entry automatically carries the current task title, task ID, workspace, and session file path, which is useful when the issue is tied to one task.

After Submitting: Background Upload & Progress Tracking

Close the panel — uploads continue in the background

There is no need to wait after submitting: click the close button in the top-right corner and the upload automatically switches to the background. Screenshots and logs keep uploading while you continue working in ZCode.

Track progress in real time and add more details

In My Feedback you can track each report's progress in real time (Submitted → In Review → In Progress → Closed). While it is being handled, you can add reproduction steps, screenshots, or log snippets in the Additional Info area at any time to help the team locate the issue faster.

GitHub Issue Format

To help us reproduce and triage issues quickly, please follow this format when opening an issue at zai-org/feedback:

• Title: a one-sentence summary of the problem, e.g. "Blank screen on macOS launch" or "Bot @ trigger has no response".
• Environment: OS and version, ZCode version, and the model channel you are using, such as Z.ai or an enterprise channel.
• Steps to reproduce: numbered steps the team can follow to hit the problem reliably.
• Expected vs. actual behavior: what you expected to happen versus what actually happened.
• Logs & screenshots: attach a log archive following How Do I Package Logs?, and include screenshots or screen recordings whenever possible.

If you aren't sure whether something is a bug or a usage question, feel free to submit anyway — we will help categorize and follow up.

How Do I Package Logs?

It is recommended to use the built-in Export Logs feature first. If export fails, you can manually locate the logs directory as described below.

macOS

1. Open the application menu in ZCode.
2. Click Export Logs and save the generated compressed archive.
3. Upload the archive to the feedback form.
4. If export fails, open Finder, choose Go -> Go to Folder..., enter ~/.zcode, and manually compress the logs folder.

Windows

1. Open the application menu in ZCode.
2. Click Export Logs and save the generated compressed archive.
3. Upload the archive to the feedback form.
4. If export fails, open File Explorer, enter %USERPROFILE%\\.zcode in the address bar, and press Enter.
5. Select the logs folder, then right-click and choose Send to -> Compressed (zipped) folder.

Join the Community

If you have other needs or run into issues, you can also reach us directly in the user community. The Feishu (Lark) group is recommended — the official team is in the group and responds fastest. You can also join the ZCode Discord community.

Feishu Group (Recommended)

ZCode user feedback group with the official team

WeChat Group

Scan to join the developer beta group

WeChat Official Account

Follow for the latest updates

Next Steps