Dify 工作流基础 URL

用于播客/视频说话人检测的 Dify 工作流 API 密钥

用于生成 RSS 站点配置的 AI 工作流 API 密钥

用于生成网页模式的 AI 工作流 API 密钥

用于转写文本校正的 Dify 工作流 API 密钥

是否启用播客/视频转写文本校正流程

单次发送给转写校正工作流的最大字符数

每轮文章处理批次优先分配给等待翻译内容的比例（0.01-1），按批次容量向上取整，避免翻译阶段饥饿

播客处理轮询间隔时间（秒）

播客处理最大轮询次数

播客最小时长阈值，低于此时长将被过滤（秒）

视频最小时长阈值，低于此时长将被过滤（秒）

免费用户每日可使用 AI 伴读的次数上限

Pro 用户每日可使用 AI 伴读的次数上限

用于普通对话的模型，建议使用速度较快的模型

用于深度分析的模型，建议使用能力较强的模型

单次对话携带的最大 Token 数，超出时自动截断历史消息

保留的最大对话历史轮数，超出时自动截断最早的消息

用户单条消息允许的最大字符数

OpenAI 或兼容接口的 API 密钥

OpenAI API 的 Base URL，支持自定义兼容接口

SSE 流式响应的超时时间，超时后自动断开连接

免费用户每日可触发内建翻译的文章/推文数量上限

Pro 用户每日可触发内建翻译的文章/推文数量上限

实时翻译优先使用的 LLM 模型（复用 AI 伴读的 OpenAI 兼容接口）

默认模型调用失败或超时时使用的兜底模型

单个段落翻译时 LLM 输出的 Token 上限，超出会截断

段落语言置信度低于该阈值时显示翻译按钮，高于则认为已是目标语言不翻译

建立 SSE 连接后多少毫秒内用户主动 CANCEL 可退回本次配额

Free 用户可查看的译文段落数量，超过后展示升级 Pro CTA

段落级翻译结果在 MongoDB 中的最长保留时间

后端向客户端发送心跳帧的时间间隔，用于防止代理层超时断连

SSE 连接空闲无事件的最大超时时间，超过后主动关闭连接

播客/视频转录翻译的 SSE 空闲超时；长文本可能数千段落，需要更宽松阈值

开启后，同一用户对同一资源仅在首次翻译时扣 1 次配额，跨语言/跨日复访均不再扣费；关闭则回退到按次扣费

开启后，播客的转录翻译入口仅向 Pro 用户开放；Free 用户看到锁标

开启后，视频的转录翻译入口仅向 Pro 用户开放；Free 用户看到锁标

单次翻译会话中段落级 LLM 调用的并发上限；增大可提速但会加大上游限流压力

总开关。开启后高分英文文章在处理完成或人工调分时入队，后台 Job 提前翻译并写入段落缓存，用户首次访问直接看中文。关闭即停止入队和消费（已入队条目保留，重开后继续消费）。

只有综合评分 ≥ 此值的文章才会入队（推荐 88 分）。与下方“高分通知阈值”解耦，可独立调整。

发布时间超过此窗口的旧文章即使评分高也不入队（用户访问概率低）。默认 14 天。

Job 每 30 秒运行一次，单次最多处理此数量的文章。调大可加快队列消费，但需确保在 6 分钟内处理完毕；建议不超过 10。

Job 处理单篇文章时的段落并发上限，与用户实时翻译通道相互隔离，避免后台预热影响用户访问速度。

资源处理完成后综合评分 ≥ 此值触发 Bark 通知运营审核。与“预翻译评分阈值”解耦：可以把通知阈值设得比预翻译阈值更高（仅顶级内容人工兜底）或反过来。

是否向用户开放每日早报功能入口

禁止后台定时生成每日早报内容

Pro 个性化早报候选池仅保留最近 N 天内的内容；公共早报使用下方独立 ConfigKey

公共早报候选池仅保留最近 N 天内的内容；与 Pro 早报解耦，调整本字段不影响 Pro 路径

开启后公共早报将排除最近已推荐过的内容；与 Pro 早报解耦，调整本字段不影响 Pro 路径

