read-xiaoyuzhou-article

Name: read-xiaoyuzhou-article
Author: SpaceZephyr

56stars18forks

How to install read-xiaoyuzhou-article?

spacezephyr/read-buddy/read-xiaoyuzhou-article

$npx -y skills add SpaceZephyr/read-buddy --skill read-xiaoyuzhou-article

Installs into the current project.

Summary

把小宇宙播客链接转成文字稿和文章。实现原理：下载小宇宙音频 → Groq Whisper 转录成文字 → 由 Claude 编写成文章。触发词："小宇宙转文字"、"播客转文章"、"把这个小宇宙链接转成文章"、"小宇宙文稿"，或用户直接发来 xiaoyuzhoufm.com 的单集链接。产出两份：逐字文稿（含标点润色）+ 改写后的文章。

Files · 1

View on GitHub

SKILL.md

1	# 小宇宙播客转文章
2
3	把一条小宇宙单集链接（`xiaoyuzhoufm.com/episode/xxx`）变成：
4	1. 逐字文稿（转录 + 中文标点润色）
5	2. 文章（由 Claude 在文稿基础上改写成可读文章）
6
7	## 实现原理
8
9	```
10	小宇宙链接
11	→ 抓页面里的音频 CDN 直链（无需登录/API）
12	→ curl 下载音频
13	→ ffmpeg 转码压缩（单声道 64k mp3）
14	→ 按 10 分钟/段切片（避免单段过长导致 Whisper 524 超时）
15	→ Groq Whisper large-v3 转录（language=zh，带 429/5xx 自动重试）
16	→ 清洗 Whisper 幻觉噪声（"请点赞订阅"、"字幕由 Amara.org 提供"等）
17	→ Groq Llama 3.3 70B 补中文标点+分段（可选 --polish）
18	→ 输出逐字文稿
19	→ Claude 把文稿编写成文章
20	```
21
22	## 前置要求
23
24	1. 工具（命令行需可用）：`curl`、`ffmpeg`、`ffprobe`、`perl`、`python3`
25	- macOS 安装 ffmpeg：`brew install ffmpeg`
26	- 若 brew 不可用（如 Xcode 许可证未接受），可下载静态二进制放到 `~/.local/bin/`（脚本会自动把该目录加入 PATH）。arm64 静态版可从 osxexperts.net 获取 `ffmpeg`/`ffprobe`。
27	- 脚本启动时会自检依赖，缺哪个会直接报出来。
28
29	2. Groq API Key（免费）——转录这一步需要：
30	- 注册 https://console.groq.com 拿到 `gsk_` 开头的 key
31	- 设置环境变量：`export GROQ_API_KEY=gsk_xxxxx`
32	- 若未设置，运行脚本时会报错提示。
33
34	## 工作流程
35
36	### Step 1: 确认链接和润色选项
37
38	用户给出小宇宙单集链接后，默认开启 `--polish`（标点润色，阅读体验更好）。
39
40	### Step 2: 运行转录脚本
41
42	```bash
43	GROQ_API_KEY=$GROQ_API_KEY bash ~/.claude/skills/read-xiaoyuzhou-article/scripts/transcribe.sh \
44	--polish "<小宇宙链接>" "/tmp/podcast_transcript.md"
45	```
46
47	脚本会输出逐字文稿到 `/tmp/podcast_transcript.md`。读取它作为下一步素材。
48
49	> 长播客转录可能需要几分钟（下载 + 转码 + 多段调用 API）。如遇 Groq 429 限流，脚本会自动等待重试。
50
51	### Step 3: 编写成文章
52
53	读取 `/tmp/podcast_transcript.md`，把逐字稿改写成一篇结构化文章。要求：
54
55	- 保留核心观点和关键信息，去掉口语赘词、重复、语气词（"对对对""然后呢""那个"）
56	- 重新组织结构：开头点题 → 用小标题分主题 → 结尾收束
57	- 忠实于原意：不要编造文稿里没有的事实、数据、观点
58	- 嘉宾有金句的话可以适当引用
59	- 在文章开头标注来源链接和播客标题
60
61	把文章保存为 `/tmp/podcast_article.md`，并把两份产出（文稿 + 文章）路径告知用户。
62
63	## 注意事项
64
65	- 只支持小宇宙单集页面（`/episode/`），不支持播客主页。
66	- 音频直链是从页面 HTML 正则提取 `media.xyzcdn.net/*.m4a\|mp3`；若小宇宙改版导致提取失败，需更新脚本里的正则。
67	- 转录用 Groq 免费额度，超大量使用可能触发速率限制。
68	- 改写文章这一步由 Claude 完成，不额外消耗 API。

