@coze-arch/cli 0.0.13 → 0.0.14-alpha.e0ee3f

package/lib/__templates__/expo/AGENTS.md

@@ -152,17 +152,25 @@ export default function TabLayout() {
     '--color-border',
   ]) as string[];
 
+  let tabBarStyle = {
+    backgroundColor: background,
+    borderTopWidth: 1,
+    borderTopColor: border,
+  };
+
+  // 用于修复 Web 上高度异常的问题（这个 if 逻辑必须添加）
+  if (Platform.OS === 'web') {
+    tabBarStyle = {
+      ...tabBarStyle,
+      height: 'auto',
+    }
+  }
+
   return (
     <Tabs
       screenOptions={{
         headerShown: false,
-        tabBarStyle: {
-          backgroundColor: background,
-          borderTopWidth: 1,
-          borderTopColor: border,
-          // 通过固定宽度 55 来修正 Web 上的表现
-          height: Platform.OS === 'web' ? 55 : 50 + insets.bottom,
-        },
+        tabBarStyle,
         tabBarActiveTintColor: accent,
         tabBarInactiveTintColor: muted,
       }}

package/lib/__templates__/expo/README.md

@@ -152,17 +152,25 @@ export default function TabLayout() {
     '--color-border',
   ]) as string[];
 
