@baize-ai/core 0.2.0 → 0.3.1

package/docs/docker.md

@@ -2,6 +2,11 @@
 
 Baize can be run inside a Docker container — useful for platforms like Synology NAS, VPS, or any environment where running the native install script is impractical.
 
+Images are **built from the published `@baize-ai/core` npm package** (no source
+code in the build context — the source repository stays private) and published
+as **public images** to GitHub Container Registry (global) and Aliyun ACR
+(China). Build/publish: `./scripts/docker-publish.sh <version>`.
+
 ## Prerequisites
 
 - Docker 24+
@@ -17,11 +22,19 @@ Variables below) if you prefer provisioning at boot.
 ### Option A: Docker Run (simplest)
 
 ```bash
+# Global (GitHub Container Registry)
+docker run -d --name baize \
+  -p 3456:3456 \
+  -v baize-data:/home/baize/baize \
+  -v claude-config:/home/baize/.claude \
+  ghcr.io/baize01-ai/baize-core:latest
+
+# China (Aliyun ACR — fast, no mirror needed)
 docker run -d --name baize \
   -p 3456:3456 \
   -v baize-data:/home/baize/baize \
   -v claude-config:/home/baize/.claude \
-  ghcr.io/baize-ai/baize-core:latest
+  crpi-8bg62qbrjs3cr3as.cn-hangzhou.personal.cr.aliyuncs.com/baize01/baize-core:latest
 ```
 
 Open `http://localhost:3456` to access the web console, then configure
@@ -31,7 +44,7 @@ authentication in 模型设置.
 
 ```bash
 mkdir baize && cd baize
-curl -fsSLO https://raw.githubusercontent.com/baize-ai/baize-core/main/docker-compose.yml
+curl -fsSLO https://raw.githubusercontent.com/baize01-ai/baize-core/main/docker-compose.yml
 ```
 
 Start (auth optional — configure in the web console after boot):
@@ -166,13 +179,14 @@ docker compose up -d
 
 **Docker Run:**
 ```bash
-docker pull ghcr.io/baize-ai/baize-core:latest
+# pull from your regional registry (ghcr global / ACR China)
+docker pull ghcr.io/baize01-ai/baize-core:latest
 docker stop baize && docker rm baize
 docker run -d --name baize \
   -p 3456:3456 \
   -v baize-data:/home/baize/baize \
   -v claude-config:/home/baize/.claude \
-  ghcr.io/baize-ai/baize-core:latest
+  ghcr.io/baize01-ai/baize-core:latest
 ```
 
 **Docker Compose:**

package/docs/release.md

