Skip to content

README.zh-CN.md

Latest commit

 

History

History
224 lines (159 loc) · 6 KB

README.zh-CN.md

File metadata and controls

224 lines (159 loc) · 6 KB
Raw

AI-PP3 - 基于AI增强的RawTherapee配置文件生成器

BeforeAfter

CC BY-NC-SA 4.0

en zh-CN npm

AI-PP3 是一款结合多模态AI分析与RawTherapee处理引擎的命令行工具，专注于为RAW摄影优化生成PP3配置文件。支持自动化工作流和创意探索。

使用示例

查看示例文档获取实际使用场景。

目录

主要特性

  • 🖼️ RAW文件AI智能分析（支持DNG/NEF/CR2/ARW等格式）
  • ⚡ 批量生成PP3配置文件
  • 📝 自定义自然语言提示词控制处理参数
  • 🔀 多模型支持（OpenAI/Anthropic/Google/本地模型）
  • 🎚️ 精细控制PP3模块（曝光/色彩/细节等）
  • 🔍 带质量控制的交互式预览生成

兼容性

支持格式

  • RAW格式：支持所有RawTherapee兼容格式，包括：
    • 常见格式：CR2/CR3、NEF、ARW、RAF、DNG
    • 其他格式：IIQ、PEF、RW2、ORF
  • 输出格式：
    • JPEG（8位）
    • TIFF（8/16位，支持ZLIB/NONE压缩）
    • PNG（8/16位）

系统要求

  • Node.js ≥18版
  • RawTherapee ≥5.8版（需启用CLI）
  • 云服务API密钥或本地GPU（用于自托管模型）

安装指南

# 全局安装
npm install -g ai-pp3

# 验证安装版本
ai-pp3 --version

AI配置

服务提供商设置

# 环境变量配置（在.env文件中）
OPENAI_API_KEY=your_key               # 默认服务提供商
ANTHROPIC_API_KEY=your_key            # Claude模型
GOOGLE_GENERATIVE_AI_API_KEY=your_key # Gemini模型

模型选择

# 使用云端模型
ai-pp3 input.dng --provider anthropic --model claude-3-opus-20240229

# 使用本地模型
ai-pp3 input.dng --provider openai-compatible --model llama3:8b-instruct-q5_K_M

基础用法

# 默认参数处理
ai-pp3 input.dng -o output.jpg

# 仅生成PP3配置文件（自定义提示词）
ai-pp3 input.dng --pp3-only -p "You are a RawTherapee processing profile (pp3) optimization ARTIST. Your mission is to creatively transform the attached pp3 file with artistic vision. A JPEG preview is provided - use it as a starting point for your artistic interpretation.

ARTISTIC MANDATE:
- Prioritize artistic expression and unique visual style
- Create a distinctive mood or atmosphere in the image
- Experiment with color relationships and tonal contrasts

Key Rules:
1. Only modify existing parameter values
2. Keep original section order and parameter order
3. Make bold, creative enhancements
4. Only include parameters you want to change

Common Parameter Value Ranges:
%%PARAMETER_RANGES%%

Output Format:

ANALYSIS:
- Artistic opportunities and potential visual directions

PLAN:
- Creative vision and mood you're aiming to create
EXECUTION:

\`\`\`
[Exposure]
Clip=0.15
Compensation=-0.7
\`\`\`

Example with another section:
\`\`\`
[ColorToning]
Redlow=20
\`\`\`

[Additional changes following these rules]
- Only include parameters you want to change
- Never change section headers
- Include only the sections that need changes

Current pp3 to transform:
"

# 多模块处理
ai-pp3 input.dng --sections Exposure,ColorToning

# 基于现有配置优化
ai-pp3 input.dng --base existing.pp3 --preview-quality 85

高级功能

批量处理

# 并行处理（需GNU Parallel）
ls *.DNG | parallel -j8 ai-pp3 {} -o {.}.jpg

# TIFF压缩输出
find . -name '*.NEF' -exec ai-pp3 {} --tiff --compression z \;

自定义工作流

# 多模型对比
ai-pp3 input.dng \
  --provider openai --model gpt-4-vision-preview \
  --base neutral.pp3 --keep-preview

CLI 选项

核心参数

  • -o, --output <路径>: 输出文件路径（默认：input.pp3 或 input_processed.[格式]）
  • --pp3-only: 仅生成PP3文件不输出图像
  • -p, --prompt <文本>: 用于AI分析的自然语言提示词
  • --preset <名称>: 预设风格（aggressive激进, creative创意, balanced平衡, technical技术）

AI配置

  • --provider <名称>: AI服务提供商（openai, anthropic, google, openrouter, openai-compatible）
  • --model <名称>: 模型名称（默认：gpt-4-vision-preview）

输出格式

  • --tiff: 导出为TIFF格式
  • --png: 导出为PNG格式
  • --compression <类型>: TIFF压缩方式（z 或 none）
  • --bit-depth <位数>: 位深度（8 或 16）
  • --quality <数值>: JPEG质量（1-100）

高级控制

  • --base <路径>: 用于增量优化的基础PP3文件
  • --sections <列表>: 要处理的PP3模块列表（例如：Exposure,ColorToning）
  • --preview-quality <数值>: 预览图质量（1-100，仅JPEG，默认：85）
  • --preview-format <格式>: 预览图格式（jpeg 或 png，默认：jpeg）
  • --max-retries <数值>: AI API调用的最大重试次数（默认：2）
  • -v, --verbose: 显示详细处理日志
  • -k, --keep-preview: 处理后保留预览文件

使用示例

# 带质量控制的TIFF转换
ai-pp3 input.dng --tiff --compression z --bit-depth 16

# 多模型对比
ai-pp3 input.dng --provider anthropic --model claude-3-opus-20240229

# 限定模块处理
ai-pp3 input.dng --sections Exposure,Detail --pp3-only

# 使用PNG预览进行AI分析（对某些模型效果更好）
ai-pp3 input.dng --preview-format png --keep-preview

发展路线

  • 支持ART(.arp)配置文件

常见问题

点击FAQ文档查看常见问题解答。

许可证

GPL-2.0