用途：通过 ${CLAUDE_PLUGIN_ROOT}/scripts/nl.py 脚本调用 Narrative Lion 的 API，管理笔记与视频项目。认证需设置 export NLK_API_KEY=nlk_xxxxxxxx，密钥可在 https://narrativelion.com/settings/api-keys 创建（资料称需 Pro 计划）。
主要能力：nl.py search 为语义搜索，nl.py fts 为全文关键词搜索；nl.py collections 列出两级文件夹树，nl.py notes list / notes get / transcript 浏览与查看笔记，nl.py submit 将 YouTube/TikTok 链接生成视频笔记（消耗积分、幂等、每分钟 10 次），nl.py export 导出 Markdown zip，nl.py usage 查看积分用量。Film Director 可由概念生成分镜（1-2 积分）；Filmwork 相关命令管理镜头、上传资产与 roll、打分、判定、记录决策与洞见、查看提示词版本与血缘。
使用方式：命令格式为 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/nl.py <command> [args...] [--json]。上传等命令需使用镜头 UUID（来自 nl.py shot <noteId> <label>），而非标签。批量提交可先不带 --wait 提交，再用 nl.py jobs / nl.py job 轮询。Reel Coach 与 Podcast 使用 curl 或 GraphQL 调用，资料给出相应请求结构。
限制：部分操作消耗积分（director、reel coach、TTS 等），上传/评审类多为 0 积分；标签需符合 01A 格式；shot-create 在有镜头后必须提供 --after；overview --json 的 shotId 字段是标签而非 UUID；[HOLD] 项应跳过；Podcast 内容为 IR JSON，不含音频字段。具体价格、模型与完整流程以官方文档为准。