@coze-arch/cli 0.0.12 → 0.0.13-alpha.281fed

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

@@ -0,0 +1,43 @@
+import { useEffect, ReactNode } from 'react';
+import { Platform } from 'react-native';
+
+const STYLE_ID = 'coze-pretty-scrollbar';
+
+function WebOnlyPrettyScrollbar({ children }: { children: ReactNode }) {
+  useEffect(() => {
+    if (Platform.OS === 'web') {
+      let style = document.getElementById(STYLE_ID);
+      if (!style) {
+        style = document.createElement('style');
+        style.id = STYLE_ID;
+        style.textContent = `
+        ::-webkit-scrollbar {
+          width: 4px;
+          height: 4px;
+        }
+
+        ::-webkit-scrollbar-track {
+          background: transparent;
+        }
+
+        ::-webkit-scrollbar-thumb {
+          background: rgba(0, 0, 0, 0.2);
+          border-radius: 2px;
+        }
+        `;
+        document.head.appendChild(style);
+      }
+
+      return () => {
+        const existingStyle = document.getElementById(STYLE_ID);
+        if (existingStyle) {
+          existingStyle.remove();
+        }
+      }
+    }
+  }, []);
+
+  return <>{children}</>
+}
+
+export { WebOnlyPrettyScrollbar }

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

@@ -2,17 +2,20 @@ import { AuthProvider } from '@/contexts/AuthContext';
 import { type ReactNode } from 'react';
 import { GestureHandlerRootView } from 'react-native-gesture-handler';
 import { WebOnlyColorSchemeUpdater } from './ColorSchemeUpdater';
+import { WebOnlyPrettyScrollbar } from './PrettyScrollbar'
 import { HeroUINativeProvider } from '@/heroui';
 
 function Provider({ children }: { children: ReactNode }) {
   return <WebOnlyColorSchemeUpdater>
-    <AuthProvider>
-      <GestureHandlerRootView style={{ flex: 1 }}>
-        <HeroUINativeProvider>
-          {children}
-        </HeroUINativeProvider>
-      </GestureHandlerRootView>
-    </AuthProvider>
+    <WebOnlyPrettyScrollbar>
+      <AuthProvider>
+        <GestureHandlerRootView style={{ flex: 1 }}>
+          <HeroUINativeProvider>
+            {children}
+          </HeroUINativeProvider>
+        </GestureHandlerRootView>
+      </AuthProvider>
+    </WebOnlyPrettyScrollbar>
   </WebOnlyColorSchemeUpdater>
 }
 

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

