前言¶
采访录音、播客、会议视频往往要先变成可读文字，再才能做摘要、检索或二次创作。常见做法是上传到在线转写服务，或自己在本机跑 Whisper 再手工改口语、断句和错别字。前者有隐私与链路依赖，后者则要在「转录脚本」和「整理成稿」之间来回切换。
下面介绍 SkillHub 上的社区技能 音频转文本整理稿（本地部署版）（@user_695efa3d/transcript-organizer）。它把本地 ASR 与文本清洗整理收进 Agent Skill 流程，最终把「分享式提纯版」中文原文写到本地 .txt，产物不离开本机。
这是什么¶
音频转文本整理稿（本地部署版） 是面向 design-media 场景的 Agent Skill，坐标 @user_695efa3d/transcript-organizer，当前版本 1.0.0，来源为 community，由发布者 user_695efa3d 维护。SkillHub 标注 requires_api_key=false，即不依赖额外 API Key 配置项。
一句话定位：接收音频、视频、播客链接、字幕、原始转写稿或未整理文字，在本地完成转录（faster-whisper / mlx-whisper）与整理，输出提纯版中文原文到本地 .txt 文件。
核心功能¶
以下能力均来自 SkillHub 页面与已抓取元数据，未单独展开的实现细节以技能包内 SKILL.md 为准。
- 多形态输入：本地音视频文件、播客链接、字幕文件、已有转写稿或未整理文字均可作为起点。
- 本地 ASR：转录侧支持本机 faster-whisper 与 mlx-whisper，适合希望数据留在本地的场景。
- 清洗与整理：在转写结果上做文本清洗与结构化整理，产出便于阅读与分享的「提纯版」中文原文。
- 本地落盘：结果写入本地
.txt，所有产物保存在本地，便于纳入现有笔记或版本管理流程。
安装与启用¶
安装分两条路径：用 SkillHub CLI 装到当前 Agent 的 skills 目录，或把官方提示词交给 AI 按文档安装。
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档 执行完整安装（文档中的推荐方式）：
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
2. 安装本技能到 Agent skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；默认装到 ./skills/ 可能不会被加载。常见路径如下（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在对应目录下执行安装（将 <skills 目录> 换成上表中的实际路径）：
skillhub install @user_695efa3d/transcript-organizer --dir <skills 目录>
也可将下面这句提示词发给当前 AI，让其按官方流程安装（SkillHub 技能页提供的安装说明）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_695efa3d/transcript-organizer`。
安装完成后，按你所用客户端的要求重启或刷新 Agent，使技能被识别。
典型用法¶
官方公开资料未给出固定 CLI 子命令示例；技能通过 Agent 对话触发。可复现的使用方式如下。
- 确认本技能已出现在 Agent 的 skills 列表中。
- 在对话中说明任务目标（例如：将某段播客/会议录音整理成可读中文稿），并附上输入：
- 本地音频或视频文件路径；
- 播客链接；
- 字幕或已有转写/未整理文字。 - 按技能指引在本机完成 ASR（faster-whisper 或 mlx-whisper）与整理步骤；最终在本地得到
.txt形式的提纯版中文原文。
具体参数、模型选择与文件命名规则以安装后的 SKILL.md 为准；本文不臆造配置字段或示例路径。
适用场景与注意¶
适合谁
- 需要把音视频、播客或字幕变成可读中文稿，且希望转录与整理在同一套 Agent 工作流里完成。
- 对数据出境敏感，倾向用本机 Whisper 系引擎处理素材。
- 习惯用 Cursor、Claude Code、Codex 等带 Skills 能力的客户端做内容整理。
限制与注意
- 本地 ASR 对算力、磁盘与依赖环境有要求；faster-whisper 与 mlx-whisper 的适用平台以你本机环境与技能说明为准。
- 播客链接类输入是否可拉流、是否需要额外工具，取决于技能包实现与网络环境，使用前宜先用小样本试跑。
- SkillHub 元数据为社区来源（community），版本 1.0.0；升级或行为变更请以 SkillHub 页面与技能包更新为准。
- 页面统计（截至资料抓取）：分类 design-media，评分 100000，下载 4334；仅作选型参考，不代表转写质量承诺。
结尾¶
音频转文本整理稿（本地部署版） 把「本地转录 + 中文整理 + 本地 .txt 输出」封装成可安装的 Agent Skill，适合在已有 AI 编程/办公客户端里处理音视频与文字素材。安装与详情见 SkillHub：
