Trans

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:

bashCopy code
python "<SKILL_DIR>/../../scripts/look_tongji.py" transcribe --lecture-url "<LECTURE_URL>"

bashCopy code
python "<SKILL_DIR>/../../scripts/look_tongji.py" transcribe --course-id "<ID>" --sub-id "<ID>"

2. Transcribe + download slides in one run:

bashCopy code
python "<SKILL_DIR>/../../scripts/look_tongji.py" transcribe --course-id "<ID>" --sub-id "<ID>" --slide

3. 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:

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:

jsonCopy code
{
  "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/`).