docs(docker-compose): update Copilot CLI documentation for runtime model

Changes:

- README: clarify Copilot CLI is runtime support, not template

- copilot-cli-troubleshooting: update for standard image tag behavior

- en-US.json: update translations for standard tag semantics

- zh-CN.json: update translations for standard tag semantics

Updates documentation to reflect that Copilot CLI is now treated as a

standard executor while the Hagicode image tag remains fixed at 0.

Co-Authored-By: Hagicode <noreply@hagicode.com>

Author: newbe36524

README.md

@@ -8,7 +8,7 @@ A modern Docker Compose configuration generator for Hagicode, built with React +
 - **Docker Compose YAML Generation**: Automatic YAML file generation based on user input
 - **Multiple Database Options**: Support for internal PostgreSQL or external database connections
 - **Explicit Executor Configuration**: Enable Claude/Codex/Copilot CLI/CodeBuddy/IFlow/OpenCode in parallel without a default-provider route
-- **Copilot CLI Docker Template**: Built-in `copilot-cli` template with release-index defaults and strict `<version>-copilot` tag validation
+- **Copilot CLI Support**: Optional `copilot-cli` executor support while the standard Hagicode image tag remains fixed at `0`
 - **LAN HTTPS Support**: Optional Caddy reverse proxy with `tls internal`
 - **Volume Management**: Configure volume mounts for data persistence
 - **User Permissions**: Linux user permission mapping (PUID/PGID) support
@@ -110,20 +110,20 @@ This will build the application and deploy it to the `gh-pages` branch.
 |----------|-------------|------------|-----------------|
 | Claude | Provider preset, token, optional custom endpoint | Requires token; custom preset also requires endpoint URL | Emits `ANTHROPIC_*` variables for the enabled Claude branch |
 | Codex | `CODEX_API_KEY`, optional `CODEX_BASE_URL` | Requires `CODEX_API_KEY` when enabled | Emits `CODEX_*` variables only |
-| Copilot CLI | `COPILOT_API_KEY`, optional `COPILOT_BASE_URL`, image tag, workspace toggle | Requires API key and `<version>-copilot` image tag when enabled | Emits `COPILOT_*` variables and optional sidecar service |
+| Copilot CLI | `COPILOT_API_KEY`, optional `COPILOT_BASE_URL`, standard image tag `0`, workspace toggle | Requires API key when enabled | Emits `COPILOT_*` variables and optional sidecar service without changing the standard Hagicode image tag |
 | CodeBuddy | `CODEBUDDY_API_KEY`, `CODEBUDDY_INTERNET_ENVIRONMENT` | Requires API key when enabled; network environment defaults to `ioa` but remains editable | Emits explicit CodeBuddy provider/platform keys plus `CODEBUDDY_*` variables |
 | IFlow CLI | Informational branch only | No invented private `IFLOW_*` field is required | Emits explicit IFlow provider/platform bootstrap keys and expects prior CLI login or mounted runtime state |
 | OpenCode | Optional managed runtime model | No extra required field beyond normal deployment validation | Emits explicit OpenCode provider registration plus `AI__OpenCode__*` managed runtime keys |
 
-##### Copilot CLI Template
+##### Copilot CLI Runtime Notes
 
-- **Template ID**: `copilot-cli`
+- **Template ID**: `copilot-cli` (reserved for explicit template flows)
 - **Required env**: `COPILOT_API_KEY`
-- **Tag policy**: `imageTag` must match `<version>-copilot` (for example `1.2.3-copilot`)
+- **Standard tag contract**: the standard Hagicode image tag stays fixed at `0`
 - **Optional env**: `COPILOT_BASE_URL`
 - **Workspace mount**: Optional bind mount to `/workspace`
 
-Copilot template defaults are loaded from release index metadata. If loading fails, the app falls back to safe embedded defaults.
+Release index metadata remains available for compatibility checks and future explicit Copilot template flows. Standard builder defaults and refresh paths keep `imageTag` at `0`.
 
 ##### CodeBuddy, IFlow, and OpenCode Notes
 

docs/copilot-cli-troubleshooting.md

@@ -1,30 +1,32 @@
-# Copilot CLI Template Troubleshooting
+# Copilot CLI Runtime Troubleshooting
 
-This guide covers common issues when using the `copilot-cli` template in Docker Compose Builder.
+This guide covers common issues when enabling the `copilot-cli` executor in Docker Compose Builder.
 
 ## 1. Release index metadata cannot be loaded
 
 **Symptoms**
