qm

一个用于让多个智能代理协作完成工作任务的运行框架,支持隔离空间、共享协作、后台任务与灵活自托管部署。

开源项目

项目信息

文章目录

这是什么

这是一个面向团队工作的多人智能代理运行框架,目标不是只提供一个聊天机器人,而是让多个智能代理在明确的权限边界内协作完成任务。每位成员都有独立工作区,也可以在频道、群聊和项目中共同使用代理;每个人、每个房间分别拥有作用域化的记忆、文件、密钥视图、权限、定时任务、Web 应用和持久沙箱。

项目以 TypeScript 为主,核心通过 Fastify 提供 HTTP API,Web 界面基于 Vite 与 Lit,Slack 接入由 Bolt 插件负责。执行器可以选择 Pi 或 Claude Code,Pi 又可接入多家模型提供商,因此团队能够保留替换模型与智能代理外壳的能力。公司特有的组织配置、自定义工具与技能、沙箱镜像及基础设施统一放在部署目录中,不会全部写死在核心里。项目采用 MIT 许可证,当前最新版本为 v0.1.15。

中央核心负责身份、策略、调度和代理循环,Postgres 则保存会话、记忆与队列等耐久状态。按作用域隔离的沙箱像一台持久电脑,代理安装过的工具可以继续保留。正式部署时应设置 DATABASE_URL 和 SESSION_STORE=postgres;否则会话只存在进程内存中,实例重启便会丢失。

适合谁用

它适合正在探索智能代理如何进入团队工作的创业公司和小型组织。比如,团队希望成员既保留各自的助手配置,又能在共享频道里共同推进项目;或者希望智能代理定时整理邮件、搜索内部资料、维护数据并持续跟进任务。

也适合希望自托管的团队。框架可部署在自己的云账号中,使用自己的模型与密钥,不要求交出数据和控制权。需要在现有代码仓库中运行测试、提交 PR、监控 CI 的研发团队,也能把它作为统一入口;熟悉智能代理基础设施的开发者还可以进一步定制沙箱、技能和内部应用。

亮点

  • 个人与共享并存:成员和房间默认隔离,可通过授权共享技能、资源与记忆。
  • 入口保持一致:同一身份与配置可跨 Slack 和 Web 使用,适配群聊与项目协作。
  • 可构建内部工具:能创建 Web 应用并按需发布,也能导入 Git 技能包、共享组织级技能。
  • 任务可持续运行:定时任务、监听和入站 Webhook 可在无人值守时继续工作。
  • 技术栈不被锁死:可切换智能代理外壳与模型提供商,并提供组织级管理、安全策略和审计。

怎么用

官方方式是在组织自己的部署仓库中初始化。下面命令会安装最新版 CLI、生成依赖 @yc-software/qm 的项目与部署技能;将 your-org 替换成组织标识,fly 也可以换成 aws:

npm exec --yes --package=@yc-software/qm@latest -- qm init . --org your-org --target fly
npm install

初始化后,按照仓库中的部署指南配置基础设施、Web 登录、连接器凭据和可选的 Slack 接入,再执行部署与线上验证。每个部署运行在自己的云账号中;初始化本身不会生成或启用部署 CI。

若要开发联调,可克隆源码,并在配置真实模型与 Postgres 后同时启动 Web 和 Slack:

git clone https://github.com/yc-software/qm.git
cd qm
npm install
npm run dev-instance:both

注意事项

  • 先确定安全边界:代理会使用当前成员的凭据和权限。组织可在严格、自动、危险三档间选择;严格模式要求逐次审批,自动模式默认阻止访问内网,危险模式则关闭工具审批门槛,但预声明命令策略仍会拦截递归删除、破坏性 SQL 等高风险操作。
  • 不要忽略持久化与共享规则:需要长期保留的状态必须接入 Postgres。资源默认处于隔离作用域,只有显式授权或采用开放共享策略后,个人文件、技能和记忆才可能进入共享房间;上线前应结合威胁模型完成配置。

国内镜像下载

这个项目已经镜像到站长自己的服务器,GitHub 打不开、或者下载太慢的时候,直接从这里拿。

项目与资料

整理自本文的外部链接,请以来源页面说明为准。

qm · 阿凡达博客