CURRENT_STATE.md — 当前状态与路线图

更新时间：2026-04-12（v2.0 生产上线；Phase 1 启动）

产品蓝图见 2-PRODUCT.md，架构细节见 4-ARCHITECTURE.md。

当前阶段：Phase 1（个性化阅读工作流）

阶段目标：

• 稳定 Daily Brief（文本/音频/邮件）全链路可用性
• 优化 Pro 升级路径与订阅留存
• 完成 Landing 2.0 改版，强化价值传达路径
• Pro 付费验证三阶段：
  • 邀请内测（→ 2026-05-01）：定向邀请，修复与完善核心功能
  • 早鸟开放（2026-05-01 → 2026-09-01）：开放注册，早鸟价 $10/月
  • 正式定价（2026-09-01 起）：恢复原价 $20/月，首次开通 Pro 享 8 折优惠（$16/月）

关注指标： Pro 转化率、Brief 使用率、7/30 日留存。

进入 Phase 2 的信号：

信号类型	判断逻辑
留存验证	Pro 用户 30 日留存稳定，且留存主要由工作流使用驱动
付费验证	Free → Pro 转化率稳定，Pro 续订率表明用户认可持续价值
工作流闭环	早报 + 为你推荐成为主要入口，发现到阅读链路稳定覆盖
质量池规模	公共质量池日均新增与质量判断准确率达到自运转水平

---

里程碑状态（按飞轮层级）

图例：✅ 开发完成（待 QA） ／ 🔄 开发中 ／ ⬜ 待开始

第一层：公共策展质量池

M3 核心内容平台 ⬜ 待验证

• 多源内容采集（RSS 等），自动同步与去重
• AI 初评评分体系：质量/相关性/新颖度等结构化评分
• 专家精审闭环：人工审核确认，双层质量把关
• 内容状态机：WAIT_PREPARE → WAIT_ANALYSIS → WAIT_REVIEW → COMPLETED 完整流转
• 元数据自动提取：标题/摘要/作者/来源/实体标签
• 多语言翻译：内容自动翻译，支持中英文消费

M4 每日早报 Daily Brief ✅ 开发完成（待 QA）

• 公共早报：每日定时策展摘要，展示 BestBlogs 判断力（06:30 发布）
• 我的早报（Pro）：基于用户兴趣个性化生成（07:00 发布）
• 音频早报：文本转语音，支持移动端收听（07:30 完成）
• 邮件推送：早报邮件递送（08:30），支持 Newsletter 详细版（Top 3 头条级 + 7 条摘要级）/ 精简版，可在设置页配置
• AI 摘要：内容要点提炼与优先级排序
• 微信群推送：公共早报文本版推送
• 失败自动重试：生成失败时自动恢复
• 质量监控：追踪生成成功率与质量指标
• 播客化内容结构：早报支持完整播客结构（章节、时间轴、深度阅读内容、封面）
• 每日回顾 Daily Review（Pro）：Pro 专属晚间回顾（21:00 批量 + 按需生成），含阅读足迹回顾、AI 摘要、思考记录
• 历史日期导航：「查看昨日」入口，支持访问任意历史早报
• 早报分享：生成个人专属分享链接，访客可沉浸式体验完整 Pro 早报，附 Pro 升级引导

M10 管理后台 P0 ✅ 开发完成（待 QA）

• 内容审核台：对待审核内容进行质量确认与可见性操作
• 参数配置管理：动态修改 ConfigKey（推荐权重、AI 模型、特征开关），无需重启
• 运营内容编辑：编辑与发布公共早报、精选内容、推荐位
• 用户管理：用户数据查看、邀请码发放、订阅状态管理
• 系统监控：后台任务状态、内容流转进度、健康指标

---

第二层：个人 AI 阅读工作流

M1 IA v2 信息架构 ✅ 开发完成（待 QA）

