VisualForge 风格铸造

中文 · English

看到喜欢的图片，把它变成你的作品。

立即下载 · 三步安装 · 完整安装指南

_{参考画面负责怎么拍，你的素材负责拍谁／拍什么。}

VisualForge 是一个接入本机 Codex 的 Chrome 侧边栏插件。在网页上看到喜欢的照片、写真或商品广告时，直接捕获它；VisualForge 会理解构图、动作、光影、色彩、材质和氛围，再结合你的人物或商品素材，生成属于你的单张作品、成套写真或宫格图。

VisualForge 是什么

它由两部分组成：

• Chrome 侧边栏插件：捕获参考图、查看画面理解、添加人物或商品、管理结果。
• 本地连接组件：连接你已经登录的 Codex，调用视觉理解和图像生成能力；不需要另填 API Key。

VisualForge 不是滤镜，也不是让你从空白提示词开始。它的起点始终是一张你真正喜欢的视觉：先理解为什么好看，再把画面里的主体换成你的。

适合谁

• 内容创作者：把收藏的视觉方向快速变成自己的封面、配图和系列内容。
• 摄影师与模特：从一张灵感图建立可执行的写真方向、镜头组合和成套作品。
• 品牌、电商与独立卖家：用现有商品照片尝试广告构图、材质表现和不同视觉气质。
• 设计师与创意团队：把“我想要这种感觉”变成可查看、可修改、可复用的作品记录。
• 普通用户：不学习复杂提示词，也能从喜欢的图片开始创作。

有什么用

传统做法要先描述风格、反复试提示词、整理人物或商品素材，再逐张对齐构图和氛围。VisualForge 把这些步骤收成一条清楚的路径：

找到喜欢的视觉 → 让系统理解画面 → 换成你的人物或商品 → 生成并选择最终作品。

它的价值不是“一键随机出图”，而是减少沟通和试错，让参考图、主体素材、每次候选、质量建议和最终选择始终在同一个作品里。

核心能力

能力	VisualForge 做什么	你得到什么
网页与本地参考	网页图片直接捕获，也可上传或粘贴	灵感无需先下载、改名、再找回来
参考图理解	分析构图、景别、动作、表情、光线、色彩、材质和后期	看得懂的创作方法，不只是一段黑盒提示词
人物／商品替换	参考图负责视觉方法，你的素材负责身份、体型或商品结构	生成“你的版本”，避免参考人物污染主体
单张、套图与宫格	支持单张及 2／3／4／6／9／12 个画面，宫格在本地合成	一张主视觉、完整写真组或社交媒体宫格
逐张选择与修改	每张保留候选、质量建议、定向重做和 Final Selection	不因一张有问题就整组从头生成
本地作品管理	保存作品、素材关系和生成记录	随时继续、回看和导出，不依赖 VisualForge 云端账号

人物与商品风格全景

VisualForge 不把“风格”理解成套在图片上的滤镜。当前内置风格系统共 48 个原创风格、6 个类别，从景别、视角、空间、光线、色彩、材质、动作和后期质感共同建立可执行的视觉规则。下面完整列出其中专门为人物与商品建立的 16 个风格；另外 32 个风格覆盖电影叙事、当代东方、艺术编辑和生活方式等跨域方向，也会按参考图与创作目标参与推荐。

_{同一人物、同一服装体系，通过近景、动态、夜景、棚拍与建筑空间形成完整写真叙事。}

