前言¶
教学录屏、课程切片这类视频，字幕往往不是「整段识别」就能搞定：画面切换点和文案分段要对齐，时间码需要人一边看片一边打点。常见做法是在剪辑软件里拖时间轴，或手写 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 与工具说明，不展开未在文档中出现的后端服务。
按键拍板与时间轴¶
- 播放视频，在画面切换点按 F：当前时间写入当前字幕的结束时间，下一段起点自动衔接。
- Ctrl+Z 撤销上一次标记。
- 方向键 ← / →：单击逐帧步进；长按约 8 倍速浏览（向前用
playbackRate，向后大步长 seek）。 - Canvas 时间轴展示彩色段落与播放位置；标记与「工作目录」通过 localStorage 持久化。
文案与导出¶
- 支持从记事本粘贴按 001 / 002 / 003 等编号的分段文案；Enter 可自动递增编号并重排。
- 点击字幕行可打开编辑模态框，改文案或结束时间。
- 导出 SMPTE 时间码表格：
MM:SS,FF（逗号为帧号），示例：
| 开始时间 | 结束时间 | 文案内容 |
|----------|----------|----------|
| 00:00,00 | 00:00,24 | 本视频将讲解如何制作进阶笔筒。 |
| 00:00,24 | 00:02,06 | 首先制作底座，选取圆柱体。 |
- 一键生成提示词（界面上的闪电按钮）：静默下载
.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 中的工作流一致，可在本地复现。
- 用记事本写好分段字幕，例如：
001. 本视频将讲解如何制作进阶笔筒。
002. 首先制作底座，选取圆柱体。
003. 通过拖拽设置底座中心点坐标（0，0，0）。
- 浏览器打开
subtitle-editor.html；在工具栏设置工作目录（项目绝对路径，会通过三层校验拒绝非法路径）。 - 将视频拖入页面，点击「粘贴字幕」并粘贴文案。
- 播放视频，在每个切换点按 F；需要微调时用方向键逐帧移动。
- 全部标记完成后点击「导出 .md」，或使用 一键生成提示词 得到文件与剪贴板内容。
- 若继续做自动配音，加载 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
