haoai

Appearance

在 codex 或 workbuddy 中免费使用 haoone skill ​

安装 haoone skill 后，你可以在 Codex 或 WorkBuddy 中直接说“把这个视频转成中文字幕”“把字幕整理成文稿”，让 AI 调用电脑上的 HaoOne 完成字幕工作，不必自己记住命令行参数。

本教程以 Codex 本地任务为例，从准备软件、安装 skill 到生成字幕，走完一次完整流程。haoone skill 本身免费；HaoOne 基础本地转录可免费使用，单个音视频限 20 分钟。增强模型和部分功能需要激活，在线转录另按模型计费；Codex、WorkBuddy 的账号权益与模型用量按各自平台规则计算。详见付费权益说明。

第一步：准备 HaoOne ​

  1. 安装并打开 HaoOne，完成登录。
  2. 打开「设置 → 本地模型设置」，选择模型目录，下载「中英-v2-2026」。第一次体验建议使用一段 20 分钟以内的中文或英文音视频。
  3. 打开「设置 → 命令行工具」，启用工具，确认显示「已注册」。

第二步：在 Codex 中安装 haoone skill ​

在装有 HaoOne 的同一台电脑上打开 Codex，创建一个本地任务，选择存放音视频和输出文件的工作文件夹。文件夹名称可以自定，例如“字幕工作”；任务需要能够读取媒体并运行本机命令。

方法一：直接让 Codex 安装 ​

把下面这段话发送给 Codex：

text
请使用 skill-installer，从 https://github.com/minghe36/haoone-skill 安装 haoone-skill，供我的本地 Codex 任务使用。安装后检查是否能加载 SKILL.md，并运行 haoone-cli --help 和 haoone-cli installed-models 验证环境，暂时不要开始转录。

Codex 会根据技能仓库结构安装技能。安装过程中如果出现文件访问、网络或命令执行授权提示，核对操作对象后按界面提示处理。安装完成后，检查回复中是否确认了技能位置、CLI 可用状态和已安装模型。

Codex 支持从本地技能目录加载 skill，用户级目录为 ~/.agents/skills，项目级目录为 .agents/skills。通常不需要手动复制；安装后未出现时，重新打开任务或重启 Codex 再检查。Codex 官方技能说明

方法二：在终端安装 ​

已经准备好 Node.js 和 pnpm 的用户，也可以运行：

bash
pnpm dlx skills add minghe36/haoone-skill

按安装器提示选择 haoone-skill 和 Codex，再选择安装范围：只在当前工作目录使用，或供个人的其他任务使用。安装完成后回到 Codex，检查技能是否可用。技能原始文件和说明见 haoone-skill 仓库。

第三步：在对话中调用 skill ​

在 Codex 输入框中明确写出 $haoone-skill，或直接说“使用 haoone-skill”。先发一条环境检查指令：

text
使用 haoone-skill，检查本机 haoone-cli 是否可用、已安装哪些转录模型，以及当前项目是什么。只检查环境，不创建项目、不开始转录。

确认 Codex 加载技能并实际检查了工具，而不是只给出一段操作建议。它应能说明可用模型、当前项目情况，以及是否还缺少配置。不要把账号、激活码或 API 密钥粘贴到对话中。

Codex CLI 和 IDE 扩展也可以输入 /skills 或 $ 选择已安装技能；自然语言明确指定技能同样适合本文的操作流程。官方调用方式

第四步：让 Codex 生成一份中文字幕 ​

将媒体放到工作文件夹中，在提示词里写清楚文件名、语言和输出目录。以下内容可直接复制，把文件名换成自己的：

text
使用 haoone-skill，把当前工作目录中的“采访.mp4”转成中文字幕。
使用已安装的“中英-v2-2026”本地模型，语言为 zh，关闭在线转录和 AI 纠错。
将结果保存到当前工作目录的 output 文件夹，不覆盖已有结果。
完成后给我 SRT 和 JSON 的实际路径，并检查文件是否生成、字幕条数是否大于 0。

Codex 会定位文件、检查模型，再组织并执行 haoone-cli transcribe。你不需要手写完整命令；想了解它使用的参数，可以查看命令行工具教程。

