OctoReport 常见问题与支持

403 Forbidden:网站需要登录或 Cookie 才能访问
- 进入数据源配置,启用「Cookie 配置」
- 参考 RSS订阅源文档配置全局或自定义 Cookie
404 Not Found:RSSHub 路由不存在或路径错误
- 使用「RSSHub 路由搜索」功能查找正确的路由
- 检查路由参数是否填写正确(例如用户ID、分类等)
RSSHub 实例故障:系统会自动切换到备用实例,稍后重试即可

2.3 报告生成失败,如何排查?

常见原因和解决方法:

失败原因	解决方法
知识库没有内容	检查关联的知识库是否有数据,如果没有,先执行数据源收集
LLM API 调用失败	检查 API Key 是否配置正确(管理员设置),或稍后重试
变量传递错误	检查步骤间变量引用是否正确(格式:`{{step_1_output}}`)
积分不足	充值积分或使用成本更低的模型(例如 GPT-4o-mini)

2.4 问答（Ask）无法找到相关内容?

问答的知识库模式基于关键词检索,如果找不到内容:

检查知识库:确认选择的知识库中有相关内容
调整提问方式:使用更具体的关键词,例如:
- ❌ 不好的提问:「有什么新闻吗?」
- ✅ 好的提问:「过去 3 天有哪些关于 AI 大模型的新闻?」
切换通用模式:如果知识库模式无法满足需求,可切换到通用模式(不基于知识库)

2.5 触发收件箱（邮件通道）没有收到回复?

请检查以下几点:

邮箱白名单:确认发送邮件的邮箱已添加到「邮箱白名单」(设置页面)
邮件主题和内容:邮件主题应包含主题词,正文应描述清楚时间范围和需求
积分余额:每次触发收件箱请求（邮件通道）需要约 100 积分,检查余额是否充足
每日限额:默认每天最多 10 次触发收件箱请求,超过限额会被拒绝
垃圾邮件文件夹:检查回复邮件是否被误判为垃圾邮件

3. 计费与积分

3.1 积分如何获取?

目前有两种获取方式:

新用户赠送:注册成功后自动获得 10,000 积分
兑换码充值:在「积分管理」页面输入兑换码充值(兑换码可通过活动或购买获得)

未来会支持在线支付充值。

3.2 积分如何消耗?

不同操作的积分成本如下:

操作类型	积分成本	说明
数据源收集(基础)	1-5 credits	RSS、Email、Google News 等不需要抓取的源
数据源收集(抓取)	5-10 credits	搜索源、网页抓取等需要调用第三方 API 的源
内容清洗	10-20 credits	使用 LLM 提取标题、摘要、关键词
报告生成	50-500 credits	取决于模型选择和内容长度(GPT-4o 最贵,GPT-4o-mini 最便宜)
问答	1-50 credits	取决于模型选择和对话长度
触发收件箱（邮件）	~100 credits	包括意图解析、报告匹配、模板触发等所有步骤

3.3 任务失败会扣费吗?

不会。OctoReport 采用「原子计费」机制:

任务开始前,先扣除预估费用
任务完成后,计算实际费用
- 如果成功 → 按实际费用结算,多余积分退还
- 如果失败 → 全额退款,积分不会损失
所有扣费和退款记录都可以在「积分管理」页面查看

3.4 如何查看积分消费记录?

进入「积分管理」页面,可以查看:

当前余额:账户可用积分
消费明细:所有扣费和退款记录,包括操作类型、时间、金额、状态
筛选功能:按操作类型(收集、清洗、报告、问答)、时间范围筛选

3.5 为什么消费明细中有负数(退款)?

负数表示退款操作,常见原因:

任务执行失败(例如 LLM API 调用失败、网络超时)
预估费用高于实际费用(例如预估 100 credits,实际只用了 80 credits,退还 20 credits)

所有退款记录都有详细说明,可以点击查看原因。

4. 数据安全

4.1 我的数据安全吗?

OctoReport 非常重视数据安全,采用多重保护措施:

数据隔离:每个用户的数据完全隔离,其他用户无法访问
API Key 加密:所有敏感 API Key(Firecrawl、OpenAI 等)使用 AES-256-GCM 加密存储
传输加密:所有数据传输使用 HTTPS 加密
权限控制:严格的用户权限控制,只有管理员才能访问系统配置
定期备份:数据库每天自动备份,防止数据丢失

4.2 我的内容会被用于训练 AI 模型吗?

不会。OctoReport 仅将内容发送到第三方 LLM 服务(OpenAI、Claude 等)用于生成报告和对话,不会用于训练模型:

OpenAI API 默认不会使用用户数据训练模型(参考 OpenAI 数据使用政策)
Anthropic Claude API 同样有严格的数据隐私保护政策
如果使用自托管 LLM(未来支持),数据完全不会离开你的服务器

