marp-lens
基于Gemini的Marp幻灯片语义搜索与内容管理CLI工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：marp-lens。 它的用途是：基于Gemini的Marp幻灯片语义搜索与内容管理CLI工具。 完整的 Skill 内容见：https://321skill.com/skills/marp-lens/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在我的幻灯片库里找所有讲解‘微服务架构优缺点’的内容。”，它会引导你使用 `marp-lens search "微服务架构优缺点"` 命令，从所有索引过的 Marp 幻灯片中，找出语义上与这个主题最相关的页面，并显示文件路径、幻灯片编号和内容片段，即使你的幻灯片里没有完全相同的字眼。或者，当你正在编辑一套新的技术分享幻灯片时，可以
对AI说：“监控我的 slides 文件夹，有任何改动就自动更新搜索索引。”，它会建议你运行 `marp-lens watch -d ./slides` 命令，实现修改后的实时索引。
介绍
Marp-lens 是一款专为 Marp（Markdown Presentation Ecosystem）幻灯片设计的智能搜索与内容管理工具。它解决了在大量幻灯片文件中难以快速定位特定内容（如概念、图表、演讲者备注）的痛点，通过语义理解而非简单关键词匹配，帮助用户高效检索知识。
使用方式非常便捷。用户首先通过 npx marp-lens index 命令为幻灯片目录建立索引，该过程会利用 Gemini 的嵌入模型将每页幻灯片的内容转化为向量并存储于本地 SQLite 数据库。之后，便可通过 npx marp-lens search "查询内容" 进行自然语言搜索，工具会返回语义最相关的幻灯片及其位置。它还支持增量索引、监控文件变化自动更新，并可选择为幻灯片中的图片生成文字描述。
这款工具非常适合经常使用 Marp 制作技术分享、产品演示、课程讲义的开发者、讲师和内容创作者。无论是准备演讲时回忆某个技术细节，还是在项目文档中查找曾经展示过的架构图，marp-lens 都能显著提升信息检索效率。
建议在使用前确保已获取 Gemini API 密钥。对于包含大量图片的幻灯片，启用 --with-images 选项可以提升搜索的全面性，但会增加 API 调用成本。定期使用 stats 命令查看索引状态，并利用 watch 模式在持续编辑幻灯片时保持索引的最新性。
核心特点
与通用文件搜索工具（如 grep）相比，其核心在于利用 Gemini 模型实现真正的语义搜索，能理解查询意图并找到概念相关但关键词不匹配的幻灯片。与其他向量数据库工具相比，它深度集成 Marp 格式，能智能解析幻灯片结构（分隔符）、演讲者备注，并可选地分析图片内容，是专为演示文稿场景优化的垂直解决方案。
注意事项
目前仅支持 Marp 格式的 Markdown 幻灯片文件，且依赖 Gemini API，需要网络连接并可能产生费用。
常见问题
marp-lens 支持哪些格式的幻灯片？
目前主要支持 Marp 格式的 Markdown 文件（.md）。
必须要有 Gemini API 密钥吗？
是的，核心的语义嵌入和图片理解功能需要有效的 Gemini API 密钥才能工作。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/marp-lens/raw/index.md 读取 marp-lens 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/marp-lens/raw/index.md（查看排版版本）