跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
演示文稿

trans

Transcribe a single Tongji Look lecture video to SRT + TXT, optionally download slide snapshots in parallel.

WALKERKILLER · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add WALKERKILLER/Look-Tongji-Notes --skill trans

技能说明


name: trans description: "Transcribe a single Tongji Look lecture video to SRT + TXT, optionally download slide snapshots in parallel." license: MIT metadata: author: WALKERKILLER version: "1.1"

Transcribe

Transcribe one lecture video from look.tongji.edu.cn and optionally download slide snapshots.

When to Use

  • User says /trans or "transcribe this lecture".
  • User provides a lecture URL or course_id + sub_id.

Workflow

  1. Resolve lecture with URL or IDs:
python "<SKILL_DIR>/../../scripts/look_tongji.py" transcribe --lecture-url "<LECTURE_URL>"
python "<SKILL_DIR>/../../scripts/look_tongji.py" transcribe --course-id "<ID>" --sub-id "<ID>"
  1. Transcribe + download slides in one run:
python "<SKILL_DIR>/../../scripts/look_tongji.py" transcribe --course-id "<ID>" --sub-id "<ID>" --slide
  1. The CLI prints real-time progress. Stdout contains result paths.

Non-Interactive / Batch Usage

When running from an automated pipeline, avoid input() prompts with these flags:

FlagDescription
--sub-idSpecify lecture sub_id directly (skips interactive lecture picker)
--course-idSpecify course ID directly (skips interactive course selection)
--slideDownload slides after transcription
--concurrency NSlide download concurrency (default 4)
--retries NSlide download retries (default 3)

manifest.json — Required for Wiki Build

transcribe does NOT automatically create manifest.json. After transcription, you MUST create it manually so the wiki indexer can find this lecture.

Create manifest.json in the session's 原始数据/ directory with this structure:

{
  "course_id": "COURSE_ID",
  "sub_id": "SUB_ID",
  "course_title": "课程名称(真实中文名)",
  "session_title": "YYYY-M-D 第X节",
  "base_name": "COURSE_ID_SUB_ID",
  "artifacts": {
    "srt": "F:\\workspace\\raw\\课程名称\\YYYY-M-D 第X节\\原始数据\\COURSE_ID_SUB_ID.srt",
    "txt": "F:\\workspace\\raw\\课程名称\\...\\COURSE_ID_SUB_ID.txt",
    "notes": "",
    "timeline": "",
    "slides": "F:\\workspace\\raw\\课程名称\\...\\slides\\index.json"
  },
  "duration_seconds": 5580
}

Critical path rules:

  • Use absolute paths for all artifact paths (relative paths break on Windows)
  • duration_seconds: must be ≥ 3600 (1 hour); if < 3600, the lecture is marked不合格 and wiki shows it as 缺失
  • If no slides were downloaded, leave slides field empty ("")
  • Fields notes and timeline are filled by /note command later

Artifacts

  • <course_id>_<sub_id>.srt — subtitle with timestamps
  • <course_id>_<sub_id>.txt — plain text transcript
  • <course_id>_<sub_id>.json — metadata
  • slides/ — slide images + index.json (if --slide)
  • manifest.json — MUST create manually after transcription

One Session Per Call

For batch transcribing, use /ralphtrans.

Where `<SKILL_DIR>` Points

`<SKILL_DIR>` is the directory containing this `SKILL.md`. Shared scripts (`look_tongji.py`, `timeline_tools.py`, `tongji_backend/`) and references live two levels up in the repository root (`<SKILL_DIR>/../../scripts/` and `<SKILL_DIR>/../../references/`).