Skip to content

geminilight/framelark

v0.1.1

Photography guidance, theme-led selection and photo retouching in one plugin.

帧好 · FrameLark

帧好 · FrameLark:从看见,到成片。右侧是一只小帧

你的 AI 摄影伙伴,让小帧陪你找画面、修照片、做组图。

FrameLark 提供 Codex 插件、独立 Skill 和浏览器工作台,陪你从拍摄想法走到成片。

English · 开始使用 · 使用指南

创作能力

想做什么小帧怎么帮你
找画面 · 摄影眼从现场照发现值得拍的画面,给你机位、构图、时机和参数建议。
修照片 · 精修台打磨光色、裁剪和局部细节,自定义风格,比较试片后再接受。
做组图 · 组图册先确定主题,再精选照片、逐张精修、安排顺序,让整组互相呼应。

人物、大场景和细节都可以放进同一组,靠主题与节奏联系起来。摄影眼由 photography-eye Skill 提供;精修台和组图册由 photo-retouch Skill 提供。

小帧是一只有「摄影眼」的观察小鸟,也是帧好的摄影伙伴。认识小帧

开始使用

Codex 用户推荐安装统一插件,一次获得两套 Skill 和本地修图工具。

需要 Node.js 20.9+(含 npm)、Git,以及支持插件的 Codex CLI。先用 codex plugin --help 确认;找不到命令时,见安装准备。

在终端运行:

git clone https://github.com/GeminiLight/FrameLark.git
cd FrameLark
npm run plugin:install

安装成功后,开启新对话,确认 FrameLark 已启用。附上照片,或给出照片目录,按下面的使用示例开始。

插件使用当前 Agent 的看图与对话能力,无需另填模型 API Key。可选 AI 生图与图片编辑会先检查宿主是否支持,不可用时跳过。当前通过仓库插件市场安装,尚未上架 OpenAI 官方通用目录。

其他入口

以下命令在上面的仓库目录中运行,选择适合自己的入口即可。

入口怎么开始
独立 Skill运行 npm run install:skills,默认安装到 ~/.codex/skills/;单独安装、其他宿主与更新。
浏览器工作台运行 npm start,打开 localhost:3177,上传照片后手动精修、比较和导出。

网页手动修图无需模型密钥;AI 顾问需在设置中连接视觉模型。现场拍摄辅导目前通过摄影眼 Skill 使用。

使用示例

找画面 · 摄影眼

附上现场照,告诉小帧你的设备和拍摄想法:

用 FrameLark 看这个光影楼梯怎么拍,给我几种取景与后期方向。

摄影眼:光影楼梯的层叠空间、暖光与扶手折线等五种取景参考

围绕层叠空间、暖光切片和扶手折线,给出取景、参数与后期方向。上图为 AI 拍摄目标示意,需现场试拍。

修照片 · 精修台

附上原片,说清想保留与想改善的地方:

用 FrameLark 精修这张照片,保留晨光和远山层次,让人物稍微清楚一点,先给我试片。

精修台:原片与已保存修片版本的真实对照界面

先审片,再试裁剪、光色与局部调整;对照原片检查细节,满意后接受并导出。上图展示内置示例的原片与已保存修片版本。

做组图 · 组图册

给出照片目录,说明用途、数量与必留照片:

用 FrameLark 从这个目录整理朋友圈九宫格,先确定主题,再选片、逐张精修和排序,保留原片。

组图册:确定表达、调整照片顺序与逐张精调

得到围绕主题的选片、顺序与成片。上图用猫与咖啡两张样片展示「安静日常」的组图操作。

示例来源与操作说明

工作台预览

帧好工作台:照片预览与小帧顾问

当前本地工作台的真实截图,使用内置示例照片,未连接视觉模型。更多界面与截图说明

更多文档

想了解什么去哪里看
安装、更新与常见问题安装指南 · 插件分发
拍摄、精修、组图与交付使用指南
构图、光色与摄影师学习参考摄影知识
本地运行、模型配置与部署运行与部署
开发、测试与贡献项目结构 · 维护指南 · 验证范围

贡献者

感谢 Yijie Xu(@yeahjack) 贡献逐项调整采纳、参数与局部层锁定、画面区域保护,以及渲染和预览响应优化:#1、#2。