OmniCraft

<div align="center"> # <img src="docs/images/omnicraft-mascot.png" alt="" height="88" valign="middle" /> 欧米克拉夫特 ### 聊天. 编码. 自动化. 一个适用于所有 AI 代理的统一平台. 欧米克拉夫特（**OmniCraft**）是一个为代理提供完整工作环境的平台：一个安全的 **聊天**（Chat）区域用于思考（无文件访问权限），一个 **代码**（Code）区域用于执行（Claude Code、Codex、Cursor、OpenCode、Hermes、Pi 和基于 YAML 的代理团队），以及一个 **自动化工作流**（Craftwork）用于自动化 - 安排任务、通过 webhook 触发并接收结果作为通知。可通过终端、浏览器、手机或原生桌面应用访问。 [](LICENSE)    </div> <p align="center"> <img src="docs/images/home-chat.png" alt="欧米克拉夫特首页：鱼形吉祥物，聊天/自动化工作流切换，以及提示想法" width="860" /> </p> > **关于此复刻版本.** 本版本为 **巴西葡萄牙语** 的 *Omnigent* 项目复刻版本，具有独立的身份（**OmniCraft** 品牌，青绿色主题 🐟）和一大批新功能 - 三个主要界面（首页/代码/自动化工作流），推送式任务调度，MCP 服务器管理，代理画廊，本地内存，诊断功能等。详见 [本复刻版本新增功能](#%E6%9C%AC%E5%8A%8A%E6%9C%98%E6%88%BB%E4%BA%8B%E9%A1%B5%E5%8A%82%E5%B7%85%E5%90%8E)。 --- ## 目录 - [三个主要界面](#%EF%B8%8F-%E4%B8%89%E4%B8%AA%E4%B8%BB%E8%A6%81%E9%9D%A1%E9%9F%A6) - [快速入门](#-%E5%BF%AB%E9%80%A6%E5%90%8B) - [代理画廊：预设团队](#-%E4%BD%93%E7%B3%B0%E5%88%8A%E9%A1%B5%EF%BC%9A%E9%A1%B5%E5%90%8B%E5%9B%A2%E9%98%9F) - [自动化：调度、触发、接收](#-%E8%BF%91%E6%9C%BA%E5%88%8A%E6%8E%92%E5%90%8B) - [MCP 服务器](#-%E6%9C%8D%E5%8A%A1%E5%99%A8-MCP) - [可观察性和诊断](#-%E5%8F%AF%E8%A7%82%E5%AD%97%E5%92%8C%E8%AF%8A%E6%96%AD) - [治理：策略和沙盒](#%EF%B8%8F-%E7%BB%B4%E6%89%8B%E7%AD%96%E7%95%A5%E5%92%8C%E6%B2%99%E6%89%96) - [架构图](#-%E6%9E%B6%E6%9E%84%E5%9B%BE) - [独立服务器、移动设备和协作](#-%E7%94%B1%E6%99%AE%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%81%E7%A7%BB%E5%8A%A8%E8%AE%88%E5%90%8B) - [编写您自己的代理](#%EF%B8%8F-%E7%BC%96%E5%86%99%E6%82%A8%E8%BF%91%E7%9A%84%E4%BD%93%E7%B3%B0) - [本复刻版本新增功能](#-%E6%9C%AC%E5%8A%8A%E6%9C%98%E6%88%BB%E4%BA%8B%E9%A1%B5%E5%8A%82%E5%B7%85%E5%90%8E) - [质量](#-%E8%B4%A8%E9%87%8F) - [贡献](#%E8%B4%A7%E7%8C%AE) · [许可证](#%E6%9D%82%E6%89%8B) --- ## 🗂️ 三个主要界面 欧米克拉夫特按照克劳德桌面版的模式组织代理工作 - 但功能更丰富： | | **💬 聊天** | **🛠️ 自动化工作流** | **`</>` 代码** | |---|---|---|---| | **用途** | 思考：规划、编写规格、讨论架构、审阅文本 | 自动化：执行代理任务、安排或即时 | 执行：具有文件系统、工作树和终端的代码会话 | | **文件访问** | **无 - 由架构保证**，而非承诺 | 是，在选定目录中 | 是，完整的 | | **内存** | 长期，本地，按项目 | - | - | | **额外** | **制品**面板，含“→ 代码” | **手动/每日/每周**频率变为真实作业 | 个人仪表盘 + “在聊天中讨论” | ### 💬 聊天 — 无风险思考 **首页**选项卡是欧米克拉夫特的一般对话。聊天代理 **不会收到任何文件系统工具** （服务器拒绝任何尝试声明的聊天包）- 因此您可以粘贴规格，讨论架构和完善想法，而无需担心影响您的文件。 - **🧠 本地长期内存** - 聊天记住项目之间的事实，存储在本地文件中，**无需 API 密钥或外部服务**，每个项目都有独立的数据库。 - **📦 制品面板** - 助手生成的代码块和文档存储在侧边栏面板中，可复制、下载和 **“→ 代码”**：只需单击一下即可将计划带到执行编辑器。 - **🐟 吉祥物动态** - 当您思考时，吉祥物鱼会真正游泳。 ### 🛠️ 自动化工作流 — 在同一编辑器中自动化 **聊天/自动化工作流**切换按钮将编辑器转换为（无需切换屏幕，与 Cowork 相同）：选择目录、代理和 **频率** - `手动` 立即执行，`每日/工作日/每周` **创建调度作业**，在您的时区。 <p align="center"> <img src="docs/images/craftwork-composer.png" alt="首页选项卡的编辑器转换为自动化工作流模式：聊天/自动化工作流切换、频率托盘、主机、目录和代理、以及带每日/每周标签的想法" width="860" /> </p> ### `</>` 代码 — 有上下文地执行 **代码**选项卡是具有文件系统（机器、工作目录、Git 工作树）的会话编辑器 - 还有 **个人仪表盘**：会话、令牌、活动日、序列（连胜）、峰值小时、喜爱模型和 GitHub 样式的活动热图。完成后，**“在聊天中讨论”** 会将结果带回规划桌。 <p align="center"> <img src="docs/images/code-dashboard.png" alt="代码选项卡：带有统计数据和活动热图的个人仪表盘，位于新会话编辑器上方" width="860" /> </p> --- ## 🚀 快速入门 ```bash # 1. 安装 CLI（命令`omnicraft`和快捷方式`omni`） uv tool install --python 3.12 git+https://github.com/editzffaleta/OmniCraft.git # 2. 配置模型提供商（Anthropic，Claude 签名，网关...） omnicraft setup # 3. 启动本地服务器 + 网页界面，并将您的机器注册为托管主机 omnicraft server start omnicraft host # 在另一个终端 ``` 在网页界面中打开，选择 **首页** 进行对话或 **代码** 进行执行 - 或直接在终端中运行代理： ```bash omnicraft run examples/fucho/ # 多代理代码编排器 omnicraft claude # 带有会话/策略的 Claude Code 封装 ``` <details> <summary><b>开发的先决条件和安装</b></summary> - **`git`** （必需）和 **Python 3.12** （`uv` 为您解决） - **Node.js 22 LTS+** 带有 `npm`，用于通过 `npm` 安装的工具包（Claude、Codex、OpenCode、Pi）和通过 `npx` 的 MCP 服务器。 - **`tmux`** ，原生终端包装器（`omnicraft claude|codex|cursor|hermes|kiro|pi`）需要 - `brew install tmux` / `apt install tmux`. ```bash # 可编辑模式（在复刻中开发） git clone https://github.com/editzffaleta/OmniCraft.git cd OmniCraft uv tool install --force --editable . ``` - **Databricks** （可选）：使用 `databricks` 额外功能安装以使用工作区作为模型提供商。 </details> --- ## 🤖 代理画廊：预设团队 **一键安装 18 个代理** - 从简单的助手到完整的专家团队，累计 **51 个子代理** 和 **133 个技能**: <p align="center"> <img src="docs/images/agent-gallery.png" alt="代理画廊，卡片显示每个代理的描述、子代理和技能" width="860" /> </p> | 代理 | 是什么 | 子代理 | 技能 | |---|---|---:|---:| | **fucho** | 多代理代码编排器（Claude Code · Codex · Gemini · Cursor · OpenCode · Hermes · Pi）带有另一个供应商的审查 | 7 | 4 | | **gemini** | Google 的 Gemini CLI 作为代理，通过 ACP - 使用 CLI 的登录 | - | - | | **maestro** | 测试/QA：编写测试、委托执行、审查套件设计 | 2 | 3 | | **atlas** | 规划/架构：生成计划，从不编写代码 | 2 | 3 | | **polyglot** | 带有跨供应商流利度审查的本地化/i18n | 2 | 3 | | **sculptor** | 安全重构：在之前映射影响半径，在之后验证 | 2 | 3 | | **scribe** | 文档：发布说明、README、迁移指南 | 2 | 3 | | **sentinel** | 安全审计 - 仅报告，不会自行纠正 | 2 | 1 | | **lilo** | 不同供应商模型之间的辩论 | 2 | 1 | | **remy** | 带有长期记忆（Hindsight）的助手 | - | - | | **chat** | 首页选项卡的常规对话，无文件系统 | - | - | 在编排器中，**审查始终来自与实施者不同的供应商** - 一个 Claude 的 PR 由 Codex/Cursor/Pi 审查，反之亦然。在选定的代理上键入 **`/`** 以浏览技能。 --- ## ⏰ 自动化：调度、触发、接收 <p align="center"> <img src="docs/images/scheduled-agents.png" alt="调度代理页面：一键模板、表单和 cron/时区/webhook，以及作业列表" width="860" /> </p> **调度作业** 将代理 + 提示 + 目录链接到触发器： - **🕒 间隔或确切时间** - “每 6 小时”或 5 个字段的 cron（`0 9 * * 1-5`） **在您的 IANA 时区**，具有一键式模板（☕️ 日常总结，📋 每周回顾）和夏令时保护。 - **🔗 公共 webhook** - GitHub/Linear/Stripe 调用 URL，请求体通过 `{{issue.title}}` 插值；恒定令牌比较和不透明响应。 - **📬 结果返回给您** - 代理完成时，最终响应作为 **可点击通知** 返回；如果作业连续失败 3 次，您也会收到通知。 - **🧯 故障保护** - 无重叠执行、主机离线时短重试、严格验证（无法实现 cron、无效间隔和错误时区返回 `400`，而不是无限循环），以及原子状态写入。 --- ## 🔌 MCP 服务器 将外部工具（模型上下文协议）连接到 **画廊中的任何代理** - 标准输入/输出或 HTTP - 使用 **一键式目录**（内存图、获取、文件系统、Playwright、顺序思考）和 **测试** 按钮，拨打真实服务器并列出它公开的工具： <p align="center"> <img src="docs/images/mcp-servers.png" alt="MCP 服务器页面：代理选择器、带有测试/编辑/删除的服务器卡片、表单和目录" width="860" /> </p> 机密（`env`/`headers`）仅存储在代理包中 - API 绝不接受或返回它们。 --- ## 📊 可观察性和诊断 - **实时费用** - 按天、模型和会话计算的支出，包含预算警报。 - **评估/回归** - 代理的测试套件，比较执行结果。 - **诊断** - 六项环境检查，附带可行的建议： 机器连接、聊天代理、GitHub、代码路径中的 CLI、调度完整性以及推送注册。永不调试“无响应”，靠猜测： <p align="center"> <img src="docs/images/doctor.png" alt="诊断页面：环境检查清单，状态和提示" width="860" /> </p> --- ## 🛡️ 治理：策略和沙盒 每个代理都在 **声明式策略**（pt-BR 目录中的 23 个）下运行：git 命令的爆炸半径、成本限制、推送审批、下游代理的用途、目录范围等 - 带有 **可视化编辑器和模拟**，在实际会话之前测试。 ```yml policies: approve_shell: type: function handler: omnicraft.policies.builtins.safety.ask_on_os_tools # 在 shell / 写入之前询问 budget: type: function handler: omnicraft.policies.builtins.cost.cost_budget factory_params: max_cost_usd: 5.00 # 硬上限... ask_thresholds_usd: [3.00] # ...带有警告阈值 ``` 策略按三个层级堆叠 - **服务器**（管理员）、**代理**（开发人员）和 **会话**（您）- 总是采用最严格的策略。审查不受信任代码的代理 **默认沙盒化** (`bwrap`/`seatbelt`)，并且 `chat` 名称 **在服务器上保留**，用于无文件系统规范：包含 `os_env` 的仿冒包被拒绝，返回 `400`。 --- ## 🧬 架构图 ```mermaid flowchart LR subgraph Voce["您"] UI["🖥️ 桌面 / 网络 / 📱 移动"] CLI["⌨️ CLI · omnicraft"] end subgraph Server["OmniCraft 服务器"] API["API + 网络界面"] SCHED["⏰ 调度器<br/>cron · webhook · 推送"] GAL["🤖 画廊<br/>16 个代理"] MCPP["🔌 MCP 连接池"] POL["🛡️ 策略"] end subgraph Host["您的机器（托管）"] RUN["运行器"] H1["克劳德代码"] H2["Codex · Cursor · OpenCode"] H3["Hermes · Pi · YAML 代理"] FS[("📁 文件系统<br/>+ Git 工作树")] end UI --> API CLI --> API SCHED --> API API <--> RUN GAL --> RUN MCPP <--> RUN POL --> RUN RUN --> H1 & H2 & H3 H1 & H2 & H3 --> FS ``` 服务器编排；**运行器** 在您的机器（或托管沙盒）上执行。聊天选项卡与 `FS` 端点 **分离** - 通过构造，而不是配置。 --- ## 🌐 独立服务器、移动设备和协作 📱 在具有稳定 URL 的服务器上运行欧米克拉夫特，您的会话随身携带 - 网页界面针对移动设备进行了优化，聊天、子代理、终端和文件同步。 ```bash omnicraft login https://your-host # 登录一次；运行/附加/托管主机重用令牌 omnicraft host # 注册笔记本作为托管主机 ``` - **实时共享会话** - 点击 **共享** 并发送链接；队友实时查看代理工作并与其聊天。 - **共同驾驶** - `omnicraft attach <session_id>` 将队友附加到您的会话；他们的消息在 **您的** 机器上执行。 - **分支** - `omnicraft run --fork <session_id>` 将对话克隆到另一台机器并独立继续。 - **单点登录** - 通过 `OMNICRAFT_OIDC_ISSUER` 支持 Google、GitHub、Okta 和 Microsoft。 `docker compose up` 在任何 VPS 上启动；**Render** 和 **Railway** 一键部署；**Fly.io**、**Hugging Face Spaces**、**Modal**、**Cloudflare** 和 **Databricks Apps** 均有支持 - 详见 [`deploy/README.md`](deploy/README.md)。 --- ## ✍️ 编写您自己的代理 代理是一个包含 `config.yaml` 的目录 - 提示、工具包、工具、子代理、技能和策略： ```yaml spec_version: 1 name: my-agent description: >- 审查拉取请求的 PR 检查者，以 pt-BR 回复 executor: type: omnicraft config: harness: claude-sdk os_env: type: caller_process cwd: . guardrails: policies: blast_radius: type: function on: [tool_calls] function: path: omnicraft.inner.nessie.policies.blast_radius prompt: | 你是一个严格的拉取请求审查员... ``` ```bash omnicraft run my-agent/ ``` 示例目录中的 11 个代理（`chat` 最简单，`fucho` 完整编排器带防护、spawn 和跨供应商审查）是最佳学习材料。完整规范见 [`docs/AGENT_YAML_SPEC.md`](docs/AGENT_YAML_SPEC.md). --- ## 🍴 本复刻版本新增功能 除了 **pt-BR** 完整的翻译（UI、CLI、策略和文档）和欧米克拉夫特的身份外，本复刻版本带来了大量新功能： | 区域 | 新增功能 | |---|---| | **界面** | **首页/代码**选项卡，独立历史记录；**无文件系统聊天**（服务器端保证）；具有频率的 **自动化工作流**，类似 Cowork | | **聊天** | 按项目存储的本地内存，无需 API 密钥；**制品**面板，含“转到代码”，**在聊天中讨论**，动态鱼 🐟 | | **自动化** | 调度器，含 cron + 时区 + 模板，**Webhook 模板** `{{...}}`，**推送结果**，故障警报，无重叠，基于所有者的范围 | | **代理** | 可安装的画廊，含 11 个代理：完整的编排器 **fucho** （7 个工作线程），maestro/atlas/polyglot/sculptor/scribe/sentinel，**lilo** （跨供应商辩论），**remy** （内存）和聊天 | | **供应商** | **在一个运行中混合三种**：克劳德、Codex 和谷歌 - **Gemini CLI** （通过 ACP）和 **Antigravity** 新增到工具包。带有任务 → （工作线程，模型）的**路由**技能和规则：构建者永远不会是裁判 | | **本地资产** | **ComfyUI** 连接到代理：网站图像（1024px + 2 倍 AI 提升）和 **3D 文本到 GLB** （Hunyuan3D）- 无需云服务，无需密钥 | | **桌面端** | 启动应用 **自动安装本地栈**（服务器 + 托管主机）；**Windows (.exe)** 和 **macOS (.dmg)** 安装程序；托管主机可驱动的浏览器嵌入式代理（`browser_*`） | | **MCP** | 代理模板管理页面，**一键式目录**，**真实连接测试** | | **驾驶舱** | 代码个人仪表盘（连胜、热图、最喜欢的模型），实时费用，评估/回归，**诊断** | | **集成** | GitHub（问题/PR → 种子会话），**`/`** 技能菜单，首次使用时的引导 | --- ## ✅ 质量 - 所有新增功能都经过了 **端到端测试**（在浏览器和 API 上）并覆盖了单元测试 - 包括 2026-11-01 的夏令时转换测试用例。 - **四方面多代理审计**（后端、前端、端到端集成、包）发现并修复了 26 个问题。 - `pre-commit` （ruff、prettier、ktlint、swift-format）和 CI 镜像执行相同的检查。 ```bash # 服务器测试 uv run --with pytest --with pytest-asyncio python -m pytest tests/server -q # 前端 cd web && npx tsc -b && npx vitest run ``` --- ## 贡献 问题和 PR 均欢迎。阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 以获取完整的工作流程（带有视频/图像演示的 PR 模板，用于 UI 更改）和 [`CLAUDE.md`](CLAUDE.md)，如果您是本仓库中工作的 AI 代理 - 是的，本复刻版本是在与其中一个代理的合作下构建的。 🤝 ## 许可证 [Apache 2.0](LICENSE)。本项目是 **Omnigent** 的复刻版本 - 基础运行时、工具包、策略和部署的所有功劳归于原始项目；此处列出的 [新增功能](#%E6%9C%AC%E5%8A%8A%E6%9C%98%E6%88%BB%E4%BA%8B%E9%A1%B5%E5%8A%82%E5%B7%85%E5%90%8E) 归本复刻版本所有。 --- <div align="center"> 用 🐟 在巴西葡萄牙语中制作。 *如果吉祥物游得背朝上，请提交问题。*