@@ -0,0 +1,150 @@
+# Baize 发布手册（Release Guide）
+
+> npm 包发布 + Docker 镜像发布（ghcr + 阿里云 ACR）完整流程。
+> 组件**包规范**（命名/keywords/打包）见 `docs/component-publishing.md`；本文件聚焦**发布执行**。
+
+## 发布物总览
+
+| 发布物 | 目标 | 内容 |
+|--------|------|------|
+| `@baize-ai/core` | npmjs | CLI + skills（web-console/comm-bridge）+ templates（4738 条目） |
+| `@baize-ai/baize-wecom` | npmjs | 企业微信渠道组件 v0.2.0 |
+| `@baize-ai/baize-feishu` | npmjs | 飞书渠道组件 v0.3.6 |
+| `@baize-ai/baize-lark` | npmjs | 飞书国际版渠道组件 v0.3.11 |
+| `ghcr.io/baize01-ai/baize-core:<v>` | GitHub Container Registry | 海外镜像（`<v>` + `latest`） |
+| `crpi-8bg62qbrjs3cr3as.cn-hangzhou.personal.cr.aliyuncs.com/baize01/baize-core:<v>` | 阿里云 ACR | 国内镜像（`<v>` + `latest`） |
+| `ghcr.io/baize01-ai/baize-admin-workspace:<v>` | GitHub Container Registry | admin 管理台镜像（`<v>` + `latest`） |
+| `crpi-8bg62qbrjs3cr3as.cn-hangzhou.personal.cr.aliyuncs.com/baize01/baize-admin-workspace:<v>` | 阿里云 ACR | admin 管理台国内镜像（`<v>` + `latest`） |
+
+**web-console 不单独发布**：它是 `@baize-ai/core` 包内的 skill，随 core 一起发布；`baize init` 同步到 `~/baize/.claude/skills/web-console/`。
+
+## 前置条件（一次性）
+
+### 1. npm org 与认证
+- npmjs.com 创建组织 **`baize-ai`**（发布 `@baize-ai/*` scope 包的硬前提）
+- 账号开启 2FA 时，CLI 发布要求 **bypass 2FA 的 token**：
+  - npmjs.com → Access Tokens → **Granular Access Token**（勾选 *Bypass 2FA for packages publication*，包权限选 baize-ai org 的 core/wecom/feishu/lark 为 Read and write），或 **Automation token**
+  - 写入 npm 配置：`npm config set //registry.npmjs.org/:_authToken="<token>"`
+  - 验证：`npm whoami` 显示你的账号；`curl -H "Authorization: Bearer <token>" https://registry.npmjs.org/-/whoami` 返回 `{"username":"..."}`
+  - ⚠️ token 若在对话/日志中暴露，发布完成后撤销重新生成
+
+### 2. 阿里云 ACR（国内镜像）
+- 容器镜像服务 → 个人版（免费）→ 命名空间 **`baize01`**（已建）→ **创建镜像仓库 `baize-core`**（本地仓库，先建才能 push）
+- 设置仓库密码：控制台 → 访问凭证 → 设置固定密码
+- 登录：`docker login crpi-8bg62qbrjs3cr3as.cn-hangzhou.personal.cr.aliyuncs.com`（用户名 = 阿里云账号，密码 = 仓库密码）
+
+### 3. GitHub Container Registry（海外镜像）
+- GitHub 账号需有 ghcr 推送权限（org `baize-ai` 就绪后，或先用个人账号 + 私有包空间）
+- 登录：`docker login ghcr.io`（GitHub token，`packages:write` 权限）
+
+### 4. Claude Code 二进制（镜像构建必需）
+- `.claude-local/claude`（~324M，Linux arm64 ELF，gitignored）必须在构建上下文
+- 用途：镜像预装 Claude CLI（容器运行时下载 ~340M 不可靠——D4 实测失败）
+- ⚠️ **发布公开镜像前确认 Anthropic 分发条款**：镜像内含 Claude 二进制，需确认允许在镜像中分发；不允许则改 Dockerfile（运行时按需安装）
+
+## npm 发布
+
+```bash
+cd ~/huyh/work/aiagentpro/baize-ai
+
+# 发布前自检（每个包）
+npm pack --dry-run        # 确认包内容（SKILL.md/src/scripts/ecosystem 在、node_modules/测试排除）
+
+# 逐包发布
+cd baize-core    && npm publish --access public   # @baize-ai/core@0.2.0
+cd ../baize-wecom  && npm publish --access public # @baize-ai/baize-wecom@0.2.0
+cd ../baize-feishu && npm publish --access public # @baize-ai/baize-feishu@0.3.6
+cd ../baize-lark   && npm publish --access public # @baize-ai/baize-lark@0.3.11
+```
+
+### 发布后验证
+
+```bash
+npm view @baize-ai/core version
+npm view @baize-ai/baize-wecom version
+npm view @baize-ai/baize-feishu version
+npm view @baize-ai/baize-lark version
+
+# 国内镜像同步（公开包分钟级）
+npm view @baize-ai/baize-wecom version --registry https://registry.npmmirror.com
+
+# 真实安装链路（全新环境）
+npm i -g @baize-ai/core && baize --version && baize add feishu
+```
+
+### 常见错误
+
+| 错误 | 原因 | 解决 |
+|------|------|------|
+| `403 ... Two-factor authentication or granular access token with bypass 2fa` | 账号 2FA，token 无 bypass 权限或未写入 .npmrc | 生成 bypass-2FA token → `npm config set //registry.npmjs.org/:_authToken=...` |
+| `403 ... do not have permission to publish` | 账号非 org `baize-ai` 成员 | 用创建 org 的账号 / 添加为 member |
+| `NPM_TOKEN` env 不生效 | npm CLI 不读该 env，只认 .npmrc `_authToken` | 写 .npmrc 或 `npm publish --//registry.npmjs.org/:_authToken=<token>` |
+
+## Docker 镜像发布
+
+镜像由**已发布的 npm 包**构建（`Dockerfile` 内 `npm install -g @baize-ai/core@<version>`），构建上下文不含源码（`.dockerignore` 白名单：entrypoint/ecosystem/Claude 二进制）——源码仓库保持私有。
+
+```bash
+cd ~/huyh/work/aiagentpro/baize-ai/baize-core
+
+# 前提：@baize-ai/core 已发布；.claude-local/claude 存在；两 registry 已登录
+
+# 构建 + 双推（ACR 地址/namespace 已写入脚本默认值）
+./scripts/docker-publish.sh 0.2.0
+
+# 或只构建不推送
+./scripts/docker-publish.sh 0.2.0 --build-only
+```
+
+脚本行为：`docker build --build-arg BAZE_CORE_VERSION=0.2.0` → tag `ghcr.io/baize01-ai/baize-core:{v,latest}` + `crpi-.../baize01/baize-core:{v,latest}` → 双推。
+
+### 发布后验证
+
+```bash
+# 国内拉取（免镜像加速）
+docker pull crpi-8bg62qbrjs3cr3as.cn-hangzhou.personal.cr.aliyuncs.com/baize01/baize-core:latest
+docker run -d --name baize -p 3456:3456 \
+  -v baize-data:/home/baize/baize -v claude-config:/home/baize/.claude \
+  crpi-8bg62qbrjs3cr3as.cn-hangzhou.personal.cr.aliyuncs.com/baize01/baize-core:latest
+# 打开 http://localhost:3456 → 「模型设置」配置认证
+
+# 海外
+docker pull ghcr.io/baize01-ai/baize-core:latest
+```
+
+### baize-admin-workspace 镜像（源码构建）
+
+与 core 不同，admin-workspace 镜像**从本仓库源码构建**（多阶段 Dockerfile：node:22 构建 admin-ui → node:22-slim 运行 API），tag 与版本号一致，不依赖 npm 发布。
+
+```bash
+cd ~/huyh/work/aiagentpro/baize-ai/baize-admin-workspace
+
+# 构建 + 双推（同一套 ACR/ghcr 默认值，脚本参照 docker-publish.sh 模式）
+./scripts/docker-publish.sh 0.1.0
+
+# 验证（首次登录：admin + BAIZE_ADMIN_TOKEN 或启动日志打印的随机口令）
+docker pull crpi-8bg62qbrjs3cr3as.cn-hangzhou.personal.cr.aliyuncs.com/baize01/baize-admin-workspace:latest
+docker run -d --name baize-admin -p 8080:8080 -v baize-admin-data:/data \
+  crpi-8bg62qbrjs3cr3as.cn-hangzhou.personal.cr.aliyuncs.com/baize01/baize-admin-workspace:latest
+# API: http://localhost:8080/healthz ；控制台静态产物在容器内 /app/dist（反代挂同源）
+```
+
+## 版本与发布节奏
+
+- **版本号**：core 与组件均为 SemVer；镜像 tag 与 npm 版本一致（`docker-publish.sh <version>` 的参数 = npm 包版本）
+- **发布顺序**：npm 四包 → 镜像（依赖 npm core 包）→ 验证
+- **npmmirror**：公开 npm 包自动镜像（分钟级），国内 npm 用户无需操作
+- **公开镜像**：发布即公开（匿名可拉）；Node 镜像含运行时 JS 可被查看，源码仓库私有不受影响
+
+## 完整 checklist
+
+- [ ] npm org `baize-ai` 已创建、账号有发布权限
+- [ ] bypass-2FA token 写入 .npmrc，`npm whoami` 通过
+- [ ] ACR 命名空间 baize01 + 镜像仓库 baize-core 已建、`docker login` 通过
+- [ ] ghcr `docker login` 通过
+- [ ] `.claude-local/claude` 存在（324M）
+- [ ] Anthropic 镜像分发条款已确认
+- [ ] 四包 `npm publish` 成功 + `npm view` 验证
+- [ ] `./scripts/docker-publish.sh 0.2.0` 双推成功
+- [ ] 国内/海外 `docker pull` + 运行验证
+- [ ] 泄露过的 token 已撤销重生成

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baize-ai/core",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "Baize (白泽) — autonomous AI agent infrastructure",
   "main": "cli/baize.js",

