故障排查
快速定位登录、导入、同步、Agent 与发布问题，并收集可用诊断信息。
先确认问题属于哪一层
| 现象 | 优先检查 |
|---|---|
| 无法登录或会话丢失 | 账户状态、Client 本地会话、系统时间 |
| 素材一直处理中 | 文件格式、大小、解析任务与 Backend Worker |
| 搜索不到已导入内容 | 素材状态、知识库范围、索引任务 |
| Agent 无响应 | Runtime 在线状态、任务租约、Provider 可用性 |
| 同步不前进 | 工作区类型、网络、同步游标与冲突状态 |
| 平台草稿失败 | 内容包审核状态、扩展登录、平台页面变化 |
登录或工作区不对
确认系统时间正确，再检查 Web 或客户端当前账户。客户端退出会删除本地登录 Token，但不会删除本地工作区内容。页面看起来“空了”时先检查是否切到了另一个工作区，不要立刻新建同名空间。
素材导入失败
打开失败记录，确认文件可打开、URL 仍可访问、正文预览是否为空。动态网页改用扩展，扫描 PDF 或复杂表格需要抽查结果。一直处理中时不要重复提交同一大文件。
搜索不到内容
确认素材已经可用、加入当前知识库，页面没有切换到别的工作区。用标题中的专有名词或原文短语搜索；刚导入时等待索引完成再刷新。
Agent 没有响应
查看任务是等待、运行、等待审批、失败还是过期。本地模式检查 Runtime 与 Provider，云端模式检查网络和账户。终端有输出不等于业务任务已经完成。
扩展或平台草稿失败
确认内容包已审核、扩展与 Web 使用同一在线工作区、浏览器已经登录正确平台账号。结果未知时先查平台草稿箱，不要连续点击造成重复内容。
收集诊断
记录发生时间、工作区与对象 ID、入口与版本、预期结果、实际状态和错误码。不要在截图或日志中包含 Cookie、Token、数据库 URL 或完整私密素材。
有效的最小复现包含：在哪个入口、选择什么对象、执行哪一步、看到什么状态，以及相同操作能否稳定复现。截图前遮住账户、客户名称和正文。
安全重试
未知结果的发布操作先查询状态；导入失败可以重试但保留原失败记录；Agent 任务过期后重新创建任务，不要手动把数据库状态改成完成。
仍未解决
联系支持时提供最小复现步骤和脱敏诊断。说明问题发生在 Web、Client、扩展、CLI 还是 Runtime，可以显著缩短定位时间。
同时提供客户端或扩展版本、操作系统、浏览器版本和发生时间。若问题涉及发布，请说明平台是否已经出现草稿，避免直接重试。