信息卡

一句话定位

QM 自我定位是"A multiplayer agent harness for work, in Slack and on the web"——与个人助理式 Agent 不同，它面向创业公司团队：每位员工都有隔离工作区，可在频道、群消息和项目中与 Agent 协作，且供应商中立（Pi、OpenCode、Codex、Claude Code 都能驱动同一核心）。

走红原因分析

其一，Agent 产品普遍聚焦单人对话，"多人协作 + 组织级管控"是明确空档，而该仓库出现在 yc-software 名下天然吸睛；其二，部署哲学激进——直接告诉你的编码 Agent"Let's deploy https://github.com/yc-software/qm"；其三，人写贡献政策（contributions 必须是 human-written 文本）引发社区讨论；其四，私有 fork 升级路径写得极其工程化，显示出对企业落地的认真程度。

核心功能拆解

• 个人/共享双作用域：每人独立的记忆、文件、钥匙串视图、权限、crontab 与持久沙箱，频道与项目各有一份作用域状态；
• Slack + Web 双入口：身份与配置跨两端携带；
• 管理员平面：组织级配置、安全姿态、允许的 harness/模型清单；
• Web Apps：快速生成内部小应用并定向发布给指定人员；
• 共享技能：作用域持有、授权共享、管理员审核晋升组织级，可从 git 导入技能包；
• 后台任务：crontabs、watches、入站 webhook。

架构与技术栈浅析

无头核心 = API（身份、策略、调度器）+ Agent 循环，TypeScript on Node + Fastify；Postgres 承载会话、记忆、队列与持久状态；每个作用域一个隔离沙箱，Agent 通过固定的 execute 工具在其中执行命令；Web UI/Admin/门户是核心 HTTP API 之上的可选插件（Vite 构建、Lit 渲染），Slack 为 Bolt 进程内插件。harness/session store/sandbox/memory 四类基底都藏在接口后，靠一个 wiring 文件替换。

安装与环境要求

推荐由你的编码代理代劳部署；直连方式：

npm exec --yes --package=@yc-software/qm@latest -- \
  qm init . --org <slug> --target <fly-or-aws>
npm install

部署跑在你自己的云账号里，无需 checkout 源码。

快速上手示例

需要核心+定制共存的团队建议建私有 fork（明说别用 GitHub Fork 按钮）：

gh repo create <org>/qm-private --private
git clone --bare git@github.com:yc-software/qm qm-seed.git
git -C qm-seed.git push --mirror git@github.com:<org>/qm-private

组织定制放 `deploy/layers//`，核心保持与上游字节一致以便小幅合并。

进阶使用要点

• 安全三姿态：Strict（每次工具调用暂停审批）、Auto（默认，分类器筛外部数据）、Dangerous（无筛查），外加递归删除/破坏性 SQL 的硬拒绝命令策略；
• update-qm 与 upstream-pr 两个 skill 维护 fork 边界；
• 漏洞须按 SECURITY.md 私密上报，勿公开发 issue。

典型应用场景

• 团队共享搜索笔记/邮件/文档/数据库；
• 收件箱分诊（自动打标签 + 回复草稿）；
• 仓库值守：跑测试、盯 PR 与 CI；
• 共享频道里的项目进度跟踪。

同类生态位对比

与 LangGraph/CrewAI 等编排框架不同，QM 是带组织治理的完整产品；对比各家个人向 Coding Agent（Claude Code 等），它是" Harness 之上的协作层"；对比 Slack 内 bot 应用，多了沙箱、技能与部署体系。

资源导航

仓库 README（部署/fork/架构章节）、adrs/ 目录提交建议、SECURITY.md、update-qm 与 upstream-pr 两个维护 skill。