-- Copilot template shows fallback warning
-- Default `imageTag` is not the expected release tag
+- Copilot metadata warning is shown
+- You want to confirm whether metadata changes the standard `imageTag`
 
 **Checks**
 1. Verify the release index URL is reachable
 2. If needed, override index URL with `VITE_RELEASE_INDEX_URL`
 3. Confirm payload includes `copilot.provider = "copilot-cli"`
+4. Standard builder flows should still keep `imageTag = 0`; metadata is informational unless an explicit template flow opts in
 
-## 2. Image tag validation fails
+## 2. Standard image tag unexpectedly changes
 
 **Symptoms**
-- Validation error on `imageTag`
-- YAML generation blocked
+- `imageTag` is no longer `0` in a standard builder flow
+- Generated standard image reference does not end with `:0`
 
 **Expected format**
-- `<version>-copilot` (example: `1.2.3-copilot`)
+- Standard builder flows keep `imageTag` fixed at `0`
 
 **Fix**
-1. Use a semantic version with `-copilot` suffix
-2. Avoid non-version tags such as `latest` for copilot template
+1. Reset the builder or switch profiles once to re-normalize older saved state
+2. Refresh the page after upgrading to a build that includes the tag fix
+3. If the problem persists, clear the stored builder config from localStorage and reload
 
 ## 3. Missing `COPILOT_API_KEY`
 

src/i18n/locales/en-US.json

@@ -131,15 +131,15 @@
     "openCodeModel": "OpenCode Model",
     "openCodeModelHint": "Optional managed runtime model. The image ships the opencode command even though routing is configured explicitly.",
     "copilotConfiguration": "Copilot CLI Configuration",
-    "copilotDescription": "Configure Copilot runtime using COPILOT_* environment variables and copilot image tag policy",
+    "copilotDescription": "Configure Copilot runtime using COPILOT_* environment variables while the standard Hagicode image tag stays fixed at 0",
     "copilotMountWorkspace": "Mount workspace volume to /workspace",
     "loadingCopilotMetadata": "Loading Copilot release metadata...",
-    "copilotMetadataHint": "Using release index defaults (env schema v{{version}})",
-    "copilotMetadataFallback": "Failed to fetch release index metadata. Fallback defaults are applied.",
+    "copilotMetadataHint": "Release index metadata is available for compatibility checks (env schema v{{version}}); the standard image tag remains 0",
+    "copilotMetadataFallback": "Failed to fetch release index metadata. The standard image tag remains 0.",
     "standardTemplate": "Standard Template",
     "standardTemplateDescription": "Default Hagicode application template",
     "copilotTemplate": "Copilot CLI Template",
-    "copilotTemplateDescription": "Copilot-focused template with strict tag and environment validation",
+    "copilotTemplateDescription": "Reserved for explicit Copilot template flows; the standard builder keeps imageTag at 0",
     "optional": "optional",
     "compatibilityAliasHint": "Compatibility Alias Hint",
     "codexCompatibilityDescription": "You can also use OPENAI_* environment variables as compatibility aliases",

src/i18n/locales/zh-CN.json

@@ -131,15 +131,15 @@
     "openCodeModel": "OpenCode 模型",
     "openCodeModelHint": "可选的托管运行时模型。镜像内仍然提供 opencode 命令，但路由改为显式配置。",
     "copilotConfiguration": "Copilot CLI 配置",
-    "copilotDescription": "使用 COPILOT_* 环境变量配置 Copilot 运行时，并遵循 copilot 镜像标签规则",
+    "copilotDescription": "使用 COPILOT_* 环境变量配置 Copilot 运行时，同时保持标准 Hagicode 镜像标签固定为 0",
     "copilotMountWorkspace": "挂载工作目录到 /workspace",
     "loadingCopilotMetadata": "正在加载 Copilot 发布索引元数据...",
-    "copilotMetadataHint": "正在使用发布索引默认值（环境 schema v{{version}}）",
-    "copilotMetadataFallback": "拉取发布索引元数据失败，已使用回退默认值。",
+    "copilotMetadataHint": "发布索引元数据可用于兼容性检查（环境 schema v{{version}}）；标准镜像标签仍保持为 0",
+    "copilotMetadataFallback": "拉取发布索引元数据失败，但标准镜像标签仍保持为 0。",
     "standardTemplate": "标准模板",
     "standardTemplateDescription": "默认 Hagicode 应用模板",
     "copilotTemplate": "Copilot CLI 模板",
-    "copilotTemplateDescription": "面向 Copilot 的模板，包含严格标签与环境校验",
+    "copilotTemplateDescription": "仅供显式 Copilot 模板流程使用；标准构建器会将 imageTag 保持为 0",
     "optional": "可选",
     "compatibilityAliasHint": "兼容别名提示",
     "codexCompatibilityDescription": "您也可以使用 OPENAI_* 环境变量作为兼容别名",