Q: 如何使用 claude-video 修复自动生成的视频转录文本中听错的词语？

目前没有一键写入修正后 VTT/SRT 文件的选项，但可以通过两步工作流程实现： 1. 运行 `/watch --detail transcript`，并让 Claude 提供带时间戳的原始转录文本以及可疑片段，例如专有名词、同音词和上下文突变处。对于已有字幕的 URL，该工具会使用 `yt-dlp` 抓取的 VTT，并跳过下载视频。 2. 下载视频，仅重新检查存疑的时间戳： ```text /watch --detail transcript --timestamps 1:23,4:56,7:08 --no-whisper ``` Claude 仅在这些时间戳处提取帧，将其与转录文本进行比对，并可给出结合上下文的修正建议。请手动将这些修正应用到 VTT/SRT 文件中。

Question 1

在 Windows 上运行 Python CLI 时，如何修复 "UnicodeEncodeError: 'charmap' codec can't encode character '→'" 错误？

Accepted Answer

出现这种情况是因为 Windows 控制台通常使用 cp1252 而不是 UTF-8，而报告中会打印诸如 `→`、`…` 或 `—` 之类的字符。

临时用户解决方案：

```cmd
setx PYTHONUTF8 1
```

运行后关闭并重新打开终端。如果仅对当前 PowerShell 会话生效，请使用：

```powershell
$env:PYTHONUTF8 = "1"
```

永久性应用修复：在程序启动时、任何报告输出之前，将 stdout 和 stderr 重新配置为 UTF-8：

```python
import sys

for stream in (sys.stdout, sys.stderr):
    try:
        stream.reconfigure(encoding="utf-8")
    except (AttributeError, ValueError):
        pass
```

在每个入口点调用此辅助函数，例如 `watch.py`、`frames.py`、`whisper.py`、`transcribe.py`、`setup.py` 和 `download.py`。`TextIOWrapper.reconfigure()` 在 Python 3.7+ 中可用；受影响的项目要求 Python 3.10+。不要仅仅删除非 ASCII 字符，因为其他报告输出也可能触发同样的 cp1252 错误。

Question 2

在 Claude Code 中安装 watch@claude-video 后，如何修复 "Unknown command: /watch" 错误？

Accepted Answer

斜杠命令失败，因为 Claude Code 2.1.126 无法解析 `allowed-tools` 的 YAML 内联列表格式。编辑 `~/.claude/plugins/cache/claude-video/watch/0.1.2/commands/watch.md`，将：

```yaml
allowed-tools: [Bash, Read, AskUserQuestion]
```

替换为：

```yaml
allowed-tools: Bash, Read, AskUserQuestion
```

你可以直接使用以下命令应用此修改：

```bash
sed -i '' 's/^allowed-tools: $$Bash, Read, AskUserQuestion$$$/allowed-tools: Bash, Read, AskUserQuestion/' ~/.claude/plugins/cache/claude-video/watch/0.1.2/commands/watch.md
```

完全退出并重新打开 Claude Code，然后运行 `/watch` 或从自动补全中选择 `/watch:watch`。永久修复方案是由插件维护者在 `main` 分支的 `commands/watch.md` 中进行这一行修改；添加 frontmatter 校验可以防止回归。

Question 3

为什么在 Windows 上 /watch 报告中缺少视频标题和上传者信息？

Accepted Answer

升级到 `watch` v0.1.3 或更高版本。该 bug 产生的原因是 `scripts/download.py` 在调用 `Path.read_text()` 时未指定 `encoding="utf-8"`；在 Windows 上 Python 会使用 cp1252，因此 yt-dlp 的 `video.info.json` 中的非 ASCII 字符会导致 `UnicodeDecodeError`。随后，宽泛的 `except` 会静默地只保留 URL，导致 title 和 uploader 被省略。要为旧版本打补丁，请将：

```python
raw = json.loads(info_path.read_text())
```

改为：

```python
raw = json.loads(info_path.read_text(encoding="utf-8"))
```

此外，还应记录解析失败的情况，而不是静默忽略，例如：

```python
except Exception as exc:
    print(f"[watch] info.json parse failed: {exc}", file=sys.stderr)
    info = {"url": url}
```

作为临时解决方案，可以从输出目录中以 UTF-8 显式重新读取 `video.info.json`。如果 Windows 控制台在输出表情符号或其他非 ASCII 标题字符时失败，请在运行命令前设置 `PYTHONUTF8=1` 或 `PYTHONIOENCODING=utf-8`。

Question 4

如何在通过 Python subprocess 传递用户提供的 URL 时防止 yt-dlp 选项注入？

Accepted Answer

在 `yt-dlp` 的 argv 数组中，紧跟在 URL 之前插入 `"--"`，使其解析器停止处理选项。同时校验 URL，拒绝以 `-` 开头的输入。

```python
cmd = [
    "yt-dlp",
    "-N", "8",
    "-o", output_template,
    "--",
    url,
]
subprocess.run(cmd, check=True)
```

强化 URL 校验，作为纵深防御：

```python
from urllib.parse import urlparse

def is_url(source: str) -> bool:
    if source.startswith("-"):
        return False
    parsed = urlparse(source)
    return parsed.scheme in ("http", "https") and bool(parsed.netloc)
```

对于 `ffmpeg`/`ffprobe`，不要依赖 `--`，因为这些工具不会将其视为选项结束标记；应使用 `Path.resolve()` 将用户控制的路径解析为绝对路径。该问题已在 `claude-video` v0.1.3/commit `c333c22` 中修复。

Question 5

如何使用 claude-video 修复自动生成的视频转录文本中听错的词语？

Accepted Answer

目前没有一键写入修正后 VTT/SRT 文件的选项，但可以通过两步工作流程实现：

1. 运行 /watch <url> --detail transcript，并让 Claude 提供带时间戳的原始转录文本以及可疑片段，例如专有名词、同音词和上下文突变处。对于已有字幕的 URL，该工具会使用 yt-dlp 抓取的 VTT，并跳过下载视频。
2. 下载视频，仅重新检查存疑的时间戳：

/watch <local-video> --detail transcript --timestamps 1:23,4:56,7:08 --no-whisper

Claude 仅在这些时间戳处提取帧，将其与转录文本进行比对，并可给出结合上下文的修正建议。请手动将这些修正应用到 VTT/SRT 文件中。

claude-video

项目简介

README 预览

常见问题 (5)

同类型项目

hermes-agent

firecrawl

go

markitdown