前言¶

在 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 官方简介，已核实能力包括：

1. 本地生成项目：不通过 git clone 拉远程仓库，由模板在本地产出 Audio2SRT 工程。
2. 依赖与环境：安装 Python、Node.js 侧依赖（具体包由生成后的项目决定，由 Skill 流程驱动）。
3. 模型：从 ModelScope 自动下载 MLX 所用模型（需联网，与「源码零网络」是两层含义）。
4. 服务架构：
   - 后端：Python aiohttp，默认端口 8765
   - 前端：Vite + React，默认端口 3000
5. 触发方式：在已启用该 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 检查、目录选择与安装。

典型用法¶

1. 在 Apple Silicon Mac 上启用本 Skill 后，用触发语说明目标，例如：「本地生成 audio2srt，搭建 MLX Whisper 转录翻译 Web 工具，不要从远程 clone。」
2. 按 Agent 与 Skill 指引完成：本地生成项目 → 安装 Python/Node 依赖 → 从 ModelScope 拉取 MLX 模型 → 启动后端（8765）与前端（3000）。
3. 在浏览器访问前端端口（简介中为 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