@duckmind/deepquark-darwin-arm64 0.9.78 → 0.9.81

package/.deepquark/skills/bundled/youtube-downloader/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: youtube-downloader
+description: Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.
+---
+
+# YouTube Video Downloader
+
+Download YouTube videos with full control over quality and format settings.
+
+## Quick Start
+
+The simplest way to download a video:
+
+```bash
+python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"
+```
+
+This downloads the video in best available quality as MP4 to `/mnt/user-data/outputs/`.
+
+## Options
+
+### Quality Settings
+
+Use `-q` or `--quality` to specify video quality:
+
+- `best` (default): Highest quality available
+- `1080p`: Full HD
+- `720p`: HD
+- `480p`: Standard definition
+- `360p`: Lower quality
+- `worst`: Lowest quality available
+
+Example:
+```bash
+python scripts/download_video.py "URL" -q 720p
+```
+
+### Format Options
+
+Use `-f` or `--format` to specify output format (video downloads only):
+
+- `mp4` (default): Most compatible
+- `webm`: Modern format
+- `mkv`: Matroska container
+
+Example:
+```bash
+python scripts/download_video.py "URL" -f webm
+```
+
+### Audio Only
+
+Use `-a` or `--audio-only` to download only audio as MP3:
+
+```bash
+python scripts/download_video.py "URL" -a
+```
+
+### Custom Output Directory
+
+Use `-o` or `--output` to specify a different output directory:
+
+```bash
+python scripts/download_video.py "URL" -o /path/to/directory
+```
+
+## Complete Examples
+
+1. Download video in 1080p as MP4:
+```bash
+python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
+```
+
+2. Download audio only as MP3:
+```bash
+python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
+```
+
+3. Download in 720p as WebM to custom directory:
+```bash
+python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path
+```
+
+## How It Works
+
+The skill uses `yt-dlp`, a robust YouTube downloader that:
+- Automatically installs itself if not present
+- Fetches video information before downloading
+- Selects the best available streams matching your criteria
+- Merges video and audio streams when needed
+- Supports a wide range of YouTube video formats
+
+## Important Notes
+
+- Downloads are saved to `/mnt/user-data/outputs/` by default
+- Video filename is automatically generated from the video title
+- The script handles installation of yt-dlp automatically
+- Only single videos are downloaded (playlists are skipped by default)
+- Higher quality videos may take longer to download and use more disk space

package/.deepquark/skills/bundled/youtube-downloader/scripts/download_video.py

