前言¶
在 Mac 上做語音轉錄、翻譯並導出字幕，常見路徑是拉一個現成倉庫再改配置。若網絡受限、或不想把源碼來源綁在 Gitee 等遠程倉庫上，「先 clone 再裝依賴」會變成額外負擔。下面介紹 SkillHub 上的 本地語音轉錄翻譯字幕工具（@user_af21af52/audio2srtlocal）：由 Agent 按 Skill 指引，在本機用內嵌模板生成完整 Audio2SRT 項目，再安裝依賴並啓動前後端，面向 Apple Silicon 上的 MLX Whisper 轉錄與翻譯 Web 界面。
這是什麼¶
本地語音轉錄翻譯字幕工具 是社區發佈的 Agent Skill（版本 1.0.0，分類 dev-programming，發佈者 user_af21af52）。它用於 本地生成並部署 Audio2SRT：基於 MLX Whisper 的音頻轉錄與翻譯 Web GUI，目標平臺爲 Apple Silicon Mac。
與同類的 audio2srt-deploy（從 Gitee clone 源碼）不同，本 Skill 從 內嵌模板 在本地生成整個項目，獲取項目源碼本身不需要聯網。Skill 會協助安裝 Python 與 Node.js 依賴，從 ModelScope 自動下載 MLX 模型，並啓動後端與前端服務。Skill 標註 requires_api_key=false，不依賴額外 API Key 配置。
核心功能¶
依據 SkillHub 官方簡介，已覈實能力包括：
- 本地生成項目：不通過
git clone拉遠程倉庫，由模板在本地產出 Audio2SRT 工程。 - 依賴與環境：安裝 Python、Node.js 側依賴（具體包由生成後的項目決定，由 Skill 流程驅動）。
- 模型：從 ModelScope 自動下載 MLX 所用模型（需聯網，與「源碼零網絡」是兩層含義）。
- 服務架構：
- 後端：Python aiohttp，默認端口 8765
- 前端：Vite + React，默認端口 3000 - 觸發方式：在已啓用該 Skill 的 Agent 中，可用自然語言或下列意圖觸發，例如：本地生成 audio2srt、本地搭建轉錄工具、
generate Audio2SRT、生成音頻轉錄項目、local deploy mlx whisper，或任何「在不從遠程 clone 的前提下創建/搭建 audio2srt 項目」的請求。
安裝與啓用¶
通過 SkillHub CLI（推薦）¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝技能時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。座標爲 @user_af21af52/audio2srtlocal，示例：
skillhub install user_af21af52/audio2srtlocal --dir <skills 目錄>
常用 Agent 的 skills 路徑（摘自 SkillHub 安裝說明）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按所用客戶端要求重啓或刷新 Agent，使 Skill 生效。
通過對話讓 AI 安裝¶
SkillHub 頁面提供的提示詞爲：請根據 SkillHub 安裝與優先源配置，安裝 @user_af21af52/audio2srtlocal。
將上述說明發給支持 Skills 的 Agent，由其按文檔完成 CLI 檢查、目錄選擇與安裝。
典型用法¶
- 在 Apple Silicon Mac 上啓用本 Skill 後，用觸發語說明目標，例如：「本地生成 audio2srt，搭建 MLX Whisper 轉錄翻譯 Web 工具，不要從遠程 clone。」
- 按 Agent 與 Skill 指引完成：本地生成項目 → 安裝 Python/Node 依賴 → 從 ModelScope 拉取 MLX 模型 → 啓動後端（8765）與前端（3000）。
- 在瀏覽器訪問前端端口（簡介中爲 3000），使用 Web GUI 完成音頻轉錄、翻譯與字幕相關操作；具體菜單與導出格式以生成後的項目爲準。
全程由 Skill 編排；若某步需要網絡（如 ModelScope 模型下載、npm/pip 包），需保證對應環境可訪問外網或鏡像。
適用場景與注意¶
適合誰
- 使用 Apple Silicon Mac，希望用 MLX Whisper 做本地或近本地轉錄/翻譯，並需要 Web GUI。
- 希望 源碼在本地由模板生成，而不是從 Gitee 等遠程倉庫 clone（與 audio2srt-deploy 的區分點）。
- 已在 Cursor、Claude Code、Codex 等支持 SkillHub 技能的 Agent 中工作。
限制與注意
- 平臺：簡介明確面向 Apple Silicon Mac；Intel Mac 或未說明支持的環境不在官方承諾範圍內。
- 網絡：項目源碼可離線生成，但 ModelScope 模型 與 依賴安裝 通常仍需要網絡；完全離線環境需自行準備模型與依賴源。
- 端口：後端 8765、前端 3000，若衝突需在生成後的項目中調整配置（Skill 未在簡介中寫死改法，以實際生成工程爲準）。
- 數據口徑：SkillHub 頁面顯示評分 100000、下載 1446 次（統計隨 SkillHub 更新變化）。
結尾¶
本地語音轉錄翻譯字幕工具 把「搭一套 Audio2SRT」收斂成 Agent 可執行的本地生成與部署流程：模板出工程、MLX 模型從 ModelScope 拉取、雙進程 Web 棧開箱即用，適合不想綁遠程 clone 的 Apple Silicon 開發者。
- Skill API：
https://api.skillhub.cn/user_af21af52/audio2srtlocal - SkillHub 頁面：
https://www.skillhub.cn/skills/user_af21af52/audio2srtlocal
