deep-reading

Deep Reading Agent v2

概要

YouTube 動画、PDF 書籍、ポッドキャスト、ウェブページなどのコンテンツを深く読み込み、ノートを管理するための深度読書アシスタントです。Mortimer Adler の『本を読む本』に基づき、三段階の読書（点検読書、分析読書、比較読書）を実現します。

使用するタイミング

ユーザーが以下のように言ったとき、このスキルを自動的に起動します：

• 「この動画を見て／読んで／学んで」＋ YouTube URL
• 「この内容を深く読んで」
• 「この動画／記事を分析して」
• 「この本を読んで」＋ PDF のパス
• 「xxx を再生して」（ダウンロード済みのコンテンツ）

クイックスタート - AI の操作フロー

1. YouTube 動画の処理

ユーザーが YouTube URL を提示した場合：

# Step 1: 下载内容
cd /Users/liweixin/.claude/skills/deep-reading
python3 -m src.fetcher.cli "YOUTUBE_URL"

# Step 2: 生成检视阅读报告
python3 -m src.processor.cli youtube_VIDEO_ID

# Step 3: 告诉用户笔记已生成，可在 Obsidian 查看

2. PDF 書籍の処理

ユーザーが PDF ファイルのパスまたは Zotero ディレクトリを提示した場合：

# Step 1: 处理 PDF（提取文本和元数据）
python3 -m src.fetcher.cli "/path/to/file.pdf"
# 或提供包含 PDF 的目录（如 Zotero storage）
python3 -m src.fetcher.cli "/Users/liweixin/Zotero/storage/VDEZ72XG"

# Step 2: 生成检视阅读报告
python3 -m src.processor.cli pdf_XXXXXX

# Step 3: 告诉用户笔记已生成

3. ダウンロード済みコンテンツの再生

# 列出所有已下载内容
python3 -m src.player.cli -l

# 播放指定内容 (交互式，需要用户操作)
python3 -m src.player.cli SOURCE_ID

4. 生成されたノートの確認

ノートは ~/smart notes/DeepReading/Sources/ に保存されます。

ワークフロー全体の例

ユーザー：「この動画を深く読んで https://www.youtube.com/watch?v=RSNuB9pj9P8」

AI の操作：

cd /Users/liweixin/.claude/skills/deep-reading

# 1. 下载视频内容
python3 -m src.fetcher.cli "https://www.youtube.com/watch?v=RSNuB9pj9P8"

# 2. 生成检视阅读报告到 Obsidian
python3 -m src.processor.cli youtube_RSNuB9pj9P8

AI の返信： 「完了しました！

• 📥 動画をダウンロードしました：[タイトル]
• 📝 点検読書レポートを生成しました：~/smart notes/DeepReading/Sources/[タイトル].md
• 🎧 音声を再生する場合は、お知らせください

ノートには以下が含まれます：

• 動画のメタ情報
• クイック要約（AI による分析後に入力）
• 主な見解
• 重要な概念
• 考察のための質問

この動画を再生しましょうか？」

ユーザー：「この本を読んで /Users/liweixin/Zotero/storage/VDEZ72XG」

AI の操作：

# 1. 处理 PDF
python3 -m src.fetcher.cli "/Users/liweixin/Zotero/storage/VDEZ72XG"

# 2. 生成报告
python3 -m src.processor.cli pdf_XXXXXX

AI の返信： 「完了しました！

• 📖 書籍を処理しました：[タイトル]
• 📝 点検読書レポートを生成しました：~/smart notes/DeepReading/Sources/[タイトル].md
• 📄 全 XX ページ

ノートには以下が含まれます：

• 書籍のメタ情報（タイトル、著者、ページ数）
• クイック要約（AI による分析後に入力）
• 主な見解
• 重要な概念
• 考察のための質問」

キャッシュとデータの保存場所

~/.deep-reading/
├── cache/
│   ├── youtube/{video_id}/
│   │   ├── audio.mp3        # 音频文件
│   │   ├── transcript.vtt   # 带时间戳的字幕
│   │   ├── transcript.txt   # 纯文本字幕
│   │   └── metadata.json    # 视频元数据
│   └── pdf/{pdf_id}/
│       ├── source.pdf       # PDF 副本
│       ├── content.txt      # 提取的文本
│       └── metadata.json    # PDF 元数据
├── db/deep_reading.db       # SQLite 数据库
└── config.py                # 配置文件

~/smart notes/DeepReading/
└── Sources/                 # Obsidian 笔记
    └── {标题}.md

再生コントロールキー（ユーザーへの案内）

キー	機能
空格	一時停止／再生
j	30 秒早送り
k	10 秒巻き戻し
J	60 秒早送り
K	30 秒巻き戻し
+ / =	速度を上げる
-	速度を下げる
q	終了

エラー処理

1. 字幕がない場合：字幕のない動画もあり、その場合はエラーになります
2. ネットワークの問題：ダウンロードに失敗した場合は、ネットワークを確認するようユーザーに案内します
3. すでに存在する場合：コンテンツがすでにダウンロードされている場合は、キャッシュを使用します
4. PDF の解析：PyMuPDF のインストールが必要です（pip install PyMuPDF）

今後の機能（M2-M6）

• M2：TUI プレーヤー＋字幕同期
• M3：AI による自動チャプター分割＋概念カード
• M4：Obsidian の双方向リンクを自動生成
• M5：ポッドキャスト対応
• M6：ウェブページ対応

ノートの作成ルール

Obsidian の双方向リンク [[]] のルール

重要：リンク先のファイルがすでに存在する場合に限り、[[]] リンクを使用してください！

• ❌ 禁止：[[效价]]、[[强化学习]] のように、存在しないファイルへの空のリンクを追加すること
• ✅ 正しい：先にノートファイルを作成し、その後、ほかのノートに [[ファイル名]] リンクを追加すること
• ✅ 正しい：まだ作成していない概念は、「効力（Valence）」のようにプレーンテキストで記述すること

リンクが有効か確認する

[[]] リンクを追加する前に、ファイルが存在することを確認してください：

ls "~/smart notes/DeepReading/Sources/目标文件名.md"

例

# 正确做法
- 父笔记：A Brief History of Intelligence.md
- 相关概念：效价(Valence)、两侧对称动物

# 错误做法（目标文件不存在）
- 父笔记：[[A Brief History of Intelligence]]
- 相关概念：[[效价]]、[[两侧对称动物]]