@@ -10,6 +10,7 @@ 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';
+import expo from '../eslint-plugins/expo/index.js';
 
 export default [
   {
@@ -66,6 +67,7 @@ export default [
       reactnative,
       forbidEmoji,
       restrictLinearGradient,
+      expo,
     },
     rules: {
       // 关闭代码风格规则
@@ -90,6 +92,7 @@ export default [
       'reanimated/ban-mix-use': 'error',
       'forbidEmoji/no-emoji': 'error',
       'restrictLinearGradient/no-linear-gradient-backgroundcolor': 'error',
+      'expo/require-globalcss-and-provider': 'error',
       // 禁止使用 via.placeholder.com 服务
       'no-restricted-syntax': [
         'error',

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

@@ -0,0 +1,9 @@
+const requireGlobalCssAndProvider = require('./rule')
+
+const plugin = {
+  rules: {
+    'require-globalcss-and-provider': requireGlobalCssAndProvider,
+  },
+}
+
+module.exports = plugin

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

@@ -0,0 +1,105 @@
+function normalizeFilename(filename) {
+  // ESLint may provide Windows paths; normalize to forward slashes for suffix checks.
+  return typeof filename === 'string' ? filename.replace(/\\/g, '/') : ''
+}
+
+function isTargetLayoutFile(context) {
+  return normalizeFilename(context.getFilename()).endsWith('/app/_layout.tsx')
+}
+
+function isSideEffectImportOf(node, sourceValue) {
+  return (
+    node &&
+    node.type === 'ImportDeclaration' &&
+    node.source &&
+    node.source.type === 'Literal' &&
+    node.source.value === sourceValue &&
+    Array.isArray(node.specifiers) &&
+    node.specifiers.length === 0
+  )
+}
+
+function getProviderImportLocalName(node) {
+  if (
+    !node ||
+    node.type !== 'ImportDeclaration' ||
+    !node.source ||
+    node.source.type !== 'Literal' ||
+    node.source.value !== '@/components/Provider'
+  ) {
+    return null
+  }
+
+  const specifiers = Array.isArray(node.specifiers) ? node.specifiers : []
+  if (specifiers.length !== 1) return null
+  const [specifier] = specifiers
+  if (specifier.type !== 'ImportSpecifier') return null
+  if (!specifier.imported || specifier.imported.type !== 'Identifier') return null
+  if (!specifier.local || specifier.local.type !== 'Identifier') return null
+
+  // Allow `import { Provider } ...` and `import { Provider as XXX } ...`
+  if (specifier.imported.name !== 'Provider') return null
+  return specifier.local.name
+}
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Require global.css import and Provider usage in app/_layout.tsx',
+      recommended: 'error',
+    },
+    schema: [],
+    messages: {
+      missingGlobalCssImport: `app/_layout.tsx 必须引入 global.css 文件（参考写法：import '../global.css'）`,
+      requireProviderImportAndUsage:
+        "app/_layout.tsx 必须从 @/components/Provider 导入 Provider（参考写法：import { Provider } from '@/components/Provider'），并使用导入的 Provider 包裹其余组件",
+    },
+  },
+
+  create(context) {
+    if (!isTargetLayoutFile(context)) {
+      return {}
+    }
+
+    let hasGlobalCssImport = false
+    let providerImportLocalName = null
+    let hasProviderJsxUsage = false
+
+    return {
+      Program(node) {
+        const body = Array.isArray(node.body) ? node.body : []
+        for (const stmt of body) {
+          if (isSideEffectImportOf(stmt, '../global.css')) {
+            hasGlobalCssImport = true
+          }
+          const localName = getProviderImportLocalName(stmt)
+          if (localName) {
+            providerImportLocalName = localName
+          }
+        }
+      },
+
+      JSXOpeningElement(node) {
+        if (!node || !node.name) return
+        if (
+          providerImportLocalName &&
+          node.name.type === 'JSXIdentifier' &&
+          node.name.name === providerImportLocalName
+        ) {
+          hasProviderJsxUsage = true
+        }
+      },
+
+      'Program:exit'(node) {
+        if (!hasGlobalCssImport) {
+          context.report({ node, messageId: 'missingGlobalCssImport' })
+        }
+
+        if (!providerImportLocalName || !hasProviderJsxUsage) {
+          context.report({ node, messageId: 'requireProviderImportAndUsage' })
+        }
+      },
+    }
+  },
+}

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

@@ -0,0 +1,108 @@
+# expo 技术设计（layout 规则）
+
+## 目标
+- 强约束 Expo Router 的 `app/_layout.tsx` 模板结构，避免初始化项目后被误删导致运行时样式/上下文缺失
+- 校验 `app/_layout.tsx` 必须：
+  - 包含 `import '../global.css'`
+  - 使用从 `@/components/Provider` 导入的 Provider 组件作为 JSX 组件（允许 `import { Provider } ...` 或 `import { Provider as XXX } ...`）
+- 实现轻量、易维护，不引入新依赖
+
+## 规则命名与对外形态
+- 插件目录：expo/eslint-plugins/expo
+- 规则名：expo/require-globalcss-and-provider
+- 规则类型：problem
+- 默认等级：error
+
+## 规则行为定义
+### 报错
+仅对目标文件 `app/_layout.tsx` 生效，满足以下任一情况报错：
+- 缺少 side-effect import：`import '../global.css'`
+- 缺少或不符合要求的 Provider 导入语句：
+  - 必须从 `@/components/Provider` 导入
+  - 必须为命名导入，导入名必须为 `Provider`
+  - 允许形式：
+    - `import { Provider } from '@/components/Provider';`
+    - `import { Provider as XXX } from '@/components/Provider';`
+- 未在 JSX 中使用导入的 Provider 组件（例如：只导入但从未作为 JSX 组件出现）
+
+### 不报错
+- 非 `app/_layout.tsx` 文件不做检查
+- 目标文件同时满足：
+  - 存在 `import '../global.css'`
+  - 存在 Provider 命名导入（允许 as 别名）
+  - JSX 中至少出现一次 `<Provider ...>` / `<Provider>` 或 `<XXX ...>` / `<XXX>`（XXX 为别名）
+
+## 检测策略
+### 目标文件判定
+- 通过 `context.getFilename()` 获取当前文件路径
+- 仅当路径以 `/app/_layout.tsx` 结尾时启用规则（同时兼容 Windows 路径分隔符做归一化）
+
+### AST 访问节点
+- `Program`：收集顶层 `ImportDeclaration`，判定是否存在目标 import
+- `JSXOpeningElement` / `JSXElement`：判定是否使用 `<Provider>`
+
+### Import 判定细则
+- global.css：
+  - `ImportDeclaration.source.value === '../global.css'`
+  - `ImportDeclaration.specifiers.length === 0`（side-effect import）
+- Provider import（严格形式）：
+  - `ImportDeclaration.source.value === '@/components/Provider'`
+  - `ImportDeclaration.specifiers` 仅包含一个 `ImportSpecifier`
+  - `specifier.imported.name === 'Provider'`，`specifier.local.name` 允许为 `Provider` 或任意别名
+
+## 报错信息
+- messageId: missingGlobalCssImport
+  - 文案：`app/_layout.tsx 必须包含 "import '../global.css';"`
+- messageId: requireProviderImportAndUsage
+  - 文案：`app/_layout.tsx 中必须从 @/components/Provider 导入 Provider（参考写法：import { Provider } from '@/components/Provider'），并使用导入的 Provider 包裹其余组件`
+
+## 典型示例
+### 触发
+- 缺少 global.css：
+  - 未包含 `import '../global.css';`
+- Provider import 形式不对：
+  - `import Provider from '@/components/Provider'`
+  - `import { Provider } from '@/components/provider'`
+- Provider 未使用：
+  - 有 `import { Provider } ...`，但 JSX 中没有 `<Provider>`
+
+### 不触发
+```tsx
+import { Provider } from '@/components/Provider';
+import '../global.css';
+
+export default function RootLayout() {
+  return (
+    <Provider>
+      {/* ... */}
+    </Provider>
+  );
+}
+```
+
+```tsx
+import { Provider as AppProvider } from '@/components/Provider';
+import '../global.css';
+
+export default function RootLayout() {
+  return (
+    <AppProvider>
+      {/* ... */}
+    </AppProvider>
+  );
+}
+```
+
+## 边界与决策
+- 仅做结构约束，不尝试自动修复（fixer）以避免在 TSX 顶部插入 import 引起格式与注释位置变化
+- 仅检查 JSX 中的 `<Provider>` 使用，不做“必须最外层包裹”的结构分析，降低复杂度与误报
+
+## 性能考虑
+- 仅在命中目标文件时启用
+- 仅扫描顶层 import 与 JSX 标签名，复杂度 O(n)
+
+## 测试计划
+- 缺少 global.css import：报 `missingGlobalCssImport`
+- 未从 `@/components/Provider` 正确导入 Provider：报 `requireProviderImportAndUsage`
+- Provider 未在 JSX 使用：报 `requireProviderImportAndUsage`
+- 满足全部要求：不报错

package/lib/__templates__/nextjs/AGENTS.md

@@ -42,6 +42,11 @@
 
 ## 开发规范
 
+### 编码规范
+
+- 默认按 TypeScript `strict` 心智写代码；优先复用当前作用域已声明的变量、函数、类型和导入，禁止引用未声明标识符或拼错变量名。
+- 禁止隐式 `any` 和 `as any`；函数参数、返回值、解构项、事件对象、`catch` 错误在使用前应有明确类型或先完成类型收窄，并清理未使用的变量和导入。
+
 ### Hydration 问题防范
 
 1. 严禁在 JSX 渲染逻辑中直接使用 typeof window、Date.now()、Math.random() 等动态数据。**必须使用 'use client' 并配合 useEffect + useState 确保动态内容仅在客户端挂载后渲染**；同时严禁非法 HTML 嵌套（如 <p> 嵌套 <div>）。

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

@@ -10,6 +10,15 @@ const syntaxRules = [
   },
 ];
 
+const nextConfigRestrictedSyntaxRules = [
+  {
+    selector:
+      'Property[key.name=/^(root|outputFileTracingRoot)$/] > Literal[value=/^\\//]',
+    message:
+      '禁止在 next.config 中写死绝对路径，请改用 path.resolve(__dirname, ...)、import.meta.dirname 或 process.cwd() 动态拼接。',
+  },
+];
+
 const eslintConfig = defineConfig([
   ...nextVitals,
   ...nextTs,
@@ -19,6 +28,12 @@ const eslintConfig = defineConfig([
       'no-restricted-syntax': ['error', ...syntaxRules],
     },
   },
+  {
+    files: ['next.config.ts'],
+    rules: {
+      'no-restricted-syntax': ['error', ...nextConfigRestrictedSyntaxRules],
+    },
+  },
   // Override default ignores of eslint-config-next.
   globalIgnores([
     // Default ignores of eslint-config-next:

package/lib/__templates__/taro/.coze

@@ -1,6 +1,4 @@
 [project]
-template = "taro"
-version = "legacy.2"
 entrypoint = "server.js"
 requires = ["nodejs-24"]
 

package/lib/__templates__/taro/src/presets/dev-debug.ts

@@ -3,11 +3,11 @@ import Taro from '@tarojs/taro';
 /**
  * 小程序调试工具
  * 在开发版/体验版自动开启调试模式
- * 支持微信小程序和抖音小程序
+ * 支持微信小程序
  */
 export function devDebug() {
   const env = Taro.getEnv();
-  if (env === Taro.ENV_TYPE.WEAPP || env === Taro.ENV_TYPE.TT) {
+  if (env === Taro.ENV_TYPE.WEAPP) {
     try {
       const accountInfo = Taro.getAccountInfoSync();
       const envVersion = accountInfo.miniProgram.envVersion;

package/lib/__templates__/vite/AGENTS.md

@@ -39,3 +39,8 @@
 ## 开发规范
 
 - 使用 Tailwind CSS 进行样式开发
+
+### 编码规范
+
+- 默认按 TypeScript `strict` 心智写代码；优先复用当前作用域已声明的变量、函数、类型和导入，禁止引用未声明标识符或拼错变量名。
+- 禁止隐式 `any` 和 `as any`；函数参数、返回值、解构项、事件对象、Express `req`/`res`、`catch` 错误在使用前应有明确类型或先完成类型收窄，并清理未使用的变量和导入。