@coze-arch/cli 0.1.3 → 0.1.4-alpha.0e7259

package/lib/__templates__/expo/.coze

@@ -5,8 +5,11 @@ project_type = "app"
 
 [dev]
 build = ["bash", ".cozeproj/scripts/dev_build.sh"]
+build_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/dev_build.ps1"]
 run = ["bash", ".cozeproj/scripts/dev_run.sh"]
+run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/dev_run.ps1"]
 validate = ["bash", ".cozeproj/scripts/validate.sh"]
+validate_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/validate.ps1"]
 
 [deploy]
 build = ["bash", ".cozeproj/scripts/prod_build.sh"]

package/lib/__templates__/expo/.cozeproj/scripts/dev_build.ps1

@@ -0,0 +1,10 @@
+$ErrorActionPreference = "Stop"
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+Set-Location $workspace
+
+Write-Host "Installing Expo project dependencies..."
+& pnpm install --registry=https://registry.npmmirror.com
+if ($LASTEXITCODE -ne 0) {
+  Write-Warning "Expo 项目依赖安装失败"
+}

package/lib/__templates__/expo/.cozeproj/scripts/dev_build.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 if [ -z "${BASH_VERSION:-}" ]; then exec /usr/bin/env bash "$0" "$@"; fi
 set -euo pipefail
-ROOT_DIR="$(pwd)"
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
 PREVIEW_DIR="/source/preview"
 SOURCE_DIR="/source"
 
@@ -34,8 +34,8 @@ echo "==================== 安装项目依赖 ===================="
 if [ ! -f "package.json" ]; then
   echo "项目目录下无 package.json，不是合法的 Node.js 项目"
 fi
-# 步骤 2.1/2.2：安装项目依赖
-pnpm install --registry=https://registry.npmmirror.com || echo "Expo 项目依赖安装失败（pnpm 执行出错）"
+# 步骤 2.1/2.2：通过受管入口安装项目依赖
+bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --registry=https://registry.npmmirror.com
 
 echo "检查根目录 post_install.py"
 if [ -f "$PREVIEW_DIR/post_install.py" ]; then

package/lib/__templates__/expo/.cozeproj/scripts/dev_run.ps1

