[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-quoroom-ai--room":3,"tool-quoroom-ai--room":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",158594,2,"2026-04-16T23:34:05",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":77,"owner_website":78,"owner_url":79,"languages":80,"stars":115,"forks":116,"last_commit_at":117,"license":118,"difficulty_score":32,"env_os":119,"env_gpu":120,"env_ram":121,"env_deps":122,"category_tags":128,"github_topics":129,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":139,"updated_at":140,"faqs":141,"releases":142},8129,"quoroom-ai\u002Froom","room","Open-source earning-focused swarm intelligence engine. Self-governing AI collectives (queen, workers, quorum voting) running locally via MCP. Works with Claude Code, Codex, or pay-per-use APIs.","Quoroom 是一款开源的群体智能引擎，旨在让多个 AI 代理像蜂群一样协作，自主完成复杂任务。它通过模拟“女王”制定策略、“工人”执行操作、“议会”投票决策的机制，实现了去中心化的自我治理。这一设计解决了单个 AI 代理在应对长期、多步骤目标时缺乏规划与纠错能力的问题，让智能体能够自主学习新技能并动态调整行为。\n\n该项目特别适合开发者、AI 研究人员以及对自主代理系统感兴趣的技术爱好者。用户可以在本地机器上私有化部署，利用 Ollama 等免费模型运行，也可连接 Claude Code、Codex 或各类付费 API，甚至扩展至云端集群。其核心技术亮点在于基于 MCP（模型上下文协议）的本地优先架构，内置了钱包管理、任务调度及记忆系统，支持智能体在无需人工干预的情况下持续运行。作为一个开放的研究项目，Quoroom 致力于以透明公开的方式探索群体智能的潜力，让用户能直观观察并实验 AI 蜂群的实际执行力。","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fquoroom.ai\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fquoroom-ai_room_readme_48eb43969086.png\" alt=\"Quoroom — Swarm Intelligence. Relentless Execution.\" width=\"100%\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n# Quoroom\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](LICENSE)\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fquoroom)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fquoroom)\n[![Tests](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftests-1092%20passing-brightgreen)](#)\n[![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fquoroom-ai\u002Froom)](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Fstargazers)\n[![macOS](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FmacOS-.pkg-000000?logo=apple&logoColor=white)](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Flatest)\n[![Windows](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWindows-.exe-0078D4?logo=windows&logoColor=white)](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Flatest)\n[![Linux](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLinux-.deb-FCC624?logo=linux&logoColor=black)](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Flatest)\n\n**An open research project in autonomous agent collectives.**\n\nA single agent thinks. A collective decides. We're building the swarm.\n\nQueen, Workers, Quorum. Goals, skills, self-modification, wallet — local-first on your machine, with optional cloud swarm runtime on quoroom.io.\n\n[Local](https:\u002F\u002Fquoroom.ai) · [Cloud](https:\u002F\u002Fquoroom.io)\n\nLocal\u002Fcloud split:\n- Local app + install surface: `quoroom.ai`\n- Cloud app + API + public rooms + swarm instances: `quoroom.io`\n\n\u003Cp align=\"center\">\n  \u003Cvideo src=\"docs\u002Fdemo.mp4\" autoplay loop muted playsinline width=\"800\">\u003C\u002Fvideo>\n\u003C\u002Fp>\n\n---\n\n## Trademark and Anti-Scam Notice\n\n- Code in this repository is MIT-licensed, but **Quoroom name\u002Flogo\u002Fbranding are not licensed** under MIT.\n- Quoroom does **not** endorse third-party tokens using our name.\n- Quoroom will never ask for wallet seed phrases or private keys.\n\nOfficial channels only:\n\n- `https:\u002F\u002Fquoroom.ai` (local app\u002Fdownload)\n- `https:\u002F\u002Fquoroom.io` (cloud app\u002Fpublic rooms\u002Fswarm instances)\n- `https:\u002F\u002Fgithub.com\u002Fquoroom-ai`\n- Telegram: `@quoroom_ai_bot`\n\nIf you see impersonation or scam activity, report it to `hello@quoroom.io`.\nSee `TRADEMARKS.md` for full trademark usage terms.\n\n---\n\n## Why Quoroom?\n\nRun a swarm of AI agents that pursue goals autonomously. The Queen strategizes, a swarm of Workers execute, and the Quorum votes on decisions. Agents learn new skills and modify their own behavior. In cloud mode, workers run on the swarm runtime host provisioned for the room on quoroom.io.\n\nContinuous autonomous execution is becoming widespread. It's already happening behind closed doors. We believe it should happen in the open — publicly, transparently — so everyone can learn. Quoroom is an experiment: let's see what AI swarms can actually execute.\n\nThe architecture draws from swarm intelligence research: decentralized decision-making, emergent behavior from local interactions, and collective intelligence that exceeds any individual agent. The queen doesn't dictate — the swarm decides.\n\n---\n\n## What is Quoroom?\n\nQuoroom is an open research project exploring autonomous agent collectives. Each collective (a **Room**) is a self-governing swarm of agents.\n\n- **Queen** — strategic brain, supports free local (`ollama:qwen3-coder:30b`), Claude Code CLI, Codex CLI, and OpenAI\u002FClaude\u002FGemini API\n- **Workers** — specialized agents that inherit the queen model by default (or can run a separate model, including free local)\n- **Quorum** — agents deliberate and vote on decisions\n- **Keeper** — the human who sets goals and funds the wallet\n\n## This Repo\n\n`quoroom-ai\u002Froom` is the engine: agent loop, quorum governance, goals, skills, self-modification, wallet, memory, task scheduling, MCP server, HTTP\u002FWebSocket API, dashboard UI, and CLI.\n\n| Repo | Purpose |\n|------|---------|\n| **room** (this) | Engine + HTTP server + UI |\n| [cloud](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Fcloud) | Landing page, public rooms, PostgreSQL, swarm instance infrastructure |\n\n---\n\n## Features\n\n**Rooms** — Create autonomous agent collectives with a Queen and Workers. Pause, restart, monitor activity.\n\n**Activity Controls** — Throttle the queen per room: configurable cycle gap (sleep between runs), max turns per cycle, and quiet hours (time window where the queen rests). Plan-aware defaults apply automatically when you create a new room based on your model provider.\n\n**Free Local Model (Ollama)** — One-click setup for `ollama:qwen3-coder:30b` in Queen\u002FClerk\u002FWorkers setup flows. Quoroom runs compatibility checks, installs Ollama, pulls the pinned model, streams install progress, and applies it across active rooms. Local-only path, fail-closed (no paid fallback).\n\n**Quorum Voting** — Agents propose and vote on decisions. Majority, supermajority, or unanimous — you choose the threshold. All voters (keeper and workers) have equal weight. Ties are broken by the queen's vote by default.\n\n**Goals** — Hierarchical goal decomposition with progress tracking. Set a top-level objective and let agents break it down.\n\n**Skills** — Reusable agent capabilities with activation contexts and versioning. Agents learn and improve over time.\n\n**Self-Modification** — Agents edit their own skills and files with full audit trail and one-click revert.\n\n**Memory** — Entities, observations, and relations with semantic vector search (384-dim embeddings). Knowledge persists across sessions.\n\n**Wallet** — EVM wallet with multi-chain support. USDC and USDT on Base, Ethereum, Arbitrum, Optimism, and Polygon. Encrypted keys (AES-256-GCM). Same address works on all chains — balance is aggregated across all networks.\n\n**On-Chain Identity** — ERC-8004 agent identity on Base. Rooms register as on-chain agents with discoverable metadata. Reputation-ready.\n\n**Swarm Runtime (cloud mode)** — Cloud rooms provision a single swarm runtime host. All queen\u002Fworker execution runs there; no additional execution routing layer exists.\n\n**Task Scheduling** — Recurring (cron), one-time, on-demand, or **webhook-triggered** tasks with session continuity and auto-nudge.\n\n**Webhooks** — HTTP endpoints to trigger tasks or wake the queen from any external service. GitHub push, Stripe payment, monitoring alert — any system that can POST to a URL can drive your agents. Per-task and per-room tokens, 30 req\u002Fmin rate limiting, no auth setup required beyond the URL.\n\n**Keeper Control Model** — Rooms run in a keeper-controlled mode with full dashboard\u002FAPI control for agent and user tokens. Cloud member tokens are read-only plus limited collaboration endpoints (vote, resolve\u002Freply, mark read).\n\n**Public Rooms** — Toggle your room public on [quoroom.io\u002Frooms](https:\u002F\u002Fquoroom.io\u002Frooms). Live room stats and activity appear on the leaderboard. Room registers with cloud and sends heartbeats every 5 minutes. No account needed to browse.\n\n**HTTP Server + REST API** — Full REST API with dual-token auth (agent + user) and WebSocket real-time events. Cloud member role uses constrained collaboration access. Run `quoroom serve` to start.\n\n**Dashboard** — React SPA served directly by your local Quoroom server at `http:\u002F\u002Flocalhost:3700` (or your configured port). Manage rooms, agents, goals, memory, wallet — all from the browser, with local-first data storage.\n\n**Clerk** — A fully functional keeper assistant in the dashboard. It can chat across all rooms, remember context and history, act proactively, and execute management actions (create\u002Fupdate rooms, tasks, reminders, messaging) while streaming live commentary about swarm activity.\n\n**Cloud Mode** — Deploy to the cloud on quoroom.io and control your room remotely. Same dashboard works in both local and cloud mode. Cloud instances auto-detect their environment, support JWT-based auth, and serve the UI over HTTPS with strict CORS. Connect your model provider from the remote Settings panel.\n\n**Inbox** — Rooms can message the keeper and other rooms. Cross-room communication with reply threading. Agents escalate decisions, share updates, or request resources from neighboring rooms.\n\n**Credentials** — Secure credential storage for API keys and secrets. Agents list and retrieve credentials at runtime without exposing raw values in prompts or logs.\n\n**Auto-updates** — Update behavior depends on deployment mode. In local mode, the dashboard shows update controls (popup + Settings row) and lets you download\u002Fapply updates manually. In cloud mode, updates are managed automatically by the runtime with no manual update buttons in the UI.\n\n---\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────┐\n│                    Room                          │\n│  ┌───────┐  ┌─────────┐  ┌──────────────────┐  │\n│  │ Queen │  │ Workers │  │     Quorum       │  │\n│  │(LLM cfg)│ │(LLM cfg)│  │ propose → vote   │  │\n│  └───┬───┘  └────┬────┘  └──────────────────┘  │\n│      │           │                               │\n│  ┌───┴───────────┴───────────────────────────┐  │\n│  │              Agent Loop                    │  │\n│  │  goals · skills · self-mod · memory        │  │\n│  └───────────────────────────────────────────┘  │\n│                                                  │\n│  ┌────────┐  ┌──────────────┐  ┌────────────────┐  │\n│  │ Wallet │  │ Swarm Runtime│  │ Task Scheduler │  │\n│  │(EVM)   │  │(local\u002Fcloud) │  │cron\u002Fonce\u002Fhook  │  │\n│  └────────┘  └──────────────┘  └────────────────┘  │\n│                                                  │\n│  ┌──────────────────────────────────────────┐   │\n│  │  Auth: agent token + user token + member │   │\n│  │  Access: agent\u002Fuser full · member scoped │   │\n│  └──────────────────────────────────────────┘   │\n└────────────────────┬────────────────────────────┘\n                     │\n        ┌────────────┼────────────┐\n        │            │            │\n   MCP Server   HTTP\u002FREST    WebSocket\n    (stdio)    (port 3700)   (real-time)\n                     │\n              POST \u002Fapi\u002Fhooks\u002F\n              (webhooks — no auth)\n              task\u002F:token · queen\u002F:token\n                     │\n        ┌────────────┼────────────┐\n        │                         │\n ┌──────┴──────┐         ┌───────┴───────┐\n │  Dashboard  │         │  Cloud Sync   │\n │ localhost   │         │ quoroom.io    │\n └─────────────┘         │  \u002Frooms page  │\n                          └───────────────┘\n```\n\n---\n\n## Install\n\n### npm (recommended)\n\n```bash\nnpm install -g quoroom\n```\n\n### Homebrew (macOS)\n\n```bash\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nDownload from [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases). Installers add `quoroom` to your PATH automatically. No dependencies needed. The installer bundles only Node.js v20 — no third-party software, toolbars, or extensions are included.\n\nInstaller launchers:\n- macOS `.pkg`: open `\u002FApplications\u002FQuoroom Server.app`\n- Windows `.exe`: Start Menu -> Quoroom Server -> Open Quoroom Server\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | `.pkg` | `.tar.gz` |\n| Linux x64 | `.deb` | `.tar.gz` |\n| Windows x64 (signed) | `.exe` setup | `.zip` |\n\n\u003Cdetails>\n\u003Csummary>Platform notes\u003C\u002Fsummary>\n\n**macOS**\n- Universal binary (Apple Silicon + Intel) — single `.pkg` works on both architectures\n- Native menu bar tray app (Swift) — auto-starts server, provides \"Open Dashboard\" \u002F \"Restart\" \u002F \"Quit\"\n- `.pkg` is codesigned + Apple-notarized\n- Shell wrapper with auto-update check (polls GitHub every 4h) and crash rollback (3-strike reset)\n- PATH: inherits login shell PATH at startup (`zsh -lic`) so Homebrew\u002FNVM-installed CLIs (`claude`, `codex`) are found\n\n**Windows**\n- Signed `.exe` installer (NSIS, SSL.com eSigner)\n- VBS launcher — starts server without a console window\n- Adds `quoroom` to system PATH via registry\n- PATH: adds npm global prefix dir at startup so globally-installed `claude.cmd` \u002F `codex.cmd` are found\n- `.cmd` wrappers (npm-installed CLIs) are auto-resolved to underlying `.js` scripts to bypass cmd.exe 8191-char argument limit\n\n**Linux**\n- `.deb` package (x64), installs to `\u002Fusr\u002Flocal\u002Flib\u002Fquoroom`\n- Same shell wrapper and auto-update mechanism as macOS\n\n\u003C\u002Fdetails>\n\n### Uninstall\n\n```bash\nquoroom uninstall\n```\n\nRemoves Quoroom binaries, all data, and logs. Prompts for confirmation before proceeding.\n\n---\n\n## Quick Start\n\n```bash\n# Start the HTTP\u002FWebSocket API server + dashboard\nquoroom serve\n```\n\nIf you installed with the macOS `.pkg` or Windows `.exe` installer, you can also use the launcher app\u002Fshortcut instead of command line.\n\nOn first run, `quoroom serve` automatically registers the Quoroom MCP server in every AI coding tool you have installed (Claude Code, Claude Desktop, Codex, Cursor, Windsurf). Just **restart your AI client once** — after that, all `mcp__quoroom__*` tools are available automatically in every session.\n\nOpen **http:\u002F\u002Flocalhost:3700** (or the port shown in your terminal). The dashboard and API run locally, and your room data stays on your machine by default.\n\n> **MCP-only mode** (no HTTP server): `quoroom mcp` starts just the stdio MCP transport, useful for scripting or testing. For normal use, `quoroom serve` is all you need.\n\n## Clerk\n\nThe **Clerk** tab is your global assistant for the whole local system (not a single room).\n\n- Clerk is a full assistant, not only commentary: it can reason, remember, and execute actions for the keeper\n- Setup paths: Free Local (`ollama:qwen3-coder:30b`), Claude Code CLI (`claude`), Codex CLI (`codex`), OpenAI API (`openai:gpt-4o-mini`), Anthropic API (`anthropic:claude-3-5-sonnet-latest`), Gemini API (`gemini:gemini-2.5-flash`)\n- API keys entered in Clerk Setup are validated before saving\n- Clerk can answer and do: room lifecycle, room settings, task creation, reminders, inter-room messaging, and keeper communication\n- Clerk can act proactively through scheduled tasks\u002Freminders and activity-driven commentary\n- Telegram and Email are important Clerk control channels: connect at least one so Clerk can always reach you, keep reminders flowing, and store those conversations in Clerk memory\n- Email replies are threaded when possible, and Telegram replies are direct\u002Freal-time for fast keeper control\n- Live commentary streams over WebSocket channel `clerk` while rooms are running\n\nAPI key resolution for Clerk API models:\n\n1. Any room credential (`openai_api_key`, `anthropic_api_key`, or `gemini_api_key`)\n2. Clerk-saved API key (`clerk_openai_api_key` \u002F `clerk_anthropic_api_key` \u002F `clerk_gemini_api_key`)\n3. Environment variable (`OPENAI_API_KEY` \u002F `ANTHROPIC_API_KEY` \u002F `GEMINI_API_KEY`)\n\nSee full guide: [docs\u002FCLERK.md](docs\u002FCLERK.md)\n\n---\n\n## All Tools\n\nThe room engine exposes an MCP server over stdio. All tools use the `quoroom_` prefix.\n\n\u003Cdetails>\n\u003Csummary>Full tool reference (click to expand)\u003C\u002Fsummary>\n\n### Room\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_create_room` | Create a new autonomous agent collective |\n| `quoroom_list_rooms` | List rooms by status |\n| `quoroom_room_status` | Get room status and summary |\n| `quoroom_room_activity` | Get recent room activity |\n| `quoroom_pause_room` | Pause a running room |\n| `quoroom_restart_room` | Restart a paused room |\n| `quoroom_delete_room` | Delete a room |\n| `quoroom_configure_room` | Update room configuration |\n\n### Quorum\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_propose` | Create a proposal for the quorum to vote on |\n| `quoroom_vote` | Cast a vote on a proposal |\n| `quoroom_list_decisions` | List quorum decisions |\n| `quoroom_decision_detail` | Get details of a specific decision |\n\n### Goals\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_set_goal` | Set a room's primary objective |\n| `quoroom_create_subgoal` | Decompose a goal into sub-goals |\n| `quoroom_update_progress` | Log a progress observation |\n| `quoroom_delegate_task` | Delegate a task to a specific worker |\n| `quoroom_complete_goal` | Mark a goal as completed |\n| `quoroom_abandon_goal` | Abandon a goal |\n| `quoroom_list_goals` | List goals for a room |\n\n### Skills\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_create_skill` | Create a reusable agent skill |\n| `quoroom_edit_skill` | Update a skill (increments version) |\n| `quoroom_list_skills` | List available skills |\n| `quoroom_activate_skill` | Activate a skill |\n| `quoroom_deactivate_skill` | Deactivate a skill |\n| `quoroom_delete_skill` | Delete a skill |\n\n### Self-Modification\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_self_mod_edit` | Edit a skill or file with audit logging |\n| `quoroom_self_mod_revert` | Revert a modification by audit ID |\n| `quoroom_self_mod_history` | View modification audit history |\n\n### Workers\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_create_worker` | Create a named agent with system prompt |\n| `quoroom_list_workers` | List all workers |\n| `quoroom_update_worker` | Update a worker's configuration |\n| `quoroom_delete_worker` | Delete a worker |\n| `quoroom_export_worker_prompts` | Export worker prompts to markdown files |\n| `quoroom_import_worker_prompts` | Import worker prompts from markdown files |\n\n#### Worker Prompt Markdown Sync\n\n- Runtime source of truth stays in SQLite (`workers.system_prompt`).\n- Markdown sync is explicit (no background watcher): export\u002Fimport via Workers UI, HTTP API, or MCP tools.\n- Default path: `.quoroom\u002Fprompts\u002Fworkers\u002Froom-\u003CroomId|global>\u002Fworker-\u003CworkerId>.md`.\n- File format: YAML frontmatter + markdown body (body becomes full system prompt).\n- Conflict policy: newest mtime wins unless `force=true` is passed on import\u002Fexport.\n\n### Task Scheduling\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_schedule` | Create a recurring (cron), one-time, on-demand, or webhook-triggered task |\n| `quoroom_webhook_url` | Get or generate the webhook URL for a task or room |\n| `quoroom_list_tasks` | List tasks by status |\n| `quoroom_run_task` | Execute a task immediately |\n| `quoroom_task_progress` | Check running task progress |\n| `quoroom_task_history` | View task run history |\n| `quoroom_pause_task` | Pause a scheduled task |\n| `quoroom_resume_task` | Resume a paused task |\n| `quoroom_delete_task` | Delete a task |\n| `quoroom_reset_session` | Clear session continuity for a task |\n\n### Memory\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_remember` | Store facts, preferences, people, events |\n| `quoroom_recall` | Semantic + full-text search of memories |\n| `quoroom_forget` | Delete a memory |\n| `quoroom_memory_list` | List all memories |\n\n### Wallet\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_wallet_create` | Create an EVM wallet (multi-chain) |\n| `quoroom_wallet_address` | Get wallet address |\n| `quoroom_wallet_balance` | Check on-chain balance (USDC\u002FUSDT, all chains) |\n| `quoroom_wallet_send` | Send USDC or USDT on any supported chain |\n| `quoroom_wallet_history` | View transaction history |\n| `quoroom_wallet_topup` | Get wallet top-up URL |\n\n### Identity\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_identity_register` | Register room as ERC-8004 on-chain agent |\n| `quoroom_identity_get` | Get on-chain identity (agentId, registry, URI) |\n| `quoroom_identity_update` | Update on-chain registration metadata |\n\n### Inbox\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_send_message` | Send a message to the keeper or another worker |\n| `quoroom_inbox_send_room` | Send a message to another room |\n| `quoroom_inbox_list` | List inbox messages |\n| `quoroom_inbox_reply` | Reply to a room message |\n\n### Invite\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_invite_create` | Create an invite link for your room |\n| `quoroom_invite_list` | List invite links and usage |\n| `quoroom_invite_network` | View rooms in your invite network |\n\n### Credentials\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_credentials_list` | List stored credentials |\n| `quoroom_credentials_get` | Get a credential value |\n\n### Resources\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_resources_get` | Get local system resources (CPU, memory, disk) |\n\n### Browser\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_browser` | Control a headless browser for multi-step web flows |\n\n### WIP\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_save_wip` | Save in-progress context for later continuation |\n\n### Settings\n\n| Tool | Description |\n|------|-------------|\n| `quoroom_get_setting` | Get a setting value |\n| `quoroom_set_setting` | Update a setting |\n\n\u003C\u002Fdetails>\n\n## Development\n\n```bash\nnpm install              # Install dependencies\nnpm run build            # Typecheck + bundle MCP server + build UI\nnpm run build:mcp        # Bundle MCP server only (esbuild)\nnpm run build:ui         # Build UI SPA only (Vite)\nnpm run dev              # Local-only dev (links + room)\nnpm run dev:with-cloud   # Local dev + cloud (requires ..\u002Fcloud)\nnpm run dev:isolated     # Isolated local dev (room :4700 + UI, no cloud)\nnpm run dev:isolated:with-cloud # Isolated local dev + cloud\nnpm run dev:cloud        # Cloud-only (runs ..\u002Fcloud on :3715)\nnpm run dev:ui           # UI dev server with hot reload\nnpm run typecheck        # Type-check only (tsc --noEmit)\nnpm test                 # Run all tests (vitest, fork pool)\nnpm run test:watch       # Watch mode\nnpm run test:e2e         # End-to-end tests (Playwright)\n\n# Windows\nnpm run dev:win              # Local-only dev (same as npm run dev)\nnpm run dev:with-cloud:win   # Local dev + cloud (requires ..\u002Fcloud)\nnpm run dev:isolated:win    # Windows equivalent of dev:isolated\nnpm run dev:isolated:with-cloud:win # Windows isolated + cloud\nnpm run build:windows:local # Local Windows build (PowerShell)\n```\n\n### Docker (cloud runtime)\n\n```bash\ndocker build -t quoroom .\ndocker run -p 3700:3700 quoroom\n```\n\n### Cloud Runtime Auto-Update Diagnostics\n\nCloud runtimes now prefer a centralized update source and expose diagnostics in status:\n\n- `QUOROOM_UPDATE_SOURCE_URL` — cloud endpoint for latest runtime release metadata (preferred source)\n- `QUOROOM_UPDATE_SOURCE_TOKEN` — optional bearer token for update-source auth\n- `QUOROOM_UPDATE_GITHUB_TOKEN` — optional fallback GitHub token when direct fallback is needed\n\n`GET \u002Fapi\u002Fstatus` includes `updateDiagnostics`:\n\n- `lastCheckAt`, `lastSuccessAt`, `lastErrorAt`\n- `lastErrorCode`, `lastErrorMessage`\n- `updateSource` (`cloud` or `github`)\n- `nextCheckAt`, `consecutiveFailures` (backoff visibility)\n\n## Releasing\n\nTriggered by pushing a git tag (`v*`) → GitHub Actions multi-platform build:\n\n- **macOS**: Universal `.pkg` (ARM64 + x64 via `lipo`), Swift tray app compiled, codesigned + Apple-notarized\n- **Windows**: NSIS `.exe` installer, signed with SSL.com eSigner\n- **Linux**: `.deb` package via `fpm`\n- All platforms bundle Node.js runtime (no system dependency), with auto-update and crash rollback\n- Post-build: GitHub Release → npm publish → Homebrew tap update\n\n\u003Cdetails>\n\u003Csummary>Project structure\u003C\u002Fsummary>\n\n```\nroom\u002F\n├── src\u002F\n│   ├── cli\u002F               # CLI entry point (quoroom command)\n│   ├── mcp\u002F               # MCP server (stdio)\n│   │   ├── server.ts      # Tool registration\n│   │   ├── db.ts          # Database initialization\n│   │   └── tools\u002F         # 19 tool modules\n│   ├── server\u002F            # HTTP\u002FWebSocket API server\n│   │   ├── index.ts       # Server bootstrap (local + cloud mode)\n│   │   ├── router.ts      # Request router\n│   │   ├── auth.ts        # Dual-token auth + CORS + cloud JWT\n│   │   ├── access.ts      # Role-based access control\n│   │   ├── webhooks.ts    # Webhook receiver (no-auth token endpoints)\n│   │   ├── ws.ts          # WebSocket real-time events\n│   │   └── routes\u002F        # REST API routes (19 modules)\n│   ├── ui\u002F                # React SPA dashboard\n│   │   ├── App.tsx        # Root component\n│   │   ├── components\u002F    # UI components (32 modules)\n│   │   ├── hooks\u002F         # React hooks\n│   │   └── lib\u002F           # API client, auth, storage, WebSocket\n│   └── shared\u002F            # Core engine\n│       ├── agent-loop.ts       # Worker agent loop with rate limiting\n│       ├── agent-executor.ts   # Claude Code CLI execution\n│       ├── room.ts             # Room lifecycle\n│       ├── quorum.ts           # Voting & decisions\n│       ├── goals.ts            # Goal decomposition\n│       ├── skills.ts           # Skill management\n│       ├── wallet.ts           # EVM wallet (multi-chain, USDC\u002FUSDT)\n│       ├── identity.ts         # ERC-8004 on-chain identity\n│       ├── task-runner.ts      # Task execution engine\n│       ├── model-provider.ts   # Multi-provider LLM support\n│       ├── cloud-sync.ts       # Cloud registration + heartbeat\n│       ├── db-queries.ts       # Database query layer\n│       ├── schema.ts           # SQLite schema (WAL mode)\n│       ├── embeddings.ts       # Vector embeddings (all-MiniLM-L6-v2)\n│       └── __tests__\u002F          # Test suite (907 tests)\n├── e2e\u002F                    # Playwright end-to-end tests\n├── installers\u002F\n│   ├── macos\u002F             # Swift tray app (QuoroomTray.swift)\n│   └── windows\u002F           # NSIS installer + PowerShell\u002FVBS scripts\n├── scripts\u002F\n│   └── build-mcp.js       # esbuild bundling\n├── Dockerfile              # Cloud runtime image\n└── docs\u002F                   # Media assets + architecture docs\n```\n\n**Tech stack**: TypeScript (strict), React, Tailwind CSS, better-sqlite3, sqlite-vec, viem, MCP SDK, HuggingFace Transformers, node-cron, zod, esbuild, Vite, Vitest\n\n\u003C\u002Fdetails>\n\n## Model Providers\n\nFree local model included. Bring an API key for cloud models.\n\n| Model string | Provider | Execution | Requires |\n|---|---|---|---|\n| `ollama:qwen3-coder:30b` | Ollama local runtime | Local HTTP (`127.0.0.1:11434`) | Local deployment mode, macOS\u002FWindows compatibility gate, Ollama runtime + pulled model |\n| `claude` (default) | Claude Code CLI | Spawns CLI process | [Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code) installed |\n| `codex` | OpenAI Codex CLI | Spawns CLI process | `npm i -g @openai\u002Fcodex` |\n| `openai:gpt-4o-mini` | OpenAI API | HTTP REST | `OPENAI_API_KEY` |\n| `anthropic:claude-3-5-sonnet-latest` | Anthropic API | HTTP REST | `ANTHROPIC_API_KEY` |\n| `gemini:gemini-2.5-flash` | Gemini API | HTTP REST | `GEMINI_API_KEY` |\n\n**Free local model** (`ollama:qwen3-coder:30b`) — Local-only mode via Ollama OpenAI-compatible endpoint. Uses pinned model tag, no API key, and fail-closed runtime checks (if Ollama\u002Fmodel are unavailable, agents stop with actionable errors).\n\n**CLI models** (`claude`, `codex`) — Full agentic loop with tool use via the CLI. Session continuity via `--resume`. On Windows, `.cmd` wrappers are auto-resolved to underlying `.js` scripts to bypass the cmd.exe 8191-char argument limit.\n\n**API models** (`openai:*`, `anthropic:*`, `gemini:*`) — Direct HTTP calls. Support multi-turn tool-calling loops. API keys resolve from: room credentials → Clerk-saved keys → environment variables. `anthropic:*` also accepts the `claude-api:` prefix. `gemini:*` uses Google's OpenAI-compatible endpoint.\n\nWorkers inherit the queen's model by default, or can use a separate model (API or free local).\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fquoroom.ai\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fquoroom-ai_room_readme_48eb43969086.png\" alt=\"Quoroom — 群体智能。不懈执行。\" width=\"100%\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n# Quoroom\n\n[![许可证：MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](LICENSE)\n[![npm版本](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fquoroom)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fquoroom)\n[![测试](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftests-1092%20passing-brightgreen)](#)\n[![GitHub 星标](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fquoroom-ai\u002Froom)](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Fstargazers)\n[![macOS](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FmacOS-.pkg-000000?logo=apple&logoColor=white)](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Flatest)\n[![Windows](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWindows-.exe-0078D4?logo=windows&logoColor=white)](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Flatest)\n[![Linux](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLinux-.deb-FCC624?logo=linux&logoColor=black)](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Flatest)\n\n**一项关于自主智能体群体的开放研究项目。**\n\n单个智能体会思考，而群体则会决策。我们正在构建一个智能体群落。\n\n女王、工蜂、法定人数。目标、技能、自我修改、钱包——在您的本地设备上以“本地优先”方式运行，并可选在 quoroom.io 上使用云端群集运行时。\n\n[本地](https:\u002F\u002Fquoroom.ai) · [云端](https:\u002F\u002Fquoroom.io)\n\n本地与云端的分工：\n- 本地应用 + 安装界面：`quoroom.ai`\n- 云端应用 + API + 公共房间 + 群集实例：`quoroom.io`\n\n\u003Cp align=\"center\">\n  \u003Cvideo src=\"docs\u002Fdemo.mp4\" autoplay loop muted playsinline width=\"800\">\u003C\u002Fvideo>\n\u003C\u002Fp>\n\n---\n\n## 商标及防诈骗声明\n\n- 本仓库中的代码采用 MIT 许可证，但 **Quoroom 的名称\u002F标志\u002F品牌标识并不受 MIT 许可证保护**。\n- Quoroom **不认可**任何使用我们名称的第三方代币。\n- Quoroom 绝不会要求用户提供钱包助记词或私钥。\n\n请仅通过官方渠道进行交互：\n\n- `https:\u002F\u002Fquoroom.ai`（本地应用\u002F下载）\n- `https:\u002F\u002Fquoroom.io`（云端应用\u002F公共房间\u002F群集实例）\n- `https:\u002F\u002Fgithub.com\u002Fquoroom-ai`\n- Telegram: `@quoroom_ai_bot`\n\n如发现冒充或诈骗行为，请向 `hello@quoroom.io` 报告。完整商标使用条款请参阅 `TRADEMARKS.md`。\n\n---\n\n## 为什么选择 Quoroom？\n\n运行一个能够自主追求目标的 AI 智能体群落。女王负责制定战略，一群工蜂负责执行，而法定人数则对决策进行投票。智能体可以学习新技能并自我调整行为。在云端模式下，工蜂将在 quoroom.io 上为该房间提供的群集运行时主机上运行。\n\n持续的自主执行正变得越来越普遍，目前许多此类应用仍在封闭环境中运行。我们认为，这种技术应当公开透明地发展，以便所有人都能从中受益。Quoroom 是一次实验：让我们看看 AI 群体究竟能够完成哪些任务。\n\n该架构借鉴了群体智能的研究成果：去中心化的决策机制、由局部交互产生的涌现行为，以及超越单个智能体能力的集体智慧。女王并不发号施令——而是由整个群落共同决定。\n\n---\n\n## 什么是 Quoroom？\n\nQuoroom 是一项探索自主智能体群体的开放研究项目。每个群体（称为“Room”）都是一个自治的智能体群落。\n\n- **女王** — 战略大脑，支持本地免费模型（`ollama:qwen3-coder:30b`）、Claude Code CLI、Codex CLI 以及 OpenAI\u002FClaude\u002FGemini API\n- **工蜂** — 专门化智能体，默认继承女王模型（也可运行独立模型，包括本地免费模型）\n- **法定人数** — 智能体就决策进行讨论并投票\n- **守护者** — 设定目标并为钱包提供资金的人类\n\n## 本仓库\n\n`quoroom-ai\u002Froom` 是核心引擎：智能体循环、法定人数治理、目标、技能、自我修改、钱包、记忆、任务调度、MCP 服务器、HTTP\u002FWebSocket API、仪表盘 UI 和 CLI。\n\n| 仓库 | 用途 |\n|------|---------|\n| **room**（本仓库） | 引擎 + HTTP 服务器 + UI |\n| [cloud](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Fcloud) | 登陆页面、公共房间、PostgreSQL、群集实例基础设施 |\n\n---\n\n## 功能特性\n\n**房间** — 创建由女王和工蜂组成的自治智能体集群。支持暂停、重启及活动监控。\n\n**活动控制** — 按房间对女王进行限流：可配置循环间隔（每次运行之间的休眠时间）、每轮最大步数，以及静默时段（女王休息的时间窗口）。基于您的模型提供商，创建新房间时会自动应用与规划感知相关的默认设置。\n\n**免费本地模型（Ollama）** — 在女王\u002F文员\u002F工蜂的部署流程中，一键即可设置 `ollama:qwen3-coder:30b`。Quoroom 会执行兼容性检查、安装 Ollama、拉取固定版本的模型、实时展示安装进度，并将其应用到所有活跃的房间中。全程仅使用本地路径，且为失败封闭模式（无付费回退机制）。\n\n**共识投票** — 智能体提出并投票表决决策。多数、超多数或全票通过——您可以选择相应的门槛。所有投票者（看守人和工蜂）拥有同等权重。默认情况下，平票将由女王的一票决定胜负。\n\n**目标** — 分层目标分解，并跟踪进展。设定一个顶层目标，让智能体自行将其拆解。\n\n**技能** — 可复用的智能体能力，具备激活上下文和版本管理功能。智能体能够不断学习与改进。\n\n**自我修改** — 智能体可以编辑自身的技能和文件，同时保留完整的审计日志，并支持一键回滚。\n\n**记忆** — 存储实体、观察结果及关系，并提供语义向量搜索（384 维嵌入）。知识可在不同会话间持久化。\n\n**钱包** — 支持多链的 EVM 钱包。可在 Base、以太坊、Arbitrum、Optimism 和 Polygon 上使用 USDC 和 USDT。密钥采用 AES-256-GCM 加密。同一地址可在所有链上使用，余额会在各网络间自动汇总。\n\n**链上身份** — 在 Base 上使用 ERC-8004 标准的智能体身份。房间可注册为链上智能体，具备可发现的元数据，并已准备好用于声誉系统。\n\n**群集运行时（云模式）** — 云房间会预置一台群集运行时主机。所有女王和工蜂的执行任务均在此运行；无需额外的执行路由层。\n\n**任务调度** — 支持周期性（cron）、一次性、按需触发，以及 **Webhook 触发** 的任务，具备会话连续性和自动提醒功能。\n\n**Webhooks** — HTTP 端点可用于从任何外部服务触发任务或唤醒女王。GitHub 提交、Stripe 支付、监控告警等——任何能够向 URL 发送 POST 请求的系统都可以驱动您的智能体。每个任务和每个房间都配备独立的令牌，请求频率限制为每分钟 30 次，且无需额外的身份验证配置，只需提供 URL 即可。\n\n**看守人控制模式** — 房间以看守人控制模式运行，提供完整的仪表板和 API 控制权限，分别针对智能体和用户令牌。云成员令牌为只读权限，并仅开放有限的协作接口（投票、解决\u002F回复、标记已读）。\n\n**公开房间** — 您可以在 [quoroom.io\u002Frooms](https:\u002F\u002Fquoroom.io\u002Frooms) 上将房间设为公开。实时房间统计数据和活动会显示在排行榜上。房间会向云端注册，并每 5 分钟发送一次心跳信号。浏览无需登录账号。\n\n**HTTP 服务器 + REST API** — 完整的 REST API，采用双令牌认证（智能体 + 用户），并支持 WebSocket 实时事件。云成员角色具有受限的协作访问权限。运行 `quoroom serve` 即可启动。\n\n**仪表板** — 基于 React 的 SPA 应用程序，直接由您本地的 Quoroom 服务器在 `http:\u002F\u002Flocalhost:3700`（或您配置的端口）提供服务。您可以通过浏览器管理房间、智能体、目标、记忆和钱包等，所有数据均优先存储在本地。\n\n**文员** — 仪表板中的全功能看守人助手。它可以在所有房间之间聊天，记住上下文和历史记录，主动行动，并执行管理操作（创建\u002F更新房间、任务、提醒和消息），同时实时播报群集活动情况。\n\n**云模式** — 您可以将应用部署到 quoroom.io 的云端，并远程控制您的房间。本地和云模式下使用相同的仪表板。云实例会自动检测其运行环境，支持基于 JWT 的身份验证，并通过 HTTPS 提供 UI 服务，严格遵守 CORS 规则。您可以在远程“设置”面板中连接您的模型提供商。\n\n**收件箱** — 房间可以向看守人和其他房间发送消息。跨房间通信支持回复线程。智能体可以向上级汇报决策、分享更新信息，或向邻近房间请求资源。\n\n**凭据** — 安全的凭据存储，用于存放 API 密钥和机密信息。智能体可在运行时列出并检索凭据，而不会在提示或日志中暴露原始值。\n\n**自动更新** — 更新行为取决于部署模式。在本地模式下，仪表板会显示更新控件（弹出窗口 + 设置栏），允许您手动下载和应用更新。而在云模式下，更新将由运行时自动管理，UI 中不再提供手动更新按钮。\n\n---\n\n## 架构\n\n```\n┌─────────────────────────────────────────────────┐\n│                    房间                          │\n│  ┌───────┐  ┌─────────┐  ┌──────────────────┐  │\n│  │ 女王  │  │ 工蜂    │  │   共识机制       │  │\n│  │(LLM 配置)│ │(LLM 配置)│  │ 提案 → 投票      │  │\n│  └───┬───┘  └────┬────┘  └──────────────────┘  │\n│      │           │                               │\n│  ┌───┴───────────┴───────────────────────────┐  │\n│  │              智能体循环                    │  │\n│  │  目标 · 技能 · 自我修改 · 记忆        │  │\n│  └───────────────────────────────────────────┘  │\n│                                                  │\n│  ┌────────┐  ┌──────────────┐  ┌────────────────┐  │\n│  │ 钱包   │  │ 群集运行时│  │ 任务调度器    │  │\n│  │(EVM)   │  │(本地\u002F云)   │  │cron\u002F一次性\u002Fhook  │  │\n│  └────────┘  └──────────────┘  └────────────────┘  │\n│                                                  │\n│  ┌──────────────────────────────────────────┐   │\n│  │  认证：智能体令牌 + 用户令牌 + 成员     │   │\n│  │  权限：智能体\u002F用户完全访问 · 成员受限访问│   │\n│  └──────────────────────────────────────────┘   │\n└────────────────────┬────────────────────────────┘\n                     │\n        ┌────────────┼────────────┐\n        │            │            │\n   MCP 服务器   HTTP\u002FREST    WebSocket\n    (stdio)    (端口 3700)   (实时)\n                     │\n              POST \u002Fapi\u002Fhooks\u002F\n              (webhooks — 无需认证)\n              task\u002F:token · queen\u002F:token\n                     │\n        ┌────────────┼────────────┐\n        │                         │\n ┌──────┴──────┐         ┌───────┴───────┐\n │  仪表板  │         │  云同步   │\n │ localhost   │         │ quoroom.io    │\n └─────────────┘         │  \u002Frooms 页面  │\n                          └───────────────┘\n```\n\n---\n\n## 安装\n\n### npm（推荐）\n\n```bash\nnpm install -g quoroom\n```\n\n### Homebrew（macOS）\n\n```bash\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n从 [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases) 下载。安装程序会自动将 `quoroom` 添加到您的 PATH 中。无需任何依赖项。安装程序仅捆绑了 Node.js v20 — 不包含任何第三方软件、工具栏或扩展。\n\n安装程序启动方式：\n- macOS `.pkg`：打开 `\u002FApplications\u002FQuoroom Server.app`\n- Windows `.exe`：开始菜单 -> Quoroom Server -> 打开 Quoroom Server\n\n| 平台 | 安装程序 | 归档文件 |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | `.pkg` | `.tar.gz` |\n| Linux x64 | `.deb` | `.tar.gz` |\n| Windows x64 (已签名) | `.exe` 安装程序 | `.zip` |\n\n\u003Cdetails>\n\u003Csummary>平台说明\u003C\u002Fsummary>\n\n**macOS**\n- 通用二进制（Apple Silicon + Intel）— 单个 `.pkg` 文件适用于两种架构\n- 原生菜单栏托盘应用（Swift）— 自动启动服务器，提供“打开仪表盘”\u002F“重启”\u002F“退出”功能\n- `.pkg` 文件已进行代码签名并获得 Apple 认证\n- 包含自动更新检查的 Shell 包装器（每 4 小时轮询一次 GitHub）和崩溃回滚机制（三次触发重置）\n- PATH：在启动时继承登录 Shell 的 PATH（`zsh -lic`），因此可以找到 Homebrew\u002FNVM 安装的命令行工具（`claude`、`codex`）\n\n**Windows**\n- 已签名的 `.exe` 安装程序（NSIS、SSL.com eSigner）\n- VBS 启动器 — 在无控制台窗口的情况下启动服务器\n- 通过注册表将 `quoroom` 添加到系统 PATH\n- PATH：在启动时添加 npm 全局前缀目录，以便找到全局安装的 `claude.cmd` \u002F `codex.cmd`\n- `.cmd` 包装器（npm 安装的命令行工具）会自动解析为底层的 `.js` 脚本，以绕过 cmd.exe 8191 字符的参数限制\n\n**Linux**\n- `.deb` 包（x64），安装路径为 `\u002Fusr\u002Flocal\u002Flib\u002Fquoroom`\n- 与 macOS 相同的 Shell 包装器和自动更新机制\n\n\u003C\u002Fdetails>\n\n### 卸载\n\n```bash\nquoroom uninstall\n```\n\n此命令会移除 Quoroom 二进制文件、所有数据和日志。在继续操作前会提示确认。\n\n---\n\n## 快速入门\n\n```bash\n# 启动 HTTP\u002FWebSocket API 服务器 + 仪表盘\nquoroom serve\n```\n\n如果您使用 macOS `.pkg` 或 Windows `.exe` 安装程序进行安装，也可以直接使用启动器应用程序或快捷方式，而无需通过命令行。\n\n首次运行时，`quoroom serve` 会自动在您已安装的所有 AI 编程工具中注册 Quoroom MCP 服务器（Claude Code、Claude Desktop、Codex、Cursor、Windsurf）。只需 **重新启动一次您的 AI 客户端** — 之后，所有 `mcp__quoroom__*` 工具都会在每次会话中自动可用。\n\n打开 **http:\u002F\u002Flocalhost:3700**（或终端中显示的端口）。仪表盘和 API 在本地运行，默认情况下您的房间数据会保留在您的设备上。\n\n> **仅 MCP 模式**（不启动 HTTP 服务器）：`quoroom mcp` 只启动 stdio MCP 传输，适用于脚本编写或测试。正常使用时，`quoroom serve` 就足够了。\n\n## Clerk\n\n**Clerk** 选项卡是您在整个本地系统中的全局助手（而非单个房间）。\n\n- Clerk 是一个完整的助手，不仅限于评论：它能够推理、记忆，并为守护者执行操作。\n- 配置路径：Free Local (`ollama:qwen3-coder:30b`)、Claude Code CLI (`claude`)、Codex CLI (`codex`)、OpenAI API (`openai:gpt-4o-mini`)、Anthropic API (`anthropic:claude-3-5-sonnet-latest`)、Gemini API (`gemini:gemini-2.5-flash`)。\n- 在 Clerk 设置中输入的 API 密钥会在保存前进行验证。\n- Clerk 可以回答问题并执行以下操作：房间生命周期管理、房间设置、任务创建、提醒、跨房间消息传递以及与守护者的沟通。\n- Clerk 还可以通过计划任务\u002F提醒和基于活动的评论主动采取行动。\n- Telegram 和 Email 是重要的 Clerk 控制渠道：请至少连接其中一个，以便 Clerk 始终能联系到您，持续发送提醒，并将这些对话存储在 Clerk 的记忆中。\n- 邮件回复尽可能保持线程化，Telegram 回复则是直接且实时的，便于快速控制。\n- 当房间运行时，Clerk 会通过 WebSocket 通道 `clerk` 实时推送评论流。\n\nClerk API 模型的 API 密钥解析顺序：\n\n1. 任何房间凭据（`openai_api_key`、`anthropic_api_key` 或 `gemini_api_key`）\n2. Clerk 保存的 API 密钥（`clerk_openai_api_key` \u002F `clerk_anthropic_api_key` \u002F `clerk_gemini_api_key`）\n3. 环境变量（`OPENAI_API_KEY` \u002F `ANTHROPIC_API_KEY` \u002F `GEMINI_API_KEY`）\n\n完整指南请参阅：[docs\u002FCLERK.md](docs\u002FCLERK.md)\n\n---\n\n## 所有工具\n\n房间引擎通过 stdio 暴露了一个 MCP 服务器。所有工具都使用 `quoroom_` 前缀。\n\n\u003Cdetails>\n\u003Csummary>完整工具参考（点击展开）\u003C\u002Fsummary>\n\n### 房间\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_create_room` | 创建一个新的自主代理集体 |\n| `quoroom_list_rooms` | 按状态列出房间 |\n| `quoroom_room_status` | 获取房间状态和摘要 |\n| `quoroom_room_activity` | 获取最近的房间活动 |\n| `quoroom_pause_room` | 暂停正在运行的房间 |\n| `quoroom_restart_room` | 重启暂停的房间 |\n| `quoroom_delete_room` | 删除房间 |\n| `quoroom_configure_room` | 更新房间配置 |\n\n### 委员会\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_propose` | 提出一项供委员会投票的提案 |\n| `quoroom_vote` | 对提案进行投票 |\n| `quoroom_list_decisions` | 列出委员会的决定 |\n| `quoroom_decision_detail` | 获取特定决定的详细信息 |\n\n### 目标\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_set_goal` | 设定房间的主要目标 |\n| `quoroom_create_subgoal` | 将目标分解为子目标 |\n| `quoroom_update_progress` | 记录进度观察 |\n| `quoroom_delegate_task` | 将任务委派给特定工作人员 |\n| `quoroom_complete_goal` | 标记目标已完成 |\n| `quoroom_abandon_goal` | 放弃目标 |\n| `quoroom_list_goals` | 列出房间的目标 |\n\n### 技能\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_create_skill` | 创建可重用的代理技能 |\n| `quoroom_edit_skill` | 更新技能（版本递增） |\n| `quoroom_list_skills` | 列出可用技能 |\n| `quoroom_activate_skill` | 激活技能 |\n| `quoroom_deactivate_skill` | 停用技能 |\n| `quoroom_delete_skill` | 删除技能 |\n\n### 自我修改\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_self_mod_edit` | 使用审计日志编辑技能或文件 |\n| `quoroom_self_mod_revert` | 根据审计 ID 撤销修改 |\n| `quoroom_self_mod_history` | 查看修改审计历史 |\n\n### 工人\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_create_worker` | 创建带有系统提示的命名代理 |\n| `quoroom_list_workers` | 列出所有工人 |\n| `quoroom_update_worker` | 更新工人的配置 |\n| `quoroom_delete_worker` | 删除工人 |\n| `quoroom_export_worker_prompts` | 将工人提示导出为 Markdown 文件 |\n| `quoroom_import_worker_prompts` | 从 Markdown 文件导入工人提示 |\n\n#### 工人提示 Markdown 同步\n\n- 运行时的事实来源保存在 SQLite 数据库中（`workers.system_prompt`）。\n- Markdown 同步是显式的（无后台监视器）：可通过工人 UI、HTTP API 或 MCP 工具进行导出\u002F导入。\n- 默认路径：`.quoroom\u002Fprompts\u002Fworkers\u002Froom-\u003CroomId|global>\u002Fworker-\u003CworkerId>.md`。\n- 文件格式：YAML 前置元数据 + Markdown 正文（正文将成为完整的系统提示）。\n- 冲突策略：除非在导入\u002F导出时传递 `force=true`，否则以最新修改时间为准。\n\n### 任务调度\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_schedule` | 创建定期（cron）、一次性、按需或 Webhook 触发的任务 |\n| `quoroom_webhook_url` | 获取或生成任务或房间的 Webhook URL |\n| `quoroom_list_tasks` | 按状态列出任务 |\n| `quoroom_run_task` | 立即执行任务 |\n| `quoroom_task_progress` | 查看正在运行的任务进度 |\n| `quoroom_task_history` | 查看任务运行历史 |\n| `quoroom_pause_task` | 暂停计划任务 |\n| `quoroom_resume_task` | 恢复暂停的任务 |\n| `quoroom_delete_task` | 删除任务 |\n| `quoroom_reset_session` | 清除任务的会话连续性 |\n\n### 记忆\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_remember` | 存储事实、偏好、人物、事件 |\n| `quoroom_recall` | 对记忆进行语义和全文搜索 |\n| `quoroom_forget` | 删除一条记忆 |\n| `quoroom_memory_list` | 列出所有记忆 |\n\n### 钱包\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_wallet_create` | 创建 EVM 钱包（多链） |\n| `quoroom_wallet_address` | 获取钱包地址 |\n| `quoroom_wallet_balance` | 查询链上余额（USDC\u002FUSDT，所有链） |\n| `quoroom_wallet_send` | 在任何支持的链上发送 USDC 或 USDT |\n| `quoroom_wallet_history` | 查看交易历史 |\n| `quoroom_wallet_topup` | 获取钱包充值 URL |\n\n### 身份\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_identity_register` | 将房间注册为 ERC-8004 链上代理 |\n| `quoroom_identity_get` | 获取链上身份信息（agentId、注册表、URI） |\n| `quoroom_identity_update` | 更新链上注册元数据 |\n\n### 收件箱\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_send_message` | 向守护者或其他工人发送消息 |\n| `quoroom_inbox_send_room` | 向其他房间发送消息 |\n| `quoroom_inbox_list` | 列出收件箱消息 |\n| `quoroom_inbox_reply` | 回复房间消息 |\n\n### 邀请\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_invite_create` | 为您的房间创建邀请链接 |\n| `quoroom_invite_list` | 列出邀请链接及其使用情况 |\n| `quoroom_invite_network` | 查看您邀请网络中的房间 |\n\n### 凭证\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_credentials_list` | 列出已存储的凭证 |\n| `quoroom_credentials_get` | 获取凭证值 |\n\n### 资源\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_resources_get` | 获取本地系统资源（CPU、内存、磁盘） |\n\n### 浏览器\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_browser` | 控制无头浏览器，用于多步骤的网页流程 |\n\n### 半成品\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_save_wip` | 保存正在进行的工作上下文，以便稍后继续 |\n\n### 设置\n\n| 工具 | 描述 |\n|------|-------------|\n| `quoroom_get_setting` | 获取设置值 |\n| `quoroom_set_setting` | 更新设置 |\n\n\u003C\u002Fdetails>\n\n## 开发\n\n```bash\nnpm install              # 安装依赖\nnpm run build            # 类型检查 + 打包 MCP 服务器 + 构建 UI\nnpm run build:mcp        # 仅打包 MCP 服务器（esbuild）\nnpm run build:ui         # 仅构建 UI 单页应用（Vite）\nnpm run dev              # 仅本地开发（链接 + 房间）\nnpm run dev:with-cloud   # 本地开发 + 云端（需要 ..\u002Fcloud）\nnpm run dev:isolated     # 隔离的本地开发（房间 :4700 + UI，无云端）\nnpm run dev:isolated:with-cloud # 隔离的本地开发 + 云端\nnpm run dev:cloud        # 仅云端（在 :3715 上运行 ..\u002Fcloud）\nnpm run dev:ui           # 带有热重载的 UI 开发服务器\nnpm run typecheck        # 仅进行类型检查（tsc --noEmit）\nnpm test                 # 运行所有测试（vitest，进程池）\nnpm run test:watch       # 监视模式\nnpm run test:e2e         # 端到端测试（Playwright）\n\n# Windows\nnpm run dev:win              # 仅本地开发（与 npm run dev 相同）\nnpm run dev:with-cloud:win   # 本地开发 + 云端（需要 ..\u002Fcloud）\nnpm run dev:isolated:win    # Windows 版本的 dev:isolated\nnpm run dev:isolated:with-cloud:win # Windows 隔离版 + 云端\nnpm run build:windows:local # 本地 Windows 构建（PowerShell）\n```\n\n### Docker（云运行时）\n\n```bash\ndocker build -t quoroom .\ndocker run -p 3700:3700 quoroom\n```\n\n### 云运行时自动更新诊断\n\n云运行时现在更倾向于使用集中式更新源，并在状态中暴露诊断信息：\n\n- `QUOROOM_UPDATE_SOURCE_URL` — 最新运行时发布元数据的云端点（首选源）\n- `QUOROOM_UPDATE_SOURCE_TOKEN` — 可选的更新源认证令牌\n- `QUOROOM_UPDATE_GITHUB_TOKEN` — 当需要直接回退时使用的可选 GitHub 令牌\n\n`GET \u002Fapi\u002Fstatus` 包含 `updateDiagnostics`：\n\n- `lastCheckAt`、`lastSuccessAt`、`lastErrorAt`\n- `lastErrorCode`、`lastErrorMessage`\n- `updateSource`（`cloud` 或 `github`）\n- `nextCheckAt`、`consecutiveFailures`（退避可见性）\n\n## 发布\n\n通过推送 Git 标签（`v*`）触发 → GitHub Actions 多平台构建：\n\n- **macOS**: 通用 `.pkg` 安装包（ARM64 + x64，通过 `lipo` 打包），Swift 系统托盘应用编译、代码签名并经 Apple 认证\n- **Windows**: NSIS `.exe` 安装程序，使用 SSL.com eSigner 签名\n- **Linux**: 使用 `fpm` 构建的 `.deb` 包\n- 所有平台均打包 Node.js 运行时环境（无系统依赖），支持自动更新和崩溃回滚\n- 构建完成后：GitHub Release → npm 发布 → Homebrew tap 更新\n\n\u003Cdetails>\n\u003Csummary>项目结构\u003C\u002Fsummary>\n\n```\nroom\u002F\n├── src\u002F\n│   ├── cli\u002F               # CLI 入口点（quoroom 命令）\n│   ├── mcp\u002F               # MCP 服务器（标准输入输出）\n│   │   ├── server.ts      # 工具注册\n│   │   ├── db.ts          # 数据库初始化\n│   │   └── tools\u002F         # 19 个工具模块\n│   ├── server\u002F            # HTTP\u002FWebSocket API 服务器\n│   │   ├── index.ts       # 服务器启动逻辑（本地 + 云模式）\n│   │   ├── router.ts      # 请求路由\n│   │   ├── auth.ts        # 双令牌认证 + CORS + 云 JWT\n│   │   ├── access.ts      # 基于角色的访问控制\n│   │   ├── webhooks.ts    # Webhook 接收器（无认证令牌端点）\n│   │   ├── ws.ts          # WebSocket 实时事件\n│   │   └── routes\u002F        # REST API 路由（19 个模块）\n│   ├── ui\u002F                # React 单页应用仪表板\n│   │   ├── App.tsx        # 根组件\n│   │   ├── components\u002F    # UI 组件（32 个模块）\n│   │   ├── hooks\u002F         # React 钩子\n│   │   └── lib\u002F           # API 客户端、认证、存储、WebSocket\n│   └── shared\u002F            # 核心引擎\n│       ├── agent-loop.ts       # 带限流的工作者代理循环\n│       ├── agent-executor.ts   # Claude Code CLI 执行\n│       ├── room.ts             # 房间生命周期\n│       ├── quorum.ts           # 投票与决策\n│       ├── goals.ts            # 目标分解\n│       ├── skills.ts           # 技能管理\n│       ├── wallet.ts           # EVM 钱包（多链，USDC\u002FUSDT）\n│       ├── identity.ts         # ERC-8004 链上身份\n│       ├── task-runner.ts      # 任务执行引擎\n│       ├── model-provider.ts   # 多模型 LLM 支持\n│       ├── cloud-sync.ts       # 云注册 + 心跳检测\n│       ├── db-queries.ts       # 数据库查询层\n│       ├── schema.ts           # SQLite 模式（WAL 模式）\n│       ├── embeddings.ts       # 向量嵌入（all-MiniLM-L6-v2）\n│       └── __tests__\u002F          # 测试套件（907 个测试）\n├── e2e\u002F                    # Playwright 端到端测试\n├── installers\u002F\n│   ├── macos\u002F             # Swift 系统托盘应用（QuoroomTray.swift）\n│   └── windows\u002F           # NSIS 安装程序 + PowerShell\u002FVBS 脚本\n├── scripts\u002F\n│   └── build-mcp.js       # esbuild 打包\n├── Dockerfile              # 云运行时镜像\n└── docs\u002F                   # 媒体资源 + 架构文档\n```\n\n**技术栈**: TypeScript（严格模式）、React、Tailwind CSS、better-sqlite3、sqlite-vec、viem、MCP SDK、HuggingFace Transformers、node-cron、zod、esbuild、Vite、Vitest\n\n\u003C\u002Fdetails>\n\n## 模型提供商\n\n包含免费的本地模型。如需使用云端模型，请提供 API 密钥。\n\n| 模型字符串 | 提供商 | 执行方式 | 需要条件 |\n|---|---|---|---|\n| `ollama:qwen3-coder:30b` | Ollama 本地运行时 | 本地 HTTP (`127.0.0.1:11434`) | 本地部署模式、macOS\u002FWindows 兼容性检查、Ollama 运行时及已拉取的模型 |\n| `claude`（默认） | Claude Code CLI | 启动 CLI 进程 | 已安装 [Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code) |\n| `codex` | OpenAI Codex CLI | 启动 CLI 进程 | `npm i -g @openai\u002Fcodex` |\n| `openai:gpt-4o-mini` | OpenAI API | HTTP REST | 设置 `OPENAI_API_KEY` |\n| `anthropic:claude-3-5-sonnet-latest` | Anthropic API | HTTP REST | 设置 `ANTHROPIC_API_KEY` |\n| `gemini:gemini-2.5-flash` | Gemini API | HTTP REST | 设置 `GEMINI_API_KEY` |\n\n**免费本地模型**（`ollama:qwen3-coder:30b`）— 仅限本地模式，通过 Ollama 的 OpenAI 兼容端点运行。使用固定模型标签，无需 API 密钥，并配备失败关闭的运行时检查机制（若 Ollama 或模型不可用，代理将停止运行并抛出可操作错误）。\n\n**CLI 模型**（`claude`、`codex`）— 通过 CLI 实现完整的代理循环及工具调用。可通过 `--resume` 参数保持会话连续性。在 Windows 上，`.cmd` 包装脚本会自动解析为底层的 `.js` 脚本，以绕过 cmd.exe 对命令行参数长度 8191 字符的限制。\n\n**API 模型**（`openai:*`、`anthropic:*`、`gemini:*`）— 直接进行 HTTP 调用，支持多轮工具调用循环。API 密钥优先级顺序为：房间凭据 → Clerk 保存的密钥 → 环境变量。`anthropic:*` 也接受 `claude-api:` 前缀。`gemini:*` 使用 Google 提供的 OpenAI 兼容端点。\n\n工作者默认继承女王的模型，也可选择单独指定模型（API 或免费本地模型）。\n\n## 许可证\n\nMIT 许可证。详情请参阅 [LICENSE](LICENSE) 文件。","# Quoroom 快速上手指南\n\nQuoroom 是一个开源的自主智能体集群（Swarm Intelligence）研究项目。它允许你运行由\"Queen\"（战略大脑）、\"Workers\"（执行者）和\"Quorum\"（投票决策机制）组成的智能体集体，实现目标的自主分解、执行与自我进化。\n\n## 环境准备\n\n### 系统要求\n支持以下主流操作系统：\n- **macOS**: Apple Silicon (M1\u002FM2\u002FM3) 或 Intel 芯片\n- **Windows**: x64 架构 (Windows 10\u002F11)\n- **Linux**: x64 架构 (推荐 Debian\u002FUbuntu 系列)\n\n### 前置依赖\n- **Node.js**: 安装包已内置 Node.js v20，通常无需单独安装。若使用 npm 安装，请确保本地 Node.js 版本 >= 20。\n- **可选模型后端**:\n  - **本地运行**: 推荐安装 [Ollama](https:\u002F\u002Follama.com) 以免费运行本地模型（如 `qwen3-coder:30b`）。\n  - **云端 API**: 若使用 Claude、OpenAI 或 Gemini，需准备好相应的 API Key。\n\n> **注意**：国内开发者若访问 GitHub 或 npm 较慢，建议配置国内镜像源（如淘宝 npm 镜像）或使用代理加速下载。\n\n## 安装步骤\n\n你可以选择以下任意一种方式进行安装：\n\n### 方式一：通过 npm 安装（推荐）\n适用于已配置 Node.js 环境的开发者。\n\n```bash\nnpm install -g quoroom\n```\n\n### 方式二：通过 Homebrew 安装（仅限 macOS）\n\n```bash\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 方式三：下载安装包\n访问 [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Flatest) 下载对应系统的安装包：\n- **macOS**: 下载 `.pkg` 文件，双击安装后在“应用程序”中找到 `Quoroom Server.app` 启动。\n- **Windows**: 下载 `.exe` 安装程序，运行后在开始菜单找到 `Quoroom Server` 启动。\n- **Linux**: 下载 `.deb` 包并使用 `sudo dpkg -i \u003C文件名>.deb` 安装。\n\n> 安装包已自动将 `quoroom` 命令加入系统 PATH，安装完成后直接在终端即可使用。\n\n## 基本使用\n\n### 1. 启动服务\n在终端输入以下命令启动 Quoroom 本地服务器：\n\n```bash\nquoroom serve\n```\n\n启动成功后，默认会在 `http:\u002F\u002Flocalhost:3700` 运行仪表板（Dashboard）。\n\n### 2. 访问仪表板\n打开浏览器访问 `http:\u002F\u002Flocalhost:3700`。\n- **创建房间 (Room)**：点击新建，配置你的智能体集群。\n- **配置模型**：\n  - **本地模式**：选择 Ollama，一键拉取 `qwen3-coder:30b` 模型。\n  - **云端模式**：输入 OpenAI\u002FClaude 等 API Key。\n- **设定目标 (Goals)**：输入顶层目标，Queen 智能体将自动分解任务并调度 Workers 执行。\n\n### 3. 使用 CLI 创建房间（命令行示例）\n你也可以直接通过命令行创建一个名为 \"my-swarm\" 的房间：\n\n```bash\nquoroom room create my-swarm --model ollama:qwen3-coder:30b\n```\n\n### 4. 核心功能体验\n- **观察集群决策**：在仪表板查看 Quorum 投票过程，智能体将通过多数决机制决定行动。\n- **技能自我进化**：智能体在执行过程中会自动修改和优化自身的技能代码，所有变更均有审计记录并可一键回滚。\n- **钱包集成**：在设置中连接 EVM 钱包（支持 Base, Ethereum 等链），用于链上身份注册及未来的自主支付场景。\n\n### 5. 停止服务\n在运行 `quoroom serve` 的终端按 `Ctrl+C` 即可停止服务。若使用桌面启动器，可通过菜单栏选择 \"Quit\"。","一位独立开发者试图在有限预算下，构建一个能自动监控市场动态、编写交易策略并执行回测的复杂量化系统。\n\n### 没有 room 时\n- **单点智能瓶颈**：仅靠单个 AI 助手难以同时兼顾宏观策略制定、代码细节实现与风险合规审查，导致方案顾此失彼。\n- **协作流程断裂**：需要人工在不同对话窗口间反复复制粘贴上下文，手动协调“分析”与“编码”步骤，效率极低且易出错。\n- **决策缺乏制衡**：生成的交易逻辑往往未经多方验证就直接运行，缺乏类似“投票机制”的纠错环节，容易因幻觉导致资金损失。\n- **持续执行困难**：无法让 AI 团队在本地全天候自主运行，一旦断开连接或遇到报错，整个自动化流程即刻中断。\n\n### 使用 room 后\n- **群体智慧分工**：room 自动组建包含\"Queen\"（战略大脑）、\"Workers\"（执行专家）和\"Quorum\"（投票评审）的自治蜂群，各司其职又紧密协作。\n- **自主闭环流转**：Queen 拆解目标后，Workers 自动获取技能并编写代码，Quorum 对关键决策进行投票表决，无需人工干预即可在本地完成从构思到回测的全流程。\n- **动态纠错机制**：通过法定人数投票（Quorum Voting）机制，系统能自动识别并否决高风险或低质量的策略提案，显著降低误操作概率。\n- **持久化无人值守**：基于 MCP 协议在本地持续运行，即使面对长时间的市场数据流，room 也能自我调度任务、修正行为并确保持续产出。\n\nroom 将孤立的 AI 对话升级为具备自我治理、持续执行与集体决策能力的本地智能蜂群，让复杂系统的自动化构建变得安全且高效。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fquoroom-ai_room_f932a3b7.png","quoroom-ai","Quoroom.ai","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fquoroom-ai_0d540714.png","",null,"https:\u002F\u002Fquoroom.ai","https:\u002F\u002Fgithub.com\u002Fquoroom-ai",[81,85,89,93,97,100,104,108,111],{"name":82,"color":83,"percentage":84},"TypeScript","#3178c6",87,{"name":86,"color":87,"percentage":88},"JavaScript","#f1e05a",11,{"name":90,"color":91,"percentage":92},"PowerShell","#012456",0.8,{"name":94,"color":95,"percentage":96},"Swift","#F05138",0.4,{"name":98,"color":77,"percentage":99},"NSIS",0.3,{"name":101,"color":102,"percentage":103},"CSS","#663399",0.2,{"name":105,"color":106,"percentage":107},"Shell","#89e051",0.1,{"name":109,"color":110,"percentage":107},"HTML","#e34c26",{"name":112,"color":113,"percentage":114},"Dockerfile","#384d54",0,694,23,"2026-04-16T05:41:02","MIT","Linux, macOS, Windows","未说明 (支持本地运行 Ollama，具体 GPU 需求取决于所选模型，如 qwen3-coder:30b)","未说明",{"notes":123,"python":124,"dependencies":125},"该工具主要基于 Node.js 运行，安装程序已捆绑 Node.js v20，无需额外依赖。若使用本地免费模型，需安装 Ollama 并拉取 qwen3-coder:30b 模型。支持 macOS (Apple Silicon + Intel)、Linux x64 和 Windows x64。","未说明 (安装包内置 Node.js v20，无需单独安装 Python)",[126,127],"Node.js v20 (内置)","ollama (可选，用于本地模型)",[14,45,15,35,13],[130,131,132,133,134,135,136,6,137,138],"ai","automaton","claude","claudecode","linux","llm","macos","windows","giminiapi","2026-03-27T02:49:30.150509","2026-04-17T08:25:37.864841",[],[143,148,153,158,163,168,173,178,183,188,193,198,203,208,213,218,223,228,233,238],{"id":144,"version":145,"summary_zh":146,"released_at":147},289164,"v0.1.42","## 新增内容\n\n- 版本 0.1.42：强化更新重启流程，防止设置界面和更新模态框卡住。\n- 稳定更新重启的用户体验以及各设置流程中的房间运行时控制功能。\n- 修复 Docker 工作流中运行时收敛检查脚本的解析问题。\n- 在临时 API 超时时重试云端运行时收敛检查。\n\n## 安装\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n安装程序会自动将 `quoroom` 添加到您的 PATH 中。无需其他依赖。\n\n| 平台 | 安装程序 | 归档文件 |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.42\u002Fquoroom-v0.1.42-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.42\u002Fquoroom-v0.1.42-darwin-universal.tar.gz) |\n| Linux x64 | [.deb 包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.42\u002Fquoroom_0.1.42_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.42\u002Fquoroom-v0.1.42-linux-x64.tar.gz) |\n| Windows x64 (已签名) | [.exe 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.42\u002Fquoroom-v0.1.42-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.42\u002Fquoroom-v0.1.42-win-x64.zip) |\n","2026-03-02T03:07:06",{"id":149,"version":150,"summary_zh":151,"released_at":152},289165,"v0.1.41","## 新增功能\n\n- 移除站点界面，并强制实施可验证的云端运行时更新发布。\n\n## 安装\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n安装程序会自动将 `quoroom` 添加到您的 PATH 中。无需其他依赖。\n\n| 平台 | 安装程序 | 归档文件 |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.41\u002Fquoroom-v0.1.41-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.41\u002Fquoroom-v0.1.41-darwin-universal.tar.gz) |\n| Linux x64 | [.deb 包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.41\u002Fquoroom_0.1.41_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.41\u002Fquoroom-v0.1.41-linux-x64.tar.gz) |\n| Windows x64 (已签名) | [.exe 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.41\u002Fquoroom-v0.1.41-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.41\u002Fquoroom-v0.1.41-win-x64.zip) |\n","2026-03-01T23:35:23",{"id":154,"version":155,"summary_zh":156,"released_at":157},289166,"v0.1.40","## 新增内容\n\n- 通过将 HuggingFace 缓存重定向到用户主目录，修复 Windows 系统全局安装时的 EPERM 错误\n- 将默认的 Queen 最大回合数提高到 50，并迁移旧版房间\n- 启用云端运行时自动更新，并移除手动云端更新界面\n\n## 安装\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n安装程序会自动将 `quoroom` 添加到您的 PATH 中。无需额外依赖。\n\n| 平台 | 安装程序 | 归档文件 |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg 安装包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.40\u002Fquoroom-v0.1.40-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.40\u002Fquoroom-v0.1.40-darwin-universal.tar.gz) |\n| Linux x64 | [.deb 包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.40\u002Fquoroom_0.1.40_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.40\u002Fquoroom-v0.1.40-linux-x64.tar.gz) |\n| Windows x64 (已签名) | [.exe 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.40\u002Fquoroom-v0.1.40-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.40\u002Fquoroom-v0.1.40-win-x64.zip) |","2026-03-01T22:12:53",{"id":159,"version":160,"summary_zh":161,"released_at":162},289167,"v0.1.39","## 新增内容\n\n- 发布 0.1.39 版本，引入严格的显式模型选择机制，并取消运行时回退行为。\n- 强制执行显式模型解析，确保 Queen 和 Worker 不会无声地回退到其他模型。\n- 在 Queen 和 Worker 冷启动之前，强制要求手动启动房间。\n\n## 安装\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n安装程序会自动将 `quoroom` 添加到您的 PATH 中。无需额外依赖。\n\n| 平台 | 安装程序 | 归档文件 |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg 安装包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.39\u002Fquoroom-v0.1.39-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.39\u002Fquoroom-v0.1.39-darwin-universal.tar.gz) |\n| Linux x64 | [.deb 包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.39\u002Fquoroom_0.1.39_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.39\u002Fquoroom-v0.1.39-linux-x64.tar.gz) |\n| Windows x64 (已签名) | [.exe 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.39\u002Fquoroom-v0.1.39-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.39\u002Fquoroom-v0.1.39-win-x64.zip) |\n","2026-03-01T03:14:48",{"id":164,"version":165,"summary_zh":166,"released_at":167},289168,"v0.1.38","## 新功能\n\n- 将开发启动脚本从云端分离，并添加明确的“带云”脚本\n- 修复（Windows 桌面通知）：强化停止操作的验证机制，并引入 WMIC 回退方案\n\n## 安装\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n安装程序会自动将 `quoroom` 添加到您的 PATH 环境变量中，无需额外依赖。\n\n| 平台 | 安装程序 | 归档文件 |\n|------|-----------|----------|\n| macOS（Apple Silicon + Intel） | [.pkg 安装包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.38\u002Fquoroom-v0.1.38-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.38\u002Fquoroom-v0.1.38-darwin-universal.tar.gz) |\n| Linux x64 | [.deb 包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.38\u002Fquoroom_0.1.38_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.38\u002Fquoroom-v0.1.38-linux-x64.tar.gz) |\n| Windows x64（已签名） | [.exe 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.38\u002Fquoroom-v0.1.38-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.38\u002Fquoroom-v0.1.38-win-x64.zip) |","2026-03-01T01:19:14",{"id":169,"version":170,"summary_zh":171,"released_at":172},289169,"v0.1.37","## 新功能\n\n- 修复（UI）：清除旧版 PWA 缓存，以防止 UI 显示过时内容  \n- 修复（UI）：强制启用 no-cache，并移除 PWA\u002F安装界面  \n\n## 安装\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n安装程序会自动将 `quoroom` 添加到您的 PATH 环境变量中。无需额外依赖。\n\n| 平台 | 安装程序 | 压缩包 |\n|------|-----------|--------|\n| macOS（Apple Silicon + Intel） | [.pkg 安装包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.37\u002Fquoroom-v0.1.37-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.37\u002Fquoroom-v0.1.37-darwin-universal.tar.gz) |\n| Linux x64 | [.deb 包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.37\u002Fquoroom_0.1.37_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.37\u002Fquoroom-v0.1.37-linux-x64.tar.gz) |\n| Windows x64（已签名） | [.exe 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.37\u002Fquoroom-v0.1.37-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.37\u002Fquoroom-v0.1.37-win-x64.zip) |","2026-03-01T00:00:52",{"id":174,"version":175,"summary_zh":176,"released_at":177},289170,"v0.1.36","## 新功能\n\n- 修复：恢复发布流程，并使端到端测试与当前房间 UI 对齐\n- 修复（更新）：优先使用捆绑的 UI，除非缓存的更新版本更新\n\n## 安装\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n安装程序会自动将 `quoroom` 添加到您的 PATH 环境变量中。无需任何依赖。\n\n| 平台 | 安装程序 | 压缩包 |\n|------|-----------|--------|\n| macOS（Apple Silicon + Intel） | [.pkg 安装包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.36\u002Fquoroom-v0.1.36-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.36\u002Fquoroom-v0.1.36-darwin-universal.tar.gz) |\n| Linux x64 | [.deb 包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.36\u002Fquoroom_0.1.36_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.36\u002Fquoroom-v0.1.36-linux-x64.tar.gz) |\n| Windows x64（已签名） | [.exe 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.36\u002Fquoroom-v0.1.36-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.36\u002Fquoroom-v0.1.36-win-x64.zip) |","2026-02-28T22:20:06",{"id":179,"version":180,"summary_zh":181,"released_at":182},289171,"v0.1.35","## 新功能\n\n- 修复：改进本地运行时进程清理，适用于所有托盘启动器（0.1.35）\n- 修复：通过清理孤立的 quoroom 进程来增强托盘重启的安全性\n- 新增功能：为本地用户在 Telegram 欢迎页面添加 RU\u002FEN 版 Keeper 群组链接\n- 新增功能（云端）：在云端模式下隐藏 PWA 安装按钮和横幅\n- 新增功能：网关站仅可租用至云端实例\n- 新增功能：将点云 API 和应用 URL 指向 quoroom.io\n- 跟踪：将 X 像素 ID 更改为 r6f8j\n- 新增功能（合规）：在 README 中添加“不捆绑”说明，并优化 package.json 的描述以提高安全性\n- 修复（复制）：移除模板、演示和 README 中的所有政策风险相关表述\n- 修复（复制）：移除占位符、模板和 README 中的所有金钱相关表述\n- 维护任务：强制刷新横幅缓存\n- 维护任务：在 README 中进行横幅缓存失效操作\n- 维护任务：替换横幅——移除所有与金钱相关的表述\n\n## 安装\n\n```\nnpm install -g quoroom\n```\n\n### macOS（Homebrew）\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n安装程序会自动将 `quoroom` 添加到您的 PATH 环境变量中。无需任何依赖。\n\n| 平台 | 安装程序 | 归档文件 |\n|------|-----------|----------|\n| macOS（Apple Silicon + Intel） | [.pkg 安装包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.35\u002Fquoroom-v0.1.35-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.35\u002Fquoroom-v0.1.35-darwin-universal.tar.gz) |\n| Linux x64 | [.deb 包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.35\u002Fquoroom_0.1.35_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.35\u002Fquoroom-v0.1.35-linux-x64.tar.gz) |\n| Windows x64（已签名） | [.exe 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.35\u002Fquoroom-v0.1.35-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.35\u002Fquoroom-v0.1.35-win-x64.zip) |","2026-02-28T20:54:03",{"id":184,"version":185,"summary_zh":186,"released_at":187},289172,"v0.1.34","## 新功能\n\n本次发布重点在于简化核心运行时与控制流，降低复杂性。\n\n- 简化 Keeper 控制模型：移除了自动模式，并将执行方式统一为半控制模式。\n- 通过移除非必要的聊天、结果和观看流程及相关代码路径，减少了未使用的产品表面。\n- 强化运行时生命周期：房间\u002F服务器的停止与重启现在能够可靠地终止已启动的运行时子会话。\n- 保持 Clerk 在重启后的连续性（会话仍被持久化；仅重置清除的行为保持不变）。\n- 修复 macOS 发布的可靠性问题：pkg 签名现强制使用可信时间戳，且 CI 在发布前会验证签名的有效性。\n\n## 为何推出此版本\n\n目标是提升操作清晰度：减少活动部件、降低隐藏状态，并使房间\u002F女王的行为更加可预测。\n\n## 安装\n\n```bash\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```bash\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n安装程序会自动将 `quoroom` 添加到您的 PATH 中。无需任何依赖。\n\n| 平台 | 安装程序 | 压缩包 |\n|------|----------|--------|\n| macOS（Apple Silicon + Intel） | [.pkg 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.34\u002Fquoroom-v0.1.34-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.34\u002Fquoroom-v0.1.34-darwin-universal.tar.gz) |\n| Linux x64 | [.deb 包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.34\u002Fquoroom_0.1.34_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.34\u002Fquoroom-v0.1.34-linux-x64.tar.gz) |\n| Windows x64（已签名） | [.exe 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.34\u002Fquoroom-v0.1.34-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.34\u002Fquoroom-v0.1.34-win-x64.zip) |","2026-02-27T06:00:41",{"id":189,"version":190,"summary_zh":191,"released_at":192},289173,"v0.1.32","## 新功能\n\n- 特性：重新调整围绕群组执行的公共信息传达\n- 任务（复制）：将房间消息传递方式调整为群组执行模式\n- 修复（运行时）：在确保店员服务连续性的前提下，强制终止服务器子会话\n- 重构：移除聊天与观看界面，并强化半控制机制\n- 重构法定人数流程，使其基于已宣布的决策，并简化目标用户界面\n- 修复：在发布任务中获取完整的 Git 历史记录，以生成准确的变更日志\n\n## 安装\n\n```\nnpm install -g quoroom\n```\n\n### macOS（Homebrew）\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### 下载\n\n安装程序会自动将 `quoroom` 添加到您的 PATH 环境变量中。无需任何依赖。\n\n| 平台 | 安装程序 | 归档文件 |\n|------|-----------|----------|\n| macOS（Apple Silicon + Intel） | [.pkg 安装包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.32\u002Fquoroom-v0.1.32-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.32\u002Fquoroom-v0.1.32-darwin-universal.tar.gz) |\n| Linux x64 | [.deb 包](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.32\u002Fquoroom_0.1.32_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.32\u002Fquoroom-v0.1.32-linux-x64.tar.gz) |\n| Windows x64（已签名） | [.exe 安装程序](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.32\u002Fquoroom-v0.1.32-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.32\u002Fquoroom-v0.1.32-win-x64.zip) |","2026-02-27T03:44:20",{"id":194,"version":195,"summary_zh":196,"released_at":197},289174,"v0.1.31","## What's new\n\n- feat: uninterrupted agent cycles with WIP system for forward momentum\n- feat: add local mode banner, dismissible early banner, and E2E video demo service\n\n## Install\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nInstallers add `quoroom` to your PATH automatically. No dependencies needed.\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.31\u002Fquoroom-v0.1.31-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.31\u002Fquoroom-v0.1.31-darwin-universal.tar.gz) |\n| Linux x64 | [.deb package](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.31\u002Fquoroom_0.1.31_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.31\u002Fquoroom-v0.1.31-linux-x64.tar.gz) |\n| Windows x64 (signed) | [.exe installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.31\u002Fquoroom-v0.1.31-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.31\u002Fquoroom-v0.1.31-win-x64.zip) |","2026-02-26T19:33:08",{"id":199,"version":200,"summary_zh":201,"released_at":202},289175,"v0.1.30","## What's new\n\n- Bug fixes and improvements\n\n## Install\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nInstallers add `quoroom` to your PATH automatically. No dependencies needed.\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.30\u002Fquoroom-v0.1.30-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.30\u002Fquoroom-v0.1.30-darwin-universal.tar.gz) |\n| Linux x64 | [.deb package](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.30\u002Fquoroom_0.1.30_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.30\u002Fquoroom-v0.1.30-linux-x64.tar.gz) |\n| Windows x64 (signed) | [.exe installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.30\u002Fquoroom-v0.1.30-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.30\u002Fquoroom-v0.1.30-win-x64.zip) |\n","2026-02-25T22:44:33",{"id":204,"version":205,"summary_zh":206,"released_at":207},289176,"v0.1.29","## What's new\n\n- Bug fixes and improvements\n\n## Install\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nInstallers add `quoroom` to your PATH automatically. No dependencies needed.\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.29\u002Fquoroom-v0.1.29-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.29\u002Fquoroom-v0.1.29-darwin-universal.tar.gz) |\n| Linux x64 | [.deb package](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.29\u002Fquoroom_0.1.29_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.29\u002Fquoroom-v0.1.29-linux-x64.tar.gz) |\n| Windows x64 (signed) | [.exe installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.29\u002Fquoroom-v0.1.29-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.29\u002Fquoroom-v0.1.29-win-x64.zip) |\n","2026-02-25T15:57:10",{"id":209,"version":210,"summary_zh":211,"released_at":212},289177,"v0.1.28","## What's new\n\n- Bug fixes and improvements\n\n## Install\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nInstallers add `quoroom` to your PATH automatically. No dependencies needed.\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.28\u002Fquoroom-v0.1.28-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.28\u002Fquoroom-v0.1.28-darwin-universal.tar.gz) |\n| Linux x64 | [.deb package](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.28\u002Fquoroom_0.1.28_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.28\u002Fquoroom-v0.1.28-linux-x64.tar.gz) |\n| Windows x64 (signed) | [.exe installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.28\u002Fquoroom-v0.1.28-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.28\u002Fquoroom-v0.1.28-win-x64.zip) |\n","2026-02-25T15:09:47",{"id":214,"version":215,"summary_zh":216,"released_at":217},289178,"v0.1.27","## What's new\n\n- Bug fixes and improvements\n\n## Install\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nInstallers add `quoroom` to your PATH automatically. No dependencies needed.\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.27\u002Fquoroom-v0.1.27-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.27\u002Fquoroom-v0.1.27-darwin-universal.tar.gz) |\n| Linux x64 | [.deb package](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.27\u002Fquoroom_0.1.27_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.27\u002Fquoroom-v0.1.27-linux-x64.tar.gz) |\n| Windows x64 (signed) | [.exe installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.27\u002Fquoroom-v0.1.27-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.27\u002Fquoroom-v0.1.27-win-x64.zip) |\n","2026-02-25T07:58:10",{"id":219,"version":220,"summary_zh":221,"released_at":222},289179,"v0.1.26","## What's new\n\n- Bug fixes and improvements\n\n## Install\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nInstallers add `quoroom` to your PATH automatically. No dependencies needed.\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.26\u002Fquoroom-v0.1.26-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.26\u002Fquoroom-v0.1.26-darwin-universal.tar.gz) |\n| Linux x64 | [.deb package](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.26\u002Fquoroom_0.1.26_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.26\u002Fquoroom-v0.1.26-linux-x64.tar.gz) |\n| Windows x64 (signed) | [.exe installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.26\u002Fquoroom-v0.1.26-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.26\u002Fquoroom-v0.1.26-win-x64.zip) |\n","2026-03-01T01:18:08",{"id":224,"version":225,"summary_zh":226,"released_at":227},289180,"v0.1.25","## What's new\n\n- Bug fixes and improvements\n\n## Install\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nInstallers add `quoroom` to your PATH automatically. No dependencies needed.\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.25\u002Fquoroom-v0.1.25-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.25\u002Fquoroom-v0.1.25-darwin-universal.tar.gz) |\n| Linux x64 | [.deb package](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.25\u002Fquoroom_0.1.25_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.25\u002Fquoroom-v0.1.25-linux-x64.tar.gz) |\n| Windows x64 (signed) | [.exe installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.25\u002Fquoroom-v0.1.25-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.25\u002Fquoroom-v0.1.25-win-x64.zip) |\n","2026-02-24T11:51:39",{"id":229,"version":230,"summary_zh":231,"released_at":232},289181,"v0.1.24","## What's new\n\n- Bug fixes and improvements\n\n## Install\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nInstallers add `quoroom` to your PATH automatically. No dependencies needed.\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.24\u002Fquoroom-v0.1.24-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.24\u002Fquoroom-v0.1.24-darwin-universal.tar.gz) |\n| Linux x64 | [.deb package](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.24\u002Fquoroom_0.1.24_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.24\u002Fquoroom-v0.1.24-linux-x64.tar.gz) |\n| Windows x64 (signed) | [.exe installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.24\u002Fquoroom-v0.1.24-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.24\u002Fquoroom-v0.1.24-win-x64.zip) |\n","2026-02-24T03:21:53",{"id":234,"version":235,"summary_zh":236,"released_at":237},289182,"v0.1.23","## What's new\n\n- Bug fixes and improvements\n\n## Install\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nInstallers add `quoroom` to your PATH automatically. No dependencies needed.\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.23\u002Fquoroom-v0.1.23-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.23\u002Fquoroom-v0.1.23-darwin-universal.tar.gz) |\n| Linux x64 | [.deb package](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.23\u002Fquoroom_0.1.23_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.23\u002Fquoroom-v0.1.23-linux-x64.tar.gz) |\n| Windows x64 (signed) | [.exe installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.23\u002Fquoroom-v0.1.23-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.23\u002Fquoroom-v0.1.23-win-x64.zip) |\n","2026-02-24T02:28:30",{"id":239,"version":240,"summary_zh":241,"released_at":242},289183,"v0.1.22","## What's new\n\n- Bug fixes and improvements\n\n## Install\n\n```\nnpm install -g quoroom\n```\n\n### macOS (Homebrew)\n```\nbrew install quoroom-ai\u002Fquoroom\u002Fquoroom\n```\n\n### Download\n\nInstallers add `quoroom` to your PATH automatically. No dependencies needed.\n\n| Platform | Installer | Archive |\n|----------|-----------|---------|\n| macOS (Apple Silicon + Intel) | [.pkg installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.22\u002Fquoroom-v0.1.22-darwin-universal.pkg) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.22\u002Fquoroom-v0.1.22-darwin-universal.tar.gz) |\n| Linux x64 | [.deb package](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.22\u002Fquoroom_0.1.22_amd64.deb) | [.tar.gz](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.22\u002Fquoroom-v0.1.22-linux-x64.tar.gz) |\n| Windows x64 (signed) | [.exe installer](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.22\u002Fquoroom-v0.1.22-win-x64-setup.exe) | [.zip](https:\u002F\u002Fgithub.com\u002Fquoroom-ai\u002Froom\u002Freleases\u002Fdownload\u002Fv0.1.22\u002Fquoroom-v0.1.22-win-x64.zip) |\n","2026-02-24T01:17:30"]