AI 相关内容（tagCodes 含 domain-ai/AI 子标签、category=AI，或标题/摘要命中 AI 关键词）的入选最低分；默认 85 放宽召回。与 Pro 早报解耦

与 AI 无关内容的入选最低分；默认 88，更高门槛自然剔除无关内容、保持池子聚焦 AI。与 Pro 早报解耦

开启后会将早报推送到配置的微信群

微信群推送机器人服务地址，例如 https://wechat-bot.example.com

微信群推送机器人 API Key

需要推送的微信群名称，JSON array 格式

用于生成早报内容摘要的 Dify 工作流 API 密钥

关闭后站内 BriefHome 的 textVariant 降级为空，前端自动回退到 contentItems 兜底；用于紧急回滚图文视图

开启后早报页首屏由服务器直接渲染，已登录 Pro 用户打开速度显著提升；关闭立即回退到原客户端渲染（灰度与紧急回滚开关，默认关闭）

总分排序后取 Top N 进入早报候选池

从用户关注源中最多选取的文章数

从兴趣标签匹配中最多选取的文章数

HOT 分桶上限（默认 20）；最终列表 HOT 条数另受「HOT 最少条数」约束

最终 Top50 中 HOT 来源至少保留的条数（默认 5）

三桶合并且同源 cap 之后，按用户领域偏好限制各 domain 条数（非 Domain 硬切桶路径）

用户有 2 个及以上活跃领域时，多域分配的下限（默认 3）

活跃领域数≥2 时单域上限，防止某一领域挤占列表（默认 15）

仅 1 个活跃领域时放宽的上限，可高于「每域最多」（默认 40）

热门兜底内容的最低质量分数阈值

候选不足时降低后的最低质量分数阈值

热门兜底扫描的候选池大小

同一来源最多出现在早报中的文章数（旧路径软重排；预算模型路径内为硬上限）

仅预算模型路径生效。开启后非订阅的公共 / 兴趣内容只保留命中用户兴趣领域的文章，避免给无相关订阅的用户推送不相关领域（如无 AI 订阅的用户不再被推 AI 内容）

普通关注源在排序中的加分（特别关注另有更高加分）；调高可让订阅内容更靠前

开启后早报按「相关 / 探索 / 兜底」三段预算分配位置，相关内容不再与全站爆款拼分数；默认关，建议用实验灰度对比

订阅（关注 + 特别关注）内容占早报的目标比例（0~1），如 0.6 = 60%；相关内容不足时多出的额度自动让给探索内容

兴趣标签 + 阅读历史相关内容占早报的目标比例（0~1），如 0.25 = 25%；兜底内容比例 = 1 − 相关 − 探索

若用户有特别关注源内容，早报头条前 N 个位置为其保底，近乎必达

单个关注源在推荐中最多贡献的文章数

按兴趣标签召回时扫描的候选池大小

参与标签召回的最大标签数量

拉取用户最近阅读历史的回溯天数

用于去重的用户阅读历史记录最大条数

越近的阅读权重越高；7 天前权重约 0.37

阅读历史标签维度的最大得分

按用户阅读领域比例自动提升对应 domain 标签权重

推荐结果不足此数值时进行降级补充

domain 类型标签在 tagMatch 维度的加权系数（配置键沿用 entity 命名）

低于此分数的内容直接剔除，不受个人化加分影响（五维评分基线门槛）

五维评分中 quality 维度的乘子（quality × weight），调高=质量分占比更重

用户关注订阅源中标记为「特别关注」的内容额外排序加分，默认 45 分，高于普通关注源

qualified=true（编辑精选）的内容在 quality 分基础上叠加此固定加分

五维评分中 tagMatch 维度的最高分上限，用于抑制标签权重过大压制其他维度

deepRead 位条目低于此分时与 4–10 位质量最高条目交换

soft constraint；候选不足时降级

0=不限；兴趣标签桶按用户兴趣过滤后的每领域条数上限

0=不限；默认 2 防止单一领域垄断兜底位

A/B 实验配置；空或 enabled=false 时走默认权重

启用后为每份早报生成标题、关键词和导语

Dify 工作流调用失败时的最大重试次数

管理后台 /api/admin/brief/retry-batch 入口的 kill switch；关闭后接口返回 FEATURE_DISABLED