类型	风格	是什么	适合什么	关键控制
人物	呼吸近场 Breathing Close Field	用近距离、真实皮肤和错开视线，形成不表演的亲密肖像。	情绪近景、人物封面、身份卡精选	保持人物身份、真实皮肤和呼吸中间帧；避免磨皮、僵硬直视和手挡五官。
人物	风迹侧写 Wind Trace Profile	让统一方向的风塑造轮廓、衣物和动作，人物仍清楚稳定。	户外人像、时装动态、故事套图	保持统一风向、清楚身份和可信重心；避免乱飞、糊脸和站桩吹发。
人物	夜行硬闪 Night Walk Hard Flash	用夜间行走中间帧、近轴硬闪与环境光，制造偶发的时尚能量。	时装、音乐人物、夜景故事	保持动作中间帧及硬闪与环境光并存；避免棚拍黑底、紫蓝霓虹和张张直视。
人物	低声棚景 Low Voice Studio	保留影棚设备和制作痕迹，以有任务的低声量动作完成环境肖像。	时装编辑、演员肖像、系列识别图	保持人物与影棚的真实关系；避免证件照式纯背景、器材堆满和无任务动作。
人物	斜轴显影 Oblique Disclosure	用一条可信的建筑斜轴同时推动机位、空间秩序和人物行动。	时装大片、人物封面、角色视觉	保持身份、完整肢体和真实建筑轴线；避免无理由歪画面、脸部变形和贴边裁切。
人物	重力成衣 Gravity Drapery	让织物重量、支点与身体反作用力塑造人物，而不是靠无重力飘带。	高级时装、人物全身、软质商品	保持身体结构和连续重量线；避免飞布、复制褶皱及手臂与布料融合。
人物	轮廓反证 Contour Counterproof	用清楚轮廓与清楚面部的不同镜头互相证明同一身份。	人物身份套图、时装型录、演员肖像	保持同一脸部结构、骨架比例和光向；避免剪影丢身份或不同镜头像不同人。
人物	姿态折线 Posture Vector	由肩、髋、膝和足形成连续受力线，让姿态成为时装画面的第一语言。	时装大片、人物全身照、动态型录	保持完整肢体、真实关节与重心；避免断肢、无重心姿势和衣身受力矛盾。
商品	黑镜悬台 Black Mirror Plinth	以黑镜承托、短距离悬浮、准确倒影和边缘光建立商品权威。	消费电子、腕表、香水主视觉	保持商品几何、可信悬浮和对应倒影；避免无影漂浮、轮廓过曝和组件重复。
商品	液晶解构 Liquid Crystal Explode	用透明液体与晶体层解释材质或成分，同时让商品结构完整可读。	护肤品、饮品、透明材质产品	保持完整结构和单轴透明层级；避免爆炸碎片、无重力水花和标签遮挡。
商品	软域日常 Soft Domain Daily	把产品放进有真实使用痕迹的柔软日常空间，用因果动作证明价值。	家居、耳机、美妆生活方式	保持环境尺度、商品结构和真实使用因果；避免只换背景、无痕样板间和无结果手势。
商品	工艺剖面 Craft Cross Section	用一个可信剖面或开合状态直观说明工艺与复杂结构。	机械产品、包装结构、功能详情	保持组件数量、位置和整体到局部顺序；避免幻觉零件、无因果拆解和技术文字堆叠。
商品	合缝月体 Joined Imperfection	用真实合缝、轻微偏轴和制造色差，把受控偏差变成器物价值。	陶瓷、香水与美妆容器、家居器物	保持整体轮廓、结构和真实合缝；避免刻意做旧、随机凹凸和商品歪斜。
商品	层启仪式 Layered Unveiling	让绳、纸、布、盒与内衬按真实动作逐层打开，组成不可交换的发现过程。	香水、珠宝、茶、护肤与礼盒	保持商品、包装结构和开启顺序；避免一次全开、包装漂浮和重复手指。
商品	应力显形 Stress Reveal	让商品在受控负载中显露材料响应和结构逻辑，以真实受力证明性能。	运动装备、家具、工具、耐用品广告	保持商品几何、接口与品牌标识；避免破裂、液化和没有接触点的假变形。
商品	接触计量 Contact Gauge	用一个准确的人体接触动作，同时说明商品尺度、人体工学和功能入口。	消费电子、美妆、工具、可穿戴设备	保持商品比例和唯一功能接口；避免多只无关手、错误接口及遮挡品牌结构。

风格只负责“画面应该如何成立”，不会覆盖你上传人物的身份、体型或商品结构，也不会替你决定最终作品。参考图的可观察事实仍是第一优先级；内置风格用于补全方法，而不是把所有作品改成同一种模板。

商品广告

把人物换成商品，同一条流程就能用于香水、美妆、食品包装、数码配件、服装、家居器物等广告视觉：

1. 选择一张喜欢的商品广告或商业摄影作为参考。
2. 添加自己的商品照片；多角度素材可以帮助理解轮廓、标签、材质和结构。
3. VisualForge 分开处理“参考广告怎么拍”和“你的商品是什么”，再生成单张主视觉或一套广告画面。
4. 逐张检查商品结构、文字、材质、倒影和比例，选定最终版本后导出。

适合前期视觉探索、提案、社交媒体素材和小批量内容制作。生成结果仍需你对品牌文字、商品结构和商业使用权做最终确认。

真实运行效果

下面不是裁切后的界面局部，而是 网页参考图＋完整 VisualForge 侧边栏 的真实连续工作区。

_{参考图与生成结果并排查看：本次引用、生成进度和当前单张结果都在同一页。}

_{逐张选择最终版本，再在下方生成横向或纵向宫格；不会把最后一张单图冒充宫格结果。}

使用流程

1. 找到参考：在网页图片上点击 VisualForge，或在侧边栏上传／粘贴图片。
2. 确认理解：查看画面事实、创作方法和可复用提示词，必要时直接修改。
3. 决定是否替换：选择“换成我的”添加人物或商品；不替换也可以继续。
4. 选择交付：明确生成单张、拍一套，或按 2／3／4／6／9／12 宫格生成。
5. 逐张确认：查看结果和质量建议；只有你明确点击时才会额外重做。
6. 选定与导出：为每张选择 Final Selection，套图可再合成横向／纵向宫格并导出。

