Film Matcher

把一篇中文文章，变成一套可看、可选、可追溯的电影画面候选库。

真实联网检索 · 20–40 张候选 · 16:9 横向预览 · 逐张来源核验 · Codex Skill

预览2

这个仓库是什么

Film Matcher 是一个面向中文长文的 Codex Skill。它会先读完整篇文章，理解论点、情绪曲线和段落作用，再真实联网寻找可以承担这些内容的电影截图或电影剧照。

它不是一个只返回电影名称的片单生成器，也不是把几个熟悉片名机械贴到文章旁边。它的核心目标是：让你直接看到候选画面，并知道每张图为什么匹配、适合放在哪里、来自哪个真实网页。

一句话：让 AI 不只是“想到一部电影”，而是交付一套可以继续选图和寻源的电影画面图库。

适合谁用

特别适合：

写中文文章、公众号、Newsletter、博客或知识型长文，需要正文配图的人
已经有完整文章，但不想花几个小时逐段搜索电影截图的人
在意画面与观点、情绪和隐喻之间的关系，而不只是在意片名的人
希望每张候选图都带来源页、场景说明和使用理由的编辑与创作者
用 Codex 做内容生产，希望复用一套稳定选图流程的人

不适合：

只有一个标题或零散想法，还没有完整文章的人
只想要“推荐十部类似电影”的普通片单需求
想绕过登录、付费墙或网站访问限制获取图片的人
需要自动下载高清原图、自动获得转载授权或直接批量发布图片的人

它会产出什么

默认输出：

约 20–40 张经过实时检索与来源核验的电影画面候选
按文章段落、主题节点或情绪阶段组织的 4–8 个分组
统一填满的 16:9 横向预览，方便快速比较和挑选
每张图对应的电影中外文名、年份、场景说明和文章位置
“直接对应 / 氛围对应 / 隐喻对应”等轻量匹配标签
可点击的真实来源页；可靠取得时同时提供图片直链
原生展示受限时，可额外交付响应式 HTML 图库

默认不做：

不下载或缓存高清原图
不自动把图片插入文章
不把搜索结果页当作最终来源
不把海报、红毯、幕后照、粉丝画或 AI 图片冒充电影截图
不虚构电影、剧情位置、来源网页或图片地址

示例效果

从文章结构到分组图库

下面的实例来自文章《高学历人才对于体力活动的迷思》。Film Matcher 没有把文章简化成“办公室很坏、田园劳动很美”，而是按五段视觉线索展开：心智被征用、从疲劳到中断、具身创造、体力劳动的阴影，以及重新拥有与呼吸。

每张候选图都带完整判断依据

图库不是图片瀑布流。每张卡片都会把预览和元数据放在一起：电影、场景、对应段落、匹配理由、来源页和可用的图片链接。

可以直接查看仓库中的两个完整成品：

示例用于说明 Film Matcher 的选图方法与交付结构。电影画面版权归各自权利方所有；本项目不主张示例图片可自由转载。

安装

下载或克隆本仓库后，把真正的 Skill 子目录 film-matcher/ 复制到 Codex skills 目录。

macOS / Linux：

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ./film-matcher "${CODEX_HOME:-$HOME/.codex}/skills/"

Windows PowerShell：

$skillRoot = if ($env:CODEX_HOME) {
  Join-Path $env:CODEX_HOME "skills"
} else {
  Join-Path $env:USERPROFILE ".codex\skills"
}

New-Item -ItemType Directory -Force -Path $skillRoot | Out-Null
Copy-Item -Recurse -Force .\film-matcher $skillRoot

安装后，在 Codex 中直接调用：

Use $film-matcher 为下面这篇中文文章真实联网寻找 30 张候选电影截图，
按段落或主题展示分组图库，并逐张附片名、场景说明、匹配理由和真实来源链接。

<粘贴文章全文>

怎么用

默认生成一套完整图库

Use $film-matcher 为下面这篇文章寻找电影配图。
请真实联网检索并核验来源，按文章段落分组展示约 30 张候选图。

<粘贴文章全文>

控制候选数量

Use $film-matcher 为这篇文章寻找 20 张电影截图候选。
同一电影最多出现 2 张，不要用海报，优先横向电影画面。

<粘贴文章全文>

强调情绪和隐喻

Use $film-matcher 为这篇文章建立电影配图库。
除了字面场景，也要保留情绪对应和视觉隐喻；
整体从压抑、失序逐渐过渡到松弛和重新获得主动性。

<粘贴文章全文>

从本地文章文件开始

Use $film-matcher 读取 workspace 里的 article.md，
为全文生成 25 张可预览、可溯源的电影截图候选。

工作流程

Film Matcher 的默认流程是：

通读文章全文，提炼核心论点、情绪曲线、视觉意象和叙述节奏
选择约 4–8 个值得配图的段落或主题节点
为每个节点同时生成字面场景、情绪氛围、视觉隐喻和反向联想路线
使用中英文片名、角色、动作、构图及 film still、movie frame、screencap 等词真实联网检索
建立目标数量 2–3 倍的候选池，再逐张检查电影身份、来源页、预览可用性和画面质量
去除重复帧、弱相关画面、海报、竖图、失效链接和无法确认的结果
用 16:9 卡片分组展示候选，并把场景、文章映射、匹配理由和来源放在图片旁边
对无法确认的剧情位置、无法直显的预览或不足的候选数量做诚实标注

一张卡片里有什么

09 / 20 · 核心配图
《法式火锅》 The Taste of Things · 2023

场景  厨师在十九世纪厨房的大锅与炉火之间工作，动作、器具与材料处于同一画面。
对应  烹饪吸引力来自材料选择、味道判断和一道菜从无到有的过程。
匹配  几乎无言的协作把身体经验、专业判断和亲密关系连成一个连续过程。

来源  BFI Player
图片  已核验的远程预览地址

这些字段让候选图不只是“看起来差不多”，而是能够回到文章中被判断、比较和取舍。

选图原则

先读文章，再找电影。 不根据标题或开头草率判断全文。
先扩大候选，再做筛选。 默认先收集目标数量的 2–3 倍，避免被第一批搜索结果限制。
来源页必须真实可打开。 不使用搜索跳转链接或内部工具引用代替来源。
预览必须能直接看。 优先清晰横向画面，统一放入 16:9 框并保持比例。
同一电影默认不超过 2 张。 避免少数熟悉电影垄断整篇文章。
保留不同匹配方式。 直接场景、情绪氛围和视觉隐喻可以同时存在。
不确定就明确标注。 无法确认剧情位置时，只描述画面中可见的信息。

目录结构

.
├── README.md
├── assets/
│   └── readme/
│       ├── 预览2.png
│       └── 预览.png
├── film-matcher-20-stills.html
├── AI存在主义危机-电影配图库.html
└── film-matcher/
    ├── SKILL.md
    └── agents/
        └── openai.yaml

真正需要安装到 Codex 的是子目录：

film-matcher/

根目录的 README、示例截图和 HTML 图库用于 GitHub 展示与效果参考。

注意事项

Film Matcher 提供的是选图候选与寻源线索，不等于获得图片转载或商业使用授权。
远程图片地址可能因来源站点改版、防盗链或下线而失效；来源页应始终作为主要核验入口。
电影截图的精确剧情位置如果无法从来源和画面可靠确认，会标注“剧情位置待确认”。
默认不会绕过登录、付费墙、访问控制或网站限制。
默认不会下载高清原图、建立本地电影图库或自动把图片插入文章。