scope-validator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Scope Validator

范围验证器

Helps users and contributors understand whether a feature belongs in:

OSS Core → Submit a PR or feature request to genfeedai/core
Cloud SaaS → Subscribe at genfeed.ai/cloud

帮助用户和贡献者了解某个功能属于：

OSS核心版 → 提交PR或功能请求至genfeedai/core
云SaaS版 → 前往genfeed.ai/cloud订阅使用

When This Activates

触发场景

User asks "should this be in core or cloud?"
User wants to contribute a new node or feature
User requests social publishing features
User asks about RSS/Twitter/feed integration
Feature request triage
PR review for scope compliance

用户询问“这个功能应该放在核心版还是云版？”
用户想要贡献新节点或功能
用户请求社交发布功能
用户询问RSS/Twitter/订阅源集成相关问题
功能请求分类筛选
针对范围合规性的PR评审

OSS Core Scope

OSS核心版范围

Included Nodes (26 total)

包含的节点（共26个）

Input Nodes (5)

输入节点（5个）

Node	Type	Description
Image Input	`imageInput`	Upload or reference an image
Audio Input	`audioInput`	Upload an audio file (MP3, WAV)
Video Input	`videoInput`	Upload or reference a video file
Prompt	`prompt`	Text prompt for AI generation
Template	`template`	Preset prompt template

节点	类型	描述
Image Input	`imageInput`	上传或引用图片
Audio Input	`audioInput`	上传音频文件（MP3、WAV格式）
Video Input	`videoInput`	上传或引用视频文件
Prompt	`prompt`	AI生成用的文本提示词
Template	`template`	预设提示词模板

AI Nodes (7)

AI节点（7个）

Node	Type	Description
Image Generator	`imageGen`	Generate images with nano-banana models
Video Generator	`videoGen`	Generate videos with veo-3.1 models
LLM	`llm`	Generate text with meta-llama
Lip Sync	`lipSync`	Generate talking-head video from image/video and audio
Voice Change	`voiceChange`	Replace or mix audio track in a video
Text to Speech	`textToSpeech`	Convert text to natural-sounding speech
Transcribe	`transcribe`	Convert video or audio to text transcript

节点	类型	描述
Image Generator	`imageGen`	使用nano-banana模型生成图片
Video Generator	`videoGen`	使用veo-3.1模型生成视频
LLM	`llm`	使用meta-llama生成文本
Lip Sync	`lipSync`	基于图片/视频和音频生成对口型视频
Voice Change	`voiceChange`	替换或混合视频中的音轨
Text to Speech	`textToSpeech`	将文本转换为自然语音
Transcribe	`transcribe`	将视频或音频转换为文字转录稿

Processing Nodes (12)

处理节点（12个）

Node	Type	Description
Resize	`resize`	Resize media to different aspect ratios using Luma AI
Animation	`animation`	Apply easing curve to video
Video Stitch	`videoStitch`	Concatenate multiple videos
Video Trim	`videoTrim`	Trim video to a specific time range
Frame Extract	`videoFrameExtract`	Extract a specific frame from video as image
Luma Reframe Image	`lumaReframeImage`	AI-powered image outpainting
Luma Reframe Video	`lumaReframeVideo`	AI-powered video reframing
Topaz Image Upscale	`topazImageUpscale`	AI-powered image upscaling with face enhancement
Topaz Video Upscale	`topazVideoUpscale`	AI-powered video upscaling to 4K
Grid Split	`imageGridSplit`	Split image into grid cells
Annotation	`annotation`	Add shapes, arrows, and text to images
Subtitle	`subtitle`	Burn subtitles into video using FFmpeg

节点	类型	描述
Resize	`resize`	使用Luma AI调整媒体的宽高比
Animation	`animation`	为视频应用缓动曲线
Video Stitch	`videoStitch`	拼接多个视频
Video Trim	`videoTrim`	将视频裁剪到指定时间范围
Frame Extract	`videoFrameExtract`	从视频中提取指定帧作为图片
Luma Reframe Image	`lumaReframeImage`	AI驱动的图片扩绘
Luma Reframe Video	`lumaReframeVideo`	AI驱动的视频重构图
Topaz Image Upscale	`topazImageUpscale`	AI驱动的图片放大，含人脸增强功能
Topaz Video Upscale	`topazVideoUpscale`	AI驱动的视频放大至4K分辨率
Grid Split	`imageGridSplit`	将图片分割为网格单元格
Annotation	`annotation`	为图片添加形状、箭头和文字
Subtitle	`subtitle`	使用FFmpeg将字幕嵌入视频