package/scripts/docker-publish.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# ────────────────────────────────────────────────────────────────────────────
+# Baize Docker image build + dual-registry publish (ghcr + Aliyun ACR)
+#
+# Publishes a PUBLIC image from the published npm package — no source code in
+# the build context (see .dockerignore). Source repo stays private.
+#
+# Usage:
+#   ./scripts/docker-publish.sh <version>            # build + push both
+#   ./scripts/docker-publish.sh <version> --build-only
+#
+# Env:
+#   ACR_REGISTRY   e.g. registry.cn-hangzhou.aliyuncs.com (required for ACR push)
+#   ACR_NAMESPACE  your Aliyun ACR namespace (required for ACR push)
+#   GHCR_ORG       default baize01-ai
+#
+# Auth (once per registry, or via CI secrets):
+#   docker login ghcr.io --username <user> --password <token>
+#   docker login ${ACR_REGISTRY} --username <user> --password <password>
+# ────────────────────────────────────────────────────────────────────────────
+set -euo pipefail
+
+VERSION="${1:?Usage: docker-publish.sh <version> [--build-only]}"
+BUILD_ONLY="${2:-}"
+
+GHCR_ORG="${GHCR_ORG:-baize01-ai}"
+GHCR_IMAGE="ghcr.io/${GHCR_ORG}/baize-core"
+ACR_REGISTRY="${ACR_REGISTRY:-crpi-8bg62qbrjs3cr3as.cn-hangzhou.personal.cr.aliyuncs.com}"
+ACR_NAMESPACE="${ACR_NAMESPACE:-baize01}"
+
+# ── Build ────────────────────────────────────────────────────────────────────
+echo "==> Building baize-core:${VERSION} (from npm @baize-ai/core@${VERSION})"
+docker build \
+  --build-arg BAZE_CORE_VERSION="${VERSION}" \
+  -t "${GHCR_IMAGE}:${VERSION}" \
+  -t "${GHCR_IMAGE}:latest" \
+  .
+
+if [ -n "${ACR_REGISTRY}" ] && [ -n "${ACR_NAMESPACE}" ]; then
+  ACR_IMAGE="${ACR_REGISTRY}/${ACR_NAMESPACE}/baize-core"
+  docker tag "${GHCR_IMAGE}:${VERSION}" "${ACR_IMAGE}:${VERSION}"
+  docker tag "${GHCR_IMAGE}:${VERSION}" "${ACR_IMAGE}:latest"
+fi
+
+echo "==> Built: ${GHCR_IMAGE}:${VERSION} (+latest)"
+[ "${BUILD_ONLY}" = "--build-only" ] && { echo "Build only — not pushing."; exit 0; }
+
+# ── Push ─────────────────────────────────────────────────────────────────────
+# ACR first (mainland China primary). ghcr requires the GitHub org (KI-001);
+# a ghcr failure degrades to a warning so the ACR push still completes.
+PUSH_GHCR="${PUSH_GHCR:-1}"
+if [ -n "${ACR_IMAGE:-}" ]; then
+  echo "==> Pushing ${ACR_IMAGE} (Aliyun ACR — fast for mainland China)"
+  docker push "${ACR_IMAGE}:${VERSION}"
+  docker push "${ACR_IMAGE}:latest"
+fi
+
+if [ "${PUSH_GHCR}" = "1" ]; then
+  echo "==> Pushing ${GHCR_IMAGE}"
+  if docker push "${GHCR_IMAGE}:${VERSION}" && docker push "${GHCR_IMAGE}:latest"; then
+    :
+  else
+    echo "!! ghcr push failed (org/权限未就绪? 见 docs/release.md). ACR push above already completed." >&2
+    [ "${STRICT_GHCR:-}" = "1" ] && exit 1
+  fi
+fi
+
+echo "==> Done."
+echo "    Global:      docker pull ${GHCR_IMAGE}:${VERSION}"
+echo "    China:       docker pull ${ACR_IMAGE:-<ACR_REGISTRY>/<namespace>/baize-core}:${VERSION}"