4.3 我可以导出我的数据吗?

可以,但目前需要手动导出:

报告内容:进入报告详情页,复制 Markdown 内容
知识库内容:进入知识库详情页,复制内容列表
问答记录:进入问答会话,复制对话内容

未来会提供一键导出功能(JSON/CSV/Markdown 格式)。

4.4 删除数据后可以恢复吗?

取决于删除类型:

软删除(例如删除数据源、知识库、报告):数据会保留 30 天,期间可以联系客服恢复
硬删除(例如删除账号):数据立即物理删除,无法恢复
过期内容:URL 去重时标记为过期的内容会保留 90 天,之后自动删除

5. 使用限制

5.1 有哪些使用限制?

为了保证系统稳定性和公平性,设置了以下限制:

限制项	默认值	说明
数据源数量	50 个	每个用户最多创建 50 个数据源
知识库数量	20 个	每个用户最多创建 20 个知识库
报告模板数量	20 个	每个用户最多创建 20 个报告模板
问答会话数量	无限制	可创建任意数量的问答会话
触发收件箱频率（邮件）	10 次/天	每个用户每天最多触发 10 次邮件请求
单次报告长度	128K tokens	取决于 LLM 模型的上下文窗口

如需提升限额,请联系客服。

5.2 最小执行间隔是多久?

数据源和报告模板的最小执行间隔:

数据源:最小间隔 1 小时(避免频繁抓取浪费资源)
报告模板:最小间隔 1 小时(避免频繁生成报告)

如果需要更频繁的执行,建议使用「手动触发」功能。

6. 联系支持

6.1 如何联系客服?

我们提供多种支持渠道:

电子邮件(工作日 24 小时内回复):[email protected]
在线反馈:进入「设置」页面,点击「反馈与建议」提交工单
文档中心:查看完整文档
问题反馈:GitHub Issues

6.2 反馈问题时需要提供哪些信息?

为了更快地解决问题,请提供以下信息:

问题描述:详细描述问题现象和复现步骤
截图或录屏:如果是界面问题,提供截图或录屏
错误日志:如果有错误提示,提供完整的错误信息
任务 ID:如果是数据源或报告问题,提供任务日志中的任务 ID
浏览器和操作系统:例如「Chrome 120 / macOS 14.0」

6.3 功能建议如何提交?

我们非常欢迎用户的功能建议!提交方式:

邮件:发送到 [email protected],主题注明「功能建议」
在线反馈:在「设置」页面提交反馈,选择类型为「功能建议」
GitHub Discussions:在 GitHub 上发起讨论

7. 技术架构FAQ

关于 OctoReport 核心技术的深度解答,涵盖架构设计、计费机制、安全措施等。

7.1 为什么选择 RSSHub 混合架构?

单一 RSSHub 实例存在单点故障风险。我们采用"内嵌实例 + 外部实例"的混合架构,按优先级自动切换,保证采集成功率 > 95%。即使内嵌实例故障,也能无缝切换到外部实例。

7.2 URL 去重与过期如何配合报告生成?

重复 URL 采集成功时,旧版本会标记为"已过期",保存新版本。报告生成时默认只使用未过期内容,避免同一 URL 多版本混乱。历史版本仍可追溯,但不参与报告。

详见 URL去重技术文档。

7.3 如何保证扣费一致性?

我们使用数据库事务 + 行锁机制,确保"检查余额 → 扣费 → 执行任务"是原子操作。任务失败时自动回滚,永不出现"扣费但任务失败"的情况。所有交易记录完整留痕,可审计。

详见原子计费技术文档。

7.4 任务失败与重试如何呈现?

任务失败后最多重试 3 次,状态清晰标记为"RETRYING"。第 3 次仍失败后标记为"FAILED",并发送邮件通知。每次尝试独立记录日志(尝试次数、执行耗时、错误原因),便于排查。

7.5 是否支持私有化部署?

完全支持。OctoReport 是 MIT License 开源项目,可自托管在任何服务器。我们提供完整的部署文档(Docker Compose 一键部署),以及技术支持(GitHub Issues)。

7.6 安全性与日志保护如何实现?

API Key 加密:AES-256-GCM 加密存储
多租户隔离:所有查询默认按 userId 过滤
日志脱敏:生产日志自动过滤 Cookie/Session/Token
权限控制:ADMIN/USER 角色,路由级中间件保护

7.7 与普通"LLM 聚合网站"的差异?

普通聚合网站只做"网页拼贴",我们做的是"工程可信的数据处理":

数据去重与版本管理:避免重复/过时内容
原子计费与补偿:永不丢钱
任务队列与重试:稳定可靠
完整日志与可观测:问题可追踪