批量重试时识别卡住任务的默认阈值；GENERATING 超过此分钟数视为卡住，请求体未传时使用

请求体未指定 limit 时使用，建议小于硬上限以预留余量

硬上限，请求 limit 超过此值会被截断；避免长时间阻塞导致网关超时

failed/total 超过此值时推 WARNING 告警（Bark）；取值 0~1，默认 0.3

批次运行超过此时长后，仍在排队的任务直接丢弃以避免无限堆积，默认 1800 秒（30 分钟）

开启后早报开头会出现动态问候 + 用户称呼（如「早上好，Gino」），邮件 Subject、App Push、早报标题同步亲切化。称呼优先取用户昵称，未设置时退回邮箱前缀；时段 / 工作日 / 周末 / 中国法定节假日自动切换。默认关闭，灰度验证后再全量开启

管理后台 /api/admin/brief/global-candidate-pool 入口的 kill switch；关闭后 daily-briefing skill 无法拉取候选，接口返回 FEATURE_DISABLED

早报 Top10 审批工单超过此时长无人回应时，自动按 AI 默认 Top10 推进。建议 15-30 分钟

默认关闭灰度。Dogfood 3 天稳定后开启；关闭时 PENDING 工单不会自动回退（仅用于灾备 / 演练）

付费 / Trial 等开通事件触发的 5 分钟一次 Job，目标 SLA：付费后 ≤ 15 分钟生成首份个性化早报。默认关闭，建议先在内测白名单验证再全量开启

Job 每次执行时回看的最大窗口；超过此窗口的 grant 事件不再兜底，避免脏数据无限重试。默认 30 分钟

单次扫描最多处理的用户数（去重后）。冷启动期遇到大量并发付费时控制 Job 总耗时，剩余用户由下一轮兜底。默认 20

单用户订阅源拉取的并发线程数，控制 RSS 抓取与下游 LLM 评分负载。默认 3

开启后用户早报生成任务从单实例升级为多节点并行，目标支撑数千 Pro 用户在 20 分钟窗口内完成。建议集群至少 2 个节点活跃后再开启；关闭则回退为旧版单实例模式。默认关闭灰度发布

单节点生成窗口下限；实际预算=min(硬上限，max(本值，按任务数估算))。06:40 启动、07:40 发邮件前需完成。默认 50

工作节点按波次提交线程池，每波独立超时。默认 50；单机 Dify 并发建议配合线程池 max-size=10

单波最长等待时间；超时任务留待节点末轮重试。默认 15

单节点最长生成时间，对齐 06:40→07:40 约 60 分钟窗口。默认 55

分布式主节点轮询等待全集群完成的最长时间。默认 65

首次失败时在同一节点立即重试一次（不跨节点协调），可显著降低偶发抖动导致的失败率；重试仍失败则由下一次定时任务自动回收。默认开启

主节点每次合并当日处于失败 / 生成中状态用户的扫描上限，防止异常状态扩散导致单批分片过大。默认 2000，Pro 用户量级大幅增长前维持默认

UserBriefJob 主节点分布式锁租期，需大于整批生成时长

是否向用户开放每日回顾功能入口

禁止后台定时生成每日回顾内容

用于生成回顾内容摘要的 Dify 工作流 API 密钥

触发每日回顾生成的最低阅读文章数

默认开启。开启后 /library/review 页面在已读 ≥ 最低篇数时会显示「立即生成今日回顾」按钮，用户主动点击才会调用 Dify 生成（有成本）；关闭后按钮隐藏，今日回顾仅由晚间 Job 自动生成

灰度开关：开启后每用户回顾生成成功 → 立即触发 @Async 邮件发送（不阻塞 Job 主线）。默认关闭。issue #362

邮件 List-Unsubscribe header 使用的退订 URL 模板。留空则使用 ${BASE_URL}/api/email/unsubscribe?token=XXX 兜底

是否向用户展示基于已订阅源的内容信息流

开启后「我的关注」与「我的源」合并为三列工作台（左侧订阅源树 / 中间内容列表 / 右侧上下文详情）。关闭时回退到旧版双页面

隐式兴趣标签的自然衰减周期（天）