• 统一导航体系：侧边栏重构，核心入口可达性优化
• 内容分类重组：品类分组与浏览层级优化，降低认知负荷
• 统一内容列表系统：Explore / For You / Follow 三页代码路径统一，体验按页面意图分化
• 响应式布局：桌面 / 平板 / 移动端自适应，各关键页面通过 4 视口 + light/dark 验证
• Locale 自动检测：基于 IP / 浏览器语言自动推断并设置偏好
• 内容广场（Explore）：FilterToolbar 分层（QuickPresets / Sort / Filter / Density 单行布局）；已读态本地持久化；精选 / 个性化 / 来源质量信号系统接入
• 推荐流（For You）：ContentListShell 统一接管，Pro 门禁与 Feature Flag 闪烁修复
• 订阅流（Follow）：统一代码路径，sidebar 来源活跃度展示
• 订阅源三页角色分化：/explore/sources（公共发现）/ /me/sources（管理台）/ /me/sources/add（扩充桥梁）；SourceCard 质量 / 可见性 / 时效信号落地；智能视图（特别关注 / 未分类 / 最近更新 / 长期未更新）；"我的关注 → 我的早报"因果闭环可视化（每个来源显示近 7 天进入早报次数）
• 图书馆（Library）三页统一升级：书签 / 划线 / 阅读历史采用统一壳层，左侧 Sidebar（标签 / 文件夹 / 智能视图），支持时间筛选、关键词搜索、密度切换、工作流化卡片操作（继续阅读 / 查看上下文 / 归类 / 删除）
• 统一标签 / 文件夹体系：跨书签 / 划线 / 历史的统一组织维度

M2 Landing Page 2.0 ✅ 开发完成（待 QA）

• 价值主张重塑：清晰传达「高质量内容 + 个性化工作流」定位
• Free / Pro 分层展示：差异化价值可感知
• 转化路径优化：强化升级激励与注册引导
• 上线阶段标识：展示当前内测 / 早鸟 / 正式阶段
• PostHog 事件追踪：Landing → Auth → 激活 → 付费完整漏斗
• /pro 页面完善：benefit bullets、定价方案、价值主张区块

M5 Pro 订阅闭环 ✅ 开发完成（待 QA）

• 订阅方案与定价：USD 统一定价（早鸟 $10/月 → 正式 $20/月，首次 8 折）
• Creem 支付集成：支付接口与自动化计费
• 订阅生命周期管理：激活 / 到期 / 续费 / 取消
• Pro 能力开放：我的早报、每日回顾、为你推荐、高阶 AI 伴读、自定义视图等
• 配额管理：Pro 用户各能力的日 / 月配额追踪
• Pro 门禁：服务层集中治理，Free / Pro 功能边界明确

M6 AI 伴读 ✅ 开发完成（待 QA）

• 内容摘要：智能生成文章 / 播客 / 视频核心观点摘要（skill_summary）
• 互动问答：基于当前内容的自由对话式提问
• 划线提问：对任意文本段落提问，获得深度解释
• 章节跳转：播客 / 视频快速定位并跳转相关章节
• 预置技能：思维导图、关键观点提炼、问答对生成等模板
• 配额控制：Free 有限次数（摘要为主），Pro 高阶能力与更高用量
• 全内容类型覆盖：文章 / 播客 / 视频 / 推文四种类型均已支持，各自差异化欢迎语与快捷问题

M6.5 内建沉浸式翻译 🚧 开发中（v2.0.14）

• 替换外部 wenrun.ai 跳转为内建段落级双语对照，免跳出阅读流
• 内容类型：文章 + 推文（播客 / 视频翻译推 v2）
• 方向：en → zh；Free 3 段预览 + Pro 解锁完整译文（配额 20/天）
• 技术链路：/api/content-translate/resources/{id}/stream（SSE）→ ParagraphSplitter → 段落级缓存（bb_content_translation，命中率目标 ≥ 50%）→ LLM（gpt-5.4-mini 默认 + gpt-5.4-nano fallback）→ post-filter
• 三层 Prompt Injection 防御：XML wrap + system instruction + 输入 sanitize + 输出 tag/length 校验
• Feature Flag：FEATURE_CONTENT_TRANSLATE_ENABLED（默认关闭，灰度放开）
• 详见 specs/content-translate.md

M7 个性化推荐 ✅ 开发完成（待 QA）

• 多路召回：兴趣、探索、热点、协同 4 路并行召回
• 六维兴趣标签：Domain(8) / Topic(~220) / Entity(~30高信号) / Format(16) 四层标签体系；per-tier 打标上限（domain≤1/topic≤5/format≤1/entity≤3）已落地；cold-start 精简至 27 个 topic
• 行为学习闭环：点击 / 阅读 / 收藏 / 划线 / 不感兴趣 / 深度阅读等信号实时更新偏好
• 智能重排：综合标签匹配（含 Entity 独立加权）、来源亲和度、新鲜度、质量分、多样性排序
• 推荐解释：用户可见的推荐理由，非黑盒
• 反馈机制：不感兴趣 / 感兴趣实时影响后续推荐
• Quality Feedback：内容质量反馈，已接入兴趣画像