7.8 支持哪些 LLM 模型?

所有 OpenAI SDK 兼容的模型,包括:

OpenAI: GPT-4o, GPT-4o-mini, o1
火山引擎: Doubao 系列
Anthropic: Claude 3.5 Sonnet
Deepseek: Deepseek V3
自定义: 任何兼容 OpenAI API 的模型

7.9 Credit 系统是如何计费的?

按操作类型计费:

搜索/爬虫: 每次 ¥0.01-0.05(根据源类型)
LLM 清洗: 每次 ¥0.02-0.1(根据模型)
报告生成: 按 Token 计费(模型定价)

所有费用提前估算,余额不足时拦截任务。详见上文「3.2 积分如何消耗」。

7.10 可以导出数据吗?

完全可以。所有数据存储在 PostgreSQL 数据库,支持:

数据库导出:pg_dump 完整备份
API 导出:通过 API 获取 JSON 数据
报告下载:Markdown/HTML 格式

7.11 如何贡献代码或报告问题?

欢迎贡献!

GitHub 仓库:github.com/Octo-o-o-o/OctoReport
Issue 提交:github.com/Octo-o-o-o/OctoReport/issues
Pull Request:遵循代码规范,通过测试即可合并

7.12 有技术支持吗?

社区支持:GitHub Issues(免费)
邮件支持:[email protected](云服务用户优先)
技术文档:完整的部署指南、API 参考、故障排查

8. 更多资源

新手指南 - 快速了解 OctoReport 的核心功能
功能文档 - 详细的功能说明和配置指南
最佳实践 - 成本优化和性能提升技巧

还有其他问题? 发送邮件到 [email protected],我们会尽快回复。

这里汇总了用户最常遇到的问题和解决方案。如果你的问题未在此列出,请通过下方的支持渠道联系我们。

1. 账号相关

1.1 如何注册账号?

访问 www.octoooo.com,点击「开始使用」按钮:

邮箱 + 密码:填写邮箱和密码(8位以上,包含字母和数字),验证邮箱后完成注册
Magic Link:输入邮箱,系统发送登录链接到邮箱,点击即可登录(无需密码)
第三方登录:支持 Google、GitHub 账号快速登录

1.2 忘记密码怎么办?

如果忘记密码,有两种解决方案:

使用 Magic Link 登录(推荐):在登录页选择「Magic Link」,输入注册邮箱,点击邮件中的链接即可登录
重置密码:点击登录页的「忘记密码」链接,输入注册邮箱,按照邮件提示重置密码

1.3 可以更换邮箱吗?

目前暂不支持直接更换注册邮箱。如有特殊需求,请联系客服处理。

1.4 如何删除账号?

进入「设置」页面,在底部找到「删除账号」按钮:

删除账号后,所有数据(数据源、知识库、报告、问答记录)将被永久删除
未使用的积分将被清零,无法退款
操作不可撤销,请谨慎操作

2. 功能使用

2.1 数据源创建后没有自动收集内容?

请检查以下几点:

定时策略设置:确认数据源的定时策略不是「手动触发」,如果是间隔模式或周计划模式,查看「下次执行时间」是否已到
余额充足:检查账号积分是否充足(每次收集需要 1-50 积分)
任务日志:进入「任务日志」页面,查看是否有失败记录,如果有请查看失败原因
手动触发:可以在数据源详情页点击「立即执行」按钮手动触发一次收集

2.2 RSS 数据源返回 403 或 404 错误?

这通常是因为目标网站有访问限制或 RSSHub 路由配置问题:

403 Forbidden:网站需要登录或 Cookie 才能访问
- 进入数据源配置,启用「Cookie 配置」
- 参考 RSS订阅源文档配置全局或自定义 Cookie
404 Not Found:RSSHub 路由不存在或路径错误
- 使用「RSSHub 路由搜索」功能查找正确的路由
- 检查路由参数是否填写正确(例如用户ID、分类等)
RSSHub 实例故障:系统会自动切换到备用实例,稍后重试即可

2.3 报告生成失败,如何排查?

常见原因和解决方法:

失败原因	解决方法
知识库没有内容	检查关联的知识库是否有数据,如果没有,先执行数据源收集
LLM API 调用失败	检查 API Key 是否配置正确(管理员设置),或稍后重试
变量传递错误	检查步骤间变量引用是否正确(格式:`{{step_1_output}}`)
积分不足	充值积分或使用成本更低的模型(例如 GPT-4o-mini)

2.4 问答（Ask）无法找到相关内容?

问答的知识库模式基于关键词检索,如果找不到内容:

检查知识库:确认选择的知识库中有相关内容
调整提问方式:使用更具体的关键词,例如:
- ❌ 不好的提问:「有什么新闻吗?」
- ✅ 好的提问:「过去 3 天有哪些关于 AI 大模型的新闻?」
切换通用模式:如果知识库模式无法满足需求,可切换到通用模式(不基于知识库)

