支持 / 10
10. 故障排查
按现象快速定位 | 仍无法解决请联系 support@douflow.top
安装与启动
客户端打不开（Windows）
| 可能原因 | 处理 |
|---|---|
| 运行了错误的程序 | 确认双击的是官网下载的 DouFlow.exe |
| 路径兼容性问题 | 若 DouFlow.exe 所在目录含中文、特殊符号或层级过深，可尝试移到简短英文路径，如 C:\Apps\DouFlow |
| 被 360 等第三方安全软件拦截或提示风险 | 先确认 DouFlow.exe 来自官网；在安全软件隔离区恢复该文件，再将其所在目录加入信任名单后重试。仅在排查时临时退出安全软件，确认可启动后立即重新开启防护 |
| 缺少运行库 | 安装 VC++ 运行库（Windows 官方） |
客户端打不开（macOS）
| 可能原因 | 处理 |
|---|---|
| 未公证被拦截 | 右键 → 打开；或 xattr -cr /Applications/DouFlow.app |
| 芯片版本下错 | Apple 芯片用 ARM 版，Intel Mac 用 Intel 版 |
首次启动卡在资源检查或模型下载
- 检查网络与磁盘空间（≥ 3 GB 余量）
- 关闭 VPN / 切换网络
- 重启客户端重试
- 查看设置或日志目录中的下载错误信息
登录与账号
无法登录
- 确认邮箱密码正确，可在 https://douflow.top 试登录
- 检查本机时间是否正确
- 检查防火墙是否拦截客户端访问 API
订阅未生效
- 确认激活码输入正确、无多余空格
- 退出账号重新登录
- 在官网确认订单状态
采集与内置浏览器
提示未登录抖音或需要安全验证
- 保持 DouFlow 打开的内置 Chrome 窗口不关闭
- 在该窗口中扫码或输入账号密码登录抖音
- 如出现滑块 / 验证码，先在浏览器中完成验证
- 回到客户端点击「我已登录，继续采集」或重新刷新数据
采集数据不完整
- 博主作品本身较少
- 网络慢导致页面未滚到底 — 重试采集
- 抖音未登录 — 在 DouFlow 内置 Chrome 中登录抖音
- 置顶帖被过滤 — 属正常逻辑
抖音会话失效或内置浏览器异常
- 在内置 Chrome 中重新登录抖音
- 仍然异常时，进入 设置 重置内置浏览器环境，再重新登录
- 重置只清除 DouFlow 内置浏览器的 Cookie / 缓存，不影响系统 Chrome
字幕与改写
字幕生成失败
- 确认视频含清晰人声
- 确认 Whisper 模型已下载完成
- 尝试换较短视频测试
- 客户端 帮助中心 → 诊断日志 查看错误
提示额度用尽（quota_exceeded）
- 字幕等免费额度用尽后，按账户页显示等待下一次重置
- 视频下载、字幕提取和 AI 改写分别计算对应额度
- 这些非创作型免费额度与创作积分分开计算，不会重复扣费
AI 改写无响应
- 检查今日改写额度
- 检查网络
- 缩短输入文本后重试
成片与自动化
自动化中途失败
| 检查项 | 说明 |
|---|---|
| 磁盘空间 | 成片缓存需数 GB |
| 成本任务余额 | 数字人、AI 画面、AI 生图、高级声音等提交前会报价；检查订阅或体验积分是否足够 |
| 报价状态 | 配置变化、报价过期或余额不足时，刷新报价并重新确认 |
| 本地项目 | 即使创作积分不足，也可继续编辑和预览；只是不能提交新的成本型任务 |
client_not_ready
- 创作自动化默认项未配置完整 — 打开 设置 → 创作自动化
- 客户端 UI 未就绪 — 重启客户端后再试
automation_in_progress
- 等待当前任务结束，或进入自动化页取消
替换画面自动匹配不到素材
| 可能原因 | 处理 |
|---|---|
| 素材没有描述 | 进入 替换画面 → 管理素材，补一句具体用途描述 |
| 素材和分镜语义不匹配 | 换更贴近口播内容的描述，或手动选择素材 |
| 选择了素材库匹配但素材库为空 | 先上传图片/视频素材，或改用 AI 生图 / 混合优先 |
| 纯素材模式想用讲解头像 | 纯素材模式只能全屏；需要讲解头像请先使用数字人口播 |
多机位无法启用或生成失败（进阶本地机位功能）
| 现象 | 处理 |
|---|---|
| 「启用多机位」不可点 | 至少导入 2 个本地机位素材 |
| 没有分镜可分配 | 先完成字幕处理，让项目生成分镜 |
| 提示旧版云端模板记录 | 新版多机位需重新导入本地 A/B/C 机位素材 |
| 提示机位素材文件不存在 | 原始本地文件可能被移动或删除，请重新导入 |
| 浏览器预览无法加载本地素材 | 使用桌面客户端打开项目，浏览器预览能力有限 |
多机位是进阶本地机位功能，实际可用性以客户端提示为准。
网络视频没有应用到分镜
- 只会自动应用高匹配候选，低匹配会跳过
- 网络不稳定或素材源不可用时，可改用 AI 生图（提交前核对积分报价）或自有素材
- 发布前请自行确认网络素材授权与平台规则
图文、热点与远程任务
图文卡片导出或抖音图文上传失败
- 先确认至少已完成图文规划，并且每张图卡都有标题
- 图文发布目前只支持抖音；其它平台显示“即将上线”属于正常状态
- 抖音图文上传前，检查标题或正文至少填写了一项
- 登录、风控或图片顺序无法校验时，内置 Chrome 会保留在发布页，请人工检查后再继续
详见 13-图文发布。
热点选题无法创建视频项目
- 先在「我的选题」完成文案定稿，确保最终文稿不是空白
- 选题角度、事实卡或多模型写稿仍在运行时，等待任务完成后再修改下游内容
- 热点来源正文不足时，系统会降级为摘要或标题；不要把未核验的信息当作事实发布
详见 14-热点选题。
远程工作台显示没有可执行设备
- 确认网页端和桌面端登录的是同一个 DouFlow 账号
- 保持新版桌面客户端打开并联网，等待设备状态刷新
- 在网页端「设备」页确认桌面端在线；离线、退出或网络中断时任务会等待桌面端恢复
详见 15-远程工作台。
直播话术防护没有声音或不同步（Windows）
- 打开话术防护页，等待输入麦克风和输出虚拟麦克风完成检测；更换设备后点击麦克风区域右上角的刷新按钮
- 在 OBS / 直播伴侣中选择客户端提示的虚拟麦克风。外部 VB-CABLE 场景通常为
CABLE Output (VB-Audio Virtual Cable)；产品组件可用时以页面显示的设备名为准 - 将直播软件的视频延迟设为 800 ms，并使用耳机测试是否存在回声
- 话术防护为 Beta，正式直播前应在非正式环境完整试讲
详见 07-直播助手。
发布
一直 waiting_user
- 查看是否弹出 Chrome 创作者中心
- 扫码登录对应平台
- 回到 DouFlow 点「已登录，继续」
- 不要手动关闭自动化控制的浏览器窗口
上传失败
- 视频过大 — 压缩或剪短
- 网络不稳定 — 重试
- 账号权限 — 确认创作者中心可正常手动上传
内置 Chrome 无法打开或持续登录失败
- 退出当前采集 / 发布任务并重启 DouFlow
- 在 设置 中重置内置浏览器环境
- 重新发起操作，并在打开的浏览器中完成登录或安全验证
- 若仍失败，导出日志并附上复现步骤联系支持
Agent 接入
| 现象 | 处理 |
|---|---|
| health_check 失败 | 开启 Agent 侦听；客户端保持打开 |
| skill_disabled | 在接入中心勾选对应 Skill |
| MCP 连不上 | 确认 Node 18+；检查 38767 端口未被占用 |
详见 08-Agent接入。
如何导出日志
- 客户端 帮助中心
- 打开 诊断日志 面板（部分版本需连点解锁开发者工具）
- 复制日志或找到本机
logs目录 - 发送邮件至 support@douflow.top 并说明复现步骤
下一篇
→ 11-常见问题