v0.6.0 — 速览产品 + RBCP Desktop

v0.6.0 — 速览产品（Extract → Digest → Render）+ RBCP Desktop

从「忠实原文」到帮你快速读懂。0.6 在「链接 → 忠实原文」之上加了一层速览：重点高亮跳读、金句卡片、脉络大纲，一竖屏抓住重点，随时切回看原文。

架构按 Extract（采集转录 → 忠实原文，无损）→ Digest（原文 → 高亮/卡片/脉络，LLM 提炼但确定性服务端锚定回原文坐标，不编造原文没有的内容）→ Render（CLI / WebUI / 桌面三形态呈现）分层。

亮点

• 速览三形态：全文 + 重点高亮 / 金句卡片 / 脉络大纲（点标题跳回原文位置）。
• RBCP Desktop（新）：Tauri 原生桌面客户端，装好即用，内置服务，红蓝品牌界面——任务列表（状态筛选）、文件库（搜索/排序/封面缩略图）、账单（逐篇明细表）、设置（界面里配 Key）、速览阅读器（精华/清洗全文/整篇连贯阅读/原始逐字四视图，渐进加载）。
• CLI 速览：rbcp digest <url>、rbcp ls；所有命令 --json 供 AI Agent 编排。
• 配置发现：跨平台自动发现 .env（rbcp config 打印你本机的确切路径）。

安装

命令行 / 网页端（全平台）

pipx install red-blue-cp          # 或 uv tool install red-blue-cp
rbcp config                       # 看配置目录 + 怎么写百炼 API Key
rbcp serve                        # 网页界面 http://localhost:8000
rbcp digest "<B站/小红书链接>"     # 转录 + 速览

桌面客户端 · macOS arm64
下载 RBCP-Desktop-0.6.0-macos-arm64.dmg，打开后把 RBCP Desktop 拖进「应用程序」。本版未做代码签名：首次打开 macOS 会拦，右键 app → 打开，弹窗里再点「打开」确认一次即可，之后正常双击。在「设置」里填百炼 API Key 就能用。

桌面客户端 · Windows x64（实验性，未经测试）
下载 RBCP-Desktop-0.6.0-windows-x64-setup.exe 安装。⚠️ 这是云端 CI 构建、尚未在真实 Windows 上验证过的实验产物——能不能正常转录（ffmpeg / 路径 / 配置发现）未知，可能有坑。想尝鲜可装，遇问题欢迎反馈；要稳定请用命令行 / 网页端。未签名，安装时 SmartScreen 可能拦，点「仍要运行」。

引擎/CLI/WebUI 全平台走 PyPI（稳定）。桌面 Windows 为实验性；Intel Mac 待后续。

完整变更见 CHANGELOG.md。

v0.5.2 — 旧批次标题去渣 + 批次费用汇总

修复

• 旧批次条目标题去渣：0.5.1 的回填把整个文件名当了标题（带日期、博主名、笔记 ID）。本版解析出纯标题；当年就没标题的笔记诚实显示笔记 ID。已经升过 0.5.1 的用户不用做任何事——启动时自动把脏标题再洗一遍。

新增

• 批次卡片显示估算费用：批次进度旁汇总该批有账任务的费用。注意：升级到 0.4.1 之前下载的内容当时没有记账功能，账单补不出来，不计入——这是诚实的空白，新批次起完整。

升级

pipx upgrade red-blue-cp   # 或 uv tool upgrade red-blue-cp

升级后重启 rbcp serve 刷新页面即可。

Full Changelog: v0.5.1...v0.5.2

🤖 Generated with Claude Code

v0.5.1 — 修复旧批次条目没标题、点不进详情

修复

升级 0.5.0 后，之前批量下载的批次条目显示一串 ID、点不进详情——本版修复。

原因：0.5.0 之前批量下载的条目没有对应的任务记录（也没存标题），升级后批次卡片只能显示笔记 ID。