@@ -0,0 +1,145 @@
+#!/usr/bin/env python3
+"""
+YouTube Video Downloader
+Downloads videos from YouTube with customizable quality and format options.
+"""
+
+import argparse
+import sys
+import subprocess
+import json
+
+
+def check_yt_dlp():
+    """Check if yt-dlp is installed, install if not."""
+    try:
+        subprocess.run(["yt-dlp", "--version"], capture_output=True, check=True)
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        print("yt-dlp not found. Installing...")
+        subprocess.run([sys.executable, "-m", "pip", "install", "--break-system-packages", "yt-dlp"], check=True)
+
+
+def get_video_info(url):
+    """Get information about the video without downloading."""
+    result = subprocess.run(
+        ["yt-dlp", "--dump-json", "--no-playlist", url],
+        capture_output=True,
+        text=True,
+        check=True
+    )
+    return json.loads(result.stdout)
+
+
+def download_video(url, output_path="/mnt/user-data/outputs", quality="best", format_type="mp4", audio_only=False):
+    """
+    Download a YouTube video.
+    
+    Args:
+        url: YouTube video URL
+        output_path: Directory to save the video
+        quality: Quality setting (best, 1080p, 720p, 480p, 360p, worst)
+        format_type: Output format (mp4, webm, mkv, etc.)
+        audio_only: Download only audio (mp3)
+    """
+    check_yt_dlp()
+    
+    # Build command
+    cmd = ["yt-dlp"]
+    
+    if audio_only:
+        cmd.extend([
+            "-x",  # Extract audio
+            "--audio-format", "mp3",
+            "--audio-quality", "0",  # Best quality
+        ])
+    else:
+        # Video quality settings
+        if quality == "best":
+            format_string = "bestvideo+bestaudio/best"
+        elif quality == "worst":
+            format_string = "worstvideo+worstaudio/worst"
+        else:
+            # Specific resolution (e.g., 1080p, 720p)
+            height = quality.replace("p", "")
+            format_string = f"bestvideo[height<={height}]+bestaudio/best[height<={height}]"
+        
+        cmd.extend([
+            "-f", format_string,
+            "--merge-output-format", format_type,
+        ])
+    
+    # Output template
+    cmd.extend([
+        "-o", f"{output_path}/%(title)s.%(ext)s",
+        "--no-playlist",  # Don't download playlists by default
+    ])
+    
+    cmd.append(url)
+    
+    print(f"Downloading from: {url}")
+    print(f"Quality: {quality}")
+    print(f"Format: {'mp3 (audio only)' if audio_only else format_type}")
+    print(f"Output: {output_path}\n")
+    
+    try:
+        # Get video info first
+        info = get_video_info(url)
+        print(f"Title: {info.get('title', 'Unknown')}")
+        print(f"Duration: {info.get('duration', 0) // 60}:{info.get('duration', 0) % 60:02d}")
+        print(f"Uploader: {info.get('uploader', 'Unknown')}\n")
+        
+        # Download the video
+        subprocess.run(cmd, check=True)
+        print(f"\n✅ Download complete!")
+        return True
+    except subprocess.CalledProcessError as e:
+        print(f"\n❌ Error downloading video: {e}")
+        return False
+    except Exception as e:
+        print(f"\n❌ Error: {e}")
+        return False
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Download YouTube videos with customizable quality and format"
+    )
+    parser.add_argument("url", help="YouTube video URL")
+    parser.add_argument(
+        "-o", "--output",
+        default="/mnt/user-data/outputs",
+        help="Output directory (default: /mnt/user-data/outputs)"
+    )
+    parser.add_argument(
+        "-q", "--quality",
+        default="best",
+        choices=["best", "1080p", "720p", "480p", "360p", "worst"],
+        help="Video quality (default: best)"
+    )
+    parser.add_argument(
+        "-f", "--format",
+        default="mp4",
+        choices=["mp4", "webm", "mkv"],
+        help="Video format (default: mp4)"
+    )
+    parser.add_argument(
+        "-a", "--audio-only",
+        action="store_true",
+        help="Download only audio as MP3"
+    )
+    
+    args = parser.parse_args()
+    
+    success = download_video(
+        url=args.url,
+        output_path=args.output,
+        quality=args.quality,
+        format_type=args.format,
+        audio_only=args.audio_only
+    )
+    
+    sys.exit(0 if success else 1)
+
+
+if __name__ == "__main__":
+    main()

