MaxOS-Spec

# MaxOS MaxOS 是在组织内部作为持久工作者身份运行 AI 代理的规范。每个 AI 员工都有一个人类所有者、有限的权限、范围内的能力、持久的上下文和可审计的执行历史。  ## 架构概览 MaxOS 将组织工作分为三个层次： - **基础层** 通过 MaxOS MCP 协调技能、连接、内存、触发器、模型和执行环境； - **虚拟员工** 绑定稳定的身份、人类所有者、狭窄的角色、权限和上下文；以及 - **自动驾驶** 通过 Linear 或 Slack 等系统中的可见状态，协调员工和人类之间的有限交接。 托管的沙盒代理和本地运行的代理使用相同的范围能力平面。更改运行时不应改变员工被授权读取、记住或执行的操作。 MaxOS 将承载环境、LLM 和执行环境视为独立的选择。承载环境控制上下文、代理循环和工具使用；LLM 提供模型推理；执行环境在本地、托管云或混合部署中运行承载环境和每次运行的沙盒。部署可以替换这些组件而不改变员工的身份、权限、技能、内存范围或审计义务。  ## 阅读和实现规范 [SPEC.md](SPEC.md) 是 MaxOS 的规范性合约。它定义了一个紧凑的核心和单独声明的治理配置文件。核心实现不需要声称所有权转移、高影响力审批、开放式执行、委托、私人生命周期、事件响应或正式保证。 规范独立于编程语言、模型提供商、数据库、云和用户界面。要实现它，请将 [SPEC.md](SPEC.md) 提供给您的工程团队或编码代理，并附上您的环境的部署约束。 ## 运行自包含的参考 笑话竞赛是一个狭窄的可执行示例，演示了规范。它使用一个工作流、三个虚拟员工、一个人类审查门控、范围内存和一个受控的学习循环。其确定性模式需要 Node.js 22.18 或更高版本，并且不与外部账户联系或使用真实凭证。 ```console npm ci --ignore-scripts npm run demo npm run check ``` 本地工作空间可以通过 Codex 应用服务器运行员工。安装 Codex，或使用 Codex 或 ChatGPT 桌面应用捆绑的二进制文件，并在启动前对其进行身份验证： ```console codex login npm run start:local ``` `start:local` 打开工作空间，执行每个员工交接，并在模拟的人类审查门控处暂停。界面标识其内存中的 Linear 源、确定性笑话生成器、Codex 员工模型和模拟连接，而不是将它们呈现为实时外部服务。  ## 连接 Linear 自动驾驶 使用专用的 Linear 工作空间，除非在现有工作空间中创建真实的测试资源是可接受的。提供的 Linear 密钥必须能够创建团队、项目、工作流状态、问题和评论。 ```console export LINEAR_API_KEY=lin_api_... export OPENAI_API_KEY=sk-... # 如果 Codex 不使用 OPENAI_API_KEY，请单独对 Codex 进行身份验证。 codex login npm run setup npm run create -- "Airport humor championship" npm start ``` 设置创建或重用 `MaxOS Demo` 团队、`Joke Competition` 项目和 `Player A Turn`、`Player B Turn`、`Judge`、`Human Review` 和 `Result` 状态。监督器每 5 秒轮询 Linear，将每个合格状态分配给其员工，并通过 Codex 应用服务器和范围内的 MaxOS MCP 服务器运行该员工。工作空间在 `http://127.0.0.1:4310` 上保持可用。 当问题达到 `Human Review` 时，人员在 Linear 评论中确认 Player A 或 Player B。然后，裁判恢复，记录其内存中的分数，并将问题移至 `Result`。 ## 参考范围和项目状态 [reference/README.md](reference/README.md) 将可执行行为映射到稳定的规范要求，并记录凭证边界、内存、外部集成和已知限制。 参考涵盖了一个评估规模的切片：一个触发器、一个连接、两个技能、三个员工、范围内存和一个人类管理的学习循环。它不实现托管的浏览器聊天沙盒或代表完整的 MaxOS 产品。 > **工程预览：** MaxOS 0.1.0-draft 旨在在受信任的环境中进行测试。规范和参考都不是生产运行时、认证计划或法律合规框架。 ## 鸣谢 OpenAI Symphony 影响了 MaxOS 的初始公共规范和参考演示。MaxOS 有其自己的架构、需求和参考行为。参见 [NOTICE](NOTICE) 以了解贡献。 MaxOS 与 OpenAI 无关，也未得到 OpenAI 的认可。 ## 许可证 该项目根据 [Apache License 2.0](LICENSE) 许可。参见 [NOTICE](NOTICE) 以了解贡献。