如果文件没有放在工作文件夹中，直接提供实际完整路径，路径含空格时保留引号。多个文件同名时明确指定目标，避免让 AI 猜测。

怎样确认任务完成 ​

查看 Codex 返回的 实际输出路径，打开生成的 SRT，检查是否有字幕文字与时间轴。再试听素材中的开头、结尾、专有名词和多人交谈处，确认文字与时间位置。

需要继续可视化校对时，在 HaoOne 打开对应媒体并导入生成的字幕，按导入字幕与词级对齐和快速修改字幕继续操作。仅看到“命令已执行”不足以确认字幕内容正确。

接下来可以让 Codex 做什么 ​

把已有字幕整理成文稿 ​

这类任务可以直接读取 SRT，由 Codex 整理文字，不需要重新识别音频：

text
使用 haoone-skill，读取 output 文件夹中的“采访.srt”，去掉字幕编号和时间轴，按主题整理成中文文稿。
保留原意，不添加字幕中没有的事实，另存为“采访文稿.md”，保留原 SRT。

用已有稿件与音频直接对齐 ​

已经有准确稿件时，先安装对应语言的对齐模型，再让 Codex 使用直接对齐命令：

text
使用 haoone-skill，将“口播稿.txt”与“口播.mp4”直接对齐生成中文字幕。
先检查本机是否支持 manuscript-matching-ctc，以及中文对齐模型是否安装。
保留稿件已有换行，将结果另存到 output 文件夹。

查询项目与字幕 ​

text
使用 haoone-skill，列出 HaoOne 的项目，找到“课程项目”中的 SRT 文件，返回文件名和实际路径。

处理多个音视频 ​

text
使用 haoone-skill，将当前目录中我指定的三个视频逐个转成中文字幕，输出到各自独立的文件夹。
先检查 batch-transcribe 的激活要求和当前参数，关闭 AI 纠错，不覆盖已有结果。

当前 CLI 的 batch-transcribe 要求激活，且默认开启 AI 纠错。批量前应明确所用模型、语言、输出位置和 AI 开关；不要把 skill 免费理解为所有批量与增强功能免费。

在 WorkBuddy 中使用 ​

同样先在电脑上准备好 HaoOne、模型和命令行工具。然后在 WorkBuddy 的技能板块点击「添加技能 → 上传技能」，导入从 haoone-skill 仓库准备的技能包，包内需要包含 SKILL.md 及其引用的配套文件。导入后确认技能已经启用。WorkBuddy 官方安装说明

在可以访问本机文件并执行命令的桌面任务中，选择媒体所在工作目录，先发送本文的“环境检查”提示词，再发送转录任务。提示词中的 使用 haoone-skill、输入文件、语言和输出要求可沿用 Codex 示例；技能选择方式按 WorkBuddy 界面操作。

如果 WorkBuddy 能看到技能但提示找不到 haoone-cli，先回 HaoOne 检查 CLI 注册，再重新打开 WorkBuddy。只有技能说明、没有本机命令执行环境时，无法完成本地转录。

常见问题 ​

遇到的情况处理方式
Codex 找不到 haoone-skill确认安装时选择了 Codex，以及安装范围是否覆盖当前任务；重新打开任务或重启 Codex，再明确说“使用 haoone-skill”。
找不到 haoone-cli回 HaoOne 检查命令行注册状态，重新打开终端和智能体应用，再运行 haoone-cli --help。
模型不存在或语言不支持运行 installed-models 核对安装，按本地转录选择模型与语言。
提示未激活或在线服务不可用检查是否用了增强模型、批量转录、文稿匹配或 AI 功能；按任务要求处理激活、登录与服务配置。
AI 使用了无效参数让它先执行对应命令的 --help，按当前 CLI 帮助重新组织命令。旧 skill 中的示例可能与新版参数不同。
找不到输出文件要求 AI 返回终端报告的实际路径，并检查文件存在与字幕内容；下一次明确指定输出目录。

安装、加载、转录是三个独立步骤。先确认 skill 能加载，再确认 CLI 与模型可用，最后用一份短素材完成首次转录，后续就可以用自然语言继续处理字幕工作。