三步开始

第一次安装请按下面顺序做。更完整的逐系统说明见《VisualForge 最小安装指南》。

第 1 步：安装并登录 Codex，然后下载 VisualForge

1. 先确认本机 Codex 已安装、已登录，并且能正常打开使用。VisualForge 使用这份登录状态，不需要 API Key。
2. 打开 VisualForge Releases，只下载与你系统对应的一个包：
   • macOS：VisualForge-0.5.8-macos-universal.dmg（Apple 芯片＋Intel）
   • Windows 10／11 x64：VisualForge-0.5.8-windows-x64.zip
   • Linux x64：VisualForge-0.5.8-linux-x64.tar.gz

第 2 步：安装本地连接组件，并加载 Chrome 扩展

1. 安装连接组件：macOS 双击 DMG 内的 Install.command；Windows 解压后右键 Install.ps1 并选择“使用 PowerShell 运行”；Linux 解压后运行 ./install.sh。
2. 在安装包中找到 VisualForge-extension.zip，把它解压到一个以后不会移动的固定文件夹。
3. 在 Chrome 地址栏输入 chrome://extensions，打开右上角“开发者模式”。
4. 点击“加载已解压的扩展程序”，选择刚才解压出的扩展文件夹。到这里即完成 加载 Chrome 扩展。

第 3 步：确认连接，开始第一张作品

1. 点击 Chrome 工具栏中的 VisualForge，打开侧边栏。
2. 打开设置，点击“重新检查连接”；顶部显示 “Codex 已连接” 即安装成功。
3. 回到“创作”，上传或粘贴一张参考图；也可以打开普通 HTTPS 网页，在喜欢的图片上使用 VisualForge。
4. 查看画面理解，按需添加自己的人物或商品，然后选择生成单张、套图或宫格——现在就可以 开始第一张作品。

如果连接失败，不要反复重装扩展：先确认 Codex 已登录，再重新运行当前系统安装包里的连接组件，最后回到设置点击“重新检查连接”。

设计理念

• 参考优先：先守住原图可观察的构图、光影、动作、材质和气质，再谈变化。
• 职责清楚：参考图决定怎么拍；人物／商品素材决定拍谁或拍什么。
• 用户做最终决定：质量检查只给建议，不静默删除候选，也不暗中自动重生。
• 把复杂留给系统：普通流程只有清楚的下一步，高级调整按需展开。
• 本地优先、可追溯：没有 VisualForge 云端账号；作品关系、候选和最终选择都能回看。

它如何工作

网页图片／上传参考图
          ↓
Chrome 侧边栏：捕获、理解、选择主体、管理作品
          ↓ Native Messaging
VisualForge 本地连接组件
          ↓ 本机 Codex App Server
视觉理解与 imagegen 图像生成

VisualForge 不复制 Codex 凭据，不要求 API Key，也不建立自己的图片生成服务器。只有你主动分析或生成时，所选图片和创作要求才会交给当前登录的 Codex／OpenAI 服务处理。

从源码构建

需要 Node.js 22+、pnpm 10+、Chrome 116+，以及已经安装并登录的 Codex。

git clone https://github.com/dososo/visualforge.git
cd visualforge
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build

构建后的扩展位于 apps/extension/.output/chrome-mv3/。开发环境安装连接组件可运行 pnpm setup:host。仓库采用 pnpm workspace：扩展位于 apps/extension/，Native Host 位于 apps/native-host/，共享契约和创作逻辑位于 packages/。

隐私与边界

• VisualForge 没有中心服务器、账号、广告和遥测。
• Chrome Web Store 尚未发布；0.5.8 通过 Releases 提供透明的旁加载安装包。
• 只有主动分析／生成时，选中图片和要求才会发送给当前登录的 Codex／OpenAI 服务。
• 请只使用你有权处理的参考图和主体素材；不要用来冒充他人或生成未经同意的敏感内容。
• macOS 0.5.8 Universal 包经 Developer ID 签名、Apple 公证并 Staple；Windows／Linux 的签名和真机验收边界写在 Release 中。

详见隐私说明、安全说明和贡献指南。

许可

Apache License 2.0 © 2026 爆裂队长 NEXT（BLCaptain）

联系作者

爆裂队长 NEXT(BLCaptain)

• GitHub: dososo
• X: @thinkszyg
• 邮箱: blteam2026@outlook.com

_{© 2026 爆裂队长 NEXT · VisualForge —— 把喜欢的视觉，变成你的作品。}