常见问题
登录、模型、积分、任务、文件、知识库、连接器和客户端更新的高频问题。
登录提示企业不存在
Section titled “登录提示企业不存在”确认企业标识拼写正确，账号属于该企业。企业标识由管理员提供，不是邮箱域名。如果企业刚开通，等待管理员完成租户初始化后再登录。
忘记密码怎么办
Section titled “忘记密码怎么办”使用登录页的「忘记密码」入口；如果企业未配置邮件服务，联系企业管理员在后台重置。重置后首次登录请修改密码。
账号被停用后还能登录吗
Section titled “账号被停用后还能登录吗”不能。成员被停用或移出企业后，已有会话会在下一次鉴权时失效。本地已经生成的文件和任务记录仍保存在磁盘上，需要按企业数据保留策略处理。
模型列表为空
Section titled “模型列表为空”通常是管理员尚未给成员分配模型，或客户端缓存的运行配置过期。先退出重登；仍然为空时联系管理员检查企业模型授权和网关状态。
提示积分不足
Section titled “提示积分不足”本月额度可能已经用完。管理员可以在企业后台查看消耗、调整额度或发放临时积分包。成员侧无法自行充值。
为什么同一个任务消耗的积分不一样
Section titled “为什么同一个任务消耗的积分不一样”模型倍率、上下文长度、缓存命中、推理强度和工具调用次数都会影响消耗。长上下文和高推理强度通常更贵。
可以填写自己的 API Key 吗
Section titled “可以填写自己的 API Key 吗”企业版默认不需要也不建议使用个人密钥。模型请求统一经过企业网关；如果企业允许特定场景使用个人密钥，按管理员的安全规范执行。
任务一直停在执行中
Section titled “任务一直停在执行中”先看任务时间线和工具调用记录，确认是否在等待命令、网络请求或权限确认。网络中断、模型超时或工具卡住都可能造成长时间等待；必要时停止任务后重试。
Agent 读不到我引用的文件
Section titled “Agent 读不到我引用的文件”确认文件在当前工作区内，路径没有超出工作区边界，并且没有被 .gitignore 或企业策略排除。远程工作区需要确认文件已经同步到目标主机。
Agent 修改了不该改的文件
Section titled “Agent 修改了不该改的文件”立即停止任务，用 Git 或备份恢复。企业版会在高风险操作前进入确认流程，但确认流程不能替代版本控制和备份。建议在任务开始前提交当前改动，或使用独立分支。
关闭窗口后任务还在跑吗
Section titled “关闭窗口后任务还在跑吗”Windows 默认关闭窗口时最小化到托盘，后台任务和定时任务会继续运行。需要完全退出时使用托盘菜单的「退出」。macOS/Linux 的行为以当前版本设置为准。
知识库与连接器
Section titled “知识库与连接器”知识库搜不到文档
Section titled “知识库搜不到文档”确认文档已经完成解析和索引，成员有该知识库的查看权限，搜索范围包含目标知识库。刚上传的文档可能需要等待索引完成。
连接器授权失败
Section titled “连接器授权失败”检查 OAuth 回调地址、企业网络、厂商账号权限和令牌有效期。授权失败时不要重复点击，先看错误码；必要时让管理员重新发起授权。
MCP 工具不出现
Section titled “MCP 工具不出现”确认 MCP 服务已启用、连接状态正常、工具发现成功。修改配置后新建会话；已有会话不保证热更新。
客户端与更新
Section titled “客户端与更新”更新失败或一直检查更新
Section titled “更新失败或一直检查更新”确认更新源可达、磁盘空间足够、安全软件没有锁定安装目录。企业强制更新时，按提示重启客户端；不要从第三方渠道替换运行时文件。
数据保存在哪里
Section titled “数据保存在哪里”企业版默认数据目录是 ~/.zworkspace，与个人版 ~/.zcode 分开。具体路径可能受企业打包配置影响；备份前先确认客户端显示的版本和数据目录。
如何导出日志
Section titled “如何导出日志”优先使用客户端的问题反馈入口导出。手动查找时，查看数据目录下的日志文件；提交前删除令牌、密钥、客户隐私和未脱敏业务数据。
与其他版本的关系
Section titled “与其他版本的关系”澄宇AI工作台和 ZCode 个人版有什么区别
Section titled “澄宇AI工作台和 ZCode 个人版有什么区别”澄宇AI工作台基于 ZCode 开源项目构建，保留 Agent、任务与文件、Skill、MCP、Hooks 等通用能力，并增加企业登录、组织权限、模型网关、积分额度和岗位工作台。个人版的套餐、定价和社区入口不适用于企业版。
文档里的功能和客户端不一致
Section titled “文档里的功能和客户端不一致”文档会标注上游独有能力；如果某个功能在企业版未开放，以企业后台公告和客户端实际界面为准。欢迎通过获取支持与反馈指出差异。
仍然没有解决
Section titled “仍然没有解决”请按获取支持与反馈准备任务 ID、时间、客户端版本、操作系统和脱敏后的日志，联系企业管理员或 IT 服务台。