M8 用户订阅源管理 ✅ 开发完成（待 QA）

• 公共订阅源库：BestBlogs 精选高质量订阅源浏览与订阅
• 私有订阅源：用户自定义导入 RSS 源，自动检测元数据
• 订阅源推荐：基于兴趣的订阅源发现
• 我的订阅流：统一展示所有关注来源的内容
• 自定义视图（Pro）：按自定义条件组织内容，上限 10 个视图

M9 会话安全改造 ✅ 开发完成（待 QA）

• HttpOnly Cookie 鉴权：access_token / refresh_token 存储在 HttpOnly + SameSite=Strict Cookie，JS 不可读
• session_active 登录态标记：非 HttpOnly Cookie，前端读取判断登录状态
• API 代理层：所有前端请求经 /api/proxy/*，代理注入 Authorization header 与 X-Internal-Token
• 内部 Token 校验：后端验证机制阻止绕过代理的直接 API 调用
• Safe Redirect：用户可控重定向 URL 经验证，仅允许同站相对路径
• API 路径白名单：/api/proxy/* 严格白名单，防止路径穿透

---

第三层：可调用知识基础设施

M11 OpenAPI 2.0 🔄 核心回归已补齐，待端到端验证

• 内容发现：资源搜索（混合检索 BM25 + kNN / 全文）、分页浏览、热趋内容、聚合详情
• 内容阅读：Markdown 全文、播客转录与章节
• 内容类型：文章 / 播客 / 视频 / 推文 / 电子报 / 每日简报
• 用户工作流（/openapi/v2/me/*）：订阅管理、书签、划线笔记、阅读历史、兴趣标签、自定义视图、早报、Pro 订阅
• 冷启动：Intake 兴趣建档（/openapi/v2/me/onboarding）
• 认证：Header X-API-KEY，API Key 元数据恢复用户上下文，Agent 无需额外传 user-id
• 速率限制：10 QPS 限流，按接口类型日配额管制
• 统一响应格式：{success, code, message, requestId, data}，1-based 分页
• 文档：bestblogs-docs/openapi/ 五份 Markdown 文档（auth / intake / discover / read / capture）

---

后续规划

个性化推荐增强

当前阶段待完善：

• searchBoostTerms 定期人工审计更新（当前标签匹配关键词为静态配置）

后续迭代方向：

• 协同过滤召回："和你兴趣相似的用户还在读"，补充 content-based 的盲区
• 知识图谱关联：Entity 标签间建立关联，自动扩展召回
• 主题演化追踪：在 Daily Brief 或个人中心展示"你的兴趣变化"
• 阅读历史摘要：周度 / 月度个人阅读报告，LLM 总结偏好变化

AI 伴读增强

当前阶段可做：

• 列表页轻入口：文章列表卡片增加 AI 伴读轻量入口，点击直接进入阅读页并打开面板
• Margin Notes 默认展示：为所有用户默认展示 AI 洞察侧注（只读），作为 Pro 体验预览
• AI 伴读行为接入兴趣画像：Copilot 交互写入用户行为信号，丰富推荐系统

后续规划：

• 跨文章上下文（Pro）：引用此前阅读过的文章作为对话上下文
• 个性化 Prompt：结合用户兴趣标签自动调整 skill prompt
• 语音输入 / 输出：语音问答交互

Phase 2（下一阶段）

• 优化推荐质量与可观测性（召回质量、超时、解释可读性）
• 强化个性化反馈闭环（不感兴趣、兴趣漂移、周报洞察）
• 提升 OpenAPI 与站内能力的一致性
• 协同过滤召回、知识图谱关联

Phase 3（验证后）

• 个人知识沉淀能力（Learning / Knowledge OS）
• Agent Native 能力：Context Pack、Content Intelligence Network、ResearchSession、WatchRule + Triggered Digest（详见 specs/agent-native.md）
• Native App（以订阅和音频留存指标触发）