内容
# 开放领域
**开源Higgsfield。 自带视频模型密钥 — 获取电影预设库、角色一致性、AI导演和免费的桌面应用程序。**
**[▶ 直播页面](https://vedsoni-dev.github.io/openfield/)**
Higgsfield实际上是四部分组成： （1）一个路由器，多个订阅后可使用Seedance / Kling / Veo / Wan，（2）一个付费的“相机控制”预设库，这只是提示工程，（3） *灵魂ID* 角色一致性，和（4） *赫尔墨斯* ，一个协调整个流程的代理。开放领域为您提供这四部分，**使用您自己的密钥**，没有任何附加费用。
## 为什么
您已经为实际模型支付了ByteDance / fal / Replicate费用。 Higgsfield再次向您收取顶部按钮的费用。 这些按钮是提示模板。 它们位于 [`src/presets/`](src/presets/) — 采用MIT许可证，可读，可扩展。
## 安装
```bash
npm install && npm run build
cp .env.example .env # 添加一个密钥以开始（FAL_KEY 影响最大）
```
Node 版本 ≥ 20.
## 使用
### 命令行界面
```bash
openfield models # 模型 + 哪个密钥可以访问每个模型
openfield presets [query] # 免费预设库（47+）
openfield compose --subject "一个雨中的孤独武士" --presets dolly-in,orbit
openfield generate --subject "..." --model seedance-2.0 --presets orbit --wait
openfield soul add nova --name "Nova" --ref <img-url> --traits "红色短发, 雀斑"
openfield generate --subject "..." --character nova --presets tracking --wait
openfield auto "一个品牌的三连拍广告" --model wan-2.2 --wait
openfield ui # 本地网页应用（mac + windows + linux）
```
`compose` 和 `auto --dry` 不会进行任何API调用 — 在花费积分之前进行检查。
### 桌面应用程序
```bash
npm run build && openfield ui # → http://localhost:4317
# 或者原生Electron应用程序：
cd app && npm install && npm start
```
选项卡：工作室 · 预设 · 灵魂ID · 导演。 查看 [docs/desktop.md](docs/desktop.md).
### MCP（从Claude Code / 任何代理生成）
将您的MCP客户端指向 `openfield-mcp`。 工具： `list_presets`, `list_models`, `compose_prompt`, `generate_video`, `check_status`, `list_characters`, `save_character`, `direct_video`. 查看 [docs/mcp.md](docs/mcp.md).
## 架构
```
主题 + 预设 ──▶ compose() ──▶ 路由器 ──▶ 提供商适配器 ──▶ 后端模型
+ 灵魂ID （免费IP） （按密钥选择） （Seedance/Kling/
+ 导演 / Veo/Wan/...）
```
- **提供商** ([`src/providers/`](src/providers/)) — `fal`, `replicate`, `custom` （自托管）。 每个提供商都读取其自己的密钥；开放领域永远不会代理它。
- **目录** ([`src/providers/catalog.ts`](src/providers/catalog.ts)) — 模型ID ➜ 多个提供商路由；第一个配置的密钥优先。
- **预设** ([`src/presets/`](src/presets/)) — 47+ 个相机 / 镜头 / 灯光 / 样式 / 特效片段。 可堆叠，模型无关。
- **灵魂ID** ([`src/soul.ts`](src/soul.ts)) — 角色存储 + 参考线程。 [文档](docs/soul-id.md).
- **协调器** ([`src/orchestrator/`](src/orchestrator/)) — LLM导演，简介 ➜ 分镜头 ➜ 镜头。 [文档](docs/orchestrator.md).
- **服务器 + 界面** ([`src/server.ts`](src/server.ts), [`src/ui/`](src/ui/)) — 零依赖本地应用程序。
## 功能状态
- [x] 自带密钥提供商路由器（fal, Replicate, 自托管）+ 11模型目录
- [x] 7类61个预设（相机，镜头，灯光，样式，视觉特效，情绪，过渡）
- [x] 电影工作室 — 相机机身 / 镜头 / 焦距 / 光圈 / 镜头 / 角度 ([文档](docs/cinema-studio.md))
- [x] 食谱 — 一键模板库 ([文档](docs/recipes.md))
- [x] 提示编译器，支持堆叠 + `{subject}` 解析
- [x] 提示优先工作室： 生成栏，支持类型/样式/相机/角色/位置，@-提及，图片/视频，宽高比/分辨率/时长/批次/音频，英雄 + 图库
- [x] 灵魂ID角色一致性 + 位置（一致设置，@-提及）
- [x] 操作： 图片起始帧，超分辨率，唇同步，视频到视频重塑风格 ([文档](docs/operations.md))
- [x] 视频拼接（ffmpeg）用于多镜头导出
- [x] 导演： **真正的Nous Hermes 3** 在多工具代理循环中 ([文档](docs/orchestrator.md))
- [x] MCP服务器
- [x] 跨平台应用程序（本地网页 + Electron for mac/win）
- [ ] 更多提供商适配器（直接Volcengine，ComfyUI食谱）
## 贡献
新的预设和提供商适配器是最容易且价值最高的PR。 查看 [CONTRIBUTING.md](CONTRIBUTING.md).
## 许可证
MIT.
