Skip to content

Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.

ci(release): publish the platform from vX.Y.Z tags (#84)

Robert0622b4ea41861ce3
diff --git a/.github/workflows/platform-image.yml b/.github/workflows/platform-image.yml
deleted file mode 100644
index 5dddc508..00000000
--- a/.github/workflows/platform-image.yml
+++ /dev/null
@@ -1,37 +0,0 @@
-name: platform-image
-on:
- workflow_dispatch:
- push:
- tags: ['platform-v*']
-permissions:
- contents: read
- packages: write
-jobs:
- image:
- runs-on: ubuntu-latest
- steps:
- - uses: actions/[email protected]
- - uses: docker/setup-buildx-action@v3
- - uses: docker/login-action@v3
- with:
- registry: ghcr.io
- username: ${{ github.actor }}
- password: ${{ secrets.GITHUB_TOKEN }}
- - id: image
- env:
- REPOSITORY: ${{ github.repository }}
- run: echo "name=ghcr.io/${REPOSITORY,,}" >> "$GITHUB_OUTPUT"
- - uses: docker/metadata-action@v5
- id: metadata
- with:
- images: ${{ steps.image.outputs.name }}
- tags: |
- type=sha,prefix=sha-,format=long
- type=ref,event=tag
- - uses: docker/build-push-action@v6
- with:
- context: .
- push: true
- tags: ${{ steps.metadata.outputs.tags }}
- cache-from: type=gha
- cache-to: type=gha,mode=max
diff --git a/.github/workflows/release-local.yml b/.github/workflows/release-local.yml
new file mode 100644
index 00000000..90dcb7af
--- /dev/null
+++ b/.github/workflows/release-local.yml
@@ -0,0 +1,175 @@
+name: release-local
+
+on:
+ workflow_dispatch:
+ inputs:
+ source_ref:
+ description: "Existing Local release tag to publish (for example local-v0.2.3)"
+ required: true
+ type: string
+
+permissions:
+ contents: write
+ id-token: write
+ packages: write
+
+concurrency:
+ group: release-local-${{ inputs.source_ref }}
+ cancel-in-progress: false
+
+defaults:
+ run:
+ working-directory: local
+
+jobs:
+ release:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/[email protected]
+ with:
+ fetch-depth: 0
+ ref: ${{ inputs.source_ref }}
+
+ - uses: actions/[email protected]
+ with:
+ python-version: "3.12"
+
+ - uses: actions/[email protected]
+ with:
+ node-version: "22"
+ registry-url: "https://registry.npmjs.org"
+
+ - name: Verify tag and package version
+ id: package
+ shell: bash
+ env:
+ SOURCE_REF: ${{ inputs.source_ref }}
+ run: |
+ package_name="$(node -p 'require("./package.json").name')"
+ package_version="$(node -p 'require("./package.json").version')"
+ release_tag="local-v${package_version}"
+ requested_ref="${SOURCE_REF}"
+ if [[ "${requested_ref}" != "${release_tag}" ]]; then
+ echo "Release ref ${requested_ref} does not match package version ${package_version}" >&2
+ exit 1
+ fi
+ tag_commit="$(git rev-parse --verify "refs/tags/${release_tag}^{commit}")"
+ if [[ "$(git rev-parse HEAD)" != "${tag_commit}" ]]; then
+ echo "Checkout does not match the release tag commit" >&2
+ exit 1
+ fi
+ if [[ "${package_version}" != *-* ]]; then
+ latest_version="$(npm view "$package_name" dist-tags.latest)"
+ newest_version="$(printf '%s\n' "$package_version" "$latest_version" | sort -V | tail -n 1)"
+ if [[ "$newest_version" != "$package_version" ]]; then
+ echo "Refusing to roll latest back from $latest_version to $package_version" >&2
+ exit 1
+ fi
+ fi
+ echo "name=${package_name}" >> "$GITHUB_OUTPUT"
+ echo "version=${package_version}" >> "$GITHUB_OUTPUT"
+ echo "tag=${release_tag}" >> "$GITHUB_OUTPUT"
+ owner="$(printf '%s' "${GITHUB_REPOSITORY_OWNER}" | tr '[:upper:]' '[:lower:]')"
+ image="ghcr.io/${owner}/loopforge-tcmcp"
+ sha="$(git rev-parse --short HEAD)"
+ tags="${image}:${package_version}"$'\n'"${image}:sha-${sha}"
+ if [[ "${package_version}" != *-* ]]; then
+ tags+=$'\n'"${image}:${package_version%.*}"
+ tags+=$'\n'"${image}:latest"
+ fi
+ {
+ echo "image_tags<<EOF"
+ printf '%s\n' "$tags"
+ echo "EOF"
+ } >> "$GITHUB_OUTPUT"
+
+ - name: Install validation dependencies
+ run: python3 -m pip install pyyaml==6.0.3
+
+ - name: Validate release contents
+ run: |
+ python3 scripts/build-classic-hosts.py --check
+ bash scripts/validate.sh
+ bash scripts/test-observability.sh
+ bash scripts/smoke-install.sh
+ bash scripts/smoke-npm.sh
+ bash scripts/smoke-curl-install.sh
+ bash scripts/e2e.sh
+ bash scripts/scan-secrets.sh
+
+ - name: Log in to GHCR
+ uses: docker/login-action@v3
+ with:
+ registry: ghcr.io
+ username: ${{ github.actor }}
+ password: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Set up Docker Buildx
+ uses: docker/setup-buildx-action@v3
+
+ - name: Build and push tcmcp image
+ uses: docker/build-push-action@v6
+ with:
+ context: local/tools/tcmcp
+ push: true
+ tags: ${{ steps.package.outputs.image_tags }}
+
+ - name: Build GitHub Release assets
+ run: bash scripts/build-release-archive.sh
+
+ - name: Check whether npm version already exists
+ id: npm
+ shell: bash
+ env:
+ PACKAGE_NAME: ${{ steps.package.outputs.name }}
+ PACKAGE_VERSION: ${{ steps.package.outputs.version }}
+ run: |
+ node <<'NODE'
+ const {execFileSync} = require('node:child_process');
+ const {appendFileSync} = require('node:fs');
+ let published = false;
+ try {
+ execFileSync('npm', ['view', `${process.env.PACKAGE_NAME}@${process.env.PACKAGE_VERSION}`, 'version', '--json'], {stdio: ['ignore', 'pipe', 'pipe']});
+ published = true;
+ } catch (error) {
+ let result;
+ try { result = JSON.parse(String(error.stdout)); } catch {}
+ if (result?.error?.code !== 'E404') throw error;
+ }
+ appendFileSync(process.env.GITHUB_OUTPUT, `published=${published}\n`);
+ NODE
+
+ - name: Publish npm package
+ if: steps.npm.outputs.published != 'true'
+ shell: bash
+ run: |
+ publish_tag="latest"
+ if [[ "${{ steps.package.outputs.version }}" == *-* ]]; then
+ publish_tag="next"
+ fi
+ npm publish --tag "$publish_tag" --provenance --access public
+ env:
+ NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+ - name: Create or update GitHub Release
+ shell: bash
+ env:
+ GH_TOKEN: ${{ github.token }}
+ VERSION: ${{ steps.package.outputs.version }}
+ TAG: ${{ steps.package.outputs.tag }}
+ run: |
+ release_args=(--title "LoopForge Local v${VERSION}" --generate-notes --latest=false)
+ if [[ "$VERSION" == *-* ]]; then
+ release_args+=(--prerelease)
+ fi
+ if gh release view "$TAG" >/dev/null 2>&1; then
+ gh release upload "$TAG" \
+ dist/release/loopforge-workflow.tar.gz \
+ dist/release/loopforge-workflow.tar.gz.sha256 \
+ --clobber
+ else
+ gh release create "$TAG" \
+ dist/release/loopforge-workflow.tar.gz \
+ dist/release/loopforge-workflow.tar.gz.sha256 \
+ "${release_args[@]}"
+ fi
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 346a47e7..d6382d9e 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -7,175 +7,123 @@ on:
workflow_dispatch:
inputs:
source_ref:
- description: "Existing release tag to publish (for example v0.1.0)"
+ description: "Existing platform release tag to publish (for example v0.3.0)"
required: true
type: string
permissions:
+ actions: read
contents: write
- id-token: write
packages: write
concurrency:
- group: release-${{ github.ref }}
+ group: release-${{ inputs.source_ref || github.ref_name }}
cancel-in-progress: false
-defaults:
- run:
- working-directory: local
-
jobs:
release:
runs-on: ubuntu-latest
+ timeout-minutes: 60
steps:
- uses: actions/[email protected]
with:
fetch-depth: 0
- ref: ${{ github.event_name == 'workflow_dispatch' && inputs.source_ref || github.ref }}
-
- - uses: actions/[email protected]
- with:
- python-version: "3.12"
+ ref: ${{ inputs.source_ref || github.ref }}
- - uses: actions/[email protected]
- with:
- node-version: "22"
- registry-url: "https://registry.npmjs.org"
-
- - name: Verify tag and package version
- id: package
+ - name: Verify release tag
+ id: release
shell: bash
env:
- SOURCE_REF: ${{ inputs.source_ref }}
+ GH_TOKEN: ${{ github.token }}
+ TAG: ${{ inputs.source_ref || github.ref_name }}
run: |
- package_name="$(node -p 'require("./package.json").name')"
- package_version="$(node -p 'require("./package.json").version')"
- release_tag="v${package_version}"
- requested_ref="${GITHUB_REF_NAME}"
- if [[ "${GITHUB_EVENT_NAME}" == "workflow_dispatch" ]]; then
- requested_ref="${SOURCE_REF}"
- fi
- if [[ "${requested_ref}" != "${release_tag}" ]]; then
- echo "Release ref ${requested_ref} does not match package version ${package_version}" >&2
+ if [[ ! "${TAG}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?$ ]]; then
+ echo "Release tag ${TAG} is not vMAJOR.MINOR.PATCH[-PRERELEASE]" >&2
exit 1
fi
- tag_commit="$(git rev-parse --verify "refs/tags/${release_tag}^{commit}")"
+ tag_commit="$(git rev-parse --verify "refs/tags/${TAG}^{commit}")"
if [[ "$(git rev-parse HEAD)" != "${tag_commit}" ]]; then
echo "Checkout does not match the release tag commit" >&2
exit 1
fi
- if [[ "${package_version}" != *-* ]]; then
- latest_version="$(npm view "$package_name" dist-tags.latest)"
- newest_version="$(printf '%s\n' "$package_version" "$latest_version" | sort -V | tail -n 1)"
- if [[ "$newest_version" != "$package_version" ]]; then
- echo "Refusing to roll latest back from $latest_version to $package_version" >&2
- exit 1
- fi
+ if ! git merge-base --is-ancestor "${tag_commit}" origin/main; then
+ echo "Release tag ${TAG} is not on main" >&2
+ exit 1
fi
- echo "name=${package_name}" >> "$GITHUB_OUTPUT"
- echo "version=${package_version}" >> "$GITHUB_OUTPUT"
- echo "tag=${release_tag}" >> "$GITHUB_OUTPUT"
- owner="$(printf '%s' "${GITHUB_REPOSITORY_OWNER}" | tr '[:upper:]' '[:lower:]')"
- image="ghcr.io/${owner}/loopforge-tcmcp"
- sha="$(git rev-parse --short HEAD)"
- tags="${image}:${package_version}"$'\n'"${image}:sha-${sha}"
- if [[ "${package_version}" != *-* ]]; then
- tags+=$'\n'"${image}:${package_version%.*}"
- tags+=$'\n'"${image}:latest"
+ ci="$(gh run list --repo "${GITHUB_REPOSITORY}" --workflow platform.yml --commit "${tag_commit}" \
+ --json event,conclusion --jq '[.[] | select(.event == "push")][0].conclusion // ""')"
+ if [[ "${ci}" != "success" ]]; then
+ echo "The platform workflow has not succeeded on ${tag_commit} (status: ${ci:-not run})" >&2
+ exit 1
fi
+ version="${TAG#v}"
+ image="ghcr.io/${GITHUB_REPOSITORY,,}"
+ prerelease=false
+ [[ "${version}" == *-* ]] && prerelease=true
{
- echo "image_tags<<EOF"
- printf '%s\n' "$tags"
- echo "EOF"
+ echo "tag=${TAG}"
+ echo "version=${version}"
+ echo "image=${image}"
+ echo "prerelease=${prerelease}"
} >> "$GITHUB_OUTPUT"
- - name: Install validation dependencies
- run: python3 -m pip install pyyaml==6.0.3
-
- - name: Validate release contents
- run: |
- python3 scripts/build-classic-hosts.py --check
- bash scripts/validate.sh
- bash scripts/test-observability.sh
- bash scripts/smoke-install.sh
- bash scripts/smoke-npm.sh
- bash scripts/smoke-curl-install.sh
- bash scripts/e2e.sh
- bash scripts/scan-secrets.sh
+ - uses: docker/setup-buildx-action@v3
- - name: Log in to GHCR
- uses: docker/login-action@v3
+ - uses: docker/login-action@v3
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
- - name: Set up Docker Buildx
- uses: docker/setup-buildx-action@v3
-
- - name: Build and push tcmcp image
- uses: docker/build-push-action@v6
+ - uses: docker/metadata-action@v5
+ id: metadata
+ with:
+ images: ${{ steps.release.outputs.image }}
+ flavor: latest=false
+ tags: |
+ type=semver,pattern={{version}},value=${{ steps.release.outputs.tag }}
+ type=semver,pattern={{major}}.{{minor}},value=${{ steps.release.outputs.tag }}
+ type=sha,prefix=sha-,format=long
+ type=raw,value=latest,enable=${{ steps.release.outputs.prerelease == 'false' }}
+
+ - uses: docker/build-push-action@v6
with:
- context: local/tools/tcmcp
+ context: .
push: true
- tags: ${{ steps.package.outputs.image_tags }}
-
- - name: Build GitHub Release assets
- run: bash scripts/build-release-archive.sh
-
- - name: Check whether npm version already exists
- id: npm
- shell: bash
- env:
- PACKAGE_NAME: ${{ steps.package.outputs.name }}
- PACKAGE_VERSION: ${{ steps.package.outputs.version }}
- run: |
- node <<'NODE'
- const {execFileSync} = require('node:child_process');
- const {appendFileSync} = require('node:fs');
- let published = false;
- try {
- execFileSync('npm', ['view', `${process.env.PACKAGE_NAME}@${process.env.PACKAGE_VERSION}`, 'version', '--json'], {stdio: ['ignore', 'pipe', 'pipe']});
- published = true;
- } catch (error) {
- let result;
- try { result = JSON.parse(String(error.stdout)); } catch {}
- if (result?.error?.code !== 'E404') throw error;
- }
- appendFileSync(process.env.GITHUB_OUTPUT, `published=${published}\n`);
- NODE
-
- - name: Publish npm package
- if: steps.npm.outputs.published != 'true'
- shell: bash
- run: |
- publish_tag="latest"
- if [[ "${{ steps.package.outputs.version }}" == *-* ]]; then
- publish_tag="next"
- fi
- npm publish --tag "$publish_tag" --provenance --access public
- env:
- NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+ tags: ${{ steps.metadata.outputs.tags }}
+ labels: ${{ steps.metadata.outputs.labels }}
+ cache-from: type=gha
+ cache-to: type=gha,mode=max
- name: Create or update GitHub Release
shell: bash
env:
GH_TOKEN: ${{ github.token }}
- VERSION: ${{ steps.package.outputs.version }}
- TAG: ${{ steps.package.outputs.tag }}
+ TAG: ${{ steps.release.outputs.tag }}
+ VERSION: ${{ steps.release.outputs.version }}
+ IMAGE: ${{ steps.release.outputs.image }}
+ PRERELEASE: ${{ steps.release.outputs.prerelease }}
run: |
- release_args=(--title "LoopForge Local v${VERSION}" --generate-notes)
- if [[ "$VERSION" == *-* ]]; then
- release_args+=(--prerelease)
+ notes="$(cat <<EOF
+ ## Install
+
+ \`\`\`bash
+ git clone --branch ${TAG} https://github.com/${GITHUB_REPOSITORY}.git
+ cd ${GITHUB_REPOSITORY#*/}
+ LOOPFORGE_IMAGE=${IMAGE}:${VERSION} LOOPFORGE_PUBLIC_URL=https://loopforge.example.com bash scripts/install.sh
+ \`\`\`
+
+ Platform image: \`${IMAGE}:${VERSION}\`. Existing installations: update \`LOOPFORGE_IMAGE\` in \`.env\`, re-run \`bash scripts/install.sh\`, and apply the new files under \`migrations/\` listed in [CHANGELOG.md](https://github.com/${GITHUB_REPOSITORY}/blob/${TAG}/CHANGELOG.md).
+ EOF
+ )"
+ if gh release view "${TAG}" >/dev/null 2>&1; then
+ echo "Release ${TAG} already exists; image republished"
+ exit 0
fi
- if gh release view "$TAG" >/dev/null 2>&1; then
- gh release upload "$TAG" \
- dist/release/loopforge-workflow.tar.gz \
- dist/release/loopforge-workflow.tar.gz.sha256 \
- --clobber
+ release_args=(--title "LoopForge v${VERSION}" --notes "${notes}" --generate-notes --verify-tag)
+ if [[ "${PRERELEASE}" == "true" ]]; then
+ release_args+=(--prerelease)
else
- gh release create "$TAG" \
- dist/release/loopforge-workflow.tar.gz \
- dist/release/loopforge-workflow.tar.gz.sha256 \
- "${release_args[@]}"
+ release_args+=(--latest)
fi
+ gh release create "${TAG}" "${release_args[@]}"
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d4927ed6..3cf23786 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,12 +1,18 @@
# Changelog
-## Unreleased — platform edition
+Platform releases use `vX.Y.Z` tags and publish `ghcr.io/tencent/loopforge`. LoopForge Local packages use `local-vX.Y.Z` tags and are published by manually running the `release-local` workflow.
+
+## 0.3.0 — platform edition
- Add the self-hosted platform implementation, including Main Bot workspace editing, durable workspace checkpoints, idle reclamation, and task-group SOP completion/reopening.
- Add public password accounts, explicit catalog installation, GitHub issue/PR adapters, actor-scoped GitHub MCP credentials, language and theme preferences, local deployment and public acceptance checks.
+- Connect GitHub by copying a PIN and approving the built-in LoopForge application, then pick repositories; PAT entry remains available.
+- Choose the branch mode, base branch and per-repository branches when opening a conversation workspace; role dispatches report their collected deliverables.
+- Install as an ordinary Linux user through sudo, install from a published platform image, and reuse that image for default sandboxes.
+- Validate repository remote URLs and restrict SSO return URLs to the same site.
- Integrate the original workflows as LoopForge Local under `local/`, with unified documentation, project policies and release history.
-Platform source and Local package releases are separate; merging the platform does not publish a platform image or a new npm version.
+Existing installations apply `migrations/022_auth_integrations.sql` and `migrations/023_role_prompt.sql`. Creating a named workspace branch on a connected runner requires runner 0.9.1 or later.
## 0.2.3 — Local packaging
diff --git a/docs/deployment.md b/docs/deployment.md
index 321260ea..c22bdcfb 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -29,14 +29,14 @@ The installer checks Docker, Compose and Python (and offers to install Docker wh
Run it as the installation owner, including an ordinary Linux user. If that user cannot access Docker directly, the installer validates sudo and uses `sudo -n docker` consistently for Compose, schema installation and seeds. Before each operation it checks whether sudo credentials expired during a long build, prompting again in a terminal or failing with instructions in unattended mode. It does not require adding the user to the Docker group or logging out. For unattended installations run `sudo -v` first; `LOOPFORGE_YES=1` accepts installation prompts but does not bypass operating-system permissions. Without sudo or Docker access it fails immediately with instructions. Rootless Docker uses its active context's Unix socket; remote Docker contexts need a separately configured deployment because sandbox workspaces are local bind mounts.
-Source builds reuse npm, Go module and Go compiler caches. For the fastest first installation, use an image published by your administrator:
+Source builds reuse npm, Go module and Go compiler caches. For the fastest first installation, check out a release tag and use its published image:
```bash
-LOOPFORGE_IMAGE=ghcr.io/YOUR_OWNER/loopforge:sha-YOUR_COMMIT \
+LOOPFORGE_IMAGE=ghcr.io/tencent/loopforge:0.3.0 \
LOOPFORGE_PUBLIC_URL=https://loopforge.example.com bash scripts/install.sh
```
-The `platform-image` workflow publishes a platform image when manually dispatched or when a `platform-v*` tag is pushed. Set the GHCR package visibility/access for your team before distributing the image. Images are pulled only when missing by default; use an immutable tag/digest, or set `LOOPFORGE_PULL_POLICY=always` when updating a mutable tag. Without `LOOPFORGE_IMAGE`, the installer builds this checkout. Existing `.env` values take precedence; change the saved image or URL there when updating an installation. Compose waits for the API's health check with a bounded timeout before installing schema extensions and seeds.
+Pushing a `vX.Y.Z` tag on `main` runs the `release` workflow once the `platform` workflow has passed on that commit. It publishes `ghcr.io/<owner>/loopforge` as `X.Y.Z`, `X.Y`, `latest` and `sha-<commit>`, and creates the GitHub Release. Forks publish under their own owner; set the GHCR package visibility/access for your team before distributing the image. Images are pulled only when missing by default; use an immutable tag/digest, or set `LOOPFORGE_PULL_POLICY=always` when updating a mutable tag. Without `LOOPFORGE_IMAGE`, the installer builds this checkout. Existing `.env` values take precedence; change the saved image or URL there when updating an installation. Compose waits for the API's health check with a bounded timeout before installing schema extensions and seeds.
Open the platform and create the first account in the browser; it receives platform administration. Until that account exists the login page only offers this setup step.
diff --git a/docs/local/usage.md b/docs/local/usage.md
index 1bd80083..b60ad726 100644
--- a/docs/local/usage.md
+++ b/docs/local/usage.md
@@ -177,7 +177,7 @@ pipx install ./local
cd local/tools/tcmcp
```
-Then follow [`tools/tcmcp/README.md`](../../local/tools/tcmcp/README.md). Cloud API keys are not written into generated zips or the container image; they stay on the machine that lists resources or installs the MCP client. LoopForge `vX.Y.Z` releases publish `ghcr.io/tencent/loopforge-tcmcp:<version>`.
+Then follow [`tools/tcmcp/README.md`](../../local/tools/tcmcp/README.md). Cloud API keys are not written into generated zips or the container image; they stay on the machine that lists resources or installs the MCP client. LoopForge Local `local-vX.Y.Z` releases publish `ghcr.io/tencent/loopforge-tcmcp:<version>`.
## Permissions and security
diff --git a/docs/local/usage.zh-CN.md b/docs/local/usage.zh-CN.md
index be602fb4..f3eb0741 100644
--- a/docs/local/usage.zh-CN.md
+++ b/docs/local/usage.zh-CN.md
@@ -176,7 +176,7 @@ pipx install ./local
cd local/tools/tcmcp
```
-再按 [`tools/tcmcp/README.md`](../../local/tools/tcmcp/README.md) 启动。云 API 密钥不会写入生成的 zip 或容器镜像,只留在拉取资源或安装 MCP 客户端的本机。LoopForge 打 `vX.Y.Z` tag 发版时会发布 `ghcr.io/tencent/loopforge-tcmcp:<version>`。
+再按 [`tools/tcmcp/README.md`](../../local/tools/tcmcp/README.md) 启动。云 API 密钥不会写入生成的 zip 或容器镜像,只留在拉取资源或安装 MCP 客户端的本机。LoopForge Local 以 `local-vX.Y.Z` tag 发版时会发布 `ghcr.io/tencent/loopforge-tcmcp:<version>`。
## 权限与安全
diff --git a/local/tools/tcmcp/README.md b/local/tools/tcmcp/README.md
index 1c744892..4f9b137a 100644
--- a/local/tools/tcmcp/README.md
+++ b/local/tools/tcmcp/README.md
@@ -33,7 +33,7 @@ cd web && npm run dev # UI :5173, proxies /api
## Docker
-LoopForge `vX.Y.Z` releases also publish this image to GHCR (same version as the CLI):
+LoopForge Local `local-vX.Y.Z` releases also publish this image to GHCR (same version as the CLI):
```bash
docker pull ghcr.io/tencent/loopforge-tcmcp:0.2.1
diff --git a/local/tools/tcmcp/README.zh-CN.md b/local/tools/tcmcp/README.zh-CN.md
index f19eb9d5..48d090b1 100644
--- a/local/tools/tcmcp/README.zh-CN.md
+++ b/local/tools/tcmcp/README.zh-CN.md
@@ -33,7 +33,7 @@ cd web && npm run dev # UI :5173,代理 /api
## Docker
-LoopForge 打 `vX.Y.Z` tag 发版时,会把本镜像推到 GHCR(版本号与 CLI 相同):
+LoopForge Local 以 `local-vX.Y.Z` tag 发版时,会把本镜像推到 GHCR(版本号与 CLI 相同):
```bash
docker pull ghcr.io/tencent/loopforge-tcmcp:0.2.1