Skip to content
DoubleMicePublic

About

声笺 Resonote:把长播客整理成视觉笔记与中文长读文章

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

声笺 Resonote

将长篇播客整理为中文视觉笔记与长读文章,并发布到 GitHub Pages。

访问网站 · 浏览内容库 · 订阅 RSS

功能

  • 从 RSS 发现节目并维护处理队列。
  • 优先读取 RSS 自带文稿;仅有音频时可调用 MiMo 或 DashScope 转写。
  • 通过 Codex 或 Claude Code 调用模型,生成 HTML 文章和元数据。视觉笔记暂停生成,已有笔记仍可阅读。
  • 使用 Astro 构建内容站,支持全文搜索、来源与标签筛选、未读筛选和本地阅读记录。
  • 通过 GitHub Actions 定时发现、生成、检查并部署到 GitHub Pages。

处理流程

RSS → scan cache → plan → transcript → article → build → GitHub Pages

主要产物:

data/transcripts/<id>.txt   转写稿
data/plans/<source>.yml     处理状态
episodes/<id>/slides.md     视觉笔记(暂停新增)
episodes/<id>/article.html  长读文章
episodes/<id>/meta.yml      内容元数据

快速开始

需要 Node.js 20.19+、pnpm 9.15.9。自动转写还需要 ffmpeg。

git clone https://github.com/DoubleMice/resonote.git
cd resonote
pnpm install
pnpm run build
pnpm run preview

本地预览地址为 http://localhost:4173。开发单集视觉笔记时运行:

pnpm run dev:episode <episodeId>

常用命令

# 刷新 RSS 缓存并生成计划
pnpm run cache:refresh
pnpm run plan

# 执行计划,默认只生成文章;可限制来源、数量或启用自动转写
pnpm run plan:run -- --id=tbpn --limit=1
pnpm run plan:run -- --auto-transcribe --transcribe-limit=3

# 重试指定单集,包括此前生成失败的条目
pnpm run plan:run -- --id=latepost --episode=<episodeId> --retry-failed --limit=1

# 与每日工作流一致:扩大批次,单集失败后继续处理和发布其他节目
pnpm run plan:run -- --auto-transcribe --transcribe-limit=12 --limit=12 --concurrency=3 --allow-episode-failures --retry-generation-failures

# 校验、构建与预览
pnpm run normalize:meta
pnpm run build
pnpm run preview

# 测试与站点检查
pnpm test
pnpm run audit:brand
pnpm run audit:home
pnpm run verify:routing

audit:brand、audit:home 和 verify:routing 检查 dist/,运行前需先执行 pnpm run build。

本地命令和每日工作流默认只生成文章、元数据与引文证据,不运行新笔记的 Slidev 生成和布局审计。已有视觉笔记继续参与构建和站点检查。需要为待处理节目同时生成视觉笔记时,显式运行 pnpm run plan:run -- --with-visual-notes。文章模式由程序在 meta.yml 中记录为 visual_notes: false,首页和 RSS 据此显示可用的阅读形式。

配置

复制本地配置示例并填写密钥:

cp scripts/env.local.example.sh scripts/env.local.sh
source scripts/env.local.sh

GitHub Actions 使用两个独立 Secret:

TRANSCRIPTION_API_KEY  自动转写密钥
CONTENT_API_KEY        文稿整理与内容生成密钥

仓库 Variables:

TRANSCRIPTION_PROVIDER=mimo
TRANSCRIPTION_BASE_URL=https://api.xiaomimimo.com/v1
TRANSCRIPTION_MODEL_NAME=mimo-v2.5
TRANSCRIPTION_MAX_COMPLETION_TOKENS=32768

CONTENT_BASE_URL=https://api.xiaomimimo.com/anthropic
CONTENT_MODEL_NAME=mimo-v2.5
CONTENT_PROVIDER=auto

可选的 CONTENT_EFFORT 控制文稿整理时的思考强度,支持 low、medium、high、xhigh 和 max。它映射为 Claude Code 的 --effort 或 Codex 的 model_reasoning_effort;不设置时沿用 CLI 默认值,取值无效时在调用模型前失败。

