From 0cae42768bd544b366041d5e5f61ceb2e8295035 Mon Sep 17 00:00:00 2001
From: IvanVelichko <ivanvelichko@slock.local>
Date: Wed, 2 Sep 2026 22:06:29 +0800
Subject: [PATCH] =?UTF-8?q?=E5=AF=B9=E9=BD=90=20v0.2.8=20=E4=BA=A4?=
 =?UTF-8?q?=E4=BB=98=E7=89=88=E6=9C=AC=E5=B9=B6=E8=A1=A5=E5=85=85=20LTS=20?=
 =?UTF-8?q?=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Compose 样例和 Chart 身份跟上已发布 tag，并写清离线导出与 lts/0.2 规则。

Closes #59
---
 README.md           | 14 +++++++++++++-
 compose.example.yml |  2 +-
 deploy/Chart.yaml   |  4 ++--
 docs/lts.md         | 16 ++++++++++++++++
 4 files changed, 32 insertions(+), 4 deletions(-)
 create mode 100644 docs/lts.md

diff --git a/README.md b/README.md
index d20f9d7..26d2a19 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,7 @@
 host-agent/   Node 服务（TypeScript，零运行时依赖，esbuild 打成单文件）
   src/        gateway / control / supervisor / ticket / config
   test/       node:test 单元与集成测试（内置 fake dsh）
-docs/         架构（architecture.md）、生命周期（lifecycle.md）、稳定性（stability.md）、配对与认证（pairing.md）、宿主运营配置（host-settings.md）、ApeMind 能力结合（apemind-integration.md）
+docs/         架构（architecture.md）、生命周期（lifecycle.md）、稳定性（stability.md）、配对与认证（pairing.md）、宿主运营配置（host-settings.md）、ApeMind 能力结合（apemind-integration.md）、LTS（lts.md）
 tests/vectors 票据 golden vectors（Python 生成，双端测试共用）
 deploy/       Kubernetes Helm chart（独立发布，不绑 ApeMind 主 chart）
 Dockerfile    运行镜像（node:22-bookworm-slim + 锁版本 dsh + apemind CLI + host-agent）
@@ -73,6 +73,18 @@ Dockerfile 的 `DSH_VERSION` 中锁定；`pnpm` 由 `corepack` 按 `PNPM_VERSION
 装到 `/usr/local/bin/apemind`（运行期零下载）。升级 dsh、pnpm 或 CLI 一律走新镜像
 tag 加回归验证。租户 HOME 与 CLI 身份注入见 [docs/lifecycle.md](docs/lifecycle.md) §1。
 
+当前发布 tag 是 `v0.2.8`。离线机先在联网环境导出镜像再 `docker load`：
+
+```bash
+docker pull apecloud/apemind-computer:v0.2.8
+docker save apecloud/apemind-computer:v0.2.8 -o apemind-computer-v0.2.8.tar
+docker load -i apemind-computer-v0.2.8.tar
+```
+
+Compose 样例见 `compose.example.yml`。ApeMind 离线交付把本组件放在
+`deploy/components/computer`，不进入核心默认安装。LTS 分支与发版规则见
+[docs/lts.md](docs/lts.md)。
+
 ## Kubernetes
 
 独立 Helm chart 在 `deploy/`。控制面只需要把 `COMPUTER_HOST_URL` 指到 chart 打出的
diff --git a/compose.example.yml b/compose.example.yml
index 708822a..8218174 100644
--- a/compose.example.yml
+++ b/compose.example.yml
@@ -8,7 +8,7 @@
 # （两边配同一个值）加一道门。
 services:
   computer-host:
-    image: apecloud/apemind-computer:v0.2.0
+    image: apecloud/apemind-computer:v0.2.8
     restart: unless-stopped
     environment:
       # 浏览器访问网关用的对外地址（决定 Origin 校验与 cookie Secure 属性）
diff --git a/deploy/Chart.yaml b/deploy/Chart.yaml
index 54e81af..86cc742 100644
--- a/deploy/Chart.yaml
+++ b/deploy/Chart.yaml
@@ -2,5 +2,5 @@ apiVersion: v2
 name: apemind-computer
 description: Multi-tenant hosted dsh (computer-host) gateway, control API, and supervisor.
 type: application
-version: 0.1.0
-appVersion: "v0.2.1"
+version: 0.2.8
+appVersion: "v0.2.8"
diff --git a/docs/lts.md b/docs/lts.md
new file mode 100644
index 0000000..0752d95
--- /dev/null
+++ b/docs/lts.md
@@ -0,0 +1,16 @@
+# LTS
+
+分支名：`lts/0.2`。基线是已发布的 `v0.2.8`。
+
+规则：
+
+1. 不把 `main` 整支合进 `lts/0.2`。只 cherry-pick 已在 main 验证的修复。
+2. 不 force-push `lts/0.2`，不改写已发布的 `v0.2.*` tag。
+3. 准入默认只收阻塞缺陷、安全和数据正确性；新功能走 main。
+4. 切 tag 会触发镜像发布（Docker Hub + 张家口 ACR）。Chart 仍在本仓 `deploy/`；
+   进入 `apecloud/helm-charts` 之前，Kubernetes 离线现场使用已打好的 `.tgz`。
+5. 产物不等于现场部署。客户环境上线需要单独授权。
+
+离线 Compose / Kubernetes 入口在 `apecloud/apemind-compose-deploy` 和
+`apecloud/apemind-k8s-deploy` 的 `deploy/components/computer`，不进入 ApeMind
+核心默认安装。