@coze-arch/cli 0.0.9 → 0.0.10-alpha.acdcf1

package/lib/__templates__/expo/AGENTS.md

@@ -67,6 +67,10 @@ npm run lint:server
 
 默认为跟随系统，如果用户明确指定为“暗色”或“亮色”，需要修改 `client/components/ColorSchemeUpdater.tsx` 的 `DEFAULT_THEME` 变量为合适的值
 
+## 如何定制主题 design tokens
+
+当前项目的**设计系统**基于 tailwindcss 实现，核心入口文件为 `client/global.css`，如果需要定制主题，应该**阅读并修改 `client/global.css` 文件**
+
 ## 路由及 Tab Bar 实现规范
 
 ### 方案一：无 Tab Bar（Stack 导航）
@@ -82,17 +86,14 @@ client/app/
 ```
 
 **根布局配置** `client/app/_layout.tsx`：
-```tsx
-import { Stack } from 'expo-router';
 
-export default function RootLayout() {
-  return (
-    <Stack screenOptions={{ headerShown: false }}>
-      <Stack.Screen name="index" />
-      <Stack.Screen name="detail" />
-    </Stack>
-  );
-}
+以下仅为代码片段供写法参考
+
+```tsx
+<Stack screenOptions={{ headerShown: false }}>
+  <Stack.Screen name="index" />
+  <Stack.Screen name="detail" />
+</Stack>
 ```
 
 **应用入口** `client/app/index.tsx`：
@@ -118,17 +119,14 @@ client/app/
 > **⚠️ [CRITICAL]**： `app/index.tsx` 优先级高于 `(tabs)/index.tsx`，会导致首页无 Tab Bar。**当有(tabs)/index.tsx时必须删除 `app/index.tsx`**。
 
 **根布局配置** `client/app/_layout.tsx`：
-```tsx
-import { Stack } from 'expo-router';
 
-export default function RootLayout() {
-  return (
-    <Stack screenOptions={{ headerShown: false }}>
-      <Stack.Screen name="(tabs)" />
-      <Stack.Screen name="detail" />
-    </Stack>
-  );
-}
+以下仅为代码片段供写法参考
+
+```tsx
+<Stack screenOptions={{ headerShown: false }}>
+  <Stack.Screen name="(tabs)" />
+  <Stack.Screen name="detail" />
+</Stack>
 ```
 
 **应用入口** `client/app/(tabs)/index.tsx`：
@@ -162,18 +160,11 @@ export default function TabLayout() {
           backgroundColor: background,
           borderTopWidth: 1,
           borderTopColor: border,
-          // 移动端：标准高度 50px + 底部安全区
-          // Web端：固定60px，无需安全区
-          height: Platform.OS === 'web' ? 60 : 50 + insets.bottom,
-          // 移动端：内容区域底部 padding 防止内容被遮挡
-          paddingBottom: Platform.OS === 'web' ? 0 : insets.bottom,
+          // 通过固定宽度 55 来修正 Web 上的表现
+          height: Platform.OS === 'web' ? 55 : 50 + insets.bottom,
         },
         tabBarActiveTintColor: accent,
         tabBarInactiveTintColor: muted,
-        tabBarItemStyle: {
-          // Web 端必须显式指定 item 高度，防止 Tab Bar 高度塌陷或图标显示异常
-          height: Platform.OS === 'web' ? 60 : undefined,
-        },
       }}
     >
       {/* name 必须与文件名完全一致 */}
@@ -214,6 +205,15 @@ export default function TabLayout() {
 export { default } from "@/screens/home";
 ```
 
+### 注意事项
+
+在改动 `client/app/_layout.tsx` 前，必须先阅读该文件，再进行修改操作
+
+以下是需要保留的重要逻辑
+
+- 保留 global.css 引入（tailwindcss 生效的关键）
+- 保留 Provider 的使用
+
 ## 依赖管理与模块导入规范
 
 ### 依赖安装

package/lib/__templates__/expo/README.md

@@ -67,6 +67,10 @@ npm run lint:server
 
 默认为跟随系统，如果用户明确指定为“暗色”或“亮色”，需要修改 `client/components/ColorSchemeUpdater.tsx` 的 `DEFAULT_THEME` 变量为合适的值
 
