应根据场景选择对应版本：v2.8.3适用于私有化稳定部署，需PostgreSQL 12.10+且禁用JIT；v3.1.0适合中大型多租户组织，依赖Docker 24.0.0+或K8s v1.27+；v3.2.0-rc2仅限测试环境验证新权限逻辑；v1.9.7专用于CentOS 7/Python 3.6旧环境，不支持安全更新。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在为 Workbuddy 项目选择部署版本，但对各版本的功能边界、依赖要求和适用场景不明确，则可能因版本误选导致服务启动失败或核心功能缺失。以下是 Workbuddy 官方发布的主流部署版本及其关键特性说明：
一、v2.8.3（LTS 稳定版）
该版本为长期支持分支，经过 6 个月以上生产环境验证，适用于对系统稳定性与兼容性要求严格的私有化部署场景，不包含实验性功能，依赖项锁定严格。
1、下载地址为 https://releases.workbuddy.dev/v2.8.3/workbuddy-v2.8.3.tar.gz。
2、解压后执行 ./install.sh --mode=standalone 启动单机模式。
3、数据库需使用 PostgreSQL 12.10 或更高版本，且必须禁用 JIT 编译以避免运行时异常。
二、v3.1.0（功能增强版）
此版本引入了多租户隔离策略与 Webhook 配置中心，适合需要动态扩展团队工作空间的中大型组织，但要求容器运行时为 Docker 24.0.0+ 或 Kubernetes v1.27+。
1、镜像名称为 workbuddy/core:v3.1.0，可通过 docker pull 直接拉取。
2、部署前须在 config.yaml 中显式设置 multi_tenant: true。
3、启动命令需附加环境变量 ENABLE_WEBHOOK_CONFIG=true。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、v3.2.0-rc2（预发布候选版）
该版本处于候选发布阶段，已集成前端微前端框架升级与权限模型重构，仅推荐用于测试环境验证新权限控制逻辑，不建议用于生产系统。
1、源码包位于 https://releases.workbuddy.dev/nightly/v3.2.0-rc2/src.zip。
2、构建时需指定构建标签 make build TARGET=prod-with-mfe。
3、首次运行前必须执行 ./migrate --force --version=3.2.0-rc2 手动触发数据库迁移。
四、v1.9.7（遗留兼容版）
面向仍在使用 CentOS 7 与 Python 3.6 运行时的旧基础设施，保留对 LDAPv2 协议和 MySQL 5.7 的原生支持，但不再接收安全补丁更新。
1、安装包哈希值为 sha256: a1f8e9d2c4b6...（完整值见 legacy-signatures.md）。
2、安装脚本需添加 --legacy-mode 参数以绕过现代 TLS 校验。
3、启动后默认监听端口为 8080（不可修改），且不支持 HTTPS 自动重定向。
