@coze-arch/cli 0.1.8-alpha.7654a3 → 0.1.8-alpha.7f9604

package/README.md

@@ -42,20 +42,6 @@ coze-dev validate  # 读取 dev.validate
 `dev` 和 `build` 在执行前会尝试应用模板补丁；补丁失败会记录调试信息，但不会阻止主命令。
 子进程日志默认写入 `~/.coze-logs/dev.log`，可用 `--log-file <path>` 覆盖。
 
-## Web 云盘开发
-
-Vite、Next.js、Nuxt 的 Unix 开发 wrapper 在 `COZE_DRIVE_ROOT`（默认 `/Coze/Drive`）内通过
-`rsync` 同步源码到本机临时目录 `coze-web-<uid>/<source-path-hash>/`，再安装依赖和执行。
-`prepare/dev` 使用 `dev` 子目录，`validate` 使用独立的 `check` 子目录，避免类型生成干扰热更新。
-依赖和开发编译产物留在本地；只有安装成功且云盘依赖输入未变化时才回写锁文件。所有修复仍在云盘完成。
-dev 的 detached 进程持续同步，框架只监听本地镜像；同步失败或依赖输入变化时停止服务。
-
-本地镜像仅用于 `[dev].build/run/validate`；部署配置、`build.sh` 和 `start.sh` 保持原流程。
-普通本地目录和 Windows PowerShell 入口保持原流程。`rsync` 由开发环境提供，`[dev].deps` 仅作声明。
-存量项目通过 `coze-dev patch --dry-run` / `coze-dev patch` 升级，沿用 patch 总开关。
-仅升级完整匹配旧模板的三个 Unix 开发脚本并保留端口；自定义开发脚本、命令和同名 helper 会跳过。
-只更新开发插件不会替换存量项目脚本。
-
 ## Windows 与 WSL
 
 原生 Windows（`process.platform === "win32"`）优先使用 `.coze` 中非空的 Windows