package/scripts/install.sh

@@ -3,10 +3,10 @@
 # Baize One-Click Installer
 #
 # Usage:
-#   curl -fsSL https://raw.githubusercontent.com/baize-ai/baize-core/main/scripts/install.sh | bash
+#   curl -fsSL https://raw.githubusercontent.com/baize01-ai/baize-core/main/scripts/install.sh | bash
 #
 # Install from a specific branch:
-#   curl -fsSL https://raw.githubusercontent.com/baize-ai/baize-core/main/scripts/install.sh | bash -s -- --branch <branch-name>
+#   curl -fsSL https://raw.githubusercontent.com/baize01-ai/baize-core/main/scripts/install.sh | bash -s -- --branch <branch-name>
 #
 # Full non-interactive deployment:
 #   curl -fsSL .../install.sh | bash -s -- -y --setup-token sk-ant-oat01-xxx --domain example.com --https
@@ -74,7 +74,7 @@ while [ $# -gt 0 ]; do
 done
 
 # ── Configuration ─────────────────────────────────────────────
-BAIZE_REPO="https://github.com/baize-ai/baize-core"
+BAIZE_REPO="https://github.com/baize01-ai/baize-core"
 NODE_VERSION="24"               # LTS-track major version
 MIN_NODE_MAJOR=20
 NVM_INSTALL_URL="https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh"
@@ -102,7 +102,7 @@ fail()  { printf "${RED}[baize]${NC} %s\n" "$*" >&2; exit 1; }
 if [ -z "$BRANCH" ]; then
   # No --branch specified: resolve latest release tag (stable version).
   # Uses GitHub API (curl is available; git may not be installed yet).
-  LATEST_TAG="$(curl -fsSL "https://api.github.com/repos/baize-ai/baize-core/releases/latest" 2>/dev/null \
+  LATEST_TAG="$(curl -fsSL "https://api.github.com/repos/baize01-ai/baize-core/releases/latest" 2>/dev/null \
     | sed -n 's/.*"tag_name": *"\([^"]*\)".*/\1/p')"
   if [ -n "$LATEST_TAG" ]; then
     BRANCH="$LATEST_TAG"