> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genaura.bianjie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题（FAQ）

## 概述

本篇汇总 GenAura 桌面应用使用过程中最高频的疑问，按功能模块分类组织。答案用产品语言讲清楚"是什么、为什么、怎么做"，帮你快速消除疑惑。

如果你遇到的问题不在本篇范围，请先查阅：

* 按症状定位的排查指南：[故障排查](/troubleshooting)
* 各功能模块的操作细节：[操作指南目录](/how-to/01-brand-management)
* 底层机制解释：[概念解释目录](/concepts/01-brand-model)
* 名词看不懂：[术语表](/glossary)

> 提示：本篇与各模块文档末尾的「常见问题」章节内容互补——本篇聚焦跨模块的高频疑问与简明结论，模块文档中的 FAQ 则提供更具体的操作上下文。

***

## 安装与启动

### Q：GenAura 支持哪些操作系统？支持 Linux 吗？

A：官方支持 **macOS 与 Windows**。如有 Linux 需求可联系团队获取。详见 [安装指南](/getting-started/01-installation)。

### Q：macOS 安装时提示"来自身份不明的开发者"或"已损坏"怎么办？

A：当前版本打包未启用代码签名。解决方式：

* **首次启动右键打开**：在「应用程序」中右键点击 GenAura →「打开」→ 确认框中点击「打开」（仅需一次）。
* **系统设置放行**：「系统设置 → 隐私与安全性」→ 滚动到底部点击「仍要打开」。