CONTENT_PROVIDER=auto 根据模型名称选择入口:gpt-*、o数字 和 codex* 使用 Codex,其余使用 Claude Code。也可显式设置 codex 或 claude。Actions 按需安装对应 CLI;本地使用 Codex 生成时需安装 @openai/codex@0.153.4。两种入口共用 CONTENT_API_KEY,旧的 ANTHROPIC_AUTH_TOKEN 本地配置仍可使用。生成任务固定使用 Ubuntu 22.04,避免 Ubuntu 24.04 的用户命名空间限制阻止 Codex 沙箱启动;调用模型前会检查本地自审服务能否启动。

设置 TRANSCRIPTION_PROVIDER=dashscope 可改用 DashScope 转写,同时需要 DASHSCOPE_API_KEY Secret。工作流将上述通用配置映射为客户端实际读取的 ANTHROPIC_*、MIMO_* 或 DashScope 环境变量。

GitHub Actions

Workflow 触发方式 用途
Discover 每天 03:00 UTC / 手动 刷新 RSS 与处理计划
Generate and Deploy 每天 18:00 UTC / 手动 转写、生成、检查并部署
Deploy to GitHub Pages 手动 构建并部署已有内容
Transcription E2E 手动 验证转写接口,不写入内容

Discover 与 Generate and Deploy 共用 content-pipeline 并发组,避免同时修改计划和内容文件。直接推送到 main 不会触发部署。

每日生成默认最多转写 12 集、生成 12 集,生成并发为 3,整项任务超时为 330 分钟。可通过手动输入或仓库 Variables TRANSCRIBE_LIMIT、GENERATE_LIMIT、GENERATE_CONCURRENCY 调整每日默认值;转写仍按集顺序执行。

生成任务的摘要分别列出通过校验的生成数量、生成或下载失败数、失败单集,以及本次转写失败数。单集转写、生成和自审失败会产生警告,其他节目继续处理。生成失败的草稿保存在 episodes/_failed/<id>/,不会进入站点校验、文章发布和导航;重试时恢复原有文件。本轮新节目打包失败也会隔离并回写计划,已发布内容的构建回归、运行器错误和站点整体检查失败仍会阻止部署。工作流在生成结束后立即保存进度,完成构建后再次保存发布结果。队列为空时显示 no new content。

工作流通过 --allow-episode-failures 启用上述行为;本地命令默认仍以非零状态报告单集失败。pnpm run build -- --allow-episode-failures 读取同次生成留下的 logs/pipeline-timing.json,只允许隔离其中列出的新节目,不能用于跳过已有内容的构建错误。

Codex 入口需要 Responses API;例如 CONTENT_BASE_URL=https://api.doublemice.top、CONTENT_MODEL_NAME=gpt-5.6-luna 会调用该网关的 /v1/responses。Claude Code 入口仍需要 Anthropic Messages API。详见 Codex 自定义提供方配置。

手动生成工作流支持 episode 和 retry_failed,可只重试一集。每日工作流启用 --retry-generation-failures,让生成失败的节目重新参与调度。自审失败的节目先复查已有内容;仍未通过时,调用一次内容生成器修复,再执行静态和版式校验。未启用生成重试时只复查,不调用模型。转写失败默认等待 48 小时再尝试,优先处理未尝试的节目;只有显式 --retry-failed 才跳过这个等待。音频下载显式发送 Accept-Language: en-US,避免 Captivate 对 Node 默认的通配语言头返回 404。下载最多尝试 3 次,单次最多 120 秒;转码时去除封面和元数据,并根据大小上限限制分块时长。

构建与页面性能

生产构建只编译一次 Slidev 播放器,公共 JS、主题和依赖放在 dist/player/。每集的页面、标题与讲稿合并为一个内容 JS 包,打开时只加载该集。/episodes/<id>/#/页码 链接、首页导航和文章地址保持兼容;本地单集开发仍使用 pnpm run dev:episode <id>。

构建结果缓存在 .cache/shared-player。任何幻灯片、资源、共享样式或构建依赖变化都会重新构建播放器与内容;文章及篇目导航仍在组装时更新。Actions 使用相同指纹复用缓存。新集编译失败且能定位到源文件时,--allow-episode-failures 会隔离该集后重新构建;旧集回归和全局错误继续阻止发布。