Output Nodes (2)

输出节点（2个）

Node	Type	Description
Output	`output`	Final workflow output
Preview	`preview`	Preview media with playback controls

节点	类型	描述
Output	`output`	工作流最终输出
Preview	`preview`	带播放控件的媒体预览

Cloud-Only Nodes (EXCLUDED from OSS)

仅云版可用的节点（不在OSS范围内）

Node	Type	Reason
Social Publish	`socialPublish`	Requires OAuth integrations for 7 platforms
RSS Input	`rssInput`	Content aggregation is Cloud feature
Tweet Input	`tweetInput`	Twitter API dependency, feed feature
Tweet Remix	`tweetRemix`	Depends on tweet input, social-focused

节点	类型	原因
Social Publish	`socialPublish`	需要对接7个平台的OAuth集成
RSS Input	`rssInput`	内容聚合是云版专属功能
Tweet Input	`tweetInput`	依赖Twitter API，属于订阅源功能
Tweet Remix	`tweetRemix`	依赖推文输入，聚焦社交场景

Cloud-Only Providers (EXCLUDED from OSS)

仅云版可用的服务商（不在OSS范围内）

Provider	Reason
FAL.ai	Cloud-only provider
HuggingFace	Cloud-only provider

OSS Provider: Replicate only

服务商	原因
FAL.ai	仅云版可用的服务商
HuggingFace	仅云版可用的服务商

OSS支持的服务商：仅Replicate

Validation Rules

验证规则

Rule 1: Node Type Check

规则1：节点类型检查

IF node.type IN [socialPublish, rssInput, tweetInput, tweetRemix]
THEN FAIL: "Node type '{node.type}' is Cloud-only. Use OSS alternatives or upgrade to Cloud."

IF node.type IN [socialPublish, rssInput, tweetInput, tweetRemix]
THEN FAIL: "Node type '{node.type}' is Cloud-only. Use OSS alternatives or upgrade to Cloud."

Rule 2: Provider Check

规则2：服务商检查

IF node.provider IN [fal, huggingface]
THEN FAIL: "Provider '{node.provider}' is Cloud-only. OSS only supports Replicate."

IF node.provider IN [fal, huggingface]
THEN FAIL: "Provider '{node.provider}' is Cloud-only. OSS only supports Replicate."

Rule 3: Template Check

规则3：模板检查

IF template contains Cloud-only nodes
THEN FAIL: "Template uses Cloud-only nodes. Remove: {cloud_nodes}"

IF template contains Cloud-only nodes
THEN FAIL: "Template uses Cloud-only nodes. Remove: {cloud_nodes}"

Rule 4: Feature Request Check

规则4：功能请求检查

IF request mentions [publish, social, twitter, rss, feed, youtube upload]
THEN WARN: "Social publishing and feed features are Cloud-only."

IF request mentions [publish, social, twitter, rss, feed, youtube upload]
THEN WARN: "Social publishing and feed features are Cloud-only."

Validation Examples

验证示例

Valid OSS Workflow

合规的OSS工作流

json

{
  "nodes": [
    { "type": "prompt" },
    { "type": "imageGen" },
    { "type": "videoGen" },
    { "type": "subtitle" },
    { "type": "output" }
  ]
}

✅ All nodes are within OSS scope.

json

{
  "nodes": [
    { "type": "prompt" },
    { "type": "imageGen" },
    { "type": "videoGen" },
    { "type": "subtitle" },
    { "type": "output" }
  ]
}

✅ 所有节点均在OSS范围内。

Invalid OSS Workflow

不合规的OSS工作流

json

{
  "nodes": [
    { "type": "rssInput" },
    { "type": "tweetRemix" },
    { "type": "socialPublish" }
  ]
}

❌ Contains Cloud-only nodes:

rssInput

tweetRemix

socialPublish

json

{
  "nodes": [
    { "type": "rssInput" },
    { "type": "tweetRemix" },
    { "type": "socialPublish" }
  ]
}

❌ 包含仅云版可用的节点：

rssInput

tweetRemix

socialPublish

Response Templates

回复模板

When Cloud Feature Requested

当用户请求云版功能时

