1. 项目定位与用途
Magic定位为新一代企业级开源AI应用创新引擎，首个整合通用AI代理（Generalist AI Agent）、可视化工作流引擎、即时通讯（IM）与在线协同办公系统的全功能平台。其核心用途是帮助企业将AI从个人玩具转化为可规模化、可管控、可产出直接业务价值的生产力工具，实现"用1个人的成本获得100人的产出"。平台提供从AI代理配置、工作流编排、多通道对话到成品交付的全链路能力，适用于构建企业知识库助手、自动化报表系统、审批流机器人、跨系统集成数字员工等场景。
项目档案文档型项目
dtyq/magic 文档/知识库：适合谁看、怎么使用
dtyq/magic：Magic是企业级开源AI Agent平台，整合通用代理、工作流引擎、即时通讯与在线协作，解决企业AI规模化部署中的安全、控制、预算与集成挑战，本页整理它适合谁看、核心内容和站内延伸入口。
AI 总结
Magic是企业级开源AI Agent平台，整合通用代理、工作流引擎、即时通讯与在线协作，解决企业AI规模化部署中的安全、控制、预算与集成挑战，实现24/7自动化并交付可直接使用的业务成果。
中文项目介绍
Magic是一个面向企业的开源一体化AI生产力平台，核心定位为通用AI代理、工作流引擎、即时通讯与在线协作系统的融合体。它旨在解决个人AI工具在企业场景下扩展时面临的典型瓶颈：数据孤岛导致知识随人员流失、API预算不可控、核心数据通过第三方工具泄露风险、高风险操作无审批机制、内部系统（如ERP/CRM）集成困难、以及输出仅为原始文本需大量人工处理。
平台提供七大核心能力：企业级知识整合与统一数据中枢、部门/用户/任务三级预算配额、沙箱隔离确保数据不离域、高风险操作人工审批网关、内部系统封装为可复用数字员工、直接生成仪表盘/报告/PPT/Excel等成品、以及支持24/7自主运行。
适用场景覆盖从一人公司到万人组织的全规模：个人团队可用AI代理覆盖营销、运营、法律等未招聘角色，零人力成本持续输出；企业级部署则实现AI资源集中管理、透明化成本归属、内部专长资产化，并严格管控数据安全与操作风险。
技术实现上，后端采用PHP/Hyperf框架构建模块化微服务（包括api-response、async-event、cloudfile、code-executor、easy-dingtalk等），支持Docker容器化部署与多架构镜像构建，文档站基于VitePress提供中英文双语支持并优化中文排版。
详细信息与使用说明
2. 解决的核心问题
Magic针对企业AI落地过程中的六大痛点提供解决方案：1) 数据孤岛问题——通过统一数据中枢将分散在个人账户的知识沉淀为组织资产；2) 预算失控——实施部门/用户/任务三级预算配额与预警；3) 数据泄露风险——采用沙箱隔离与内部部署，确保数据不出 trusted boundary；4) 高风险操作——对文件删除、邮件发送等动作设置人工审批网关；5) 系统集成困难——将ERP/CRM等内部系统封装为标准化数字员工；6) 输出效率低下——直接生成仪表盘、PPT、Excel等可直接使用的业务成品，而非原始文本。
3. 适用场景
平台适用于两种典型场景：一是OPC（一人公司）与OPT（一人团队）模式，创始人或小团队可用AI代理覆盖营销、运营、法律、数据分析、客服、设计、财务等未招聘角色，实现24/7零人力成本输出，快速生成仪表盘、报告、合同草案，并按需插拔新能力；二是企业与中型团队，作为集中化AI管理平台，防止数据泄漏、实现成本透明归属、将内部专家经验打包为跨部门可复用数字员工，并通过审批流与沙箱机制保障高风险操作安全。无论是 solo founder 还是千人组织，均可通过平台指挥AI workforce。
4. 安装方式
Magic支持Docker容器化部署。仓库中包含docs/Caddyfile（Web服务器配置）、docs/Dockerfile（多阶段构建文档站镜像）以及docs/en/development/deploy/docker.md（详细部署指南，涵盖一键脚本与手动步骤，支持macOS/Linux，基于Kubernetes沙箱环境）。项目通过GitHub Actions（docs/.github/workflows/build.yml）自动化构建并推送多架构（amd64/arm64）镜像到GHCR容器仓库。具体部署命令与配置参数需参考官方文档中的Docker部署章节，当前仓库片段未直接列出完整命令。
5. 使用方式
用户主要通过官方文档站（支持中英文切换）学习平台功能与操作。文档站基于VitePress构建（docs/.vitepress/config.mts），包含导航菜单与结构化侧边栏，覆盖平台介绍、术语表、核心功能、快速入门、开发指南等模块。教程引导用户完成AI代理配置、工作流设计、预算设置、内部系统集成（如钉钉、云文件服务）等操作。部分高级功能（如系统初始化、权限管理）有专门文档（docs/en/development/advanced/），但具体操作步骤需查阅完整文档。仓库中未提供命令行工具或图形界面直接操作指南，均以文档形式呈现。
6. 实现特点与补充说明
技术栈上，后端采用PHP/Hyperf框架，模块化设计清晰：api-response提供标准化API响应工厂；async-event实现异步事件调度与监听；cloudfile抽象多云存储（OSS/S3/TOS等）文件操作；code-executor支持代码执行环境（如阿里云）；easy-dingtalk集成钉钉开放平台。文档站针对中英文混排优化了间距插件（docs/.vitepress/plugins/chineseSpacing.ts），并自定义Layout组件管理语言偏好。权限系统基于手机号实现严格分级（docs/en/development/advanced/permission.md）。项目同时提供开源版与企业版，但仓库中未明确区分功能边界。
思维导图
Magic
核心能力
企业知识整合
预算控制
沙箱隔离
审批网关
系统集成
成品交付
24/7运行
技术架构
后端模块
PHP/Hyperf框架
Docker容器化
VitePress文档站
部署运维
Docker部署
多架构镜像构建
Caddy服务器
GitHub Actions自动化
应用场景
一人公司/个人团队
企业/中型团队
常见问题
dtyq/magic 是做什么的？
Magic是企业级开源AI Agent平台，整合通用代理、工作流引擎、即时通讯与在线协作，解决企业AI规模化部署中的安全、控制、预算与集成挑战，实现24/7自动化并交付可直接使用的业务成果。
dtyq/magic 适合用在什么场景？
Magic定位为新一代企业级开源AI应用创新引擎，首个整合通用AI代理（Generalist AI Agent）、可视化工作流引擎、即时通讯（IM）与在线协同办公系统的全功能平台。其核心用途是帮助企业将AI从个人玩具转化为可规模化、可管控、可产出直接业务价值的生产力工具，实现"用1个人的成本获得100人的产出"。平台提供从AI代理配置、工作流编排、多通道对话到成品交付的全链路能力，适用于构建企业知识库助手、自动化报表系统、审批流机器人、跨系统集成数字员工等场景。
dtyq/magic 如何安装？
Magic支持Docker容器化部署。仓库中包含docs/Caddyfile（Web服务器配置）、docs/Dockerfile（多阶段构建文档站镜像）以及docs/en/development/deploy/docker.md（详细部署指南，涵盖一键脚本与手动步骤，支持macOS/Linux，基于Kubernetes沙箱环境）。项目通过GitHub Actions（docs/.github/workflows/build.yml）自动化构建并推送多架构（amd64/arm64）镜像到GHCR容器仓库。具体部署命令与配置参数需参考官方文档中的Docker部署章节，当前仓库片段未直接列出完整命令。
dtyq/magic 如何开始使用？
用户主要通过官方文档站（支持中英文切换）学习平台功能与操作。文档站基于VitePress构建（docs/.vitepress/config.mts），包含导航菜单与结构化侧边栏，覆盖平台介绍、术语表、核心功能、快速入门、开发指南等模块。教程引导用户完成AI代理配置、工作流设计、预算设置、内部系统集成（如钉钉、云文件服务）等操作。部分高级功能（如系统初始化、权限管理）有专门文档（docs/en/development/advanced/），但具体操作步骤需查阅完整文档。仓库中未提供命令行工具或图形界面直接操作指南，均以文档形式呈现。