@coze-arch/cli 0.0.1-alpha.db1c06 → 0.0.1-alpha.de4758

package/README.md

@@ -14,6 +14,7 @@ Coze Coding 的项目模板引擎，提供基于前端技术栈的项目初始
 
 ```bash
 rush update
+
 ```
 
 ## 使用

package/lib/__templates__/expo/_npmrc

@@ -1,3 +1,4 @@
+loglevel=error
 registry=https://registry.npmmirror.com
 
 strictStorePkgContentCheck=false

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

@@ -32,7 +32,7 @@ import {
  *
  * ## 2. 沉浸式 Header (推荐)
  * - 场景：Header 背景色/图片需要延伸到状态栏 (如首页、个人中心)。
- * - 用法：`<Screen safeAreaEdges={['left', 'right', 'bottom']}>` (❌ 去掉 'top')
+ * - 用法：`<Screen safeAreaEdges={['left', 'right', 'bottom']}>` (去掉 'top')
  * - 配合：页面内部 Header 组件必须手动添加 paddingTop:
  *   ```tsx
  *   const insets = useSafeAreaInsets();
@@ -41,7 +41,7 @@ import {
  *
  * ## 3. 底部有 TabBar 或 悬浮按钮
  * - 场景：页面底部有固定导航栏，或者需要精细控制底部留白。
- * - 用法：`<Screen safeAreaEdges={['top', 'left', 'right']}>` (❌ 去掉 'bottom')
+ * - 用法：`<Screen safeAreaEdges={['top', 'left', 'right']}>` (去掉 'bottom')
  * - 配合：
  *   - 若是滚动页：`<ScrollView contentContainerStyle={{ paddingBottom: insets.bottom + 80 }}>`
  *   - 若是固定页：`<View style={{ paddingBottom: insets.bottom + 60 }}>`

package/lib/__templates__/expo/client/eslint.config.mjs

@@ -8,6 +8,8 @@ import pluginImport from 'eslint-plugin-import';
 import fontawesome6 from '../eslint-plugins/fontawesome6/index.js';
 import reanimated from '../eslint-plugins/reanimated/index.js';
 import reactnative from '../eslint-plugins/react-native/index.js';
+import forbidEmoji from '../eslint-plugins/forbid-emoji/index.js';
+import restrictLinearGradient from '../eslint-plugins/restrict-linear-gradient/index.js';
 
 export default [
   {
@@ -20,6 +22,7 @@ export default [
       'tailwind.config.js', // 排除 Tailwind 配置文件
       '**/*.d.ts',
       'eslint.config.*',
+      'metro.config.*',
     ],
   },
   regexp.configs["flat/recommended"],
@@ -60,6 +63,8 @@ export default [
       fontawesome6,
       reanimated,
       reactnative,
+      forbidEmoji,
+      restrictLinearGradient,
     },
     rules: {
       // 关闭代码风格规则
@@ -80,6 +85,8 @@ export default [
       'react/jsx-uses-react': 'off',
       'fontawesome6/valid-name': 'error',
       'reanimated/ban-mix-use': 'error',
+      'forbidEmoji/no-emoji': 'error',
+      'restrictLinearGradient/no-linear-gradient-backgroundcolor': 'error',
       // 禁止使用 via.placeholder.com 服务
       'no-restricted-syntax': [
         'error',

package/lib/__templates__/expo/client/scripts/install-missing-deps.js

@@ -9,7 +9,7 @@ const { execSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 
-console.log('🔍 检测缺失的依赖...\n');
+console.log('检测缺失的依赖...\n');
 
 try {
   // 运行 depcheck 并获取 JSON 输出
@@ -61,11 +61,11 @@ try {
   });
 
   if (missingPackages.length === 0) {
-    console.log('✅ 没有发现缺失的依赖！');
+    console.log('没有发现缺失的依赖');
     process.exit(0);
   }
 
-  console.log('📦 发现以下缺失的依赖：');
+  console.log('发现以下缺失的依赖：');
   missingPackages.forEach((pkg, index) => {
     const files = missing[pkg];
     console.log(`  ${index + 1}. ${pkg}`);
@@ -74,7 +74,7 @@ try {
     );
   });
 
-  console.log('\n🚀 开始安装...\n');
+  console.log('\n开始安装...\n');
 
   // 使用 expo install 安装所有缺失的包
   const packagesToInstall = missingPackages.join(' ');
@@ -84,22 +84,22 @@ try {
       stdio: 'inherit',
     });
 
-    console.log('\n✅ 所有缺失的依赖已安装完成！');
+    console.log('\n所有缺失的依赖已安装完成');
   } catch (installError) {
-    console.log('\n⚠️  expo install 失败，尝试使用 npm install...\n');
+    console.log('\nexpo install 失败，尝试使用 npm install...\n');
 
     execSync(`npm install ${packagesToInstall}`, {
       stdio: 'inherit',
     });
 
-    console.log('\n✅ 所有缺失的依赖已通过 npm 安装完成！');
+    console.log('\n所有缺失的依赖已通过 npm 安装完成');
   }
 } catch (error) {
   if (error.message.includes('depcheck')) {
-    console.error('❌ depcheck 未安装或运行失败');
-    console.log('💡 尝试运行: npm install -g depcheck');
+    console.error('depcheck 未安装或运行失败');
+    console.log('尝试运行: npm install -g depcheck');
   } else {
-    console.error('❌ 发生错误:', error.message);
+    console.error('发生错误:', error.message);
   }
   process.exit(1);
 }

package/lib/__templates__/expo/eslint-plugins/forbid-emoji/index.js

@@ -0,0 +1,9 @@
+const noEmoji = require('./rule')
+
+const plugin = {
+  rules: {
+    'no-emoji': noEmoji,
+  },
+}
+
+module.exports = plugin

package/lib/__templates__/expo/eslint-plugins/forbid-emoji/rule.js

@@ -0,0 +1,112 @@
+const DEFAULTS = {
+  ignorePatterns: [],
+}
+
+const RE_EMOJI =
+  // 匹配完整 emoji 序列：基础图形 + 可选变体选择符/肤色 + 可选 ZWJ 连接序列；以及国旗与 keycap
+  /(?:\p{Extended_Pictographic}(?:\uFE0F|[\u{1F3FB}-\u{1F3FF}])?(?:\u200D\p{Extended_Pictographic}(?:\uFE0F|[\u{1F3FB}-\u{1F3FF}])?)*)|(?:[\u{1F1E6}-\u{1F1FF}]{2})|(?:[#*0-9]\uFE0F?\u20E3)/gu
+
+function buildIgnoreRegexes(patterns) {
+  if (!Array.isArray(patterns)) return []
+  const result = []
+  for (const pattern of patterns) {
+    if (typeof pattern !== 'string') continue
+    try {
+      result.push(new RegExp(pattern))
+    } catch (_) {
+      continue
+    }
+  }
+  return result
+}
+
+function shouldIgnore(text, ignoreRegexes) {
+  if (!ignoreRegexes.length) return false
+  for (const re of ignoreRegexes) {
+    if (re.test(text)) return true
+  }
+  return false
+}
+
+function hasEmoji(text) {
+  if (!text) return false
+  RE_EMOJI.lastIndex = 0
+  return RE_EMOJI.test(text)
+}
+
+function collectEmojis(text) {
+  if (!text) return []
+  RE_EMOJI.lastIndex = 0
+  const result = []
+  const seen = new Set()
+  for (const match of text.matchAll(RE_EMOJI)) {
+    if (match[0] && !seen.has(match[0])) {
+      seen.add(match[0])
+      result.push(match[0])
+    }
+  }
+  return result
+}
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Disallow emoji in code',
+      recommended: 'error',
+    },
+    schema: [
+      {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ignorePatterns: {
+            type: 'array',
+            items: { type: 'string' },
+            default: DEFAULTS.ignorePatterns,
+          },
+        },
+      },
+    ],
+    messages: {
+      noEmoji: '禁止在代码中使用 emoji：{{emojis}}，请移除或者使用 @expo/vector-icons 图标',
+    },
+  },
+
+  create(context) {
+    const options = context.options && context.options[0] ? context.options[0] : {}
+    const ignoreRegexes = buildIgnoreRegexes(
+      Array.isArray(options.ignorePatterns) ? options.ignorePatterns : DEFAULTS.ignorePatterns
+    )
+
+    function checkText(node, text) {
+      if (!text) return
+      if (shouldIgnore(text, ignoreRegexes)) return
+      if (hasEmoji(text)) {
+        const emojis = collectEmojis(text)
+        const emojiText = emojis.length ? emojis.join(' ') : ''
+        context.report({ node, messageId: 'noEmoji', data: { emojis: emojiText } })
+      }
+    }
+
+    return {
+      Literal(node) {
+        if (typeof node.value !== 'string') return
+        checkText(node, node.value)
+      },
+      TemplateLiteral(node) {
+        for (const quasi of node.quasis) {
+          const cooked = quasi.value && typeof quasi.value.cooked === 'string'
+            ? quasi.value.cooked
+            : quasi.value && typeof quasi.value.raw === 'string'
+              ? quasi.value.raw
+              : ''
+          checkText(quasi, cooked)
+        }
+      },
+      JSXText(node) {
+        checkText(node, node.value)
+      },
+    }
+  },
+}

package/lib/__templates__/expo/eslint-plugins/forbid-emoji/tech.md

@@ -0,0 +1,94 @@
+# forbid-emoji 技术设计
+
+## 目标
+- 在代码中检测并禁止使用 emoji
+- 覆盖常见的字符串与 JSX 场景，避免明显漏报
+- 保持实现简单、可维护，避免引入新依赖
+
+## 规则命名与对外形态
+- 插件目录：demo/eslint-plugins/forbid-emoji
+- 规则名：forbid-emoji/no-emoji
+- 规则类型：problem
+- 默认等级：error
+
+## 规则行为定义
+### 报错
+当以下任一位置包含 emoji 时，报错：
+- 字符串字面量
+- 模板字符串的静态片段
+- JSXText 文本
+- JSXAttribute 中可静态解析为字符串的值
+
+### 不报错
+以下场景不触发：
+- 标识符、对象键名、属性名中的字符
+- 数值、正则字面量、BigInt
+- 模板字符串的表达式部分（仅检测静态片段）
+- 被用户显式忽略的路径或内容
+
+## 配置项
+```json
+{
+  "ignorePatterns": []
+}
+```
+- ignorePatterns：字符串数组，命中任一正则则跳过该文本片段
+
+## 检测策略
+### AST 访问节点
+- Literal：仅处理 typeof value === 'string'
+- TemplateLiteral：遍历 quasis，使用 cooked 值
+- JSXText：使用 node.value
+- JSXAttribute：可静态解析为字符串时处理
+
+### 忽略策略
+当文本命中 ignorePatterns 的任一正则时，不再做 emoji 检测，减少误报与白名单配置成本。
+
+## Emoji 识别方案
+### 组合序列处理
+考虑到真实文本中的 emoji 组合形式，需要识别以下组合序列并保证命中：
+- 变体选择符：U+FE0F
+- 皮肤色修饰符：U+1F3FB–U+1F3FF
+- ZWJ 组合：U+200D
+- 区域指示符组成的国旗：U+1F1E6–U+1F1FF 的成对序列
+- Keycap 组合：[#*0-9] + U+FE0F? + U+20E3
+
+实现上直接使用完整序列正则匹配，覆盖 ZWJ 连接序列、国旗与 keycap。
+
+### 正则示意
+```
+const RE_EMOJI =
+  /(?:\p{Extended_Pictographic}(?:\uFE0F|[\u{1F3FB}-\u{1F3FF}])?(?:\u200D\p{Extended_Pictographic}(?:\uFE0F|[\u{1F3FB}-\u{1F3FF}])?)*)|(?:[\u{1F1E6}-\u{1F1FF}]{2})|(?:[#*0-9]\uFE0F?\u20E3)/gu
+```
+命中即判定为 emoji。
+
+## 报错信息
+- messageId: noEmoji
+- 文案：禁止在代码中使用 emoji
+
+## 典型示例
+### 触发
+- "hello🙂"
+- `title: "Nice 👍"`
+- <Text>欢迎🎉</Text>
+
+### 不触发
+- const icon = "face-smile"
+- <Text>{user.name}</Text>
+- "hello" + emojiName
+
+## 边界与决策
+- 模板字符串表达式部分：不深入解析，避免执行风险与复杂度
+- 正则字面量：不扫描，避免干扰正则语义
+- 注释：默认不扫描
+- 误报控制：提供 ignorePatterns，由使用者按文件或内容片段进行排除
+
+## 性能考虑
+- 仅在字符串节点上进行扫描
+- 正则预编译并复用
+- 对空字符串与短文本快速返回
+
+## 测试计划
+- 覆盖 Literal、TemplateLiteral、JSXText、JSXAttribute 四类节点
+- 覆盖 ZWJ 组合、变体选择符、国旗、keycap、皮肤色修饰符
+- 覆盖 ignorePatterns 行为

package/lib/__templates__/expo/eslint-plugins/restrict-linear-gradient/index.js

@@ -0,0 +1,9 @@
+const noLinearGradientBackgroundColor = require('./rule')
+
+const plugin = {
+  rules: {
+    'no-linear-gradient-backgroundcolor': noLinearGradientBackgroundColor,
+  },
+}
+
+module.exports = plugin

package/lib/__templates__/expo/eslint-plugins/restrict-linear-gradient/rule.js

@@ -0,0 +1,120 @@
+const LINEAR_GRADIENT_RE = /linear-gradient/i
+
+function getPropertyKeyName(property) {
+  if (!property || property.type !== 'Property') return null
+  if (property.key.type === 'Identifier') return property.key.name
+  if (property.key.type === 'Literal' && typeof property.key.value === 'string') {
+    return property.key.value
+  }
+  return null
+}
+
+function getStaticStringValue(node) {
+  if (!node) return null
+  if (node.type === 'Literal' && typeof node.value === 'string') return node.value
+  if (node.type === 'TemplateLiteral') {
+    return node.quasis.map(quasi => quasi.value?.cooked || '').join('')
+  }
+  return null
+}
+
+function isLinearGradientString(text) {
+  if (!text) return false
+  return LINEAR_GRADIENT_RE.test(text)
+}
+
+function checkStyleObjectExpression(objectExpression, report) {
+  if (!objectExpression || objectExpression.type !== 'ObjectExpression') return
+  for (const property of objectExpression.properties) {
+    if (!property || property.type !== 'Property') continue
+    const keyName = getPropertyKeyName(property)
+    if (keyName !== 'backgroundColor') continue
+    const valueText = getStaticStringValue(property.value)
+    if (isLinearGradientString(valueText)) {
+      report(property.key || property)
+    }
+  }
+}
+
+function isStyleSheetMethodCall(node, methodName) {
+  if (!node || node.type !== 'CallExpression') return false
+  const callee = node.callee
+  if (!callee || callee.type !== 'MemberExpression') return false
+  if (callee.object.type !== 'Identifier' || callee.object.name !== 'StyleSheet') return false
+  if (callee.property.type === 'Identifier') return callee.property.name === methodName
+  return false
+}
+
+function checkStyleExpression(expression, report) {
+  if (!expression) return
+  if (expression.type === 'ObjectExpression') {
+    checkStyleObjectExpression(expression, report)
+    return
+  }
+  if (expression.type === 'ArrayExpression') {
+    for (const element of expression.elements) {
+      if (!element) continue
+      if (element.type === 'SpreadElement') {
+        checkStyleExpression(element.argument, report)
+      } else {
+        checkStyleExpression(element, report)
+      }
+    }
+    return
+  }
+  // 例：StyleSheet.flatten([styles.a, { backgroundColor: 'linear-gradient(...)' }])
+  if (isStyleSheetMethodCall(expression, 'flatten')) {
+    const arg = expression.arguments[0]
+    checkStyleExpression(arg, report)
+    return
+  }
+  // 例：StyleSheet.compose(styles.a, { backgroundColor: `linear-gradient(${angle},#fff,#000)` })
+  if (isStyleSheetMethodCall(expression, 'compose')) {
+    const [first, second] = expression.arguments
+    checkStyleExpression(first, report)
+    checkStyleExpression(second, report)
+  }
+}
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Disallow linear-gradient string in backgroundColor',
+      recommended: 'error',
+    },
+    schema: [],
+    messages: {
+      noLinearGradientBackgroundColor:
+        'backgroundColor 和 linear-gradient 无法一起使用，请将 backgroundColor 改为 experimental_backgroundImage',
+    },
+  },
+
+  create(context) {
+    function report(node) {
+      context.report({ node, messageId: 'noLinearGradientBackgroundColor' })
+    }
+
+    return {
+      CallExpression(node) {
+        if (!isStyleSheetMethodCall(node, 'create')) return
+        const firstArg = node.arguments[0]
+        if (!firstArg || firstArg.type !== 'ObjectExpression') return
+
+        checkStyleObjectExpression(firstArg, report)
+
+        for (const property of firstArg.properties) {
+          if (!property || property.type !== 'Property') continue
+          if (!property.value || property.value.type !== 'ObjectExpression') continue
+          checkStyleObjectExpression(property.value, report)
+        }
+      },
+
+      JSXAttribute(node) {
+        if (!node.name || node.name.name !== 'style') return
+        if (!node.value || node.value.type !== 'JSXExpressionContainer') return
+        checkStyleExpression(node.value.expression, report)
+      },
+    }
+  },
+}