@@ -0,0 +1,74 @@
+$ErrorActionPreference = "Stop"
+
+function Stop-ProcessTree([int] $processId) {
+  if ($processId -gt 0 -and (Get-Process -Id $processId -ErrorAction SilentlyContinue)) {
+    & taskkill.exe /PID $processId /T /F *> $null
+  }
+}
+
+function Stop-ListeningProcess([int] $port) {
+  Get-NetTCPConnection -LocalPort $port -State Listen -ErrorAction SilentlyContinue |
+    Select-Object -ExpandProperty OwningProcess -Unique |
+    ForEach-Object { Stop-ProcessTree $_ }
+}
+
+function Start-LoggedProcess([string] $workingDirectory, [string] $logFile, [string[]] $arguments, [hashtable] $environment) {
+  $previousEnvironment = @{}
+  foreach ($key in $environment.Keys) {
+    $previousEnvironment[$key] = [Environment]::GetEnvironmentVariable($key, 'Process')
+    [Environment]::SetEnvironmentVariable($key, $environment[$key], 'Process')
+  }
+
+  try {
+    return Start-Process -FilePath "pnpm.cmd" -ArgumentList $arguments -WorkingDirectory $workingDirectory -RedirectStandardOutput $logFile -RedirectStandardError "$logFile.error" -PassThru
+  } finally {
+    foreach ($key in $environment.Keys) {
+      [Environment]::SetEnvironmentVariable($key, $previousEnvironment[$key], 'Process')
+    }
+  }
+}
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+$serverPort = if ($env:SERVER_PORT) { [int] $env:SERVER_PORT } else { <%= serverPort %> }
+$expoPort = if ($env:DEPLOY_RUN_PORT) { [int] $env:DEPLOY_RUN_PORT } elseif ($env:EXPO_PORT) { [int] $env:EXPO_PORT } else { <%= port %> }
+$logDirectory = if ($env:COZE_LOG_DIR) { $env:COZE_LOG_DIR } else { Join-Path $workspace "logs" }
+$serverLog = Join-Path $logDirectory "server.log"
+$clientLog = Join-Path $logDirectory "client.log"
+New-Item -ItemType Directory -Force -Path $logDirectory | Out-Null
+
+Stop-ListeningProcess $serverPort
+Stop-ListeningProcess $expoPort
+
+$webUrl = if ($env:COZE_PROJECT_DOMAIN_DEFAULT) {
+  $env:COZE_PROJECT_DOMAIN_DEFAULT
+} elseif ($env:COZE_HARDWARE_DID) {
+  "https://cozedaemon-$($env:COZE_HARDWARE_DID)-$expoPort.dev.coze.site"
+} else {
+  "http://127.0.0.1:$serverPort"
+}
+
+$sharedEnvironment = @{
+  EXPO_PUBLIC_BACKEND_BASE_URL = $webUrl
+  EXPO_PACKAGER_PROXY_URL = $webUrl
+  EXPO_PUBLIC_COZE_PROJECT_ID = $env:COZE_PROJECT_ID
+}
+
+Write-Host "Starting server on port $serverPort..."
+$server = Start-LoggedProcess (Join-Path $workspace "server") $serverLog @("exec", "tsx", "watch", "./src/index.ts") (@{ NODE_ENV = "development"; PORT = "$serverPort" })
+
+Write-Host "Starting Expo on port $expoPort..."
+$expoEnvironment = @{}
+$sharedEnvironment.GetEnumerator() | ForEach-Object { $expoEnvironment[$_.Key] = $_.Value }
+$expoEnvironment.EXPO_NO_DEPENDENCY_VALIDATION = "1"
+$expo = Start-LoggedProcess (Join-Path $workspace "client") $clientLog @("exec", "expo", "start", "--web", "--clear", "--port", "$expoPort") $expoEnvironment
+
+Start-Sleep -Seconds 8
+if ((Test-Path $clientLog) -and (Select-String -Path $clientLog -Pattern "TypeError: fetch failed" -Quiet)) {
+  Write-Host "Expo 启动检测到网络错误，启用离线模式重试"
+  Stop-ProcessTree $expo.Id
+  $expoEnvironment.EXPO_OFFLINE = "1"
+  $expo = Start-LoggedProcess (Join-Path $workspace "client") $clientLog @("exec", "expo", "start", "--web", "--clear", "--port", "$expoPort") $expoEnvironment
+}
+
+Write-Host "服务已启动。Server PID: $($server.Id), Expo PID: $($expo.Id)"
+Write-Host "EXPO_PUBLIC_BACKEND_BASE_URL=$webUrl"

package/lib/__templates__/expo/.cozeproj/scripts/dev_run.sh

@@ -135,6 +135,7 @@ shift
 child_pid=$!
 
 # 先忽略 TERM，才能在向整组发 TERM（自己也在组里）之后存活下来补一发 KILL。
+if [[ -z "${COZE_EVAL:-}" && -z "${COZE_PROJECT_TYPE:-}" ]]; then
 ( trap "" TERM
   sleep "${timeout_seconds}"
   echo "[dev] 后台进程运行超过 ${timeout_seconds}s，回收进程组 $$。"
@@ -142,6 +143,7 @@ child_pid=$!
   sleep 5
   kill -KILL -- "-$$" 2>/dev/null || true
 ) &
+fi
 
 wait "${child_pid}"
 kill -KILL -- "-$$" 2>/dev/null || true

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