组装阶段清理未引用的模板图和主题示例,只删除与原模板相同的发布副本,有引用或已修改的资源保留。共享播放器、单集内容和 HTML 必须随整个 dist/ 一起发布。此适配器针对固定的 Slidev 52.18.0;升级 Slidev 或引入不同主题、单集自定义构建扩展时,需要同步验证适配层。

原单集拆包实验仍可运行 pnpm exec tsx scripts/experiment-slide-bundling.ts。全站共享播放器对比使用 --shared-player,读取 logs/shared-player/before/ 的旧站快照与当前 dist/,结果写入 logs/shared-player/experiment/<id>/。测量方法、文件数与兼容性检查见 共享播放器构建报告;前一阶段结果见 单集打包实验。

首页先输出 36 条目录,搜索、筛选或显示更多时再加载其余条目;独立内容库仍提供完整静态目录。图示校验现在覆盖 JSON、基本场景结构和线条端点。构建后的资源统计只读取文件,不再执行旧的跨集 URL 改写。

新笔记默认使用 diagramMode: static:卡片、对照、步骤和分层复用 rn-note 样式,关系图保留普通 Mermaid 代码围栏。发布构建和 audit:layout --png --keep 会用本地 Chromium 导出 SVG,内嵌到每集内容模块,浏览器不需要绘图库。dev:episode 仍使用 Slidev 原生 Mermaid 热更新预览。旧 Excalidraw 笔记继续兼容,新工作区不再复制通用图文件。

最新一集已迁移,接入过程与试验数据见视觉笔记记录。旧 Excalidraw 直接导出 SVG 的路线仍只是历史实验;首页优化、图示修复和已知分页问题见后续优化记录。

RSS 默认同时请求 3 个来源,单次请求最多等待 30 秒。资源受限时可降低并发:

RESONOTE_RSS_CONCURRENCY=1 pnpm run cache:refresh

并发值必须是正整数。首页搜索首次使用时从已有内容库读取索引;筛选保留列表节点,仅在切换排序时重排。搜索、筛选和阅读状态脚本由 Astro 打包为可缓存的模块。

添加 RSS 源

在 sources.yml 的 sources 列表中增加配置:

- id: my-source
  name: My Podcast
  rss_url: https://example.com/feed.xml
  min_duration: 3600
  min_date: "20260101"
  lookback_days: 30
  cache_limit: 100
  color: "#355f58"
  description: 节目简介

然后运行:

pnpm run cache:refresh -- --id=my-source
pnpm run plan -- --id=my-source
pnpm run plan:run -- --id=my-source --limit=1

项目结构

landing/                 Astro 内容站
episodes/                单集 Slidev、文章与元数据
data/                    RSS 缓存、计划和转写稿
scripts/                 发现、转写、生成、构建与检查脚本
scripts/prompts/         内容生成规则
.github/workflows/       自动发现、生成与部署任务
sources.yml              RSS 来源配置
tags.yml                 标签词表

内容约束

生成规则位于 scripts/prompts/slides-system-rules.md。内容必须以当前节目的转写稿为依据;引用需能回查原文,不得跨节目混用信息。只有 CLI 正常退出、报告非错误的完成事件,且产物通过静态与布局校验后,计划状态才会更新为 generated。

技术栈

项目使用 Slidev、Astro、Codex 和 Claude Code。

视觉笔记阅读

手机宽度下,当前页按原字号纵向排列,底部保留翻页和总览;顶部可进入同集文章。桌面仍使用演示布局。手机翻页后回到页首,横向比较表可在表内滚动。

Slidev 52.18.0 的 frontmatter 解析器会把标题中的 --- 误判为结束标记。仓库通过 patches/@slidev__parser@52.18.0.patch 将结束标记限定为独立一行;升级 Slidev 时应复核该补丁及真实构建测试。发布路由检查同时验证封面没有配置字段、手机导航不遮挡内容、触控翻页可用。

About

声笺 Resonote:把长播客整理成视觉笔记与中文长读文章

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages