入行影擎（Ruhang Motion）

入行影擎是入行365推出的可审计品牌视频首稿工具：从获得授权的品牌网站收集证据，经过素材真实性与权利审核，再生成可在 Remotion Studio 中预览的品牌片项目。

当前状态：内部 Alpha。安全 intake 与素材门禁可用，但在完成自有品牌端到端验收前，不应描述为生产就绪。

能做什么

• 只接受明确的 https:// 品牌网址，并阻止本地、私网和带凭据的 URL。
• 将每次运行隔离在 runs/ 下，拒绝覆盖已有运行。
• 默认关闭外部视频下载和未验证背景音乐搜索。
• 为素材生成权利台账，阻止未确认、不可解码、扩展名不符或近似空白的素材进入场景。
• 生成带固定依赖版本的 Remotion 项目，供人工编辑、检查和预览。
• 将 intake、素材放行、构建、预览批准、最终渲染和发布视为独立门禁。

Community 与 PRO

免费 Community 版面向本地、单项目使用；PRO 会员能力将由入行365的私有服务和受控资源提供，不通过可被删除的本地布尔开关限制。完整边界见 免费版与 PRO 边界。

当前仓库不包含会员、计费或 PRO 权益实现。

环境要求

• Python 3.10+
• Node.js 22+
• FFmpeg 与 FFprobe
• file
• Playwright（网站截图需要；不是基础预检的阻断项）

项目不会自动执行系统包管理器、全局 npm、pip 或 sudo 安装。

快速开始

仅对你拥有或已获得明确授权的品牌运行：

git clone https://github.com/fzy2012/ruhang-motion.git
cd ruhang-motion
python3 skills/ruhang-motion/scripts/preflight.py
python3 skills/ruhang-motion/scripts/safe_intake.py https://your-authorized-brand.example

intake 完成后，逐项查看 brand-report.json、review.md 和实际素材。编辑新运行目录中的 asset-rights.json，只把具备 owned、licensed 或 authorized 证据的素材设为 use，然后执行：

python3 skills/ruhang-motion/scripts/audit_assets.py runs/<your-run>

审计通过后，再安装该运行的局部依赖并打开 Studio：

cd runs/<your-run>
npm ci
npm run lint
npm run build
npm run dev

Remotion Studio 预览必须获得明确批准后，才能执行 npm run render。渲染完成不代表获准发布。

验证

python3 tests/test_safe_intake.py
python3 tests/test_preflight.py
python3 tests/test_asset_paths.py
python3 tests/test_asset_audit.py
python3 tests/test_timeline_contract.py
git diff --check

GitHub CI 不在托管 runner 上自动安装系统 FFmpeg，因此 CI 只执行不依赖媒体二进制的策略/路径测试和 Remotion scaffold 构建。真实解码、空白图和 MIME 黑盒测试必须在 preflight.py 通过的本地环境或正式端到端运行中执行。

安全与权利边界

• homepage-screenshot 仅用于证据和预览，禁止进入成片。
• 网站可访问不代表网站素材可用于视频。
• 不伪造指标、评价、产品行为、商标授权或音乐许可。
• 运行目录、渲染文件、环境变量和密钥均不进入 Git。
• 漏洞报告方式见 SECURITY.md。

许可证

入行影擎自行开发的免费核心代码采用 Apache License 2.0，见 LICENSE。

vendor/30x-video-v1.0.5/ 保留其上游 MIT 许可证，详情见 THIRD_PARTY_NOTICES.md。品牌素材、商标、字体、音乐以及 Remotion 本身不因本仓库许可证而获得授权；使用者仍须遵守各自条款。