+## 如何定制主题 design tokens
+
+当前项目的**设计系统**基于 tailwindcss 实现，核心入口文件为 `client/global.css`，如果需要定制主题，应该**阅读并修改 `client/global.css` 文件**
+
 ## 路由及 Tab Bar 实现规范
 
 ### 方案一：无 Tab Bar（Stack 导航）
@@ -82,17 +86,14 @@ client/app/
 ```
 
 **根布局配置** `client/app/_layout.tsx`：
-```tsx
-import { Stack } from 'expo-router';
 
-export default function RootLayout() {
-  return (
-    <Stack screenOptions={{ headerShown: false }}>
-      <Stack.Screen name="index" />
-      <Stack.Screen name="detail" />
-    </Stack>
-  );
-}
+以下仅为代码片段供写法参考
+
+```tsx
+<Stack screenOptions={{ headerShown: false }}>
+  <Stack.Screen name="index" />
+  <Stack.Screen name="detail" />
+</Stack>
 ```
 
 **应用入口** `client/app/index.tsx`：
@@ -118,17 +119,14 @@ client/app/
 > **⚠️ [CRITICAL]**： `app/index.tsx` 优先级高于 `(tabs)/index.tsx`，会导致首页无 Tab Bar。**当有(tabs)/index.tsx时必须删除 `app/index.tsx`**。
 
 **根布局配置** `client/app/_layout.tsx`：
-```tsx
-import { Stack } from 'expo-router';
 
-export default function RootLayout() {
-  return (
-    <Stack screenOptions={{ headerShown: false }}>
-      <Stack.Screen name="(tabs)" />
-      <Stack.Screen name="detail" />
-    </Stack>
-  );
-}
+以下仅为代码片段供写法参考
+
+```tsx
+<Stack screenOptions={{ headerShown: false }}>
+  <Stack.Screen name="(tabs)" />
+  <Stack.Screen name="detail" />
+</Stack>
 ```
 
 **应用入口** `client/app/(tabs)/index.tsx`：
@@ -162,18 +160,11 @@ export default function TabLayout() {
           backgroundColor: background,
           borderTopWidth: 1,
           borderTopColor: border,
-          // 移动端：标准高度 50px + 底部安全区
-          // Web端：固定60px，无需安全区
-          height: Platform.OS === 'web' ? 60 : 50 + insets.bottom,
-          // 移动端：内容区域底部 padding 防止内容被遮挡
-          paddingBottom: Platform.OS === 'web' ? 0 : insets.bottom,
+          // 通过固定宽度 55 来修正 Web 上的表现
+          height: Platform.OS === 'web' ? 55 : 50 + insets.bottom,
         },
         tabBarActiveTintColor: accent,
         tabBarInactiveTintColor: muted,
-        tabBarItemStyle: {
-          // Web 端必须显式指定 item 高度，防止 Tab Bar 高度塌陷或图标显示异常
-          height: Platform.OS === 'web' ? 60 : undefined,
-        },
       }}
     >
       {/* name 必须与文件名完全一致 */}
@@ -214,6 +205,15 @@ export default function TabLayout() {
 export { default } from "@/screens/home";
 ```
 
+### 注意事项
+
+在改动 `client/app/_layout.tsx` 前，必须先阅读该文件，再进行修改操作
+
+以下是需要保留的重要逻辑
+
+- 保留 global.css 引入（tailwindcss 生效的关键）
+- 保留 Provider 的使用
+
 ## 依赖管理与模块导入规范
 
 ### 依赖安装

package/lib/__templates__/expo/_npmrc

@@ -19,3 +19,6 @@ prefer-frozen-lockfile=true
 
 # semver 选择最高版本
 resolution-mode=highest
+
+# 不提示 npm 更新
+update-notifier=false

package/lib/__templates__/nextjs/AGENTS.md

@@ -42,9 +42,13 @@
 
 ## 开发规范
 
-- **项目理解加速**：初始可以依赖项目下`package.json`文件理解项目类型，如果没有或无法理解退化成阅读其他文件。
-- **Hydration 错误预防**：严禁在 JSX 渲染逻辑中直接使用 typeof window、Date.now()、Math.random() 等动态数据。必须使用 'use client' 并配合 useEffect + useState 确保动态内容仅在客户端挂载后渲染；同时严禁非法 HTML 嵌套（如 <p> 嵌套 <div>）。
+### Hydration 问题防范
 
