用户反馈与支持
为帮助技术团队更高效地定位并排查您遇到的问题，建议在反馈时提供详细的使用场景、操作路径以及相关的报错日志。您可以通过以下任意一种方式向我们反馈：
- 用户反馈表（飞书）：填写 用户反馈表，适合一次性提交完整问题信息。
- 应用内反馈：从头像菜单、错误提示或任务顶部更多菜单进入，详见下方 应用内反馈入口。
- GitHub Issues：前往 zai-org/feedback 提交 Issue，适合需要追踪进展、与团队公开讨论的问题。
- 加入社群：扫码加入用户社群直接联系我们，优先推荐飞书社群，详见下方 加入社群。
应用内反馈入口
ZCode 内置了统一的「问题反馈」面板。你可以补充反馈类型、功能模块、Agent 能力、影响程度、问题描述，并按需附带截图和完整日志。
头像菜单入口
点击左下角头像，选择 问题反馈，适合主动提交使用问题、功能建议或体验反馈。
进入后会打开同一个「问题反馈」面板，可直接填写标题、详细说明和补充信息。反馈功能会自动将现场截图一并上传；附带完整日志 选项默认为勾选状态，可根据需要手动关闭。
报错提示入口
如果页面出现错误提示，可以直接点击提示条里的 反馈问题。这种入口会自动带入报错摘要、最近错误详情、截图附件和当前 Agent 信息，适合反馈初始化失败、运行时报错等问题。
任务更多菜单入口
打开某个任务后，点击标题栏里的 ... 更多菜单，选择 反馈问题。这种入口会自动带入当前任务标题、任务 ID、工作区和会话文件位置，适合反馈某个任务里的异常表现。
提交后：后台上传与进度跟踪
关闭界面，自动后台上传
提交反馈后不需要停留等待：点击右上角关闭当前界面，系统会自动切换至 后台上传，截图与日志会在后台继续传输，不影响你继续使用 ZCode。
实时查看处理进度，随时补充信息
在「我的反馈」中可以实时查看每条反馈的处理进度（已提交 → 评估中 → 处理中 → 已闭环）。处理过程中，你可以随时在 补充信息 区域追加复现步骤、截图说明或日志片段，帮助团队更快定位问题。
GitHub Issue 提交格式
为方便我们快速复现和定位问题，建议在 zai-org/feedback 提交 Issue 时按以下格式描述：
- 标题：一句话概括问题，例如「macOS 上启动后白屏」「Bot @ 触发任务无响应」。
- 使用环境：操作系统及版本、ZCode 版本、所接入的模型通道（如 Z.ai 或企业模型通道）。
- 复现步骤：分步骤说明如何稳定触发该问题，便于团队按相同路径复现。
- 期望表现 vs 实际表现：分别描述您期望发生的结果和实际看到的现象。
- 日志与截图：参照下方 如何打包日志 附上日志压缩包；如有截图、录屏请一并上传。
若您不确定属于 Bug 还是使用问题，也欢迎直接提交，团队会协助分类与处理。
如何打包日志？
推荐优先使用 ZCode 软件内置的 导出日志 功能；如果导出失败，再按下方说明手动定位日志目录。
macOS 系统
- 在 ZCode 软件内打开应用菜单。
- 点击 导出日志，按提示保存生成的日志压缩包。
- 将压缩包上传至反馈表中。
- 如果导出失败，可在 Finder 中选择 前往 -> 前往文件夹...，输入
~/.zcode后手动压缩logs文件夹。
Windows 系统
- 在 ZCode 软件内打开应用菜单。
- 点击 导出日志，按提示保存生成的日志压缩包。
- 将压缩包上传至反馈表中。
- 如果导出失败，可打开 文件资源管理器，在地址栏输入
%USERPROFILE%\\.zcode并回车。 - 进入目录后，选中
logs文件夹，右键选择 发送到 -> 压缩(zipped)文件夹。
加入社群
如果你有其他需求或在使用中遇到问题，也可以直接加入社群联系我们反馈。优先推荐加入飞书社群——官方团队驻群响应，反馈触达最快。
飞书群（推荐）
ZCode 用户反馈群，官方团队驻群响应
微信群
扫码加入开发者内测群
微信公众号
关注获取最新动态