修复后首次启动会自动回填：历史已完成/失败条目补建任务并关联（标题用 Markdown 文件名兜底）。批次卡片里的旧条目从此有标题、能点进详情看正文。重新导入同博主清单时，标题还会刷新成插件抓到的原始标题。

顺带补上一个去重盲区：升级前批量下载过的内容，现在重新提交或导入也能被识别为「已下过」。

升级

pipx upgrade red-blue-cp   # 或 uv tool upgrade red-blue-cp

升级后重启 rbcp serve，打开页面即可看到旧批次恢复正常。

Full Changelog: v0.5.0...v0.5.1

🤖 Generated with Claude Code

v0.5.0 — WebUI v2：单条/批量整合、批次进任务列表、去重检测

亮点

🗂 批量不再是「另一个页面」

单条和批量现在是主页上的两个标签。独立的批量页面移除（旧链接自动跳回主页）。批量导入交互重做：文件选择按钮、可折叠的粘贴区、批次名称（不填就按博主+条数自动取名）、「已下过的也重新下载」和「允许半份清单」开关。

📋 批次进任务列表，每条笔记都是任务

每个批次一张卡片：标题、进度条、成功/失败/跳过/待下计数。默认显示前 5 条可滚动，点「展开全部」看完整清单。批量下载的每条笔记现在也是一条正式任务——可以点进详情页看正文、看用量账单、原地重试。批次重跑时失败条目复用同一条任务原地重置，历史不堆积。

🔁 去重检测：不再重复下载

• 单条提交：内容已经成功下载过（即使链接参数不一样）→ 弹窗告诉你旧任务编号，确认才重下
• 批量导入：默认自动跳过已下过的笔记并报数；要全量重下勾一下开关即可

其他

• rbcp serve --port 8001 支持自定义端口（原来写死 8000）
• 修复：配置 RBCP_PROXY 时，批量任务在页面上点重试不再绕过代理
• 测试 449 → 475；旧数据库自动迁移，升级无感

升级

pipx upgrade red-blue-cp   # 或 uv tool upgrade red-blue-cp

Full Changelog: v0.4.1...v0.5.0

🤖 Generated with Claude Code

v0.4.1 — 流式修长文超时 + 任务用量/费用统计

亮点

🐛 长视频转录不再超时

0.4.0 用户实测反馈「短视频成功、长视频失败」，根因定位：文本清洗用非流式调用 + 180 秒读超时，而长视频转录文本的清洗要生成约 300 秒，必撞超时——还会被网络重试当成抖动重跑 3 次，把等待放大 3 倍。

修复：llm_clean / vlm 全部改为流式 SSE 调用。流式下读超时只需覆盖相邻 token 的间隔，与文本长度无关。建连阶段保留重试，流中断不再整段重跑，响应用完即关不漏连接。

📊 任务用量与费用统计（新功能）

每个任务现在记一笔明白账：

• 语音转写：音频秒数（计费单位）+ 耗时
• 图片理解 / 文本清洗：输入/输出 token 数 + 耗时
• 按阿里云百炼官方目录价估算费用（单价常量收口在 service/pricing.py，调价改一处）

任务详情页新增「用量与费用」折叠账单，任务列表顶部显示累计估算费用，并提供 GET /api/stats。

估算为目录价，未扣减免费额度（如 ASR 每月赠送 10 小时），实际账单通常更低。

其他

• 重试任务时清除上一轮用量账单，不重复计账
• jobs 表新增 usage 列（JSON），旧库打开时自动迁移，旧任务页面正常显示
• 测试 406 → 449

升级

pipx upgrade red-blue-cp   # 或 uv tool upgrade red-blue-cp

Full Changelog: v0.4.0...v0.4.1

🤖 Generated with Claude Code

v0.4.0 — 博主安全批量 + 错误处理地基

把整个博主的笔记安全地批量沉淀成 Markdown，并给错误处理打了地基——失败有人话、不泄漏、可重试。

✨ 重点：博主安全批量

旧的 fetch --all（脚本驱动 Chrome 抓全量）容易被风控识别、不可分发。0.4.0 改成职责分离的安全路径：