People who liked this also viewed

6 picks

Type

read-xiaoyuzhou-article

56stars18forks

View on GitHub

How to install read-xiaoyuzhou-article?

spacezephyr/read-buddy/read-xiaoyuzhou-article

$npx -y skills add SpaceZephyr/read-buddy --skill read-xiaoyuzhou-article

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# 小宇宙播客转文章
2
3	把一条小宇宙单集链接（`xiaoyuzhoufm.com/episode/xxx`）变成：
4	1. 逐字文稿（转录 + 中文标点润色）
5	2. 文章（由 Claude 在文稿基础上改写成可读文章）
6
7	## 实现原理
8
9	```
10	小宇宙链接
11	→ 抓页面里的音频 CDN 直链（无需登录/API）
12	→ curl 下载音频
13	→ ffmpeg 转码压缩（单声道 64k mp3）
14	→ 按 10 分钟/段切片（避免单段过长导致 Whisper 524 超时）
15	→ Groq Whisper large-v3 转录（language=zh，带 429/5xx 自动重试）
16	→ 清洗 Whisper 幻觉噪声（"请点赞订阅"、"字幕由 Amara.org 提供"等）
17	→ Groq Llama 3.3 70B 补中文标点+分段（可选 --polish）
18	→ 输出逐字文稿
19	→ Claude 把文稿编写成文章
20	```
21
22	## 前置要求
23
24	1. 工具（命令行需可用）：`curl`、`ffmpeg`、`ffprobe`、`perl`、`python3`
25	- macOS 安装 ffmpeg：`brew install ffmpeg`
26	- 若 brew 不可用（如 Xcode 许可证未接受），可下载静态二进制放到 `~/.local/bin/`（脚本会自动把该目录加入 PATH）。arm64 静态版可从 osxexperts.net 获取 `ffmpeg`/`ffprobe`。
27	- 脚本启动时会自检依赖，缺哪个会直接报出来。
28
29	2. Groq API Key（免费）——转录这一步需要：
30	- 注册 https://console.groq.com 拿到 `gsk_` 开头的 key
31	- 设置环境变量：`export GROQ_API_KEY=gsk_xxxxx`
32	- 若未设置，运行脚本时会报错提示。
33
34	## 工作流程
35
36	### Step 1: 确认链接和润色选项
37
38	用户给出小宇宙单集链接后，默认开启 `--polish`（标点润色，阅读体验更好）。
39
40	### Step 2: 运行转录脚本
41
42	```bash
43	GROQ_API_KEY=$GROQ_API_KEY bash ~/.claude/skills/read-xiaoyuzhou-article/scripts/transcribe.sh \
44	--polish "<小宇宙链接>" "/tmp/podcast_transcript.md"
45	```
46
47	脚本会输出逐字文稿到 `/tmp/podcast_transcript.md`。读取它作为下一步素材。
48
49	> 长播客转录可能需要几分钟（下载 + 转码 + 多段调用 API）。如遇 Groq 429 限流，脚本会自动等待重试。
50
51	### Step 3: 编写成文章
52
53	读取 `/tmp/podcast_transcript.md`，把逐字稿改写成一篇结构化文章。要求：
54
55	- 保留核心观点和关键信息，去掉口语赘词、重复、语气词（"对对对""然后呢""那个"）
56	- 重新组织结构：开头点题 → 用小标题分主题 → 结尾收束
57	- 忠实于原意：不要编造文稿里没有的事实、数据、观点
58	- 嘉宾有金句的话可以适当引用
59	- 在文章开头标注来源链接和播客标题
60
61	把文章保存为 `/tmp/podcast_article.md`，并把两份产出（文稿 + 文章）路径告知用户。
62
63	## 注意事项
64
65	- 只支持小宇宙单集页面（`/episode/`），不支持播客主页。
66	- 音频直链是从页面 HTML 正则提取 `media.xyzcdn.net/*.m4a\|mp3`；若小宇宙改版导致提取失败，需更新脚本里的正则。
67	- 转录用 Groq 免费额度，超大量使用可能触发速率限制。
68	- 改写文章这一步由 Claude 完成，不额外消耗 API。

People who liked this also viewed

6 picks

Type