+1. 严禁在 JSX 渲染逻辑中直接使用 typeof window、Date.now()、Math.random() 等动态数据。**必须使用 'use client' 并配合 useEffect + useState 确保动态内容仅在客户端挂载后渲染**；同时严禁非法 HTML 嵌套（如 <p> 嵌套 <div>）。
+2. **禁止使用 head 标签**，优先使用 metadata，详见文档：https://nextjs.org/docs/app/api-reference/functions/generate-metadata
+   1. 三方 CSS、字体等资源在 `globals.css` 中顶部通过 `@import` 引入
+   2. preload, preconnect, dns-prefetch 通过 ReactDOM 的 preload、preconnect、dns-prefetch 方法引入
+   3. json-ld 可阅读 https://nextjs.org/docs/app/guides/json-ld
 
 ## UI 设计与组件规范 (UI & Styling Standards)
 

package/lib/__templates__/nextjs/_npmrc

@@ -21,3 +21,6 @@ prefer-frozen-lockfile=true
 
 # 如果 lockfile 存在但过期，更新而不是失败
 resolution-mode=highest
+
+# 不提示 npm 更新
+update-notifier=false

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

@@ -5,6 +5,12 @@ import { defineConfig, globalIgnores } from 'eslint/config';
 const eslintConfig = defineConfig([
   ...nextVitals,
   ...nextTs,
+  {
+    rules: {
+      'react-hooks/set-state-in-effect': 'off',
+      '@next/next/no-head-element': 'error',
+    },
+  },
   // Override default ignores of eslint-config-next.
   globalIgnores([
     // Default ignores of eslint-config-next:

package/lib/__templates__/nuxt-vue/_npmrc

@@ -21,3 +21,6 @@ prefer-frozen-lockfile=true
 
 # 如果 lockfile 存在但过期，更新而不是失败
 resolution-mode=highest
+
+# 不提示 npm 更新
+update-notifier=false

package/lib/__templates__/taro/_npmrc

@@ -16,3 +16,6 @@ lockfile=true
 prefer-frozen-lockfile=true
 
 resolution-mode=highest
+
+# 不提示 npm 更新
+update-notifier=false

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

@@ -9,6 +9,40 @@ const compat = new FlatCompat({
   baseDirectory: __dirname,
 });
 
+const REMOTE_CSS_IMPORT_PATTERN =
+  /@import\s+(?:url\(\s*['"]?((?:https?:)?\/\/[^'")\s]+)['"]?\s*\)|['"]((?:https?:)?\/\/[^'"\s]+)['"])/g;
+
+const cssImportGuardPlugin = {
+  processors: {
+    css: {
+      preprocess(text) {
+        const lines = text.split('\n');
+        const virtualLines = lines.map(line => {
+          const matches = [...line.matchAll(REMOTE_CSS_IMPORT_PATTERN)];
+
+          if (matches.length === 0) {
+            return '';
+          }
+
+          return matches
+            .map(match => {
+              const url = match[1] ?? match[2];
+
+              return `__cssExternalImport(${JSON.stringify(url)});`;
+            })
+            .join(' ');
+        });
+
+        return [virtualLines.join('\n')];
+      },
+      postprocess(messages) {
+        return messages.flat();
+      },
+      supportsAutofix: false,
+    },
+  },
+};
+
 const baseRestrictedSyntaxRules = [
   {
     selector: "MemberExpression[object.name='process'][property.name='env']",
@@ -72,6 +106,12 @@ const baseRestrictedSyntaxRules = [
       ":matches(JSXAttribute[name.name='className'], CallExpression[callee.name=/^(cn|cva)$/]) :matches(Literal[value=/\\[[^\\]]*&[^\\]]*~[^\\]]*\\]/], TemplateElement[value.raw=/\\[[^\\]]*&[^\\]]*~[^\\]]*\\]/])",
     message: '微信小程序兼容性：WXSS 不支持 ~（会导致预览上传失败）。',
   },
+  {
+    selector:
+      "CallExpression[callee.name='__cssExternalImport'] > Literal[value=/^(?:https?:)?\\/\\//]",
+    message:
+      '微信小程序兼容性：禁止在 CSS/WXSS 中使用远程 @import（如 Google Fonts）。请改为本地静态资源或删除该导入。',
+  },
   {
     selector:
       "JSXAttribute[name.name='color'][value.type='Literal'][value.value='currentColor'], JSXAttribute[name.name='color'] > JSXExpressionContainer > Literal[value='currentColor']",
@@ -173,6 +213,17 @@ export default [
       ],
     },
   },
+  {
+    files: ['src/**/*.css'],
+    plugins: {
+      local: cssImportGuardPlugin,
+    },
+    processor: 'local/css',
+    rules: {
+      'no-undef': 'off',
+      'no-restricted-syntax': ['error', ...baseRestrictedSyntaxRules],
+    },
+  },
   {
     files: ['src/pages/**/*.tsx'],
     rules: {

package/lib/__templates__/taro/package.json

@@ -17,9 +17,9 @@
     "preinstall": "npx only-allow pnpm",
     "postinstall": "weapp-tw patch",
     "kill:all": "pkill -9 -f 'concurrently' 2>/dev/null || true; pkill -9 -f 'nest start' 2>/dev/null || true; pkill -9 -f 'taro build' 2>/dev/null || true; pkill -9 -f 'node.*dev' 2>/dev/null || true; echo 'All dev processes cleaned'",
-    "lint": "eslint \"src/**/*.{js,jsx,ts,tsx}\"",
-    "lint:build": "eslint \"src/**/*.{js,jsx,ts,tsx}\" --max-warnings=0",
-    "lint:fix": "eslint \"src/**/*.{js,jsx,ts,tsx}\" --fix",
+    "lint": "eslint \"src/**/*.{js,jsx,ts,tsx,css}\"",
+    "lint:build": "eslint \"src/**/*.{js,jsx,ts,tsx,css}\" --max-warnings=0",
+    "lint:fix": "eslint \"src/**/*.{js,jsx,ts,tsx,css}\" --fix",
     "new": "taro new",
     "preview:tt": "taro build --type tt --preview",
     "preview:weapp": "taro build --type weapp --preview",
@@ -27,7 +27,7 @@
     "validate": "pnpm exec concurrently --kill-others-on-fail --kill-signal SIGKILL -n lint,tsc -c red,blue \"pnpm lint:build\" \"pnpm tsc\""
   },
   "lint-staged": {
-    "src/**/*.{js,jsx,ts,tsx}": [
+    "src/**/*.{js,jsx,ts,tsx,css}": [
       "eslint"
     ]
   },

package/lib/__templates__/taro/project.config.json

@@ -12,12 +12,5 @@
     "minified": false
   },
   "compileType": "miniprogram",
-  "packOptions": {
-    "ignore": [
-      {
-        "type": "folder",
-        "value": "assets"
-      }
-    ]
-  }
+  "packOptions": {"ignore": [{"type": "folder","value": "./assets"}]}
 }

package/lib/__templates__/vite/_npmrc

@@ -21,3 +21,6 @@ prefer-frozen-lockfile=true
 
 # 如果 lockfile 存在但过期，更新而不是失败
 resolution-mode=highest
+
+# 不提示 npm 更新
+update-notifier=false

package/lib/cli.js

@@ -2106,7 +2106,7 @@ const EventBuilder = {
 };
 
 var name = "@coze-arch/cli";
-var version = "0.0.9";
+var version = "0.0.10-alpha.acdcf1";
 var description = "coze coding devtools cli";
 var license = "MIT";
 var author = "fanwenjie.fe@bytedance.com";
@@ -2166,6 +2166,7 @@ var devDependencies = {
 	"@coze-coding/lambda": "workspace:*",
 	"@inquirer/prompts": "^3.2.0",
 	"@playwright/test": "~1.55.0",
+	"@slardar/rd-cli": "^0.10.3",
 	"@types/debug": "^4.1.12",
 	"@types/ejs": "^3.1.5",
 	"@types/iarna__toml": "^2.0.5",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.9",
+  "version": "0.0.10-alpha.acdcf1",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",
@@ -60,6 +60,7 @@
     "@coze-coding/lambda": "workspace:*",
     "@inquirer/prompts": "^3.2.0",
     "@playwright/test": "~1.55.0",
+    "@slardar/rd-cli": "^0.10.3",
     "@types/debug": "^4.1.12",
     "@types/ejs": "^3.1.5",
     "@types/iarna__toml": "^2.0.5",