The feature you're requesting ({feature}) is available in Genfeed Cloud.

OSS Core includes:
- 26 nodes for media generation and processing
- Replicate provider for AI models
- Visual workflow editor with queue-based execution
- Gallery asset management

For social publishing and content aggregation features,
consider upgrading to Genfeed Cloud: https://genfeed.ai/cloud

The feature you're requesting ({feature}) is available in Genfeed Cloud.

OSS Core includes:
- 26 nodes for media generation and processing
- Replicate provider for AI models
- Visual workflow editor with queue-based execution
- Gallery asset management

For social publishing and content aggregation features,
consider upgrading to Genfeed Cloud: https://genfeed.ai/cloud

When Suggesting Alternatives

当提供替代方案时

Instead of {cloud_feature}, consider these OSS alternatives:

1. {alternative_1}
2. {alternative_2}

These achieve similar results within the OSS scope.

Instead of {cloud_feature}, consider these OSS alternatives:

1. {alternative_1}
2. {alternative_2}

These achieve similar results within the OSS scope.

Common Requests & Responses

常见请求与回复

"Can I publish to YouTube?"

"我可以发布到YouTube吗？"

Response: Social publishing is Cloud-only. In OSS, use the

output

node to export your video, then manually upload to YouTube.

回复： 社交发布是云版专属功能。在OSS中，您可以使用

output

节点导出视频，然后手动上传至YouTube。

"Can I fetch RSS feeds?"

"我可以获取RSS订阅源吗？"

Response: RSS/feed aggregation is Cloud-only. In OSS, use the

prompt

node with manually entered content, or the

template

node with predefined prompts.

回复： RSS/订阅源聚合是云版专属功能。在OSS中，您可以使用

prompt

节点手动输入内容，或使用

template

节点调用预设提示词模板。

"Can I use FAL.ai models?"

"我可以使用FAL.ai模型吗？"

Response: FAL.ai is Cloud-only. OSS uses Replicate provider. Check if the model you need is available on Replicate.

回复： FAL.ai是云版专属服务商。OSS仅支持Replicate服务商。请确认您需要的模型是否在Replicate上可用。

"Can I remix tweets?"

"我可以 remix 推文吗？"

Response: Tweet remix is Cloud-only. In OSS, use the

llm

node with a custom prompt to rewrite text in different tones.

回复： 推文remix是云版专属功能。在OSS中，您可以使用

llm

节点搭配自定义提示词，以不同语气重写文本。

Integration

验证流程

When validating:

Parse the request - Identify node types, providers, and features mentioned
Check against scope - Compare with OSS node list
Report violations - List all Cloud-only features found
Suggest alternatives - Provide OSS workarounds when possible
Link to Cloud - Mention upgrade path for full feature access

执行验证时：

解析请求 - 识别节点类型、服务商以及请求中提及的功能
对照范围检查 - 与OSS节点列表进行比对
报告违规项 - 列出所有发现的仅云版可用功能
提供替代方案 - 如有可能，给出OSS范围内的解决办法
引导至云版 - 提及升级路径以获取完整功能权限

Quick Reference

快速参考

OSS Node Types (26):
  Input:      imageInput, audioInput, videoInput, prompt, template
  AI:         imageGen, videoGen, llm, lipSync, voiceChange, textToSpeech, transcribe
  Processing: resize, animation, videoStitch, videoTrim, videoFrameExtract,
              lumaReframeImage, lumaReframeVideo, topazImageUpscale,
              topazVideoUpscale, imageGridSplit, annotation, subtitle
  Output:     output, preview

Cloud-Only (4):
  socialPublish, rssInput, tweetInput, tweetRemix

OSS Provider:
  replicate (only)

Cloud Providers:
  fal, huggingface

OSS Node Types (26):
  Input:      imageInput, audioInput, videoInput, prompt, template
  AI:         imageGen, videoGen, llm, lipSync, voiceChange, textToSpeech, transcribe
  Processing: resize, animation, videoStitch, videoTrim, videoFrameExtract,
              lumaReframeImage, lumaReframeVideo, topazImageUpscale,
              topazVideoUpscale, imageGridSplit, annotation, subtitle
  Output:     output, preview

Cloud-Only (4):
  socialPublish, rssInput, tweetInput, tweetRemix

OSS Provider:
  replicate (only)

Cloud Providers:
  fal, huggingface