• 浏览器插件（MV3，在 extension/）：只在你登录态的浏览器里抓博主清单，慢滚到底导出 notes.json（可导出文件 / 复制到剪贴板）。
• rbcp batch notes.json --proxy ...：rbcp 只负责下载+转录，走代理护 IP。断点续传、token 过期自动跳过、单条失败不中断、开跑前出口探测确认代理生效。
• WebUI /batches：上传或粘贴 notes.json，后台批量下载 + 进度轮询。

旧路径 fetch --all（pydoll）保留为可选，适合无浏览器/脚本化场景。

🛡️ 错误处理地基

• 失败有人话：不再把裸异常糊给用户；列表/详情显示可操作提示。
• 不泄漏：技术详情是脱敏异常链摘要，完整 traceback 只进服务器日志，不暴露服务器路径/用户名。
• 重试原地：重试复用同一条任务，历史不堆积，能看到这条最终成没成。
• 结构化异常 + service 层日志 + response body：排查不再是黑洞。

🔧 其它改进

• 粘贴即用：单篇输入框接受整段分享文案（带标题/中文尾/emoji），自动抽 URL + 去追踪参数（B 站去 share_source/vd_source 保 p/t；小红书保 xsec_token）。
• 代理支持：--proxy / RBCP_PROXY 显式穿透到下载层。
• DashScope 调用：超时/连接错误自动重试；run 退出码 bug 修复。
• 小红书 token 过期可靠识别；TUN/系统代理下出口探测不再误判。

📦 安装 / 升级

pipx install --upgrade red-blue-cp     # 或 uv tool install red-blue-cp
# 浏览器插件：chrome://extensions → 开发者模式 → 加载已解压 → 选 extension/

无破坏性变更，知识库 SQLite 索引自动补表。完整改动见 CHANGELOG。

v0.3.0 — 形态落地：PyPI 首发 + WebUI 重做 + CI/CD + 自部署

首个发布到 PyPI 的版本，可一行安装。

安装

pipx install red-blue-cp      # 或 uv tool install red-blue-cp

主要变化

• 📦 上架 PyPI：首个可 pipx / uv tool 一行装的版本（https://pypi.org/project/red-blue-cp/）
• 🎨 WebUI 从零重做：「红蓝品牌」设计系统 + 详情页 Markdown 渲染/源码切换（marked + DOMPurify）；浏览器自动化 QA 修 4 个 bug
• 🤖 CI/CD：PR/push 在 Python 3.11/3.12/3.13 跑测试 + 打 tag 自动发 PyPI（Trusted Publishing，不存 token）
• 🚀 自部署远程可达：WSL 镜像网络 + Tailscale 手机/Mac 访问 + 群晖同步知识库（docs/deploy-wsl.md）

产品形态决策（Q1）

确定形态：自部署 WebUI + CLI + PyPI 分发；Tauri 桌面 GUI 门控 P2（有真实非技术用户 + API Key 上手路径再做）。详见 docs/devlog/2026-06-03-product-form-and-v3-scope.md。

Full Changelog: v0.2.0...v0.3.0

v0.2.0 — 博主全量 + 评论 + 扫码登录

Red Blue CP 把 B 站 / 小红书的内容转成本地 Markdown 知识库。本版新增小红书的批量能力。

新增

• rbcp login：扫码登录小红书，cookie 存本地复用
• 博主全量下载：rbcp fetch <博主url> --all，列清单→预览→逐条下
• 评论提取：rbcp fetch <笔记url> --comments，含楼中楼，输出 {note_id}.comments.md
• rbcp list <博主url> --json：给 Agent 用的清单接口（complete 硬契约，半份不当全量）
• --save-media（原始媒体落盘）/ --text-only（跳过转录只取正文）

实现

pydoll 原生网络捕获抓接口、温和限频（实测 ~4–14 请求/分钟）、风控检测、cookie 三来源。

完整说明见 README。243 测试通过。