Prosey 是一个 CLI 工具,用于下载并显示 YouTube 视频转录文本,让你无需浪费数小时就能获取所需信息。
主要使用场景包括:
这两种用途都需要系统上安装 AI 助手(默认:opencode,使用 prosey config 配置你自己的助手)。
如果检测到系统上安装了语法高亮工具,你将获得美观的彩色输出。
Prosey 还可以原样输出或存储原生 JSON 格式。
| 功能 | 描述 |
|---|---|
| 💡 总结 | 获取并总结视频转录文本 |
| 📖 阅读 | 获取并以 Markdown 格式显示转录文本 |
| 💬 复制 | 将摘要复制到剪贴板,可直接粘贴到网页聊天中 |
| 📋 转录下载 | 以纯文本或原样 JSON 格式获取 YouTube 转录文本 |
| 🤖 AI 总结 | 将转录文本通过管道传递给任意 AI 代理(opencode、Claude、Copilot、Codex) |
| 🎨 智能分页器 | 若安装了 bat、glow 或 mdcat,则自动进行语法高亮(或配置你自己的分页器) |
| 🛠️ 自定义 | 使用 prosey config 访问并编辑配置 / 自定义提示词 |
| 💾 磁盘缓存 | 转录文本和摘要会缓存到磁盘,以便即时重新读取 |
| 📄 支持的格式 | 纯文本和 JSON |
使用 npx 立即试用:
npx @tacone/prosey 771PQEDeRmw
npx @tacone/prosey https://youtu.be/771PQEDeRmw --lang es -o transcript.txt
使用你喜欢的包管理器进行全局安装:
npm install -g @tacone/prosey
# or
yarn global add @tacone/prosey
# or
pnpm add -g @tacone/prosey
# or
bun install -g @tacone/prosey
然后可在任意位置使用:
prosey 771PQEDeRmw
使用 Bun 进行开发——包括脚本、包管理, 以及直接运行 TypeScript 源码。
git clone https://github.com/tacone/prosey.git
cd prosey
bun install
bun run start -- 771PQEDeRmw
prosey [options] <video controls-url-or-id>
prosey read [options] <video controls-url-or-id>
prosey info [options] <video controls-url-or-id>
prosey summarize [options] <video controls-url-or-id>
prosey copy [--question <text>] <folder>
prosey index
prosey render
prosey config
prosey help
summarize 是默认命令,因此 prosey <id> 会运行 AI 摘要器。
使用 prosey read <id> 下载并打印格式丰富的转录文本。
summarize 命令会获取转录文本,在前面加上来自 [summarize] 配置部分的提示词,并将结果通过管道传递给配置好的 AI 命令。
read 命令会下载转录文本并将其打印到 stdout(纯文本、markdown 或 JSON)。当你不需要 AI 处理时,这很有用。
info 命令显示视频元数据(标题、频道、时长、观看次数)。
index 命令重建文档索引并在浏览器中打开它。
该索引列出存储在数据目录中的每个摘要和转录文本,
并在每次 summarize/transcribe 运行后自动重建。点击任何内容页面上的
Prosey 徽标都会导航回该索引。
render 命令从缓存的 markdown 重新生成每个 HTML 页面
(不进行网络或 AI 处理)并重写索引。
copy 命令将文档的摘要复制到剪贴板,以便
粘贴到网页聊天中。它接受上次运行结束时打印的文件夹名称
(或完整路径);--question 会在摘要后追加你的问题,
用两个空行分隔。只有摘要可以复制——仅含转录文本的
文件夹会报错。
摘要页面的元信息行上、阅读时间的右侧有一个 Copy 链接: 它会把摘要放到剪贴板,以便粘贴到网页聊天中。
config 命令会在 $EDITOR 中打开你的配置文件以供编辑。当
没有可附加的终端时——$EDITOR 未设置,或 stdout/stdin 被管道传输——
则会改为打印配置文件路径。
help 命令显示帮助信息,与 --help 相同。
# Summarize (AI summary + formatting + syntax highlighting)
prosey 771PQEDeRmw
# Summarize (same as above)
prosey summarize 771PQEDeRmw
# Transcribe (AI summary + formatting + syntax highlighting)
prosey read 771PQEDeRmw
# Show video metadata
prosey info 771PQEDeRmw
# Edit config in $EDITOR
prosey config
# List available languages
prosey read https://youtu.be/771PQEDeRmw --list
# Specify language
prosey read https://youtu.be/771PQEDeRmw --lang es
# Display JSON (no AI transcription)
prosey read 771PQEDeRmw
# Display plain text (no AI transcription)
prosey read 771PQEDeRmw
# Save transcript to file
prosey read 771PQEDeRmw -o transcript.txt
| 标志 | 描述 |
|---|---|
--lang <code> | 语言代码(例如 en、fr)。省略时自动检测。 |
-t, --timestamps | 在文本输出的每一行前添加 [MM:SS]。 |
--list | 列出该视频可用的字幕语言,然后退出。 |
-o, --output <path> | 将输出写入文件而不是 stdout。 |
--json | 以 JSON 数组形式输出字幕。每一项包含 text、offset(秒)、duration 和 timestamp。 |
--text | 以纯文本形式输出(prosey read 的默认值)。 |
--details | 在字幕前添加视频详情(标题、频道、时长、观看次数、描述)(默认)。 |
--no-details | 不显示视频详情,仅输出字幕。 |
--no-decode-entities | 保留原始 HTML 实体(例如 ')。文本模式下默认解码。 |
--question <text> | 复制时在摘要后附加一个问题。 |
--no-cache | 跳过缓存读取并强制重新获取。 |
--no-format | 跳过对 summarize 输出的 prettier markdown 格式化。 |
-q, --quiet | 抑制所有 stderr 日志。 |
-v, --verbose | 将调试信息打印到 stderr。 |
--no-pager | 禁用 stdout 输出的分页器(默认自动检测)。 |
--pager | 对 stdout 输出使用分页器(默认)。 |
--reset-config | 将配置文件重置为默认值并退出。 |
--help | 显示帮助信息并退出。 |
--version | 显示版本号并退出。 |
使用 --json 时,输出是一个对象数组:
[
{
"text": "♪ We're no strangers to love ♪",
"offset": 18.64,
"duration": 3.24,
"timestamp": "00:18"
}
]
timestamp 在 JSON 模式下始终存在。视频详情会被静默抑制,因为 JSON 是结构化数据。
本项目使用 Bun 进行开发。
bun run typecheck # TypeScript check
bun run start # Run the CLI from source
bun run test # Run unit tests
bun run build # Compile Node bundle to bin/prosey
在发布到 npm 之前,bun run build 会通过 prepack 钩子自动运行,在 bin/prosey 生成一个兼容 Node 的 JS 包。
Prosey 从 TOML 文件读取配置。位置遵循
XDG Base Directory Specification
(~/.config/prosey/config.toml),或者你可以设置 PROSEY_CONFIG_PATH
环境变量来使用自定义路径。
配置文件会在首次运行时以默认值自动创建。
使用 --reset-config 可随时恢复默认值。
pager用于转录文本和摘要输出的分页器命令。默认为 "auto",它会
检测以下第一个可用的命令:bat -lmd --style plain → glow -p → mdcat -l -p → less。
设置为自定义命令(例如 "less -R")可覆盖。PROSEY_PAGER
环境变量的优先级高于此设置。
clipboardprosey copy 以及生成页面上的复制操作所使用的剪贴板命令。默认为 "auto",它会检测以下第一个可用的命令:wl-copy →
xclip -selection clipboard → xsel --clipboard --input → pbcopy → clip。
设置为自定义命令可覆盖;要复制的文本通过 stdin 传入。
[summarize][summarize] 部分配置 summarize 命令: