前言¶
在 Mac 上做本地语音转写、再导出字幕，常见做法是手动查文档、配 Python 环境、拉 MLX Whisper 模型、再分别起前后端。步骤多、端口和依赖容易对不上。下面介绍 SkillHub 上的 本地语音转录字幕文件工具（@user_af21af52/audio2srt）：把「部署 Audio2SRT」写成 Agent 可执行的 Skill，在你说「部署 audio2srt」「启动转录服务」等意图时，由 Agent 按固定流程完成克隆、装依赖、下模型和启动服务。
这是什么¶
本地语音转录字幕文件工具 是社区 Skill（坐标 @user_af21af52/audio2srt，版本 1.0.0，发布者 user_af21af52，SkillHub 页作者标注为 tsingchou）。它面向 Audio2SRT：基于 MLX Whisper 的本地音频转录与翻译 Web GUI，运行环境为 Apple Silicon Mac。
Skill 本身不替代 Audio2SRT 的业务逻辑，而是告诉 Agent：何时介入、按什么顺序部署该项目——从 Gitee 克隆仓库、安装 Python 与 Node.js 依赖、从 ModelScope 自动下载 MLX 模型，并启动后端与前端。
核心功能¶
依据 SkillHub 简介，已核实能力包括：
- 本地转录与翻译：通过 Audio2SRT + MLX Whisper，在本机完成音频转写（含翻译能力，以项目 Web GUI 为准）。
- 一键式部署编排：Agent 执行克隆（Gitee）、依赖安装、模型拉取与服务启动，减少手工拼命令。
- 双进程 Web 架构：后端为 Python aiohttp，默认端口 8765；前端为 Vite + React，默认端口 3000。
- 模型来源：MLX 模型从 ModelScope 自动下载（首次部署会涉及下载体积与时间）。
- 无需 API Key：标签
requires_api_key=false，安装 Skill 本身不要求配置第三方 API 密钥。
SkillHub 分类为 design-media；页面显示评分 100000，下载 1081 次（统计以 SkillHub 为准）。
安装与启用¶
安装 Skill（SkillHub）¶
官方页面给出的方式是：让 AI 按 SkillHub 安装文档安装本 Skill。
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_af21af52/audio2srt`。
若你自行用 CLI，需先确认已安装 skillhub，并把技能装到当前 Agent 识别的 skills 目录（文档要求使用 --dir，否则默认 ./skills/ 可能不会被识别）：
command -v skillhub && skillhub --version
未安装 CLI 时，可按 SkillHub 文档执行完整安装（示例来自官方 install 文档）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，将 --dir 指向对应客户端目录，例如：
| 客户端 | Skills 目录（官方文档列举） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
示例（Cursor）：
skillhub install user_af21af52/audio2srt --dir ~/.cursor/skills/
具体包名以 skillhub search audio2srt 搜索结果为准。安装 Skill 后，按你所用 Agent 的说明刷新或重启，使新 Skill 生效。
部署 Audio2SRT（由 Skill 驱动）¶
安装 Skill 之后，部署 Audio2SRT 项目不在本文重复编造仓库地址或脚本；由 Agent 读取 Skill 内的 SKILL.md 流程执行。公开简介中明确的步骤包括：从 Gitee 克隆、安装 Python 与 Node.js 依赖、从 ModelScope 下载 MLX 模型、启动 8765（后端）与 3000（前端）服务。
典型用法¶
在已启用该 Skill 的 Agent 对话中，用自然语言触发即可。Skill 简介中列出的触发意图包括：
- 部署 audio2srt / setup Audio2SRT / deploy mlx whisper tool
- 安装音频转录工具
- 启动转录服务
- 任何明确指向 audio2srt 项目搭建、安装的表述
典型对话示例（示意，实际命令由 Agent 按 Skill 输出）：
帮我在这台 Mac 上部署 Audio2SRT，装好依赖并启动前后端。
经过上面的步骤，Agent 应完成环境准备并拉起服务；你在浏览器访问前端端口（简介中为 3000）使用 Web GUI 上传音频并导出字幕类结果，具体格式以 Audio2SRT 界面为准。
适用场景与注意¶
适合谁
- 使用 Apple Silicon Mac，希望 本地 跑 MLX Whisper，避免把长音频上传到云端。
- 需要 Web GUI 操作转录/翻译，而不是纯命令行一次性脚本。
- 愿意让 Agent 代为处理 Gitee 克隆、依赖与 ModelScope 模型下载，而不是自己维护一份部署清单。
限制与注意
- 平台：简介明确为 Apple Silicon Mac；Intel Mac 或 Linux/Windows 不在 Skill 描述范围内，勿按同一流程预期可用。
- 资源：ModelScope 模型下载与 MLX 推理会占用磁盘与内存，长音频转写耗时取决于机型与模型大小。
- 网络：克隆 Gitee、拉取 Node/Python 包与模型均需网络；内网或离线环境需自行评估。
- 端口：默认 8765、3000 若被占用，需在 Agent 执行过程中按 Skill/项目说明调整或释放端口。
- Skill 与项目：本 Skill 版本为 1.0.0；Audio2SRT 上游变更时，以 Skill 更新与 Gitee 仓库为准。
结尾¶
本地语音转录字幕文件工具 把 Audio2SRT 在 Apple Silicon 上的部署流程固化成 Agent Skill：Gitee 源码、双栈依赖、ModelScope MLX 模型与 aiohttp + Vite 双端口服务，都写在一条可触发的部署路径里。若你经常在 Cursor、Claude Code 等环境里做本地转字幕，可先按 SkillHub 安装 @user_af21af52/audio2srt，再用一句话让 Agent 完成搭建。
- Skill 安装与说明：https://www.skillhub.cn/skills/user_af21af52/audio2srt
- Skill 资源地址：https://api.skillhub.cn/user_af21af52/audio2srt
- SkillHub 通用安装：https://skillhub.cn/install/skillhub.md
