前言¶

教学录屏、课程切片这类视频，字幕往往不是「整段识别」就能搞定：画面切换点和文案分段要对齐，时间码需要人一边看片一边打点。常见做法是在剪辑软件里拖时间轴，或手写 MM:SS 再反复校对，步骤多、也容易帧级对不齐。

下面介绍 SkillHub 上的 subtitle-editor（包名 subtitle-editor-pro）。它把流程收进一个纯前端 HTML 工具：写好分段文案、浏览器里拖入视频、播放时按 F 键拍板，最后导出 Markdown 字幕模板，并可与同一作者的 video-tutorial-v2 配音流水线对接。

这是什么¶

subtitle-editor 是一套 Agent Skill，核心是目录下的 tools/subtitle-editor.html：双击用浏览器打开，无需单独安装运行时。Skill 自述版本为 V3.5.6（2026-05-14 变更记录见包内 SKILL.md）。

任务线索中的官方 API 地址为：

https://api.skillhub.cn/user_a5827f21/subtitle-editor-pro

在 SkillHub 社区侧，该 Skill 归类为 design-media；公开页显示评分约 99330、下载约 573 次（以你抓取线索为准）。2026-10-21 核对时，https://www.skillhub.cn/skills/user_a5827f21/subtitle-editor-pro 返回「Skill 未找到」；本机 skillhub CLI 可将同名包解析为 @indiv-zhangwei/subtitle-editor-pro v1.0.2 并完成安装。若你仍使用 @user_a5827f21/subtitle-editor-pro 提示词，请以 SkillHub 页面或 CLI 实际解析的 namespace 为准。

核心功能¶

下列能力均来自已安装包内的 SKILL.md 与工具说明，不展开未在文档中出现的后端服务。

按键拍板与时间轴¶

1. 播放视频，在画面切换点按 F：当前时间写入当前字幕的结束时间，下一段起点自动衔接。
2. Ctrl+Z 撤销上一次标记。
3. 方向键 ← / →：单击逐帧步进；长按约 8 倍速浏览（向前用 playbackRate，向后大步长 seek）。
4. Canvas 时间轴展示彩色段落与播放位置；标记与「工作目录」通过 localStorage 持久化。

文案与导出¶

1. 支持从记事本粘贴按 001 / 002 / 003 等编号的分段文案；Enter 可自动递增编号并重排。
2. 点击字幕行可打开编辑模态框，改文案或结束时间。
3. 导出 SMPTE 时间码表格：MM:SS,FF（逗号为帧号），示例：

| 开始时间 | 结束时间 | 文案内容 |
|----------|----------|----------|
| 00:00,00 | 00:00,24 | 本视频将讲解如何制作进阶笔筒。 |
| 00:00,24 | 00:02,06 | 首先制作底座，选取圆柱体。 |

4. 一键生成提示词（界面上的闪电按钮）：静默下载 .md、拼装提示词并复制到剪贴板；若配置了工作目录，会校验绝对路径并补齐完整文件路径。

与周边 Skill 的关系¶

• 可与 video-tutorial-v2 配合：导出模板后把路径交给配音流水线生成带字幕与配音的视频。
• 也可单独使用：导出 .md 后在剪映、Premiere 等工具中继续手工配音。

安装与启用¶

Skill 遵循通用 SKILL.md 布局：安装后 Agent 读取 SKILL.md，在用户提到「字幕模板」「时间码」「拍板」等场景时引导打开 tools/subtitle-editor.html。

安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可执行（摘自 SkillHub 安装说明）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装 subtitle-editor-pro¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。Cursor 示例如下：

skillhub install subtitle-editor-pro --namespace indiv-zhangwei --dir ~/.cursor/skills/

也可让 AI 按官方安装文档操作（页面常见提示词格式）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_a5827f21/subtitle-editor-pro`。

若 CLI 报「community skill not found」，改用上文 indiv-zhangwei namespace 或先在 SkillHub 搜索 subtitle-editor 核对当前条目。

其他客户端 skills 目录（同一份安装文档）：Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/。安装后按各客户端要求重启或刷新 Skill 列表。

打开编辑器¶

无需再装 Node 或 Python。在已安装的技能目录中打开：

<技能目录>/tools/subtitle-editor.html

双击即可；支持拖入 mp4 / mov / avi / webm / mkv 等常见容器。

典型用法¶

下面步骤与 SKILL.md 中的工作流一致，可在本地复现。

1. 用记事本写好分段字幕，例如：

001. 本视频将讲解如何制作进阶笔筒。
002. 首先制作底座，选取圆柱体。
003. 通过拖拽设置底座中心点坐标（0，0，0）。

2. 浏览器打开 subtitle-editor.html；在工具栏设置工作目录（项目绝对路径，会通过三层校验拒绝非法路径）。
3. 将视频拖入页面，点击「粘贴字幕」并粘贴文案。
4. 播放视频，在每个切换点按 F；需要微调时用方向键逐帧移动。
5. 全部标记完成后点击「导出 .md」，或使用 一键生成提示词 得到文件与剪贴板内容。
6. 若继续做自动配音，加载 video-tutorial-v2，把导出的 .md 路径交给 Agent 并按该 Skill 选择 TTS 引擎与音色。

加载本 Skill 后，文档要求 Agent 主动向用户说明上述路径与快捷键，避免用户只在对话里「口述时间」而找不到工具入口。

适用场景与注意¶

适合谁

• 需要「边看画面边打时间点」的教学视频、课程录屏字幕模板制作。
• 已使用或计划使用 video-tutorial-v2 的团队，希望时间码格式与流水线一致（MM:SS,FF 表格）。

限制与注意

• 工具为纯前端：大文件、编解码能力取决于浏览器；长时间标记依赖本机性能与 localStorage 容量。
• 外部图床截图链接写在 SKILL.md 中，若无法访问不影响本地 HTML 使用。
• Namespace 与 SkillHub 页面状态可能变化：安装前用 skillhub search subtitle-editor 确认；user_a5827f21 路径若下线，以 CLI 可安装的 @indiv-zhangwei/subtitle-editor-pro 为准。
• 任务线索中的 api.skillhub.cn/.../subtitle-editor-pro 在部分环境下返回 405 或空响应，属接口访问方式限制，不影响 skillhub install 拉取包体。

结尾¶

subtitle-editor 把「写文案 → 对画面打点 → 导出可机读模板」收成浏览器内一条线，适合不想在剪辑软件里反复拖时间轴、又需要和后续配音 Skill 对齐格式的场景。包内当前自述为 V3.5.6，核心文件是 tools/subtitle-editor.html。

官方 API 线索地址：https://api.skillhub.cn/user_a5827f21/subtitle-editor-pro
SkillHub 安装文档：https://skillhub.cn/install/skillhub.md
社区条目（访问时可能提示下线）：https://www.skillhub.cn/skills/user_a5827f21/subtitle-editor-pro