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部署

1. 初始化Fly.io部署

npm exec --yes --package=@yc-software/qm@latest -- qm init . --org my-org --target fly --model-provider anthropic npm install

2. 配置环境变量

# 设置管理员权限 echo "ADMIN_GRANTS=your-email@example.com:org_admin" >> .env # 添加模型提供商密钥 echo "ANTHROPIC_API_KEY=your-api-key" >> .env

3. 执行部署前检查

npm exec qm -- check --live npm exec qm -- conformance

4. 部署到Fly.io

npm exec qm -- up

5. 获取部署输出

npm exec qm -- outputs --json

使用AWS部署

AWS部署流程与Fly.io类似，但需要额外配置AWS CLI和权限：

1. 初始化AWS部署

npm exec --yes --package=@yc-software/qm@latest -- qm init . --org my-org --target aws --model-provider openai npm install

2. 配置AWS凭证

# 确保AWS CLI已配置 aws configure # 设置环境变量 echo "OPENAI_API_KEY=your-api-key" >> .env

3. 执行部署

npm exec qm -- up

部署后验证与配置

验证部署状态

部署完成后，通过以下命令检查系统状态：

npm exec qm -- status

访问输出的webUiUrl，使用管理员邮箱登录系统，发送测试消息验证模型响应。

配置连接器

1. 访问adminConnectorsUrl配置所需的连接器
2. 注册回调URL并输入客户端凭证
3. 完成用户连接验证

添加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