系统从行为数据推断的最大隐式兴趣标签数

开启后在用户设置页展示系统从阅读行为推断的兴趣标签，关闭时该区块对用户不可见

开启后用户可通过 Creem 在线支付订阅 Pro

Creem 服务端 API 地址，默认 https://api.creem.io

用于创建 checkout 与账单门户的 Creem 服务端密钥

用于校验 Creem Webhook 签名的共享密钥

常规月付套餐对应的 Creem Product ID

早鸟月付套餐对应的 Creem Product ID

用户完成支付后跳转的前端页面地址

用户从 Creem 订阅管理页返回时跳转的地址

开启后使用早鸟价（海外 $5/月，国内 ¥29/月）

开启后 Free 用户无法使用 Pro 专属功能

开启后在 Pro 到期前发送续费提醒

开启后每日自动向 Pro 用户推送早报邮件

控制当前产品所处阶段（BETA / EARLY_BIRD / REGULAR）

启用后，Pro 用户进入 /pro 看到使用概览 + 订阅状态卡 + 最近 7 期早报 + Tip cards；关闭则回退看 Free vs Pro 对比 + 订阅按钮（仪表盘异常时的 kill switch）

Pro 标准月度订阅价格，单位 cents（990 = $9.9）。Dashboard MRR 估算和前端价格展示都从此读取，修改后需同步更新 Creem 后台对应 Product 的价格

早鸟阶段月度订阅价格，单位 cents（490 = $4.9）。仅当“是否处于早鸟定价期”开启时生效

续费提醒邮件、营销文案中使用的中文区当前价，如 "¥39/月"。修改后即时生效，无需重启。

续费提醒邮件、营销文案中使用的英文区当前价，如 "$5.99/month"。修改后即时生效，无需重启。

仅在「是否处于早鸟定价期」=ON 时由续费邮件 / 营销文案展示，作为当前价下方的小字对比，如 "（原价 ¥99/月，限时优惠）"。正常期建议留空。

英文区原价对比文案，仅在「是否处于早鸟定价期」=ON 时由续费邮件 / 营销文案展示，作为当前价下方的小字对比，如 "(was $12.99/month, limited offer)"。正常期建议留空。

是否启用 OpenAPI 接口访问限流

控制用户端是否展示并允许使用 OpenAPI 功能

是否启用 OpenAPI 每日调用配额控制

每个 API Key 每秒允许的最大请求数 (1-1000)

Free 用户每天允许调用 OpenAPI 的最大次数

Pro 用户每天允许调用 OpenAPI 的最大次数

防止用户频繁 regenerate 绕过当日配额；0 表示关闭冷却

是否开启认证接口按 IP 维度限流

每个 IP 每小时登录接口最大尝试次数

每个 IP 每小时注册接口最大尝试次数

每个 IP 每小时发送验证码最大次数

每个 IP 每小时忘记密码接口最大尝试次数

每个 IP 每小时 Token 刷新最大尝试次数

每个 IP 每小时邮箱验证/退订 token 最大尝试次数

是否按邮箱维度限制登录失败次数

同一邮箱每小时最大登录失败次数

是否启用公开 API 限流策略

资源接口每分钟最大请求数（每 IP）

搜索接口每分钟最大请求数（每 IP）

订阅源接口每分钟最大请求数（每 IP）

早报反馈接口每小时最大请求数（每 IP）

公开早报读取接口每分钟最大请求数（每 IP）

早报分享接口每分钟最大请求数（每 IP）

分类接口每分钟最大请求数（每 IP）

兴趣标签接口每分钟最大请求数（每 IP）

公开行为上报端点（如 /api/behaviors/topic-cta）每小时最大请求数（每 IP，#346 防刷）

站内通知/邀请资格等公开端点每 IP 每分钟上限

系统全局每分钟最大请求数