@@ -0,0 +1,149 @@
+#!/usr/bin/env bash
+# Install dependencies on local disk and expose them to the source tree by symlink.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+if [ "$(basename "$(dirname "$SCRIPT_DIR")")" = ".cozeproj" ]; then
+  PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd -P)"
+else
+  PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd -P)"
+fi
+
+command -v pnpm >/dev/null 2>&1 || {
+  echo "[node_modules] pnpm is required" >&2
+  exit 1
+}
+
+DRIVE_ROOT="${COZE_DRIVE_ROOT:-/Coze/Drive}"
+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"/*) ;;
+  *)
+    (cd "$PROJECT_ROOT" && pnpm install "$@")
+    exit 0
+    ;;
+esac
+
+NM_ROOT="/tmp/nm"
+PROJECT_ID="$(basename "$PROJECT_ROOT")-$(printf '%s' "$PROJECT_ROOT" | cksum | awk '{print $1}')"
+mkdir -p "$NM_ROOT"
+WORK_DIR="$NM_ROOT/$PROJECT_ID"
+case "$WORK_DIR" in
+  "$DRIVE_ROOT"|"$DRIVE_ROOT"/*)
+    echo "[node_modules] local dependency directory must not be on Coze Drive: $WORK_DIR" >&2
+    exit 1
+    ;;
+esac
+
+LOCK_DIR="$NM_ROOT/$PROJECT_ID.lock"
+while ! mkdir "$LOCK_DIR" 2>/dev/null; do
+  echo "[node_modules] Waiting for another dependency preparation for this project..."
+  sleep 1
+done
+trap 'rmdir "$LOCK_DIR" 2>/dev/null || true' EXIT
+
+mkdir -p "$WORK_DIR"
+
+# 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
+# file watching and on-demand compilation. Keep only managed local outputs.
+cleanup_legacy_workspace() {
+  local workspace_dir="$1" entry name
+  if [ -L "$workspace_dir" ] || { [ -e "$workspace_dir" ] && [ ! -d "$workspace_dir" ]; }; then
+    rm -rf "$workspace_dir"
+    return
+  fi
+  if [ ! -d "$workspace_dir" ]; then
+    return 0
+  fi
+
+  while IFS= read -r -d '' entry; do
+    name="$(basename "$entry")"
+    [ "$name" = "node_modules" ] || rm -rf "$entry"
+  done < <(find "$workspace_dir" -mindepth 1 -maxdepth 1 -print0)
+}
+
+cleanup_legacy_shadow_project() {
+  local entry name
+  while IFS= read -r -d '' entry; do
+    name="$(basename "$entry")"
+    case "$name" in
+      node_modules|.next|client|server) continue ;;
+    esac
+    rm -rf "$entry"
+  done < <(find "$WORK_DIR" -mindepth 1 -maxdepth 1 -print0)
+
+  for workspace in client server; do
+    cleanup_legacy_workspace "$WORK_DIR/$workspace"
+  done
+}
+
+copy_install_metadata() {
+  local filename source_file target_file workspace
+  for filename in package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc; do
+    source_file="$PROJECT_ROOT/$filename"
+    target_file="$WORK_DIR/$filename"
+    rm -f "$target_file"
+    if [ -f "$source_file" ]; then
+      cp "$source_file" "$target_file"
+    fi
+  done
+
+  for workspace in client server; do
+    if [ -f "$PROJECT_ROOT/$workspace/package.json" ]; then
+      mkdir -p "$WORK_DIR/$workspace"
+      rm -f "$WORK_DIR/$workspace/package.json"
+      cp "$PROJECT_ROOT/$workspace/package.json" "$WORK_DIR/$workspace/package.json"
+    else
+      rm -rf "$WORK_DIR/$workspace"
+    fi
+  done
+}
+
+link_node_modules() {
+  local source_dir="$1" target_dir="$2"
+  local current=""
+  mkdir -p "$target_dir"
+  if [ -L "$source_dir/node_modules" ]; then
+    current="$(readlink "$source_dir/node_modules")"
+    case "$current" in
+      "$NM_ROOT"/*/node_modules|"$NM_ROOT"/*/*/node_modules) ;;
+      *)
+        echo "[node_modules] refusing to replace unmanaged symlink: $source_dir/node_modules" >&2
+        exit 1
+        ;;
+    esac
+    rm "$source_dir/node_modules"
+  elif [ -e "$source_dir/node_modules" ]; then
+    rm -rf "$source_dir/node_modules"
+  fi
+  ln -s "$target_dir" "$source_dir/node_modules"
+}
+
+cleanup_legacy_shadow_project
+copy_install_metadata
+
+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
+
+link_node_modules "$PROJECT_ROOT" "$WORK_DIR/node_modules"
+for workspace in client server; do
+  if [ -f "$PROJECT_ROOT/$workspace/package.json" ]; then
+    link_node_modules "$PROJECT_ROOT/$workspace" "$WORK_DIR/$workspace/node_modules"
+  fi
+done
+
+echo "[node_modules] Dependencies ready"

package/lib/__templates__/expo/.cozeproj/scripts/prod_build.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 if [ -z "${BASH_VERSION:-}" ]; then exec /usr/bin/env bash "$0" "$@"; fi
 set -euo pipefail
