qm部署指南：从本地开发到云环境的完整流程
qm部署指南：从本地开发到云环境的完整流程
【免费下载链接】qmMultiplayer agent harness for work项目地址: https://gitcode.com/gh_mirrors/qm6/qm
qm是一款强大的多人协作代理工具（Multiplayer agent harness for work），本指南将带你完成从本地开发环境搭建到云平台部署的全过程，让你快速上手这款协作神器。
准备工作：环境与工具要求
在开始部署前，请确保你的系统满足以下要求：
- Node.js 24+
- npm包管理器
- Git版本控制工具
- Docker（含Buildx组件）
- OpenSSL工具
首先，克隆qm项目仓库到本地：
git clone https://gitcode.com/gh_mirrors/qm6/qm cd qm本地开发环境搭建
初始化项目
本地开发环境可以通过以下命令快速初始化：
npm exec --yes --package=@yc-software/qm@latest -- qm init . --org my-org --target local npm install这条命令会创建基础配置文件和目录结构，为本地开发做好准备。
配置本地环境变量
创建并配置.env文件，设置管理员邮箱：
echo "ADMIN_GRANTS=your-email@example.com:org_admin" > .env chmod 600 .env确保.env文件权限设置为600，保障敏感信息安全。
启动本地开发服务器
完成初始化后，启动本地开发服务器：
npm run dev此时，你可以通过浏览器访问本地Web界面，开始探索qm的功能。qm的Web界面提供了会话管理、文件浏览和项目协作等核心功能，界面如下：
云环境部署准备
选择云服务提供商
qm支持两种主流云服务提供商：
- Fly.io：推荐给没有特殊偏好的用户，部署流程简单
- AWS：适合需要高度定制化和企业级功能的用户
提示：切换云服务提供商需要重新初始化部署目录，无法直接修改配置文件变更
收集必要信息
部署前需要准备以下信息：
- 组织标识符（slug）：用于资源命名的小写DNS标签
- 管理员邮箱：用于初始登录的验证邮箱
- 认证方式：内置邮件验证或Slack/外部OIDC提供商
- 模型提供商：Anthropic、OpenAI或OpenRouter
- 云服务区域：选择离用户最近的区域
云环境部署步骤
使用Fly.io部署
- 初始化Fly.io部署
npm exec --yes --package=@yc-software/qm@latest -- qm init . --org my-org --target fly --model-provider anthropic npm install- 配置环境变量
# 设置管理员权限 echo "ADMIN_GRANTS=your-email@example.com:org_admin" >> .env # 添加模型提供商密钥 echo "ANTHROPIC_API_KEY=your-api-key" >> .env- 执行部署前检查
npm exec qm -- check --live npm exec qm -- conformance- 部署到Fly.io
npm exec qm -- up- 获取部署输出
npm exec qm -- outputs --json使用AWS部署
AWS部署流程与Fly.io类似，但需要额外配置AWS CLI和权限：
- 初始化AWS部署
npm exec --yes --package=@yc-software/qm@latest -- qm init . --org my-org --target aws --model-provider openai npm install- 配置AWS凭证
# 确保AWS CLI已配置 aws configure # 设置环境变量 echo "OPENAI_API_KEY=your-api-key" >> .env- 执行部署
npm exec qm -- up部署后验证与配置
验证部署状态
部署完成后，通过以下命令检查系统状态：
npm exec qm -- status访问输出的webUiUrl，使用管理员邮箱登录系统，发送测试消息验证模型响应。
配置连接器
- 访问
adminConnectorsUrl配置所需的连接器 - 注册回调URL并输入客户端凭证
- 完成用户连接验证
添加Slack集成（可选）
如果需要Slack集成，执行以下命令：
npm exec qm -- slack render npm exec qm -- outputs根据输出的指引创建Slack应用并配置令牌，邀请机器人到测试频道验证功能。
日常维护与管理
查看日志
npm exec qm -- logs执行更新
npm update @yc-software/qm npm exec qm -- up回滚部署
npm exec qm -- rollback销毁部署
npm exec qm -- destroy进阶配置与自定义
qm允许通过组织专属层进行深度定制，相关文件位于deploy/layers/<org>/目录，包括：
- 配置文件
- 沙箱自定义
- 提供商坐标
- Slack清单生成
详细定制指南请参考deploy/layers/README.md。
常见问题解决
- 部署失败：检查
.env文件配置和云服务凭证 - 无法登录：确认管理员邮箱格式正确并检查邮件验证
- 模型无响应：验证API密钥有效性和网络连接
- Slack集成问题：检查应用权限和事件订阅配置
通过本指南，你已经掌握了qm从本地开发到云环境部署的完整流程。现在，开始探索qm带来的协作新体验吧！
【免费下载链接】qmMultiplayer agent harness for work项目地址: https://gitcode.com/gh_mirrors/qm6/qm
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考