RSS 订阅 Feed（/rss/*）每 IP 每小时最大请求数（#429）

Google OAuth 应用客户端 ID

Google OAuth 应用客户端密钥

Google OAuth 授权回调地址

GitHub OAuth 应用客户端 ID

GitHub OAuth 应用客户端密钥

GitHub OAuth 授权回调地址

OAuth 认证成功后跳转的前端页面地址

密码重置链接的有效时长 (5-1440)

5min 滑窗内鉴权失败率超过此值触发告警，默认 0.3

鉴权失败率告警的最小样本数，避免极小样本误报，默认 20

Pro 权益开通失败次数超过此值触发 CRITICAL，默认 1（任意一次即告警）

review_view_complete / review_view_today，Phase D 决策卡 / Admin Dashboard 显示，默认 0.50

review_submit_thought / review_view_today，Phase D 决策卡 / Admin Dashboard 显示，默认 0.20

review_complete 三态合计 / review_view_today，Phase D 决策卡 / Admin Dashboard 显示，默认 0.30

是否在管理后台显示 Pro 订阅仪表盘

低于该分数时仅使用规则打标

每篇内容允许关联的最大领域（domain）标签数

每篇内容允许关联的最大主题（topic）标签数

每篇内容允许关联的最大形式（format）标签数

每篇内容允许关联的最大实体（entity）标签数

开启后支持在编辑订阅源时按钮触发 AI 推荐分类/平台/优先级/兴趣标签，以及私有源定时补全

Dify 订阅源设置推荐工作流 API Key（推荐分类 + 兴趣标签）

喂给推荐工作流的最近内容条数，控制 prompt 体积，默认 5

近 3 月达标数 ≥ 此值时推荐 HIGH 优先级

近 3 月达标数 ≥ 此值时推荐 MEDIUM 优先级

近 3 月发布数 < 此值且无达标内容时推荐 LOW 优先级

RSS 调度每轮处理的最大订阅源数量

低优先级源在每轮拉取中的最大百分比

每轮调度为低优先级源保留的最小槽位百分比（避免 HIGH/MEDIUM 占满后 LOW 永远拉不上）。默认 10%，至少保留 1 个槽位。

是否启用私有源参与 RSS 拉取调度

判定冷源的最近活跃天数阈值

判定僵尸源的最近活跃天数阈值

源创建后的保护期，未达此天数即使内容陈旧也不判僵尸（避免新源被误杀）

是否自动禁用低优先级僵尸源

PRO_ONLY：仅当前 Pro 会员可见；ALL：所有登录用户可见。先 PRO_ONLY 灰度，观察效果后切到 ALL

单个用户每日可发起的邀请上限

邀请人每邀请 1 人成功，奖励的 Pro 天数（按人头模型）

单用户邀请奖励累计封顶天数

总 kill switch。关闭时 detect-rss 端点仅接受 RSS URL（兼容旧前端），不路由到 SourceDiscoveryRegistry。

开启后接受 youtube.com / youtu.be 域名 URL，自动解析 channelId 拼官方 RSS。

开启后接受 xiaoyuzhoufm.com URL，自动解析 podcastId，走 DISCOVERY_XIAOYUZHOU_RSS_BASE 镜像。

开启后未匹配专属域名的 URL 走 Jsoup 解析 head 找 alternate RSS link；建议灰度后开。

开启后接受 mp.weixin.qq.com 文章 / 主页 URL，复用 wechat2rss 接入。**依赖「微信 Pro 自助订阅」分组的 WECHAT2RSS_API_BASE + WECHAT2RSS_API_KEY 凭证**，凭证缺失时本开关即使打开也不生效（Registry 抛 PLATFORM_DISABLED）。

Redis 计数器 bb:{env}:user:rl:source_discovery:{userId}:{yyyyMMdd} 上限。防滥用 + 防 YouTube IP 封禁。0=不限制。

字节数。YouTube 频道页 ytInitialData 内嵌 JSON 较大；独立大上限避免被 RSS_DETECT_HTML_MAX_BYTES 误截导致 channelId 提取失败。默认 5MB。

末尾保留 /，会自动补齐。默认走自建 https://rsshub.bestblogs.dev/xiaoyuzhou/podcast/，切公共镜像需先评估稳定性与限流。

总开关：是否开放 Pro 用户在「我的关注」里添加微信公众号订阅。灰度期默认关，跑通 wechat2rss 链路后再切开。关闭时所有用户提交直接拒绝（FEATURE_DISABLED）。Issue #691。

wechat2rss API 基址 URL（如 https://wechat2rss.bestblogs.dev）。变更后需重启或刷新参数缓存生效。

wechat2rss Bearer 鉴权 Token。**Sensitive 字段**：GET 返回 ***MASKED***，编辑时清空再粘贴新值；保存时输入框留空（含掩码值）则保留原值不覆盖。

逗号分隔的公众号 bizId 列表。命中后用户提交订阅会直接拒绝。常用于屏蔽营销号 / 已知低质量号 / 违规号。与 URL 一键发现共用此名单。

开启时，仅 Pro 用户可以点击「全部刷新」；关闭时，所有用户均可触发（测试 / 灰度期使用）

单用户每日可触发「全部刷新」的最大次数，超出后返回配额超限错误（0 表示不限）

距上次实际抓取（lastLiveTime）不足此值的源会被跳过，避免重复拉取（0 表示不限）

单次请求最多标记多少个源进入刷新队列（0 表示不限）

开启后 Top10 早报审批与高分内容评审会并联推送飞书交互卡片（与 Telegram 同时发），按钮点击经回调写回。默认关闭

飞书开放平台自建应用的 App ID

飞书自建应用的 App Secret（敏感，回显为掩码；修改时清空再粘贴新值）

飞书事件 / 卡片回调的 Verification Token，用于校验回调来源（敏感）

飞书开启回调加密时填写的 Encrypt Key；未开启加密可留空（敏感）

接收 Top10 早报审批卡片的飞书群 chat_id（oc_ 开头）

接收高分内容评审卡片的飞书群 chat_id（oc_ 开头）

关闭每日订阅源与内容分析任务（默认开启）。开启此项后任务整体跳过

关闭后进入演练模式：只统计与记录日志，不写入数据库、不发告警、不推送摘要

每日生成分析摘要并推送到 Bark / Telegram

最近一次有新内容在 N 天内视为活跃源，默认 7 天

超过活跃天数但未超过 N 天视为冷却中，默认 30 天

超过 N 天无新内容视为僵尸源，默认 90 天

订阅者不少于此数且已沉默的源，纳入人工处理清单，默认 50

内容在非终态停留超过 N 小时视为卡死，默认 48 小时

源平均分低于此值视为低质，纳入清单，默认 30

评分不低于此值且未确认精选的内容，计入未评审积压，默认 75

每个工作清单 / 榜单保留的 top-N 条数，默认 20

沉默源占启用源比例超过此值触发告警（0-1），默认 0.30

积压内容总数超过此值触发告警，默认 5000

单个阶段卡死数超过此值触发严重告警，默认 200

最老待处理内容年龄超过此小时数触发告警，默认 72

全局内容合格率低于此值触发告警（0-1），默认 0.15

当日完成内容数低于此值触发告警（吞吐崩塌），默认 50

订阅净增长低于此值触发告警（可为负数），默认 -50

人工处理清单总计超过此值触发告警，默认 500

X-API-Key 头，用于读取 xgo.ing 用户/推文/followings 等公开接口；不可用于 entitlement

X-INTERNAL-TOKEN 头，用于 entitlement grant/revoke/status 接口；与 xgo.ing 侧 xgo.bestblogs.internal_token 必须一致，与用户面 API Key 是不同的密钥

是否禁用文章处理任务

是否禁用播客处理任务

是否禁用推文处理任务

是否禁用邮件验证任务

是否禁用图片重试上传任务

是否禁用 RSS 抓取任务

Issue #473 兜底 Job：每 2 分钟扫描审核通过 ∧ 从未抓取过的私有源调一次 RSS 拉取。生产突发（源站封禁/异常压力）时 kill switch；关闭后用户提交的源仍会按常规 20 分钟 RSS Job 周期被拉取，仅是首次拉取延迟变长

关闭后不会执行手动触发的订阅源刷新任务

支持处理的图片域名列表

阿里云听悟服务应用密钥

听悟服务访问密钥 ID

听悟服务访问密钥 Secret

Cloudflare 图片服务账户 ID

Cloudflare 图片服务 API 密钥

Cloudflare R2 存储访问密钥

Cloudflare R2 存储秘密密钥

R2 存储桶名称

R2 存储访问域名，生产环境统一使用 media.bestblogs.dev