5.3 排查常见问题

先记下出错时间、页面动作和脱敏错误，再查相应层。不要首先清空数据库或重新安装全部环境。

安装与启动

现象	检查和处理
docker 命令不存在	安装 Docker CLI 与可运行的本机引擎，执行 `docker info` 验证
Docker 无法连接	启动引擎，检查当前 context 或环境变量；不要默认切向远程环境
同名容器不属于当前项目	源码开发模式下返回原源码目录操作；该错误终止初始化，不会主动停止原容器
端口被占用	查明占用进程的用途；不要使用模糊进程名批量结束服务
插件构建错误	Compose 安装查看镜像构建输出；源码模式检查 Node、pnpm 版本和依赖，再运行 `pnpm check:dsh`
页面 401 或认证失效	使用本次启动输出的完整认证链接，避免复制旧令牌

先在普通对话验证模型。对话也失败时查模型连接；只有某位同事失败时查其在岗状态、运行配置、业务范围和资料授权。

群里没有回应时先看是否选中或提及正确同事，以及收到、配置错误等可见反馈。没有反馈也不要推断任务已开始，检查具体任务与执行记录。

确认本机服务在线、计划启用、同事状态和时间时区。再看该日期是否已有运行记录。重新上线不会保证补齐每个离线时段；补跑前核对重复风险。

提供版本、操作步骤、预期结果、实际结果和已脱敏的错误信息。不要提交模型密钥、Cookie、认证 URL、数据库连接串或整份运行目录。模型没有产生结果与界面显示结果失败应分别描述。