+  let tabBarStyle = {
+    backgroundColor: background,
+    borderTopWidth: 1,
+    borderTopColor: border,
+  };
+
+  // 用于修复 Web 上高度异常的问题（这个 if 逻辑必须添加）
+  if (Platform.OS === 'web') {
+    tabBarStyle = {
+      ...tabBarStyle,
+      height: 'auto',
+    }
+  }
+
   return (
     <Tabs
       screenOptions={{
         headerShown: false,
-        tabBarStyle: {
-          backgroundColor: background,
-          borderTopWidth: 1,
-          borderTopColor: border,
-          // 通过固定宽度 55 来修正 Web 上的表现
-          height: Platform.OS === 'web' ? 55 : 50 + insets.bottom,
-        },
+        tabBarStyle,
         tabBarActiveTintColor: accent,
         tabBarInactiveTintColor: muted,
       }}

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,15 @@
 
 ## 开发规范
 
+### 编码规范
+
+- 默认按 TypeScript `strict` 心智写代码；优先复用当前作用域已声明的变量、函数、类型和导入，禁止引用未声明标识符或拼错变量名。
+- 禁止隐式 `any` 和 `as any`；函数参数、返回值、解构项、事件对象、`catch` 错误在使用前应有明确类型或先完成类型收窄，并清理未使用的变量和导入。
+
+### next.config 配置规范
+
+- 配置的路径不要写死绝对路径，必须使用 path.resolve(__dirname, ...)、import.meta.dirname 或 process.cwd() 动态拼接。
+
 ### 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__/nextjs/scripts/check-bins.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs/promises');
+const path = require('path');
+const { execSync } = require('child_process');
+
+async function checkBins() {
+  const cwd = path.join(__dirname, '..');
+
+  const pkgJson = JSON.parse(
+    await fs.readFile(path.join(cwd, 'package.json'), 'utf8'),
+  );
+  const allDeps = Object.keys({
+    ...pkgJson.dependencies,
+    ...pkgJson.devDependencies,
+  });
+
+  const binDir = path.join(cwd, 'node_modules', '.bin');
+  const missing = [];
+
+  await Promise.all(
+    allDeps.map(async depName => {
+      const depPkgPath = path.join(
+        cwd,
+        'node_modules',
+        depName,
+        'package.json',
+      );
+
+      let depPkg;
+      try {
+        depPkg = JSON.parse(await fs.readFile(depPkgPath, 'utf8'));
+      } catch {
+        return;
+      }
+
+      if (!depPkg.bin) return;
+
+      // bin can be a string (single binary named after the package) or an object
+      const bins =
+        typeof depPkg.bin === 'string'
+          ? { [depName.split('/').pop()]: depPkg.bin }
+          : depPkg.bin;
+
+      await Promise.all(
+        Object.keys(bins).map(async binName => {
+          try {
+            await fs.access(path.join(binDir, binName));
+          } catch {
+            missing.push({ dep: depName, bin: binName });
+          }
+        }),
+      );
+    }),
+  );
+
+  if (missing.length === 0) {
+    console.log('check-bins: all bin entries present, skipping force install.');
+    return;
+  }
+
+  console.log('check-bins: missing bin entries detected:');
+  for (const { dep, bin } of missing) {
+    console.log(`  ${dep} -> .bin/${bin}`);
+  }
+  console.log('check-bins: running pnpm i --force to fix...');
+  execSync('pnpm i --force', { stdio: 'inherit', cwd });
+}
+
+checkBins().catch(err => {
+  console.warn('check-bins: skipped due to error:', err.message);
+});

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

@@ -7,3 +7,4 @@ cd "${COZE_WORKSPACE_PATH}"
 
 echo "Installing dependencies..."
 pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
+node "$(dirname "$0")/check-bins.js"

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

@@ -197,9 +197,6 @@ importers:
       '@supabase/supabase-js':
         specifier: 2.95.3
         version: 2.95.3
-      better-sqlite3:
-        specifier: ^11.9.1
-        version: 11.10.0
       coze-coding-dev-sdk:
         specifier: ^0.7.16
         version: 0.7.16(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0)
@@ -234,9 +231,6 @@ importers:
       '@nestjs/schematics':
         specifier: ^10.2.3
         version: 10.2.3(chokidar@3.6.0)(typescript@5.9.3)
-      '@types/better-sqlite3':
-        specifier: ^7.6.13
-        version: 7.6.13
       '@types/express':
         specifier: 5.0.6
         version: 5.0.6
@@ -15586,6 +15580,7 @@ snapshots:
   '@types/better-sqlite3@7.6.13':
     dependencies:
       '@types/node': 22.19.6
+    optional: true
 
   '@types/body-parser@1.19.6':
     dependencies:
@@ -16921,6 +16916,7 @@ snapshots:
     dependencies:
       bindings: 1.5.0
       prebuild-install: 7.1.3
+    optional: true
 
   big-integer@1.6.52: {}
 
@@ -16936,6 +16932,7 @@ snapshots:
   bindings@1.5.0:
     dependencies:
       file-uri-to-path: 1.0.0
+    optional: true
 
   bl@1.2.3:
     dependencies:
@@ -17239,7 +17236,8 @@ snapshots:
     dependencies:
       readdirp: 5.0.0
 
-  chownr@1.1.4: {}
+  chownr@1.1.4:
+    optional: true
 
   chroma-js@2.6.0: {}
 
@@ -17735,6 +17733,7 @@ snapshots:
   decompress-response@6.0.0:
     dependencies:
       mimic-response: 3.1.0
+    optional: true
 
   decompress-tar@4.1.1:
     dependencies:
@@ -18491,7 +18490,8 @@ snapshots:
 
   exif-parser@0.1.12: {}
 
-  expand-template@2.0.3: {}
+  expand-template@2.0.3:
+    optional: true
 
   express@4.21.2:
     dependencies:
@@ -18679,7 +18679,8 @@ snapshots:
 
   file-type@8.1.0: {}
 
-  file-uri-to-path@1.0.0: {}
+  file-uri-to-path@1.0.0:
+    optional: true
 
   filename-reserved-regex@2.0.0: {}
 
@@ -18963,7 +18964,8 @@ snapshots:
 
   git-clone@0.1.0: {}
 
-  github-from-package@0.0.0: {}
+  github-from-package@0.0.0:
+    optional: true
 
   glob-parent@5.1.2:
     dependencies:
@@ -20214,7 +20216,8 @@ snapshots:
 
   mimic-response@1.0.1: {}
 
-  mimic-response@3.1.0: {}
+  mimic-response@3.1.0:
+    optional: true
 
   min-document@2.19.2:
     dependencies:
@@ -20446,7 +20449,8 @@ snapshots:
 
   mkdir-p@0.0.7: {}
 
-  mkdirp-classic@0.5.3: {}
+  mkdirp-classic@0.5.3:
+    optional: true
 
   mkdirp@0.5.6:
     dependencies:
@@ -20503,7 +20507,8 @@ snapshots:
 
   nanoid@3.3.11: {}
 
-  napi-build-utils@2.0.0: {}
+  napi-build-utils@2.0.0:
+    optional: true
 
   natural-compare@1.4.0: {}
 
@@ -20545,6 +20550,7 @@ snapshots:
   node-abi@3.87.0:
     dependencies:
       semver: 7.7.4
+    optional: true
 
   node-abort-controller@3.1.1: {}
 
@@ -21505,6 +21511,7 @@ snapshots:
       simple-get: 4.0.1
       tar-fs: 2.1.4
       tunnel-agent: 0.6.0
+    optional: true
 
   prelude-ls@1.2.1: {}
 
@@ -22232,13 +22239,15 @@ snapshots:
 
   signal-exit@4.1.0: {}
 
-  simple-concat@1.0.1: {}
+  simple-concat@1.0.1:
+    optional: true
 
   simple-get@4.0.1:
     dependencies:
       decompress-response: 6.0.0
       once: 1.4.0
       simple-concat: 1.0.1
+    optional: true
 
   simple-plist@1.3.1:
     dependencies:
@@ -22650,6 +22659,7 @@ snapshots:
       mkdirp-classic: 0.5.3
       pump: 3.0.3
       tar-stream: 2.2.0
+    optional: true
 
   tar-stream@1.6.2:
     dependencies:

package/lib/__templates__/taro/server/package.json

@@ -17,7 +17,6 @@
     "@nestjs/core": "^10.4.15",
     "@nestjs/platform-express": "^10.4.15",
     "@supabase/supabase-js": "2.95.3",
-    "better-sqlite3": "^11.9.1",
     "coze-coding-dev-sdk": "^0.7.16",
     "dotenv": "^17.2.3",
     "drizzle-kit": "^0.31.8",
@@ -31,7 +30,6 @@
   "devDependencies": {
     "@nestjs/cli": "^10.4.9",
     "@nestjs/schematics": "^10.2.3",
-    "@types/better-sqlite3": "^7.6.13",
     "@types/express": "5.0.6",
     "@types/node": "^22.10.2",
     "drizzle-kit": "^0.31.8",

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` 错误在使用前应有明确类型或先完成类型收窄，并清理未使用的变量和导入。

package/lib/cli.js

@@ -2107,7 +2107,7 @@ const EventBuilder = {
 };
 
 var name = "@coze-arch/cli";
-var version = "0.0.13";
+var version = "0.0.14-alpha.e0ee3f";
 var description = "coze coding devtools cli";
 var license = "MIT";
 var author = "fanwenjie.fe@bytedance.com";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.13",
+  "version": "0.0.14-alpha.e0ee3f",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",