OmniGet Claude 插件环境初始化完全指南setup 命令与工具链自举原理【免费下载链接】omnigetDownload Udemy and Hotmart courses, YouTube videos, music and books — 1,800 sites, no terminal. Free open-source desktop app for Windows, macOS and Linux, with a built-in course player, PDF/EPUB reader and music library. Powered by yt-dlp. Your files stay on your computer.项目地址: https://gitcode.com/GitHub_Trending/om/omniget导读本文围绕 claude-plugin/omniget/commands/setup.md 这一 Claude 命令定义展开深入剖析 OmniGet 桌面应用配套的 Claude 插件omniget skill如何一次性完成运行环境初始化检测并安装yt-dlp、ffmpeg、omniget-cli等核心工具探测可用的转写后端并安全地管理 OpenAI / Gemini API 密钥。读完本文你将掌握setup.sh全部命令行参数的含义与底层实现、工具查找优先级、本地 Whisper 模型下载机制、API Key 的安全存储模型以及 Claude 代理与用户终端之间的职责边界。一、setup.md 在插件中的定位setup.md是一个 Claude Code 命令slash command定义文件。它的 front-matter 声明了命令的元信息Front-matter 字段值含义descriptionSet up the omniget skill: install missing tools for this OS (confirm once) and check API keys命令的核心职责安装缺失工具 检查 API Keyargument-hint[--yes] [--local]允许透传给脚本的参数allowed-tools[Bash]该命令只允许 Claude 使用 Bash 工具执行命令的正文定义了三条执行规则运行 setup 脚本并把用户传入的参数原样透传bash ${CLAUDE_PLUGIN_ROOT}/scripts/setup.sh $ARGUMENTS阅读输出并如实转述告诉用户当前已安装了什么、有哪些转写选项可用字幕始终可用有模型则可用本地 Whisper有通过校验的 Key 则可用 Gemini/OpenAI 云端转写。边界约束不允许让用户把 Key 粘贴给 Claude也绝不允许 Claude 自己执行keys.sh set——因为密钥输入必须在用户自己的终端中完成绝不能经过对话上下文。这套约束背后是明确的安全模型Key 属于用户终端不属于对话。后续章节将逐一展开其实现。二、setup.sh一次确认完成整机自举scripts/setup.sh 是命令的实际执行者自述为 One-step setup for the omniget skill。它按检测 OS → 检查工具 → 单次确认 → 安装 → Key 检查的顺序工作。2.1 完整参数表脚本的参数解析位于 setup.sh除文档提及的--yes/--local外实际还支持参数效果源码位置--yes/-y跳过安装确认提示直接安装L22--local额外安装本地 Whisper 引擎whisper-cli并下载默认模型L23--check-only只报告状态并退出不安装任何东西对 Claude 安全L24--no-cli跳过omniget-cli的下载安装L25--update刷新yt-dlp与omniget-cli隐含--yesL26未知参数打印setup: unknown flag $arg并返回退出码 2L27值得注意的是--update模式L42-L62它会按检测到的包管理器升级yt-dlp/ffmpegbrew upgrade、winget upgrade、scoop update、pipx upgrade随后重新拉取最新版omniget-cli最后执行keys.sh check汇总状态。当某个站点从能用变成报错时setup.sh --update就是首选修复手段——正如 omniget-fetch/SKILL.md 中所说If a site that used to work now fails for everyone, the fix is usually stale tools。2.2 平台与包管理器检测脚本通过resolve-tools.sh提供的og_os()基于uname -s判断 Darwin/Linux/MINGW识别操作系统然后按平台优先级探测包管理器L33-L39macOSbrewHomebrewWindows依次探测winget→scoop→chocoLinux依次探测apt-get→dnf→pacman→zypper2.3 按工具分发的安装命令install_cmd()setup.sh是一个工具 × 包管理器的配方表为每个组合输出精确的安装命令。下表是部分核心配方工具平台安装命令yt-dlpmacOSbrew install yt-dlpyt-dlpWindows (winget)winget install --silent --accept-package-agreements --accept-source-agreements yt-dlp.yt-dlpyt-dlpDebian/Ubuntusudo apt-get update sudo apt-get install -y pipx pipx install yt-dlpyt-dlpFedorasudo dnf install -y yt-dlpyt-dlpArchsudo pacman -S --noconfirm yt-dlpffmpegWindows (winget)winget install --silent --accept-package-agreements --accept-source-agreements Gyan.FFmpegffmpegDebian/Ubuntusudo apt-get update sudo apt-get install -y ffmpegwhisper-climacOSbrew install whisper-cpp若某个工具在当前 OS 上没有自动安装配方脚本会生成一条# no-auto-install recipe ...注释行并在后续执行阶段跳过L183。若完全没有检测到包管理器脚本不会硬装而是给出平台化建议L114-L120例如 macOS 先安装 Homebrew、Windows 先安装 winget 或 scoop。2.4 安装交互与 sudo 处理核心交互逻辑在 L199-L212当存在缺失工具时除非--yes已生效否则脚本会在有终端[ -t 0 ]时打印Install the N missing tool(s) now? [y/N]等待一次确认——这正是 setup.md 中 confirm once只确认一次的出处。run_installs()L177-L197还有一处细心处理如果安装命令包含sudo且当前没有交互终端典型场景就是 Claude 通过非交互 Bash 调用脚本不会强行执行而是打印该命令行让用户自行运行并置返回码为 1。三、omniget-cli原生提取器的自动装配setup.sh在基础工具就绪后还会下载 OmniGet 的专用命令行工具omniget-cli。它携带 OmniGet 的原生 Instagram / X / Bilibili / Threads 提取器对这些站点比裸yt-dlp更可靠脚本注释 L142-L143 明确说明。下载过程install_omniget_cli()setup.sh如下根据OS:arch匹配预编译产物三元组cli_triple()L131-L139macOS Apple Silicon →aarch64-apple-darwintar.gzmacOS Intel →x86_64-apple-darwintar.gzWindows x64 →x86_64-pc-windows-msvczipLinux x64 →x86_64-unknown-linux-gnutar.gz其他组合返回空脚本降级为所有站点都用 yt-dlp通过 GitHub API 解析最新 release 的 tag30 秒超时拼出资产名omniget-cli-$ver-$triple.$ext并下载。解压到 skill 缓存目录~/.cache/omniget-skill/binmacOS 下额外执行xattr -d com.apple.quarantine解除隔离属性。最后用omniget-cli --version做冒烟验证运行不干净则回退到 yt-dlpL173。仓库变量OMNIGET_REPO默认tonhowtf/omnigetL128可通过环境变量覆盖用于指定从哪个仓库拉取发布资产。四、工具查找优先级OmniGet 自有副本优先scripts/resolve-tools.sh 定义了所有脚本公用的工具解析逻辑。og_find_tool()L57-L85的查找顺序是显式覆盖OMNIGET_TOOL_NAME环境变量如OMNIGET_TOOL_YT_DLP/path/to/yt-dlp来源标记为customOmniGet 应用管理目录data dir/bin来源omniget——如果桌面版 OmniGet 已安装它自带的yt-dlp/ffmpeg就在这里无需额外安装这也是 omniget-fetch/SKILL.md 中If OmniGet (the desktop app) is installed, yt-dlp and ffmpeg are already managed and nothing needs installing的实现基础skill 缓存目录~/.cache/omniget-skill/bin来源skill系统 PATH来源system对whisper-cli额外兼容 Homebrew 旧配方安装的whisper-cpp。各平台的应用数据目录og_data_dir()L24-L35与 OmniGet 桌面版的 Rust 路径实现见src-tauri/omniget-core/src/core/paths.rs保持一致macOS 为~/Library/Application Support/wtf.tonho.omnigetLinux 为$XDG_DATA_HOME/.local/share/wtf.tonho.omnigetWindows 为%APPDATA%/wtf.tonho.omniget。五、转写后端探测setup 决定了哪些能力可用setup 的最终效果是让omniget-transcribeskill 拥有可用的转写后端。按照 omniget-transcribe/SKILL.md 的--backend auto阶梯可用性取决于 setup 阶段装了什么优先级后端依赖setup 中的对应动作1captions平台自带字幕无需额外安装始终可用2localwhisper-cli ggml 模型setup.sh --local安装引擎 下载模型3mlxmlx_whisperApple Silicon见doctor.sh的补充说明4geminiGEMINI_API_KEYkeys.sh set后经keys.sh check验证5openaiOPENAI_API_KEY同上5.1 本地 Whisper 模型下载当--local生效且whisper-cli已就位但无模型时setup.sh脚本会询问是否下载默认模型large-v3-turbo-q5_0547 MB确认后调用get-model.sh。scripts/get-model.sh 的实现要点模型从 Hugging Face 的ggerganov/whisper.cpp仓库下载目标目录优先为 OmniGet 的models/whisper目录否则回退到~/.cache/omniget-skill/models下载前先从 HF API 解析该文件在 LFS 中的 SHA-256 期望值下载完成后用sha256sum或 macOS 的shasum -a 256校验不匹配即删除并报错退出L33-L41——确保本地模型文件未被篡改模型命名需去掉ggml-前缀与.bin后缀L11例如传入large-v3-turbo-q5_0对应文件ggml-large-v3-turbo-q5_0.bin。而resolve-tools.sh的og_whisper_model()L93-L115会按large-v3-turbo量化优先→ medium → small → base → tiny的优先级在 OmniGet 模型目录与 skill 缓存中自动挑选可用模型并兼容OMNIGET_WHISPER_MODEL显式指定。六、API Key 管理keys.sh 的安全模型setup 流程的最后一步setup.sh是执行keys.sh check并打印提示让用户在自己的终端里运行keys.sh set。6.1 set交互式、隐藏输入、chmod 600scripts/keys.sh 的cmd_set()L36-L67设计了三道防线强制交互终端[ ! -t 0 ]时直接拒绝执行并提示用户去自己的终端运行L37-L41——这正是 setup.md 规则never run keys.sh set yourself的脚本级强制隐藏输入使用read -r -s读取密钥屏幕不回显空输入表示保留当前值支持已设置则回车跳过值走 stdin 而非 argv_upsert_env()L22-L34从标准输入读取密钥值写入文件密钥不会出现在ps输出或 shell history 中。密钥写入~/.config/ai-keys.env可用OMNIGET_KEYS_FILE覆盖文件权限强制为 600且通过awk按变量名去重替换、保留文件中其他无关行例如用户已有的REPLICATE_API_KEY、ANTHROPIC_API_KEY。这一保留其他行、同名替换、权限 600的行为被 tests/test_keys.sh 以五组断言覆盖验证包括无关 Key 保持不变REPLICATE_API_KEYkeep-me与ANTHROPIC_API_KEYalso-keep原样保留同名 Key 是替换而非追加OPENAI_API_KEY只出现一次且为最新值文件权限严格为 600。6.2 check只验证、不泄露cmd_check()L81-L117对已配置的 Key 逐一做真实探测OpenAI向https://api.openai.com/v1/models发送带Authorization: Bearer $KEY的请求按 HTTP 状态码分类200 working401/403 BAD KEY000 无网络/超时Gemini向https://generativelanguage.googleapis.com/v1beta/models?key$KEY探测200 working400/401/403 BAD KEY000 无网络/超时。无论何种情况脚本永远不打印 Key 值本身。报告为 working 的 Key 即可在转写时使用--backend openai/--backend gemini没有任何可用 Key 时脚本会引导用户使用平台字幕或本地 Whisper并给出keys.sh set提示。值得注意的兼容性说明keys.sh 明确不支持 OpenRouterL12 注释——因为 OpenRouter 没有 speech-to-text 端点无法用于转写。七、doctor.sh随时复查的全景诊断setup 完成之后任何时刻都可通过 scripts/doctor.sh 复查环境。它报告的项目包括引擎工具omniget-cli、yt-dlp、ffmpeg、ffprobe、whisper-cli、mlx_whisper每个均标注 status 与来源路径whisper-model是否已存在可用模型密钥GEMINI_API_KEY/OPENAI_API_KEY是否已设置omniget-app桌面版是否安装检查应用数据目录是否存在output-dir默认输出目录$HOME/Downloads/omniget可用OMNIGET_DIR覆盖。doctor.sh --json输出机器可读的 JSON 摘要--check-keys追加执行keys.sh check。同时它会按平台打印补齐缺口的建议命令macOS 的brew install whisper-cpp、Linux 的sudo apt install ffmpeg pip install -U yt-dlp、Windows 的winget install yt-dlp.yt-dlp Gyan.FFmpeg等但是否执行完全由用户决定——这是 omniget-fetch/SKILL.md 中Never run an install command without the users explicit yes规则的延续。八、典型使用流程与边界约定综合 setup.md 与 skill 定义一套标准的初始化对话大致如下全新机器用户执行setup.sh→ 脚本检测到缺yt-dlp/ffmpeg→ 一次确认后按平台包管理器安装 → 下载omniget-cli→ 报告状态并提示keys.sh set。需要离线/私密转写用户执行setup.sh --local→ 额外安装whisper-cli并下载large-v3-turbo-q5_0模型547 MB带 SHA-256 校验→ 之后transcribe.sh的--backend auto会自动优先走本地。需要云端高精度转写用户在自己的终端运行keys.sh set输入 OpenAI / Gemini Key → 回到对话用doctor.sh --check-keys或keys.sh check确认状态为 working → 即可使用--backend openai --model gpt-4o-transcribe等高精度配置。站点突然失效执行setup.sh --update刷新yt-dlp与omniget-cli。三条不可逾越的边界既是 setup.md 的规则也在脚本与 skill 中反复强化安装命令必须获得用户明确同意setup.sh只在单次确认后自动安装其他场景一律打印命令让用户决定API Key 永不经过 Claude 对话keys.sh set强制要求交互终端Key 只存在于用户终端的~/.config/ai-keys.envchmod 600Cookie 与密钥永不打印、复制或提交相关值均通过 stdin 或文件传递脚本只输出状态不输出内容。九、小结setup.md虽只是一个短小的命令定义但其背后是一个设计严谨的工具链自举体系setup.sh完成跨平台macOS / Windows / Linux × 7 种包管理器的依赖安装与omniget-cli装配resolve-tools.sh定义了自定义覆盖 → OmniGet 托管副本 → skill 缓存 → 系统 PATH的解析优先级get-model.sh以 SHA-256 校验保障本地模型完整性keys.sh以交互终端 隐藏输入 600 权限守住密钥安全底线doctor.sh则提供了随时可用的全景诊断入口。理解这套流程你就能在任意新环境下一次完成 OmniGet 插件的全部初始化并清楚知道哪些转写能力可用、为什么可用、以及如何在不泄露密钥的前提下补齐缺口。延伸阅读仓库内路径命令定义claude-plugin/omniget/commands/setup.md、claude-plugin/omniget/commands/fetch.md核心脚本scripts/setup.sh、scripts/resolve-tools.sh、scripts/keys.sh、scripts/get-model.sh、scripts/doctor.shSkill 定义omniget-fetch/SKILL.md、omniget-transcribe/SKILL.md测试用例tests/test_keys.sh、tests/test_retry.sh【免费下载链接】omnigetDownload Udemy and Hotmart courses, YouTube videos, music and books — 1,800 sites, no terminal. Free open-source desktop app for Windows, macOS and Linux, with a built-in course player, PDF/EPUB reader and music library. Powered by yt-dlp. Your files stay on your computer.项目地址: https://gitcode.com/GitHub_Trending/om/omniget创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