2.5 触发收件箱（邮件通道）没有收到回复?

请检查以下几点:

邮箱白名单:确认发送邮件的邮箱已添加到「邮箱白名单」(设置页面)
邮件主题和内容:邮件主题应包含主题词,正文应描述清楚时间范围和需求
积分余额:每次触发收件箱请求（邮件通道）需要约 100 积分,检查余额是否充足
每日限额:默认每天最多 10 次触发收件箱请求,超过限额会被拒绝
垃圾邮件文件夹:检查回复邮件是否被误判为垃圾邮件

3. 计费与积分

3.1 积分如何获取?

目前有两种获取方式:

新用户赠送:注册成功后自动获得 10,000 积分
兑换码充值:在「积分管理」页面输入兑换码充值(兑换码可通过活动或购买获得)

未来会支持在线支付充值。

3.2 积分如何消耗?

不同操作的积分成本如下:

操作类型	积分成本	说明
数据源收集(基础)	1-5 credits	RSS、Email、Google News 等不需要抓取的源
数据源收集(抓取)	5-10 credits	搜索源、网页抓取等需要调用第三方 API 的源
内容清洗	10-20 credits	使用 LLM 提取标题、摘要、关键词
报告生成	50-500 credits	取决于模型选择和内容长度(GPT-4o 最贵,GPT-4o-mini 最便宜)
问答	1-50 credits	取决于模型选择和对话长度
触发收件箱（邮件）	~100 credits	包括意图解析、报告匹配、模板触发等所有步骤

3.3 任务失败会扣费吗?

不会。OctoReport 采用「原子计费」机制:

任务开始前,先扣除预估费用
任务完成后,计算实际费用
- 如果成功 → 按实际费用结算,多余积分退还
- 如果失败 → 全额退款,积分不会损失
所有扣费和退款记录都可以在「积分管理」页面查看

3.4 如何查看积分消费记录?

进入「积分管理」页面,可以查看:

当前余额:账户可用积分
消费明细:所有扣费和退款记录,包括操作类型、时间、金额、状态
筛选功能:按操作类型(收集、清洗、报告、问答)、时间范围筛选

3.5 为什么消费明细中有负数(退款)?

负数表示退款操作,常见原因:

任务执行失败(例如 LLM API 调用失败、网络超时)
预估费用高于实际费用(例如预估 100 credits,实际只用了 80 credits,退还 20 credits)

所有退款记录都有详细说明,可以点击查看原因。

4. 数据安全

4.1 我的数据安全吗?

OctoReport 非常重视数据安全,采用多重保护措施:

数据隔离:每个用户的数据完全隔离,其他用户无法访问
API Key 加密:所有敏感 API Key(Firecrawl、OpenAI 等)使用 AES-256-GCM 加密存储
传输加密:所有数据传输使用 HTTPS 加密
权限控制:严格的用户权限控制,只有管理员才能访问系统配置
定期备份:数据库每天自动备份,防止数据丢失

4.2 我的内容会被用于训练 AI 模型吗?

不会。OctoReport 仅将内容发送到第三方 LLM 服务(OpenAI、Claude 等)用于生成报告和对话,不会用于训练模型:

OpenAI API 默认不会使用用户数据训练模型(参考 OpenAI 数据使用政策)
Anthropic Claude API 同样有严格的数据隐私保护政策
如果使用自托管 LLM(未来支持),数据完全不会离开你的服务器

4.3 我可以导出我的数据吗?

可以,但目前需要手动导出:

报告内容:进入报告详情页,复制 Markdown 内容
知识库内容:进入知识库详情页,复制内容列表
问答记录:进入问答会话,复制对话内容

未来会提供一键导出功能(JSON/CSV/Markdown 格式)。

4.4 删除数据后可以恢复吗?

取决于删除类型:

软删除(例如删除数据源、知识库、报告):数据会保留 30 天,期间可以联系客服恢复
硬删除(例如删除账号):数据立即物理删除,无法恢复
过期内容:URL 去重时标记为过期的内容会保留 90 天,之后自动删除

5. 使用限制

5.1 有哪些使用限制?

为了保证系统稳定性和公平性,设置了以下限制:

限制项	默认值	说明
数据源数量	50 个	每个用户最多创建 50 个数据源
知识库数量	20 个	每个用户最多创建 20 个知识库
报告模板数量	20 个	每个用户最多创建 20 个报告模板
问答会话数量	无限制	可创建任意数量的问答会话
触发收件箱频率（邮件）	10 次/天	每个用户每天最多触发 10 次邮件请求
单次报告长度	128K tokens	取决于 LLM 模型的上下文窗口