WorkBuddy 可通过五种 Helm 方式部署：一、从公开仓库安装；二、用本地 Chart 目录离线部署；三、通过远程 HTTPS URL 直接安装；四、对接私有 Harbor 仓库并认证部署；五、用 --set 动态注入配置实现自动化部署。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 Kubernetes 集群中快速部署 WorkBuddy 应用，但尚未具备可用的 Helm Chart 或部署入口，则需通过标准 Helm 流程完成安装。以下是针对 WorkBuddy 的多种 Helm 部署路径，适用于不同环境与资源准备情况：
一、从公开 Helm 仓库安装 WorkBuddy Chart
若 WorkBuddy 官方或可信社区已将其 Chart 发布至公共 Helm 仓库（如 Artifact Hub 或 Harbor 公共实例），可直接添加仓库并安装。该方式依赖远程仓库可达性及 Chart 版本可用性。
1、执行命令添加 WorkBuddy 所属的 Helm 仓库，例如：
helm repo add workbuddy-repo https://charts.workbuddy.dev
2、更新本地仓库索引以同步最新 Chart 列表：
helm repo update
3、搜索确认 WorkBuddy Chart 是否存在且版本符合要求：
helm search repo workbuddy
4、使用默认配置安装到 default 命名空间：
helm install workbuddy-workshop workbuddy-repo/workbuddy
5、验证 Release 是否处于 deployed 状态：
helm list --namespace default
二、使用本地解压的 WorkBuddy Chart 目录安装
当您已获得 WorkBuddy 的源 Chart 包（如 workbuddy-1.2.0.tgz）或完整目录结构时，可通过本地路径部署。此方法不依赖网络仓库，适合离线或安全隔离环境。
1、解压 Chart 包至本地目录（若为 tar.gz 格式）：
tar -xzf workbuddy-1.2.0.tgz
2、进入解压后生成的 workbuddy/ 目录：
cd workbuddy
3、检查 Chart.yaml 文件是否存在且内容有效：
cat Chart.yaml | grep -E "name:|version:"
4、执行安装命令并指定自定义 release 名称：
helm install workbuddy-local ./
5、如需覆盖默认 values.yaml 中的参数，可附加 -f 指定配置文件：
helm install workbuddy-local ./ -f my-values.yaml
三、基于远程 HTTP URL 直接安装 WorkBuddy Chart
若 WorkBuddy Chart 以 tgz 形式托管于可公开访问的 HTTPS 地址（如 GitHub Releases 或对象存储），Helm 支持直接拉取并部署，无需手动下载解压。
1、确认目标 Chart URL 可被集群节点解析和访问，例如：
https://github.com/workbuddy-org/charts/releases/download/v1.2.0/workbuddy-1.2.0.tgz
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、运行安装命令，Helm 将自动下载、校验并部署：
helm install workbuddy-remote https://github.com/workbuddy-org/charts/releases/download/v1.2.0/workbuddy-1.2.0.tgz
3、如需指定命名空间，添加 --namespace 参数：
helm install workbuddy-remote https://github.com/workbuddy-org/charts/releases/download/v1.2.0/workbuddy-1.2.0.tgz --namespace workbuddy-system
4、若 Chart 含 CRD 定义，确保 Helm 版本 ≥ 3.2 且启用 --create-namespace（如目标命名空间不存在）：
helm install workbuddy-remote https://github.com/workbuddy-org/charts/releases/download/v1.2.0/workbuddy-1.2.0.tgz --create-namespace --namespace workbuddy-system
四、通过私有 Harbor Helm 仓库部署 WorkBuddy
若您的组织使用 Harbor 2.4+ 作为 Helm Chart 仓库，并已上传 WorkBuddy Chart，则需先认证再安装。该方式适用于企业级权限管控与审计场景。
1、确保 Helm 已安装 harbor-push 插件（用于后续推送，非必需但推荐）：
helm plugin install https://github.com/goharbor/harbor-helm-plugin
2、添加 Harbor Helm 仓库并提供基础认证信息：
helm repo add workbuddy-harbor https://harbor.example.com/chartrepo/workbuddy --username admin --password Harbor12345
3、更新仓库缓存：
helm repo update
4、列出仓库中所有可用 Chart 版本：
helm search repo workbuddy-harbor/workbuddy
5、安装指定版本（如 1.2.0）并启用 TLS 配置（若 Harbor 启用 HTTPS）：
helm install workbuddy-harbor-inst workbuddy-harbor/workbuddy --version 1.2.0 --set ingress.tls.enabled=true
五、使用 Helm 3 的 --set 参数动态注入配置部署 WorkBuddy
当无法修改 values.yaml 文件，或需在 CI/CD 流水线中实现参数化部署时，可完全通过命令行传入关键配置。该方式跳过文件编辑，提升自动化兼容性。
1、确认 WorkBuddy Chart 支持 --set 所需字段，参考其 values.yaml 中的顶层键名，例如 replicaCount、image.tag、service.port
2、执行单行部署，覆盖镜像标签与副本数：
helm install workbuddy-dynamic workbuddy-repo/workbuddy --set replicaCount=3 --set image.tag=v1.2.0-release --set service.port=8080
3、如需注入敏感配置（如数据库密码），避免明文暴露，应改用 --set-string 或结合 secrets：
helm install workbuddy-secure workbuddy-repo/workbuddy --set-string env.DB_PASSWORD=prod-secret-7x9m
4、验证 Pod 是否按预期启动并就绪：
kubectl get pods -l app.kubernetes.io/instance=workbuddy-dynamic