@@ -120,7 +106,3 @@ npm run build
 ```
 
 端到端模板验证使用 `npm run test:e2e`，会真实安装模板依赖并启动服务。发布前需完成该验证。
-
-Web 镜像集成测试使用 `npm run test:integration:web`，依赖 Node.js、bash、rsync 和临时
-loopback 监听权限；包管理器和框架命令使用替身，验证目录、同步、锁文件与进程生命周期，
-不替代真实框架 E2E。

package/lib/__templates__/expo/.cozeproj/scripts/prepare-node-modules.sh

@@ -98,7 +98,6 @@ printf '%s\n' "$$" > "$LOCK_DIR/pid"
 trap release_lock EXIT
 
 mkdir -p "$WORK_DIR"
-INSTALL_STATE_FILE="$WORK_DIR/.install-state"
 
 # Previous versions mirrored the whole project into WORK_DIR. That gives pnpm
 # and framework dev servers two paths for the same source tree, which breaks
@@ -119,13 +118,12 @@ cleanup_legacy_workspace() {
   done < <(find "$workspace_dir" -mindepth 1 -maxdepth 1 -print0)
 }
 
-# Preserve existing project caches during dependency preparation.
 cleanup_legacy_shadow_project() {
   local entry name
   while IFS= read -r -d '' entry; do
     name="$(basename "$entry")"
     case "$name" in
-      node_modules|client|server|caches|.install-state) continue ;;
+      node_modules|client|server) continue ;;
     esac
     rm -rf "$entry"
   done < <(find "$WORK_DIR" -mindepth 1 -maxdepth 1 -print0)
@@ -143,162 +141,6 @@ link_install_entry() {
   fi
 }
 
-hash_install_input() {
-  if command -v sha256sum >/dev/null 2>&1; then
-    sha256sum | awk '{print $1}'
-  elif command -v shasum >/dev/null 2>&1; then
-    shasum -a 256 | awk '{print $1}'
-  else
-    cksum | awk '{print $1 "-" $2}'
-  fi
-}
-
-append_file_to_install_fingerprint() {
-  local relative_path="$1"
-  local source_path="$PROJECT_ROOT/$relative_path"
-  printf 'path=%s\n' "$relative_path"
-  if [ -f "$source_path" ]; then
-    cat "$source_path"
-  else
-    printf '<missing>\n'
-  fi
-}
-
-append_directory_to_install_fingerprint() {
-  local relative_path="$1"
-  local source_path="$PROJECT_ROOT/$relative_path"
-  local file
-  printf 'path=%s\n' "$relative_path"
-  if [ ! -d "$source_path" ]; then
-    printf '<missing>\n'
-    return
-  fi
-
-  while IFS= read -r file; do
-    printf 'file=%s\n' "${file#"${PROJECT_ROOT}/"}"
-    cat "$file"
-  done < <(find -P "$source_path" -type f -print | LC_ALL=C sort)
-}
-
-# Everything that can change the resolved dependency tree. The leading version marker
-# invalidates every stored state when this scheme itself changes.
-calculate_install_fingerprint() {
-  local filename workspace argument
-  {
-    printf 'prepare-node-modules-install-state=1\n'
-    printf 'node-version=%s\n' "$(node --version)"
-    printf 'pnpm-version=%s\n' "$(pnpm --version)"
-    printf 'node-env=%s\n' "${NODE_ENV:-}"
-    printf 'npm-config-production=%s\n' "${npm_config_production:-}"
-    printf 'npm-config-production-upper=%s\n' "${NPM_CONFIG_PRODUCTION:-}"
-    printf 'pnpm-config-production=%s\n' "${PNPM_CONFIG_PRODUCTION:-}"
-    for argument in "$@"; do
-      printf 'install-argument=%s\n' "$argument"
-    done
-    for filename in package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc; do
-      append_file_to_install_fingerprint "$filename"
-    done
-    for workspace in client server; do
-      append_file_to_install_fingerprint "$workspace/package.json"
-    done
-    append_directory_to_install_fingerprint patches
-  } | hash_install_input
-}
-
-install_requires_refresh() {
-  local argument
-  for argument in "$@"; do
-    case "$argument" in
-      --force|-f|--lockfile-only|--fix-lockfile) return 0 ;;
-    esac
-  done
-  return 1
-}
-
-# Reuse skips pnpm install entirely, so it must not skip side effects that live outside
-# node_modules. preinstall is exempt: it only guards which package manager may run, and
-# there is no install to guard when the tree is already in place.
-package_has_install_lifecycle() {
-  local package_path="$1"
-  node - "$package_path" <<'NODE'
-const fs = require('node:fs');
-const [packagePath] = process.argv.slice(2);
-
-try {
-  const packageJson = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
-  const scripts = packageJson && typeof packageJson.scripts === 'object' && packageJson.scripts
-    ? packageJson.scripts
-    : {};
-  const hasLifecycle = ['install', 'postinstall', 'prepare'].some(
-    name => typeof scripts[name] === 'string' && scripts[name].trim() !== '',
-  );
-
-  process.exit(hasLifecycle ? 0 : 1);
-} catch {
-  process.exit(0);
-}
-NODE
-}
-
-install_reuse_is_safe() {
-  local workspace package_path
-  for package_path in "$PROJECT_ROOT/.pnpmfile.cjs" "$PROJECT_ROOT/.pnpmfile.js"; do
-    if [ -e "$package_path" ]; then
-      echo "[node_modules] Reinstalling because pnpm hooks are present: $package_path"
-      return 1
-    fi
-  done
-
-  if [ -f "$PROJECT_ROOT/.npmrc" ] && grep -Eq '^[[:space:]]*pnpmfile[[:space:]]*=' "$PROJECT_ROOT/.npmrc"; then
-    echo "[node_modules] Reinstalling because .npmrc configures a pnpm hook."
-    return 1
-  fi
-
-  for workspace in . client server; do
-    package_path="$PROJECT_ROOT/$workspace/package.json"
-    [ -f "$package_path" ] || continue
-    if package_has_install_lifecycle "$package_path"; then
-      echo "[node_modules] Reinstalling because $package_path has an install lifecycle script."
-      return 1
-    fi
-  done
-  return 0
-}
-
-dependencies_are_ready() {
-  local workspace
-  [ -f "$WORK_DIR/node_modules/.modules.yaml" ] || return 1
-  for workspace in client server; do
-    if [ -f "$PROJECT_ROOT/$workspace/package.json" ] &&
-      [ ! -f "$WORK_DIR/$workspace/node_modules/.modules.yaml" ]; then
-      return 1
-    fi
-  done
-  return 0
-}
-
-# 判断顺序按代价从小到大排。指纹要读云盘上的 lockfile 和整个 patches/，所以放最后：只有其余
-# 条件都满足、确实可能复用时才付这份开销。build.sh 和 prepare.sh 不设开关，第一行就返回了。
-install_can_be_reused() {
-  local installed_fingerprint=""
-
-  [ "${COZE_REUSE_NODE_MODULES:-}" = "1" ] || return 1
-  install_requires_refresh "$@" && return 1
-  [ -f "$INSTALL_STATE_FILE" ] || return 1
-  IFS= read -r installed_fingerprint < "$INSTALL_STATE_FILE" || return 1
-  dependencies_are_ready || return 1
-  install_reuse_is_safe || return 1
-  [ "$installed_fingerprint" = "$(calculate_install_fingerprint "$@")" ] || return 1
-  return 0
-}
-
-write_install_state() {
-  local fingerprint="$1" temporary_state
-  temporary_state="$(mktemp "$WORK_DIR/.install-state.XXXXXX")"
-  printf '%s\n' "$fingerprint" > "$temporary_state"
-  mv -f "$temporary_state" "$INSTALL_STATE_FILE"
-}
-
 copy_install_metadata() {
   local filename source_file target_file workspace
   for filename in pnpm-lock.yaml pnpm-workspace.yaml .npmrc; do
@@ -348,26 +190,16 @@ link_node_modules() {
 cleanup_legacy_shadow_project
 copy_install_metadata
 
-if install_can_be_reused "$@"; then
-  echo "[node_modules] Reusing unchanged dependencies in $WORK_DIR"
-else
-  # A stale state file must not survive a failed install.
-  rm -f "$INSTALL_STATE_FILE"
-  echo "[node_modules] Installing dependencies in $WORK_DIR"
-  if ! (cd "$WORK_DIR" && pnpm install "$@"); then
-    exit 1
-  fi
-
-  if [ -f "$WORK_DIR/pnpm-lock.yaml" ]; then
-    temporary_lockfile="$(mktemp "$PROJECT_ROOT/.pnpm-lock.yaml.XXXXXX")"
-    cp "$WORK_DIR/pnpm-lock.yaml" "$temporary_lockfile"
-    chmod 0644 "$temporary_lockfile"
-    mv -f "$temporary_lockfile" "$PROJECT_ROOT/pnpm-lock.yaml"
-  fi
+echo "[node_modules] Installing dependencies in $WORK_DIR"
+if ! (cd "$WORK_DIR" && pnpm install "$@"); then
+  exit 1
+fi
 
-  # pnpm may have rewritten the lockfile, so record the fingerprint of the tree as it
-  # now stands. Otherwise the next run would see a changed input and reinstall.
-  write_install_state "$(calculate_install_fingerprint "$@")"
+if [ -f "$WORK_DIR/pnpm-lock.yaml" ]; then
+  temporary_lockfile="$(mktemp "$PROJECT_ROOT/.pnpm-lock.yaml.XXXXXX")"
+  cp "$WORK_DIR/pnpm-lock.yaml" "$temporary_lockfile"
+  chmod 0644 "$temporary_lockfile"
+  mv -f "$temporary_lockfile" "$PROJECT_ROOT/pnpm-lock.yaml"
 fi
 
 link_node_modules "$PROJECT_ROOT" "$WORK_DIR/node_modules"

package/lib/__templates__/nextjs/.coze

@@ -9,7 +9,7 @@ run = ["bash", "./scripts/dev.sh"]
 run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/dev.ps1"]
 validate = ["bash", "./scripts/validate.sh"]
 validate_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/validate.ps1"]
-deps = ["git", "rsync"] # -> apt install git rsync
+deps = ["git"] # -> apt install git
 
 [deploy]
 build = ["bash","./scripts/build.sh"]

package/lib/__templates__/nextjs/README.md

@@ -361,21 +361,3 @@ export const useStore = create<Store>((set) => ({
 3. **遵循 Next.js App Router 规范**，正确区分服务端/客户端组件
 4. **使用 TypeScript** 进行类型安全开发
 5. **使用 `@/` 路径别名** 导入模块（已配置）
-
-## 云盘源码与本地开发
-
-Vite、Next.js、Nuxt 的 Unix 开发脚本在 `COZE_DRIVE_ROOT`（默认 `/Coze/Drive`）内通过
-`scripts/local-workspace.cjs` 将源码用 `rsync` 同步到本机临时目录。系统需提供 Node.js、pnpm、bash 和 rsync。
-所有开发与修复仍在云盘源码目录完成，从该目录执行 `.coze` 的 `[dev]` 命令。
-
-- `prepare.sh` 同步并在本地安装依赖；安装成功且云盘依赖输入未变化时，仅将更新的锁文件回写云盘。
-- `dev.sh` 在本地镜像运行开发服务，每轮 rsync 结束后等待一秒再同步，框架监听本地文件进行热更新。
-  同步失败或依赖输入变化时停止服务；修复后重新运行 `prepare.sh` / `dev.sh`。
-- `validate.sh` 使用独立的本地 `check` 目录，避免类型生成影响正在运行的 `dev` 服务。
-- 同步排除 `.git`、`node_modules`、日志和框架输出；不要在镜像修复源码或将依赖、编译产物回传云盘。
-  日志和 PID 默认保留在源码目录的 `logs/`，实际镜像路径见脚本输出。
-
-本地镜像仅用于 `[dev].build/run/validate`。部署配置、`build.sh`、`start.sh` 保持原流程；
-普通本地目录和 Windows PowerShell 入口也保持原流程。
-存量项目通过新版 CLI 的 `coze-dev patch --dry-run` / `coze-dev patch` 升级，沿用 patch 总开关。
-仅升级完整匹配旧模板的三个 Unix 开发脚本并保留端口；自定义开发脚本、命令或同名 helper 会跳过。

package/lib/__templates__/nextjs/eslint.config.mjs

@@ -52,7 +52,7 @@ const eslintConfig = defineConfig([
     'server.js',
     'dist/',
     // Script files (CommonJS):
-    'scripts/**/*.{js,cjs}',
+    'scripts/**/*.js',
   ]),
 ]);
 

package/lib/__templates__/nextjs/next.config.ts

@@ -1,9 +1,18 @@
 import type { NextConfig } from 'next';
+import path from 'path';
 
 const nextConfig: NextConfig = {
   // outputFileTracingRoot: path.resolve(__dirname, '../../'),  // Uncomment and add 'import path from "path"' if needed
   /* config options here */
   serverExternalPackages: ['coze-coding-dev-sdk'],
+  webpack: (config, { dev }) => {
+    if (dev && config.cache && config.cache.type === 'filesystem') {
+      config.cache.cacheDirectory = path.resolve(
+        'node_modules/.cache/next-webpack',
+      );
+    }
+    return config;
+  },
   allowedDevOrigins: ['*.dev.coze.site'],
   images: {
     remotePatterns: [

package/lib/__templates__/nextjs/scripts/build.ps1

@@ -8,7 +8,7 @@ Write-Host "Installing dependencies..."
 if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
 
 Write-Host "Building the Next.js project..."
-& pnpm next build
+& pnpm next build --webpack
 if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
 
 Write-Host "Bundling server with tsup..."

package/lib/__templates__/nextjs/scripts/build.sh

@@ -6,10 +6,10 @@ COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
 cd "${COZE_WORKSPACE_PATH}"
 
 echo "Installing dependencies..."
-pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
+bash "$COZE_WORKSPACE_PATH/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
 
 echo "Building the Next.js project..."
-pnpm next build
+pnpm next build --webpack
 
 echo "Bundling server with tsup..."
 pnpm tsup src/server.ts --format cjs --platform node --target node20 --outDir dist --no-splitting --no-minify

package/lib/__templates__/nextjs/scripts/dev.ps1

@@ -28,7 +28,7 @@ Stop-ListeningProcess $port
 
 <% if (process.env.NODE_ENV === 'test') { %>
 $env:PORT = "$port"
-& pnpm next dev --hostname 0.0.0.0 --port $port
+& pnpm next dev --webpack --hostname 0.0.0.0 --port $port
 exit $LASTEXITCODE
 <% } else { %>
 $logDirectory = if ($env:COZE_LOG_DIR) { $env:COZE_LOG_DIR } else { Join-Path $workspace "logs" }
@@ -45,7 +45,7 @@ if (Test-Path $pidFile) {
 $previousPort = $env:PORT
 $env:PORT = "$port"
 try {
-  $process = Start-Process -FilePath $env:ComSpec -ArgumentList @("/d", "/s", "/c", "pnpm next dev --hostname 0.0.0.0 --port $port") -WorkingDirectory $workspace -RedirectStandardOutput $logFile -RedirectStandardError $errorLogFile -PassThru
+  $process = Start-Process -FilePath $env:ComSpec -ArgumentList @("/d", "/s", "/c", "pnpm next dev --webpack --hostname 0.0.0.0 --port $port") -WorkingDirectory $workspace -RedirectStandardOutput $logFile -RedirectStandardError $errorLogFile -PassThru
 } finally {
   if ($null -eq $previousPort) { Remove-Item Env:PORT -ErrorAction SilentlyContinue } else { $env:PORT = $previousPort }
 }

package/lib/__templates__/nextjs/scripts/dev.sh

@@ -1,20 +1,14 @@
 #!/bin/bash
 set -Eeuo pipefail
 
-# Resolve the source project from this script, then let the Web runner choose its local mirror.
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
-PROJECT_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd -P)"
-if [[ "${COZE_WEB_LOCAL_ACTIVE:-}" != "${PROJECT_ROOT}" ]]; then
-  exec node "${SCRIPT_DIR}/local-workspace.cjs" dev "$@"
-fi
-COZE_WORKSPACE_PATH="${PROJECT_ROOT}"
-
 <% if (process.env.NODE_ENV === 'test') { %>
 # 测试环境：支持环境变量覆盖端口
 PORT="${PORT:-<%= port %>}"
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
 DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
 <% } else { %>
 PORT="${DEPLOY_RUN_PORT:-${PORT:-<%= port %>}}"
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
 DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
 <% } %>
 
@@ -58,17 +52,62 @@ kill_port_if_listening() {
     echo "Port ${DEPLOY_RUN_PORT} cleared."
 }
 
+# Next 的路由清单由 watchpack 每次启动重新扫 src 下的 app/pages 目录现算，而 watchpack
+# 不会进入软链目录，软链子树里的 page/route 会被静默跳过：既不注册路由，也不打任何日志，
+# 表现为该路由一直 404 而 .next 里没有它的产物。这里只做提示，不改动源码。
+warn_source_symlinks() {
+    local source_dir="${COZE_WORKSPACE_PATH}/src"
+    local links link
+    if [[ ! -e "${source_dir}" ]]; then
+      return
+    fi
+    links=$(find "${source_dir}" -type l 2>/dev/null || true)
+    if [[ -z "${links}" ]]; then
+      return
+    fi
+    echo "Warning: 以下路径是软链，Next 不会进入其中，里面的 page/route 不会被编译：" >&2
+    while IFS= read -r link; do
+      echo "  ${link}" >&2
+    done <<< "${links}"
+}
+
+# 云盘挂载偶尔会把新建文件的 mtime 设为 Unix epoch。Watchpack 会因此把路由文件当作
+# 启动前的旧状态，导致 Next 的首轮扫描漏掉 route/page。只在云盘项目启动前刷新 app/pages
+# 的目录和普通文件时间戳；不跟随软链、不改文件内容。
+refresh_drive_route_mtimes() {
+    local drive_root="${COZE_DRIVE_ROOT:-/Coze/Drive}"
+    local project_root route_dir
+    project_root="$(pwd -P)"
+    if [[ -d "${drive_root}" ]]; then
+      drive_root="$(cd "${drive_root}" && pwd -P)"
+    else
+      drive_root="${drive_root%/}"
+    fi
+
+    case "${project_root}" in
+      "${drive_root}"|"${drive_root}"/*) ;;
+      *) return ;;
+    esac
+
+    for route_dir in "${COZE_WORKSPACE_PATH}/src/app" "${COZE_WORKSPACE_PATH}/src/pages"; do
+      [[ -d "${route_dir}" ]] || continue
+      if ! find -P "${route_dir}" \( -type f -o -type d \) -exec touch {} + 2>/dev/null; then
+        echo "Warning: failed to refresh Next route timestamps in ${route_dir}." >&2
+      fi
+    done
+}
+
 <% if (process.env.NODE_ENV === 'test') { %>
 echo "Clearing port ${DEPLOY_RUN_PORT} before start."
 kill_port_if_listening
-if [[ "${COZE_WEB_LOCAL_MIRROR:-}" != "1" ]]; then
-  pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
-fi
+bash "${COZE_WORKSPACE_PATH}/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
+warn_source_symlinks
+refresh_drive_route_mtimes
 echo "Starting HTTP service on port ${DEPLOY_RUN_PORT} for dev..."
 
 # 测试环境保持服务为前台进程，便于 e2e 收集输出并停止进程。
 # 开发环境直接使用 Next 的 dev CLI，避免云盘文件事件在 custom server 链路中丢失。
-exec node "${SCRIPT_DIR}/local-workspace.cjs" watch pnpm next dev --hostname 0.0.0.0 --port "${DEPLOY_RUN_PORT}"
+exec pnpm next dev --webpack --hostname 0.0.0.0 --port "${DEPLOY_RUN_PORT}"
 <% } else { %>
 LOG_DIR="${COZE_LOG_DIR:-${COZE_WORKSPACE_PATH}/logs}"
 LOG_FILE="${LOG_DIR}/app.log"
@@ -255,9 +294,9 @@ fi
 
 echo "Clearing port ${DEPLOY_RUN_PORT} before start."
 kill_port_if_listening
-if [[ "${COZE_WEB_LOCAL_MIRROR:-}" != "1" ]]; then
-  pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
-fi
+bash "${COZE_WORKSPACE_PATH}/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
+warn_source_symlinks
+refresh_drive_route_mtimes
 echo "Starting HTTP service on port ${DEPLOY_RUN_PORT} for dev..."
 
 mkdir -p "${LOG_DIR}"
@@ -265,7 +304,7 @@ mkdir -p "${LOG_DIR}"
 
 export PORT="${DEPLOY_RUN_PORT}"
 server_pid="$(spawn_detached "${COZE_WORKSPACE_PATH}" "${LOG_FILE}" \
-  "$(command -v node)" "${SCRIPT_DIR}/local-workspace.cjs" watch "$(command -v pnpm)" next dev --hostname 0.0.0.0 --port "${DEPLOY_RUN_PORT}")"
+  "$(command -v pnpm)" next dev --webpack --hostname 0.0.0.0 --port "${DEPLOY_RUN_PORT}")"
 if [[ -z "${server_pid}" ]]; then
   echo "Dev server failed to start: 未获取到后台进程 PID。" >&2
   dump_log