若 dmg 提示"映像已损坏"，通常是下载不完整，请重新下载并校验文件大小。详见 [安装指南 FAQ](/getting-started/01-installation#常见问题)。

### Q：Windows 安装时被 SmartScreen 拦截怎么办？

A：安装包未通过代码签名。在 SmartScreen 弹窗中点击「更多信息」→「仍要运行」即可继续安装。

### Q：应用如何更新？需要手动下载新版本吗？

A：GenAura 内置自动更新机制。应用会自动检查更新，发现新版本后提示你，确认后自动下载并重启安装。磁盘空间不足时会触发告警并暂停自动下载，详见 [更新与维护](/reference/02-update-maintenance)。

### Q：数据存在哪里？安全吗？

A：品牌数据存储在本地数据库中，知识库文件本地化保存，AI 平台账号登录态存储在内嵌浏览器的独立会话中，与系统浏览器隔离。详见 [数据隐私](/reference/03-data-privacy)。

***

## 登录与账号

### Q：登录是在哪里完成的？桌面端能直接输入账号密码吗？

A：GenAura 采用**网页登录流程**，桌面端不提供账号密码输入框。点击登录页的「使用网页登录」后会唤起系统默认浏览器跳转至 Web 控制台完成认证，认证成功后自动回跳桌面端。详见 [登录与账号](/getting-started/02-login-account)。

### Q：点击「使用网页登录」后浏览器没打开，或登录成功后桌面端没反应？

A：常见原因：

* 系统未设置默认浏览器 → 在系统设置中指定。
* 应用专用回跳协议未注册成功或被其他应用抢占 → 重启 GenAura 后重新走一次登录流程。
* 浏览器询问"是否打开 GenAura"时被拒绝 → 在弹窗中允许。

详见 [故障排查 - 登录与账号](/troubleshooting) 与 [登录与账号 FAQ](/getting-started/02-login-account#常见问题)。

### Q：使用过程中突然提示「登录已过期，请重新登录」？

A：登录凭证过期后系统会自动尝试刷新，若多次刷新均失败（可能是刷新凭证已过期/被吊销、网络长时间不可用、在另一台设备退出登录），会跳回登录页。请重新点击「使用网页登录」。详见 [故障排查 - 登录与账号](/troubleshooting)。

### Q：登录后没有看到新手引导？

A：引导在**进入品牌工作区后**才会触发，且需满足：①已创建至少一个品牌；②品牌初始化已完成（顶部不再显示"正在初始化品牌空间…"）；③本机未标记为"已完成引导"。若已跳过引导想重看，需清除本机的引导完成标记。详见 [新手引导 FAQ](/getting-started/03-onboarding#常见问题)。

***

## 品牌与配置

### Q：品牌数量上限是多少？可以创建很多品牌吗？

A：品牌数量上限默认为 **3 个**。达到上限时「新建品牌」按钮会置灰禁用，悬停提示「已达到品牌数量上限」，按钮右侧显示"当前数量/上限"计数。

### Q：创建品牌时需要填哪些字段？有「简介/行业」字段吗？

A：创建品牌对话框的字段为：**名称 / Logo / 链接 / 素材文件上传**。没有「简介」「行业」字段——这些信息在品牌创建后通过右侧面板「品牌配置」Tab 的「基本信息」分区补充（包含描述、关键词、别名等）。素材文件仅支持 md/txt/docx/pdf 四种格式。

### Q：创建品牌时上传的素材文件去哪了？为什么品牌配置里看不到？

A：素材文件会自动导入到该品牌知识库的"原始物料与素材"系统目录下，需在右侧面板「知识库」Tab 中查看。素材文件**不会**出现在品牌配置 Tab 中。详见 [品牌管理](/how-to/01-brand-management) 与 [知识库管理](/how-to/08-knowledge-base)。

### Q：删除品牌是物理删除还是软删除？

A：UI 上的「删除品牌」是**软删除（归档）**——品牌会被停用，其所有定时任务也会被停用，并从前端列表中隐藏。归档后的品牌记录仍在数据库中，但不会出现在任何功能模块。若删除的是当前活跃品牌，应用会自动跳转到列表中第一个未归档的品牌；若全部归档则跳转到引导页。

### Q：产品、竞品、预设问题各最多能加多少个？

A：

| 项目   | 上限                      |
| ---- | ----------------------- |
| 产品   | 5 个                     |
| 竞品   | 5 个                     |
| 预设问题 | 30 条（**品牌级 + 所有产品级合计**） |

注意：预设问题的 30 条上限**不是**"每个品牌/产品各 30 条"，而是单个品牌下（品牌级 + 所有产品级）合计。竞品不支持添加预设问题（竞品仅作为对比参照对象）。

### Q：AI 平台跟踪最多能同时开几个？为什么默认开的是这三个？

A：同时开启上限 **3 个**。系统中共有 6 个可跟踪平台：5 个有工作流的（DeepSeek、豆包、通义千问、Kimi、腾讯元宝）+ 1 个无工作流的（文心一言，显示「敬请期待」）。首次进入未初始化的品牌时，系统会自动开启前 3 个：**DeepSeek、豆包、通义千问**。详见 [品牌配置](/how-to/02-brand-config)。

### Q：品牌被归档后为什么所有「编辑」「添加」按钮都不见了？

A：品牌归档后，品牌配置 Tab 的所有编辑入口会统一隐藏，仅可查看。如需编辑，请先将品牌恢复为活跃状态。详见 [品牌配置 FAQ](/how-to/02-brand-config#常见问题)。

***

## 对话与消息

### Q：点击「新对话」后，左侧列表为什么没有立刻多出一条？

A：这是设计行为。点击「新对话」只是进入空状态欢迎界面，对话记录在你**发送第一条消息时**才真正写入索引并出现在列表中。新对话的初始标题为「新对话」，发出首条消息后 AI 会自动生成更贴切的标题。详见 [对话管理](/how-to/03-chat-management)。

### Q：单条消息最多能输入多少字？为什么提示「输入内容已达上限」？

A：纯文本上限 **6000 字符**（不含 @引用的知识库文件）。超出会弹出提示并阻止继续输入。可通过精简提示词、将长文本保存为知识库文件后用 `@` 引用、或拆分为多条消息分批发送。详见 [命令与提及 FAQ](/how-to/05-commands-mentions#常见问题)。

### Q：为什么不能直接拖拽文件到对话输入框？PDF/DOCX 怎么引用？

A：对话输入框不支持原生文件上传。请先通过知识库导入（支持 md/txt/docx/pdf）将文件存入知识库，再用 `@` 引用。注意：`@` 引用**仅支持文本类文件**（md/txt/csv/json/html）；PDF/DOCX 导入知识库后系统会生成对应的文本版本，请引用该文本版本。详见 [消息发送](/how-to/04-messaging) 与 [命令与提及](/how-to/05-commands-mentions)。

### Q：AI 消息为什么没有删除按钮？发送按钮为什么变红了？

A：当前实现中 AI 消息不可单独删除，仅用户消息支持删除。如需重新生成 AI 回复，请使用 AI 消息上的「重试」按钮，或删除其上一条用户消息后重新发送。AI 正在响应时，发送按钮会切换为红色停止按钮，点击可中断当前响应。详见 [消息发送 FAQ](/how-to/04-messaging#常见问题)。

### Q：为什么有的对话显示时钟图标？

A：该对话由定时任务自动触发创建，并非你手动新建。定时任务的配置见 [定时任务](/how-to/12-cron-tasks)。

### Q：子代理执行很慢或一直排队怎么办？

A：子代理并发上限默认为 **3 个**。若同时有多个子代理在运行，新的子任务会排队等待（最长 5 分钟）。排队超时后主 AI 助手会自行决定是否重试或降级。若频繁超时，建议拆分为多轮对话逐步完成。详见 [子代理与审批 FAQ](/how-to/06-sub-agent-approval#常见问题)。

### Q：人工审批对话框会一直等吗？哪些工具会触发审批？

A：是的。AI 助手触发审批后会暂停等待你的决策，不会自动超时跳过，需主动点击「批准」或「拒绝」。审批状态会持久化保存，即使应用重启也能恢复未决审批。人工审批仅针对运行工作流、写入或修改知识库文件等敏感操作触发；知识库检索、浏览器导航、创建子代理等不会触发审批。详见 [子代理与审批](/how-to/06-sub-agent-approval)。

***

## 工作流与浏览器

### Q：GenAura 内置了哪些 AI 平台工作流？能同时运行吗？

A：内置 **5 个** AI 平台搜索工作流：DeepSeek、通义千问、豆包、Kimi、腾讯元宝。文心一言当前**无工作流**，UI 显示「敬请期待」。

**不能同时运行**——内嵌浏览器是单一实例，多个平台会串行遍历执行。如需周期性多平台监测，请配置定时任务。详见 [AI 平台工作流](/how-to/11-ai-platform-workflows)。

### Q：工作流首次运行就弹出接管，提示需要登录？

A：5 个 AI 平台工作流均要求登录态。首次运行前请在「浏览器」Tab 中手动访问该平台并完成登录（见 [内嵌浏览器](/how-to/10-browser) 的登录态管理）。登录态存储在内嵌浏览器的独立会话中，后续运行无需重复登录。工作流运行时若检测到未登录会弹出接管对话框，点击「接管」手动登录后「释放」即可恢复。

### Q：工作流运行中弹出「检测到验证码」怎么办？

A：这是正常的安全机制。AI 平台检测到异常流量时会弹出人机验证。点击接管提示条中的「接管」按钮，手动完成滑块/拼图/点选验证后点击「释放」，工作流会从失败步骤自动恢复执行。详见 [故障排查 - 弹出验证码](/troubleshooting)。

### Q：提示「用户未完成登录」但我在接管中确实登录了？

A：接管后工作流会重新检测登录态，若仍未通过则抛出此错误。常见原因：①登录窗口未完全关闭、页面未完成跳转就点击了「释放」——请等待页面跳转完成后再释放；②平台登录态检测信号较弱——刷新页面后重新接管尝试。详见 [故障排查 - 接管后提示用户未完成登录](/troubleshooting)。

### Q：工作流失败后会自动重试吗？

A：工作流本身不自动重试。但 5 个 AI 平台工作流均设置"失败后降级到 AI 助手"，失败后 AI 助手会基于失败快照与截图诊断原因，通过接管让你修复，再精确重试失败的"问题 + 平台"组合（而非从头重跑所有平台），最多 2 轮自愈重试。详见 [工作流原理](/concepts/02-workflow)。

### Q：浏览器 Tab 关闭后登录态会丢失吗？多个 AI 平台的登录态会互相干扰吗？

A：都不会。关闭浏览器只会清空当前页面，不会清除登录态，下次打开登录态依然有效。所有平台共用内嵌浏览器的会话，但各平台的登录态由各自的 Cookie 独立维护，互不影响——在一个平台登录不会导致另一个平台登出。详见 [内嵌浏览器 FAQ](/how-to/10-browser#常见问题)。

### Q：内嵌浏览器里点击页面内的链接没反应？

A：内嵌浏览器会拦截所有弹出新窗口的链接。如需在系统浏览器打开，请复制地址栏 URL 粘贴到系统浏览器。普通链接若在当前页跳转则可正常工作。地址栏仅允许 http\:// 和 https\:// 协议，省略协议头会自动补 https\://。

***

## 知识库与文件

### Q：知识库支持导入哪些文件格式？为什么我导入的 csv/xlsx 没出现？

A：知识库**导入**仅支持 **md / txt / docx / pdf** 四种格式。csv/xlsx/xls/图片格式**无法导入**，只能通过 [文件编辑器](/how-to/09-file-editor) 预览。如需让 AI 检索表格数据，请先将其转为 md 或 txt。

### Q：PDF 导入后为什么没内容？

A：大概率是**扫描件 PDF**（图像型 PDF）。系统依赖文本层提取文字，扫描件没有文本层，会弹出「目前暂不支持扫描件」提示。建议使用 OCR 工具转为文本型 PDF，或直接导出为 md/txt 后再导入。

### Q：知识库有哪些系统目录和系统文件？能删除吗？

A：系统目录共 **7 个**：原始物料与素材、品牌画像、竞品分析、产品信息、经验与案例、分析报告、GEO 内容。

系统文件共 **6 个**（保护级别最高）：品牌画像下的品牌概述、用户画像、标准表述、信息缺口确认，以及产品矩阵概览、竞争格局概览。系统文件**可编辑内容但不可删除、重命名或移动位置**。详见 [知识库管理](/how-to/08-knowledge-base)。

### Q：如何让 AI 在对话中引用知识库文件？

A：两种方式：①在知识库树中右键文件 →「添加至对话」；②在对话输入框输入 `@` 触发提及面板选择文件。注意 `@` 引用仅支持 md/txt/csv/json/html 文本类文件，二进制文档（docx/pdf）需引用其导入后生成的文本版本。详见 [命令与提及](/how-to/05-commands-mentions)。

### Q：URL 导入失败提示「请手动粘贴正文」怎么办？

A：目标站点可能存在反爬、付费墙或登录墙。可在 [内嵌浏览器](/how-to/10-browser) 中打开该网页登录后复制正文，再以 md 文件手动导入。

### Q：文件编辑器能编辑哪些类型？xlsx 为什么只显示下载提示？

A：可编辑类型包括 md 及多种纯文本格式（txt/json/html/py/js/ts/yaml 等）。只预览类型包括 csv/xlsx/xls/pdf/docx/图片。Excel 文件为二进制格式，编辑器未内置电子表格渲染——请点击顶部「下载」按钮保存到本地后用 Excel/WPS 查看。若需在 GenAura 内以表格形式查看，建议将数据导出为 .csv。详见 [文件编辑器](/how-to/09-file-editor)。

### Q：编辑过程中断网或保存失败，内容会丢吗？

A：不会。保存失败时内容会自动写入本地草稿。下次重新打开同一文件时，顶部会提示「检测到本地有未保存的草稿」，点击「恢复草稿」即可找回。保存成功后草稿会被自动清除。

***

## 内容发布

### Q：GenAura 当前支持发布到哪些平台？能发到知乎、微博、微信公众号吗？

A：当前版本支持发布到 **5 个**平台：**百家号、搜狐号、CSDN、掘金、知乎**。其余平台（微博、B 站、语雀、微信公众号、51CTO、慕课、开源中国、SegmentFault、博客园、豆瓣、雪球、人人都是产品经理、东方财富、头条号）将在后续版本逐步开放。详见 [文章发布](/how-to/13-article-publish)。

### Q：平台显示「未登录」，但我在系统浏览器里已经登录过？

A：GenAura 发布使用的是内嵌浏览器会话的 Cookie，**与系统浏览器不共享**。请在发布对话框点击该平台的「前往登录」打开内嵌登录窗口，登录成功后窗口会自动关闭并提示「{平台} 登录成功」。

### Q：发布卡在「发布中...」超过 5 分钟怎么办？

A：发布操作设置了 5 分钟超时兜底，超时会提示「投放操作超时（5分钟）」。常见原因是目标平台 API 异常或网络不通，请重试；如持续失败请检查平台账号权限或换网络环境。详见 [故障排查 - 文章发布失败](/troubleshooting)。

### Q：发布成功但状态显示「审核中」一直不变？

A：搜狐号、掘金这类需要人工审核的平台，文章需平台审核完成后才会转为「已发布」。GenAura 会周期性检查发布链接是否可达且标题匹配，匹配成功则自动转为「已发布」。若系统多次检查仍未确认（状态显示「未确认」），可在发布记录中手动「标记为已发布」。详见 [文章发布 FAQ](/how-to/13-article-publish#常见问题)。

### Q：发布失败后能在哪里看错误详情？

A：失败的发布**不会写入发布记录**，只在发布完成时的提示框中显示「{平台}: {错误信息}」。常见错误：

| 提示                                | 含义          |
| --------------------------------- | ----------- |
| 登录态过期 / auth\_expired             | 登录态过期，需重新登录 |
| 外部服务调用失败 / external\_api\_error   | 平台 API 异常   |
| 平台未注册 / platform\_not\_registered | 平台适配器加载失败   |
| 投放操作超时                            | 5 分钟超时      |
| 参数校验失败 / validation               | 参数校验失败      |
| 品牌不存在 / not\_found                | 品牌不存在       |

***

## 数据洞察

### Q：刚跑完工作流，AI 洞察里的数据为什么没变化？

A：最常见原因是后台分析任务尚未处理到。后台分析服务会定期轮询待分析任务，且单实例串行处理；远程 AI 服务偶发超时会触发退避重试。请等待 1–2 分钟后刷新。若长时间仍无变化，可能是分析任务失败：

* **提示登录失效**：AI 服务凭证过期，重新登录应用。
* **提示「产品列表不能为空」**：品牌下未配置任何产品，需检查品牌配置。
* **提示「搜索内容不能为空」**：工作流未捕获到 AI 回答，重跑该工作流。

详见 [洞察数据来源](/concepts/03-insight-data) 与 [AI 洞察 FAQ](/how-to/14-insight#常见问题)。

### Q：AI 对话总量为什么和搜索结果总数对不上？

A：两者口径不同。AI 对话总量只统计与目标产品相关的对话，且按所选时间范围、平台、问题类型（AI 洞察页固定为推荐类）筛选；而原始搜索结果是全量记录，包含未完成分析的、其他问题类型的、其他平台的数据。两者不应直接比较。

### Q：品牌提及率为什么会超过 100%？

A：**品牌自身提及率**正常情况下不会超过 100%。**竞品提及率可能超过 100%**——竞品对比中分母是本品牌对话数而非竞品自身对话数，衡量"竞品在本品牌对话中被提及的频率"，可能远超 100%。这是设计行为，不是 bug。详见 [AI 洞察 FAQ](/how-to/14-insight#常见问题)。

### Q：AI 洞察页面为什么没有「标杆品牌」「异常预警」「行业筛选」？

A：当前版本 AI 洞察页面**不提供**这三个功能：竞品对比仅展示当前品牌配置的竞品列表，趋势图仅展示历史数据不主动检测异常，筛选区只有时间范围/问题类型/平台三个维度。问题类型下拉只能选「推荐类」也是产品决策——如需查看「对比型」「评价型」数据请前往 [情感分析](/how-to/15-emotion-analysis) Tab。

### Q：情感评分为 0 是怎么回事？

A：情感评分基于时间范围与平台筛选下的相关对话计算。当筛选结果下无任何相关对话时，情感评分会被置为 0。请检查：①时间范围内是否运行过 AI 平台工作流；②平台筛选是否选了一个无数据的平台（切回「全部平台」验证）；③品牌是否配置了产品配置与预设问题。详见 [情感分析 FAQ](/how-to/15-emotion-analysis#常见问题)。

### Q：左侧导航看不到 AI 刚识别的机会/风险？

A：左侧导航**仅显示"新建"与"跟进中"状态**、**最多各 5 条**。若已有 5 条更高优先级或同优先级但更新的条目，新的会被挤出可见范围。同时检查折叠区是否处于折叠状态。"已完成"或"已忽略"的条目从导航移出但数据库中仍保留。详见 [机会与风险](/how-to/07-opportunities-risks)。

### Q：机会和风险是怎么产生的？

A：由 AI 在品牌诊断或长期监控中自动识别产生。AI 会基于洞察数据分析品牌在 GEO 表现、市场声量、竞争态势中的有利或不利情况，生成机会（正向预警）或风险（负向预警），每条附带标题、描述、场景、问题类型、优先级与影响程度。你可以跟进到关联对话处理，并流转状态（新建 → 跟进中 → 已完成/已忽略）。详见 [机会与风险](/concepts/05-opportunity-risk)。

***

## 定时任务

### Q：定时任务为什么没在指定时间执行？

A：最常见原因是 **App 未运行或电脑处于休眠状态**。定时任务依赖 App 进程调度，关机、休眠或退出 App 期间不会触发。下次启动 App 时，若错过的周期数较多，调度器会自动补执行一次；若仅错过 1 个周期则不补执行。其他可能原因：任务开关已关闭、任务所属品牌已被归档、上一次执行尚未结束（防并发跳过）。详见 [定时任务 FAQ](/how-to/12-cron-tasks#常见问题)。

### Q：有哪些内置定时任务？能删除吗？为什么有两个默认不开启？

A：每个品牌创建时会自动生成 **4 个内置定时任务**：

\| 任务名 | 默认状态 | 执行时间 | |---|---|---|---| | 每日 AI 平台问答 | 开启 | 每天 10:30 | | 每周品牌诊断 | 开启 | 周一 14:00 | | 每日舆情监测 | 暂停 | 每天 15:00 | | 每周舆情报告 | 暂停 | 周一 16:30 |

内置任务**不可删除**，但可以暂停、编辑执行时间、修改提示词。「每日舆情监测」「每周舆情报告」默认暂停，因为它们依赖外部媒体与社交媒体数据源，默认关闭以避免在用户尚未配置相关数据源时产生无意义的执行。

***

## 设置与维护

### Q：应用支持哪些设置项？在哪里调整？

A：设置入口位于左下角账户菜单。包含通用设置、关于、主题切换、防系统休眠开关等。防系统休眠开关控制在工作流/定时任务运行期间是否阻止系统进入休眠状态。详见 [设置参考](/reference/01-settings)。

### Q：磁盘空间不足会有什么影响？

A：GenAura 内置磁盘空间守护机制。当数据目录剩余空间低于 1024 MB 时会弹出"软件数据空间不足"告警（警告级别，静音）；低于 500 MB 时会弹出"软件数据空间严重不足"告警（严重级别，响铃），此时本地数据库有损坏风险，且自动更新下载会被暂停。清理空间至安全线后会自动恢复。详见 [故障排查 - 磁盘空间不足](/troubleshooting)。

***

## 相关文档

* [用户文档总览](/)
* [故障排查](/troubleshooting) — 按症状分类的排查指南
* [术语表](/glossary) — 名词解释
* 入门系列：[安装](/getting-started/01-installation) · [登录](/getting-started/02-login-account) · [新手引导](/getting-started/03-onboarding) · [界面概览](/getting-started/04-interface-overview)
* 概念系列：[品牌模型](/concepts/01-brand-model) · [工作流原理](/concepts/02-workflow) · [洞察数据来源](/concepts/03-insight-data) · [AI Agent](/concepts/04-ai-agent) · [机会与风险](/concepts/05-opportunity-risk)
* 操作指南：[品牌管理](/how-to/01-brand-management) · [品牌配置](/how-to/02-brand-config) · [对话管理](/how-to/03-chat-management) · [消息发送](/how-to/04-messaging) · [命令与提及](/how-to/05-commands-mentions) · [子代理与审批](/how-to/06-sub-agent-approval) · [机会与风险](/how-to/07-opportunities-risks) · [知识库管理](/how-to/08-knowledge-base) · [文件编辑器](/how-to/09-file-editor) · [内嵌浏览器](/how-to/10-browser) · [AI 平台工作流](/how-to/11-ai-platform-workflows) · [定时任务](/how-to/12-cron-tasks) · [文章发布](/how-to/13-article-publish) · [AI 洞察](/how-to/14-insight) · [情感分析](/how-to/15-emotion-analysis) · [偏好洞察](/how-to/16-preference-insight)
* 参考系列：[设置](/reference/01-settings) · [更新与维护](/reference/02-update-maintenance) · [数据隐私](/reference/03-data-privacy)

***

> 最后更新：2026-07-29 | 对应版本：v1.2.0