package/.deepquark/skills/bundled/youtube-transcribe-skill/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: youtube-transcribe-skill
+description: 'Extract subtitles/transcripts from YouTube videos. Triggers: "youtube transcript", "extract subtitles", "video captions", "视频字幕", "字幕提取", "YouTube转文字", "提取字幕".'
+allowed-tools: Read, Write, Glob, Grep, Task, Bash(cat:*), Bash(ls:*), Bash(tree:*), Bash(yt-dlp:*), Bash(which:*), mcp__plugin_claude-code-settings_chrome__*
+---
+
+# YouTube Transcript Extraction
+
+Extract subtitles/transcripts from a YouTube video URL and save them as a local file.
+
+Input YouTube URL: $ARGUMENTS
+
+## Step 1: Verify URL and Get Video Information
+
+1. **Verify URL Format**: Confirm the input is a valid YouTube URL (supports `youtube.com/watch?v=` or `youtu.be/` formats).
+
+2. **Get Video Information**: Use WebFetch or firecrawl to fetch the page and extract the video title for subsequent file naming.
+
+## Step 2: CLI Quick Extraction (Priority Attempt)
+
+Use command-line tools to quickly extract subtitles.
+
+1. **Check Tool Availability**:
+   Execute `which yt-dlp`.
+
+   - If `yt-dlp` is **found**, proceed to subtitle download.
+   - If `yt-dlp` is **NOT found**, skip immediately to **Step 3**.
+
+2. **Execute Subtitle Download** (Only if `yt-dlp` is found):
+
+   - **Tip**: Always add `--cookies-from-browser` to avoid sign-in restrictions. Default to `chrome`.
+   - **Retry Logic**: If `yt-dlp` fails with a browser error (e.g., "Could not open Chrome"), ask the user to specify their available browser (e.g., `firefox`, `safari`, `edge`) and retry.
+
+   ```bash
+   # Get the title first (try chrome first)
+   yt-dlp --cookies-from-browser=chrome --get-title "[VIDEO_URL]"
+
+   # Download subtitles
+   yt-dlp --cookies-from-browser=chrome --write-auto-sub --write-sub --sub-lang zh-Hans,zh-Hant,en --skip-download --output "<Video Title>.%(ext)s" "[VIDEO_URL]"
+   ```
+
+3. **Verify Results**:
+   - Check the command exit code.
+   - **Exit code 0 (Success)**: Subtitles have been saved locally, task complete.
+   - **Exit code non-0 (Failure)**:
+     - If error is related to browser/cookies, ask user for correct browser and retry Step 2.
+     - If other errors (e.g., video unavailable), proceed to **Step 3**.
+
+## Step 3: Browser Automation (Fallback)
+
+When the CLI method fails or `yt-dlp` is missing, use browser UI automation to extract subtitles.
+
+1. **Check Tool Availability**:
+
+   - Check if `chrome-devtools-mcp` tools (specifically `mcp__plugin_claude-code-settings_chrome__new_page`) are available.
+   - **CRITICAL CHECK**: If `chrome-devtools-mcp` is **NOT** available AND `yt-dlp` was **NOT** found in Step 2:
+     - **STOP** execution.
+     - **Notify the User**: "Unable to proceed. Please either install `yt-dlp` (for fast CLI extraction) OR configure `chrome-devtools-mcp` (for browser automation)."
+
+2. **Initialize Browser Session** (If tools are available):
+
+   Call `mcp__plugin_claude-code-settings_chrome__new_page` to open the video URL.
+
+### 3.2 Analyze Page State
+
+Call `mcp__plugin_claude-code-settings_chrome__take_snapshot` to read the page accessibility tree.
+
+### 3.3 Expand Video Description
+
+_Reason: The "Show transcript" button is usually hidden within the collapsed description area._
+
+1. Search the snapshot for a button labeled **"...more"**, **"...更多"**, or **"Show more"** (usually located in the description block below the video title).
+2. Call `mcp__plugin_claude-code-settings_chrome__click` to click that button.
+
+### 3.4 Open Transcript Panel
+
+1. Call `mcp__plugin_claude-code-settings_chrome__take_snapshot` to get the updated UI snapshot.
+2. Search for a button labeled **"Show transcript"**, **"显示转录稿"**, or **"内容转文字"**.
+3. Call `mcp__plugin_claude-code-settings_chrome__click` to click that button.
+
+### 3.5 Extract Content via DOM
+
+_Reason: Directly reading the accessibility tree for long lists is slow and consumes many tokens; DOM injection is more efficient._
+
+Call `mcp__plugin_claude-code-settings_chrome__evaluate_script` to execute the following JavaScript:
+
+```javascript
+() => {
+  // Select all transcript segment containers
+  const segments = document.querySelectorAll("ytd-transcript-segment-renderer");
+  if (!segments.length) return "BUFFERING"; // Retry if empty
+
+  // Iterate and format as "timestamp text"
+  return Array.from(segments)
+    .map((seg) => {
+      const time = seg.querySelector(".segment-timestamp")?.innerText.trim();
+      const text = seg.querySelector(".segment-text")?.innerText.trim();
+      return `${time} ${text}`;
+    })
+    .join("\n");
+};
+```
+
+If it returns "BUFFERING", wait a few seconds and retry.
+
+### 3.6 Save and Cleanup
+
+1. Use the Write tool to save the extracted text as a local file (e.g., `<Video Title>.txt`).
+2. Call `mcp__plugin_claude-code-settings_chrome__close_page` to release resources.
+
+## Output Requirements
+
+- Save the subtitle file to the current working directory.
+- Filename format: `<Video Title>.txt`
+- File content format: Each line should be `Timestamp Subtitle Text`.
+- Report upon completion: File path, subtitle language, total number of lines.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@duckmind/deepquark-darwin-arm64",
-  "version": "0.9.78",
+  "version": "0.9.81",
   "license": "MIT",
-  "description": "DeepQuark native binary for darwin-arm64",
+  "description": "DeepQuark native binary + bundled skills for darwin-arm64",
   "os": [
     "darwin"
   ],
@@ -10,6 +10,7 @@
     "arm64"
   ],
   "files": [
-    "bin"
+    "bin",
+    ".deepquark"
   ]
 }