package/lib/__templates__/expo/eslint-plugins/restrict-linear-gradient/tech.md

@@ -0,0 +1,58 @@
+# restrict-linear-gradient 技术设计
+
+## 目标
+- 禁止在 backgroundColor 中使用 linear-gradient 字符串
+- 覆盖 StyleSheet.create 与 JSX style 的常见写法
+- 实现轻量、易维护，不引入新依赖
+
+## 规则命名与对外形态
+- 插件目录：expo/eslint-plugins/restrict-linear-gradient
+- 规则名：restrict-linear-gradient/no-linear-gradient-backgroundcolor
+- 规则类型：problem
+- 默认等级：error
+
+## 规则行为定义
+### 报错
+当以下任一位置出现 backgroundColor 且值包含 linear-gradient( 时，报错：
+- StyleSheet.create 的样式对象中
+- JSX 元素 style 属性内的对象或数组成员
+
+### 不报错
+以下场景不触发：
+- 非 backgroundColor 的属性
+- backgroundColor 的非字符串值
+- 模板字符串包含表达式的动态值
+- 与 style 无关的对象字面量
+
+## 检测策略
+### StyleSheet.create
+遍历 StyleSheet.create 的首个参数对象，检查：
+- 顶层 backgroundColor
+- 每个样式项对应的对象内的 backgroundColor
+
+### JSX style
+定位 JSXAttribute(name=style) 后，检查表达式：
+- ObjectExpression
+- ArrayExpression 的各元素
+- StyleSheet.flatten / StyleSheet.compose 的参数
+
+## 线性渐变识别
+使用正则 /linear-gradient/i 检测字符串字面量与模板字符串静态片段。
+
+## 报错信息
+- messageId: noLinearGradientBackgroundColor
+- 文案：backgroundColor 和 linear-gradient 无法一起使用，请将 backgroundColor 改为 experimental_backgroundImage
+
+## 典型示例
+### 触发
+- StyleSheet.create({ a: { backgroundColor: 'linear-gradient(135deg,#F97316 0%,#FB923C 100%)' } })
+- <View style={{ backgroundColor: "linear-gradient(135deg,#F97316 0%,#FB923C 100%)" }} />
+- <View style={[{ backgroundColor: `linear-gradient(135deg,#F97316 0%,#FB923C 100%)` }]} />
+
+### 不触发
+- { background: 'linear-gradient(...)' }
+- { backgroundColor: someVar }
+
+## 性能考虑
+- 仅扫描目标节点与静态字符串
+- 早返回空节点与非字符串值

package/lib/__templates__/nextjs/AGENTS.md

@@ -0,0 +1,54 @@
+# 项目上下文
+
+### 版本技术栈
+
+- **Framework**: Next.js 16 (App Router)
+- **Core**: React 19
+- **Language**: TypeScript 5
+- **UI 组件**: shadcn/ui (基于 Radix UI)
+- **Styling**: Tailwind CSS 4
+
+## 目录结构
+
+```
+├── public/                 # 静态资源
+├── scripts/                # 构建与启动脚本
+│   ├── build.sh            # 构建脚本
+│   ├── dev.sh              # 开发环境启动脚本
+│   ├── prepare.sh          # 预处理脚本
+│   └── start.sh            # 生产环境启动脚本
+├── src/
+│   ├── app/                # 页面路由与布局
+│   ├── components/ui/      # Shadcn UI 组件库
+│   ├── hooks/              # 自定义 Hooks
+│   ├── lib/                # 工具库
+│   │   └── utils.ts        # 通用工具函数 (cn)
+│   └── server.ts           # 自定义服务端入口
+├── next.config.ts          # Next.js 配置
+├── package.json            # 项目依赖管理
+└── tsconfig.json           # TypeScript 配置
+```
+
+- 项目文件（如 app 目录、pages 目录、components 等）默认初始化到 `src/` 目录下。
+
+## 包管理规范
+
+**仅允许使用 pnpm** 作为包管理器，**严禁使用 npm 或 yarn**。
+**常用命令**：
+- 安装依赖：`pnpm add <package>`
+- 安装开发依赖：`pnpm add -D <package>`
+- 安装所有依赖：`pnpm install`
+- 移除依赖：`pnpm remove <package>`
+
+## 开发规范
+
+- **项目理解加速**：初始可以依赖项目下`package.json`文件理解项目类型，如果没有或无法理解退化成阅读其他文件。
+- **Hydration 错误预防**：严禁在 JSX 渲染逻辑中直接使用 typeof window、Date.now()、Math.random() 等动态数据。必须使用 'use client' 并配合 useEffect + useState 确保动态内容仅在客户端挂载后渲染；同时严禁非法 HTML 嵌套（如 <p> 嵌套 <div>）。
+
+
+## UI 设计与组件规范 (UI & Styling Standards)
+
+- 模板默认预装核心组件库 `shadcn/ui`，位于`src/components/ui/`目录下
+- Next.js 项目**必须默认**采用 shadcn/ui 组件、风格和规范，**除非用户指定用其他的组件和规范。**
+
+

package/lib/__templates__/nextjs/README.md

@@ -43,6 +43,11 @@ src/
 ├── lib/                     # 工具函数库
 │   └── utils.ts            # cn() 等工具函数
 └── hooks/                   # 自定义 React Hooks（可选）
+
+server/
+├── index.ts                 # 自定义服务器入口
+├── tsconfig.json           # Server TypeScript 配置
+└── dist/                    # 编译输出目录（自动生成）
 ```
 
 ## 核心开发规范

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

@@ -12,6 +12,11 @@ const eslintConfig = defineConfig([
     'out/**',
     'build/**',
     'next-env.d.ts',
+    // Build artifacts:
+    'server.js',
+    'dist/**',
+    // Script files (CommonJS):
+    'scripts/**/*.js',
   ]),
 ]);
 

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

@@ -1,8 +1,7 @@
 import type { NextConfig } from 'next';
-import path from 'path';
 
 const nextConfig: NextConfig = {
-  // outputFileTracingRoot: path.resolve(__dirname, '../../'),
+  // outputFileTracingRoot: path.resolve(__dirname, '../../'),  // Uncomment and add 'import path from "path"' if needed
   /* config options here */
   allowedDevOrigins: ['*.dev.coze.site'],
   images: {

package/lib/__templates__/nextjs/package.json

@@ -82,15 +82,12 @@
     "react-dev-inspector": "^2.0.1",
     "shadcn": "latest",
     "tailwindcss": "^4",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
     "typescript": "^5"
   },
   "packageManager": "pnpm@9.0.0",
   "engines": {
     "pnpm": ">=9.0.0"
-  },
-  "pnpm": {
-    "overrides": {
-      "esbuild": "^0.25.12"
-    }
   }
 }