-ROOT_DIR="$(pwd)"
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
 
 # ==================== 工具函数 ====================
 info() {
@@ -32,8 +32,8 @@ info "==================== 安装 Node 依赖 ===================="
 info "开始安装 Node 依赖"
 if [ -f "$ROOT_DIR/package.json" ]; then
   info "进入目录：$ROOT_DIR"
-  info "正在执行：pnpm install"
-  (cd "$ROOT_DIR" && pnpm install --registry=https://registry.npmmirror.com) || error "Node 依赖安装失败"
+  info "正在执行受管依赖准备入口"
+  bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --registry=https://registry.npmmirror.com || error "Node 依赖安装失败"
 else
   warn "未找到 $ROOT_DIR/package.json 文件，请检查路径是否正确"
 fi

package/lib/__templates__/expo/.cozeproj/scripts/validate.ps1

@@ -0,0 +1,7 @@
+$ErrorActionPreference = "Stop"
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+Set-Location $workspace
+
+& pnpm validate
+exit $LASTEXITCODE

package/lib/__templates__/expo/client/components/Screen.tsx

@@ -6,13 +6,19 @@ import {
   View,
   TouchableWithoutFeedback,
   Keyboard,
-  ViewStyle,
+  type ViewStyle,
   FlatList,
+  type FlatListProps,
   SectionList,
+  type SectionListProps,
+  type ScrollViewProps,
   Modal,
 } from 'react-native';
 import { withUniwind } from 'uniwind';
-import { useSafeAreaInsets, Edge } from 'react-native-safe-area-context';
+import {
+  useSafeAreaInsets,
+  type Edge,
+} from 'react-native-safe-area-context';
 import { StatusBar } from 'expo-status-bar';
 // 引入 KeyboardAware 系列组件
 import {
@@ -86,58 +92,92 @@ type KeyboardAwareProps = {
   contentInsetBehaviorIOS: 'automatic' | 'never';
 };
 
+type NativeScrollableProps = Pick<
+  ScrollViewProps,
+  | 'contentContainerStyle'
+  | 'keyboardShouldPersistTaps'
+  | 'keyboardDismissMode'
+  | 'contentInsetAdjustmentBehavior'
+>;
+
 const KeyboardAwareScrollable = ({
   element,
   extraPadding,
   contentInsetBehaviorIOS,
 }: KeyboardAwareProps) => {
-  // 获取原始组件的 props
-  const childAttrs = ((element as React.ReactElement).props ?? {}) as Record<string, unknown>;
-  const originStyle = childAttrs['contentContainerStyle'];
-  const styleArray = Array.isArray(originStyle) ? originStyle : originStyle ? [originStyle] : [];
-  const merged = Object.assign({}, ...styleArray);
-  const currentPB = typeof merged.paddingBottom === 'number' ? merged.paddingBottom : 0;
+  const createEnhancedContentStyle = (
+    contentContainerStyle: ScrollViewProps['contentContainerStyle'],
+  ) => {
+    const mergedStyle = StyleSheet.flatten(contentContainerStyle) ?? {};
+    const currentPaddingBottom =
+      typeof mergedStyle.paddingBottom === 'number'
+        ? mergedStyle.paddingBottom
+        : 0;
 
-  // 合并 paddingBottom (安全区 + 额外留白)
-  const enhancedContentStyle = [{ ...merged, paddingBottom: currentPB + extraPadding }];
+    return [
+      {
+        ...mergedStyle,
+        paddingBottom: currentPaddingBottom + extraPadding,
+      },
+    ];
+  };
 
-  // 基础配置 props，用于传递给 KeyboardAware 组件
-  const commonProps = {
-    ...childAttrs,
-    contentContainerStyle: enhancedContentStyle,
-    keyboardShouldPersistTaps: childAttrs['keyboardShouldPersistTaps'] ?? 'handled',
-    keyboardDismissMode: childAttrs['keyboardDismissMode'] ?? 'on-drag',
+  const createKeyboardAwareProps = <Props extends NativeScrollableProps>(
+    childProps: Props,
+  ) => ({
+    ...childProps,
+    contentContainerStyle: createEnhancedContentStyle(
+      childProps.contentContainerStyle,
+    ),
+    keyboardShouldPersistTaps:
+      childProps.keyboardShouldPersistTaps ?? 'handled',
+    keyboardDismissMode: childProps.keyboardDismissMode ?? 'on-drag',
     enableOnAndroid: true,
     // 类似于原代码中的 setTimeout/scrollToEnd 逻辑，这里设置额外的滚动高度确保输入框可见
     extraHeight: 100,
     // 禁用自带的 ScrollView 自动 inset，由外部 padding 控制
     enableAutomaticScroll: true,
     ...(Platform.OS === 'ios'
-      ? { contentInsetAdjustmentBehavior: childAttrs['contentInsetAdjustmentBehavior'] ?? contentInsetBehaviorIOS }
+      ? {
+          contentInsetAdjustmentBehavior:
+            childProps.contentInsetAdjustmentBehavior ??
+            contentInsetBehaviorIOS,
+        }
       : {}),
-  };
+  });
 
-  const t = (element as React.ReactElement).type;
+  const t = element.type;
 
   // 根据组件类型返回对应的 KeyboardAware 版本
   // 注意：不再使用 KeyboardAvoidingView，直接替换为增强版 ScrollView
   if (t === ScrollView) {
-    return <KeyboardAwareScrollView {...commonProps} />;
+    const childProps = element.props as ScrollViewProps;
+    return (
+      <KeyboardAwareScrollView {...createKeyboardAwareProps(childProps)} />
+    );
   }
 
   if (t === FlatList) {
-    return <KeyboardAwareFlatList {...commonProps} />;
+    const childProps = element.props as FlatListProps<unknown>;
+    return <KeyboardAwareFlatList {...createKeyboardAwareProps(childProps)} />;
   }
 
   if (t === SectionList) {
-    return <KeyboardAwareSectionList {...commonProps} />;
+    const childProps = element.props as SectionListProps<unknown>;
+    return (
+      <KeyboardAwareSectionList {...createKeyboardAwareProps(childProps)} />
+    );
   }
 
   // 理论上不应运行到这里，如果是非标准组件则原样返回，仅修改样式
+  const childProps = element.props as NativeScrollableProps;
   return React.cloneElement(element, {
-    contentContainerStyle: enhancedContentStyle,
-    keyboardShouldPersistTaps: childAttrs['keyboardShouldPersistTaps'] ?? 'handled',
-    keyboardDismissMode: childAttrs['keyboardDismissMode'] ?? 'on-drag',
+    contentContainerStyle: createEnhancedContentStyle(
+      childProps.contentContainerStyle,
+    ),
+    keyboardShouldPersistTaps:
+      childProps.keyboardShouldPersistTaps ?? 'handled',
+    keyboardDismissMode: childProps.keyboardDismissMode ?? 'on-drag',
   });
 };
 

package/lib/__templates__/expo/client/heroui/components/toast/toast.tsx

@@ -1,5 +1,9 @@
 import React, { forwardRef, useMemo } from 'react';
-import { View, Text as RNText } from 'react-native';
+import {
+  type GestureResponderEvent,
+  View,
+  Text as RNText,
+} from 'react-native';
 import { GestureDetector } from 'react-native-gesture-handler';
 import Animated from 'react-native-reanimated';
 import { useThemeColor } from '../../helpers/external/hooks';
@@ -339,7 +343,7 @@ const ToastClose = forwardRef<View, ToastCloseProps>((props, ref) => {
    * If hide and id are available from context, use them to hide the toast
    * Otherwise, use the provided onPress handler
    */
-  const handlePress = (event: Parameters<NonNullable<React.ComponentProps<typeof Button>['onPress']>>[0]) => {
+  const handlePress = (event: GestureResponderEvent) => {
     if (hide && id) {
       hide(id);
     }

package/lib/__templates__/expo/client/heroui/helpers/internal/hooks/use-controllable-state.ts

@@ -108,7 +108,7 @@ function useUncontrolledState<T>({
  * A custom hook that converts a callback to a ref to avoid triggering re-renders when passed as a
  * prop or avoid re-executing effects when passed as a dependency
  */
-function useCallbackRef<T extends (...args: unknown[]) => unknown>(
+function useCallbackRef<T extends (...args: never[]) => unknown>(
   callback: T | undefined
 ): T {
   const callbackRef = useRef(callback);

package/lib/__templates__/expo/pnpm-lock.yaml

@@ -269,8 +269,8 @@ importers:
         specifier: ^2.8.5
         version: 2.8.6
       coze-coding-dev-sdk:
-        specifier: ^0.7.25
-        version: 0.7.25(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0)
+        specifier: ^0.7.28
+        version: 0.7.28(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0)
       dayjs:
         specifier: ^1.11.20
         version: 1.11.20
@@ -2643,8 +2643,8 @@ packages:
     resolution: {integrity: sha512-AdmX6xUzdNASswsFtmwSt7Vj8po9IuqXm0UXz7QKPuEUmPB4XyjGfaAr2PSuELMwkRMVH1EpIkX5bTZGRB3eCA==}
     engines: {node: '>=10'}
 
-  coze-coding-dev-sdk@0.7.25:
-    resolution: {integrity: sha512-5683ngikMdsRW0slGTE2OAZ1Fyj0lhkC4fGNOwsqKc35e68/gtg9KmmtK9CK9SZ+5/oIn/4wLoHXFB0gHJtO2A==}
+  coze-coding-dev-sdk@0.7.28:
+    resolution: {integrity: sha512-ku7AiVWUmgCrUuMT1m2iTmHIwG39EfmcAhPASd8M7XyKxIC6A1cjIIe/3YpStRsj8pMF9LU+pxHWxisf+F44oQ==}
     engines: {node: '>=18.0.0'}
     hasBin: true
 
@@ -9088,7 +9088,7 @@ snapshots:
       path-type: 4.0.0
       yaml: 1.10.2
 
-  coze-coding-dev-sdk@0.7.25(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0):
+  coze-coding-dev-sdk@0.7.28(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0):
     dependencies:
       '@langchain/core': 1.1.17(openai@6.16.0(ws@8.19.0)(zod@4.3.6))
       '@langchain/openai': 1.2.3(@langchain/core@1.1.17(openai@6.16.0(ws@8.19.0)(zod@4.3.6)))(ws@8.19.0)

package/lib/__templates__/expo/server/package.json

@@ -12,7 +12,7 @@
   "dependencies": {
     "@supabase/supabase-js": "2.95.3",
     "cors": "^2.8.5",
-    "coze-coding-dev-sdk": "^0.7.25",
+    "coze-coding-dev-sdk": "^0.7.28",
     "dayjs": "^1.11.20",
     "dotenv": "^17.2.3",
     "drizzle-orm": "^0.45.1",

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

@@ -23,6 +23,11 @@ const eslintConfig = defineConfig([
   ...nextVitals,
   ...nextTs,
   {
+    settings: {
+      // node_modules 里的 barrel 包（lucide-react 等）不参与 ExportMap 构建，
+      // import/no-cycle 只需要项目源码的依赖图。
+      'import/ignore': ['/node_modules/'],
+    },
     rules: {
       'import/no-cycle': ['error', { ignoreExternal: true }],
       'react-hooks/set-state-in-effect': 'off',
@@ -37,14 +42,15 @@ const eslintConfig = defineConfig([
   },
   // Override default ignores of eslint-config-next.
   globalIgnores([
-    // Default ignores of eslint-config-next:
-    '.next/**',
-    'out/**',
-    'build/**',
+    // Default ignores of eslint-config-next (trailing slash prunes the whole
+    // directory instead of walking into it):
+    '.next/',
+    'out/',
+    'build/',
     'next-env.d.ts',
     // Build artifacts:
     'server.js',
-    'dist/**',
+    'dist/',
     // Script files (CommonJS):
     'scripts/**/*.js',
   ]),

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

@@ -1,8 +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/package.json

@@ -6,7 +6,7 @@
     "build": "bash ./scripts/build.sh",
     "dev": "bash ./scripts/dev.sh",
     "preinstall": "npx only-allow pnpm",
-    "lint": "eslint",
+    "lint": "eslint --cache --cache-location node_modules/.cache/eslint/",
     "lint:build": "eslint . --quiet",
     "lint:style": "stylelint \"src/**/*.css\"",
     "start": "bash ./scripts/start.sh",
@@ -47,7 +47,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
-    "coze-coding-dev-sdk": "^0.7.25",
+    "coze-coding-dev-sdk": "^0.7.28",
     "date-fns": "^4.1.0",
     "dotenv": "^17.2.3",
     "drizzle-kit": "^0.31.8",
@@ -73,17 +73,14 @@
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@react-dev-inspector/babel-plugin": "^2.0.1",
-    "@react-dev-inspector/middleware": "^2.0.1",
     "@tailwindcss/postcss": "^4",
     "@types/node": "^20",
     "@types/pg": "^8.16.0",
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "16.3.3",
+    "eslint-config-next": "16.1.1",
     "only-allow": "^1.2.2",
-    "react-dev-inspector": "^2.0.1",
     "shadcn": "latest",
     "stylelint": "^16.4.0",
     "stylelint-config-standard": "^38.0.0",