@kmlckj/licos-ai-cli 0.0.38 → 0.0.40

package/lib/__templates__/taro/AGENTS.md

@@ -21,8 +21,12 @@ pnpm remove <package>        # 移除依赖
 - 不要在业务代码里使用裸标识符 `TARO_ENV`。如需展示文字 “TARO_ENV”，只作为普通中文/英文说明文本使用，不要把它当作变量读取。
 - Taro API 只允许单次导入，统一写 `import Taro, { useLoad } from '@tarojs/taro'`，不要同时写 `import { useLoad } from '@tarojs/taro'` 和 `import Taro from '@tarojs/taro'`。
 - React hooks 必须从 `react` 导入，例如 `import { useMemo, useState } from 'react'`；不要从 `@tarojs/taro` 导入 `useState`、`useEffect`、`useMemo`。
+- 不要重复导入同一个包。`@tarojs/taro`、`@tarojs/components`、`react`、`lucide-react-taro` 每个文件最多一个 import 语句。
 - 需要在 `src/` 展示构建环境或项目域名时，直接读取全局常量：`LICOS_TARO_ENV || 'unknown'`、`PROJECT_DOMAIN || ''`，不要写 `process.env.TARO_ENV` 或 `process.env.PROJECT_DOMAIN`。
-- 需要引用本地资源时使用 ESM import，例如 `import logoUrl from '@/assets/images/logo.svg'`，不要在 `src/` 中写 CommonJS `require(...)`。
+- 需要引用 `src/assets/...` 源码资源时使用 ESM import，例如 `import logoUrl from '@/assets/images/logo.svg'`，不要在 `src/` 中写 CommonJS `require(...)`。
+- 根目录 `assets/` 是 H5 公开静态目录，不是 `@/assets` 源码别名。放在根 `assets/images/foo.svg` 的文件必须用相对 URL `assets/images/foo.svg`，不要写 `import foo from '@/assets/images/foo.svg'`。只有文件真实存在于 `src/assets/...` 时，才允许从 `@/assets/...` 导入。
+- 部署路径是 IP + `/p/{projectId}/` 子路径，页面中禁止写根路径 `/assets/...` 或上级路径 `../assets/...`。根目录 `assets/` 文件只能写成相对 URL `assets/...`，否则部署后资源会 404。
+- 不要使用浏览器 DOM 全局做资源探测。禁止 `window`、`document`、`new Image()`、`window.Image`、`globalThis.Image`；图片状态通过 Taro `<Image onLoad onError />` 或直接渲染处理。
 - 从第三方图标包导入前必须确认导出存在；不确定时优先使用已验证的 `Package`、`Globe`、`Cpu`、`Layers` 等基础图标，避免引入不存在的命名导出导致构建失败。
 - 禁止输出不完整模板字符串、占位引号或非法 TS 字符串，例如 `"""`、未闭合的引号、未转义的英文单引号。文案中包含引号时使用反引号或正确转义。
 - 创建或测试小程序时，必须替换默认 `src/pages/index/index.tsx` 为实际首页，或把 `src/app.config.ts` 的第一个页面改为实际入口；不要新增测试页后保留默认占位首页。
@@ -32,7 +36,6 @@ pnpm remove <package>        # 移除依赖
 ```tsx
 import { View, Text, Image } from '@tarojs/components'
 import Taro, { useLoad } from '@tarojs/taro'
-import logoUrl from '@/assets/images/logo.svg'
 import { Textarea } from '@/components/ui/textarea'
 
 export default function IndexPage() {
@@ -42,6 +45,7 @@ export default function IndexPage() {
 
   const envName = LICOS_TARO_ENV || 'unknown'
   const projectDomain = PROJECT_DOMAIN || '未配置'
+  const logoUrl = 'assets/images/logo.svg'
 
   return (
     <View>
@@ -56,7 +60,14 @@ export default function IndexPage() {
 
 ## 图片与视频资源使用规范
 
-项目根 `assets/` 是 H5 预览/部署的公开静态资源目录，服务端映射到 `/assets/*`。H5 页面按 URL 引用少量静态文件时优先使用相对路径 `assets/name.ext`，避免部署在 `/p/{projectId}/` 子路径时资源 404；大图片、视频和用户上传内容仍走对象存储。
+项目根 `assets/` 是 H5 预览/部署的公开静态资源目录，服务端映射到 `/assets/*`。H5 页面按 URL 引用少量静态文件时优先使用相对路径 `assets/name.ext`，避免部署在 `/p/{projectId}/` 子路径时资源 404；大图片、视频和用户上传内容仍走对象存储。不要把根 `assets/` 文件当作 `src/assets` 导入。
+
+部署资源路径硬性要求：
+
+- 根目录 `assets/` 文件在页面中只能写相对 URL，例如 `assets/images/logo.svg`。
+- 禁止写 `/assets/images/logo.svg`，它会绕过 `/p/{projectId}/` base path。
+- 禁止写 `../assets/images/logo.svg`，不同页面层级下容易解析错误。
+- 完成前必须自查 `src/`，不能残留 `/assets/`、`../assets/` 或 Tailwind 小数类名。
 
 **强制规则**：图片、视频等静态资源必须通过 TOS 对象存储管理，代码中使用 TOS 返回的 URL 引用。
 
@@ -210,7 +221,8 @@ CRITICAL：
 - 颜色、间距、圆角、边框、阴影、排版、flex/grid、宽高等常规样式必须收敛在 Tailwind 类名中。
 - 禁止使用 `w-[340px]`、`text-[14px]`、`p-[16px]` 这类带 `px` 的 Tailwind 任意值。
 - 禁止使用颜色不透明度简写，例如 `bg-primary/10`、`text-slate-500/70`、`border-white/20`；小程序端 opacity 容易丢失，必须拆成基础颜色类和 `bg-opacity-*` / `text-opacity-*` / `border-opacity-*`。
-- 禁止使用小数值类名，例如 `space-y-1.5`、`w-0.5`、`h-2.5`；统一改成整数刻度，例如 `space-y-2`、`w-1`、`h-3`。
+- 绝对禁止使用任何 Tailwind 小数值或斜杠分数类名，例如 `space-y-1.5`、`w-0.5`、`h-2.5`、`mt-0.5`、`h-3/5`。统一改成整数刻度，例如 `space-y-2`、`w-1`、`h-3`、`mt-1`。`mt-0.5` 这类写法会直接导致部署构建失败。
+- 完成前必须搜索并消除 `className` 中所有 `字母-数字.数字` 形式的类名。常见错误包括 `mt-0.5`、`space-y-1.5`、`h-2.5`、`w-0.5`。
 - 禁止使用 `peer-*`、`group-*`、`has-*`、复杂任意选择器和属性选择器类名；这些写法在小程序构建或上传时容易失败。
 - 禁止使用 `style={{ width: '200px' }}`、`fontSize: '14px'` 这类硬编码尺寸。
 - Taro 会通过 `pxtransform` 将尺寸转换为跨端单位（小程序 `rpx`、H5 `rem`），业务代码里直接写 `px` 容易导致不同端显示不一致。

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

@@ -74,9 +74,21 @@ const baseRestrictedSyntaxRules = [
   },
   {
     selector:
-      'Literal[value=/\\b(?!gap(?:-x|-y)?-)[a-zA-Z0-9-]+\\-[0-9]+\\.[0-9]+\\b/], TemplateElement[value.raw=/\\b(?!gap(?:-x|-y)?-)[a-zA-Z0-9-]+\\-[0-9]+\\.[0-9]+\\b/]',
+      'Literal[value=/\\b[a-zA-Z0-9-]+\\-[0-9]+\\.[0-9]+\\b/], TemplateElement[value.raw=/\\b[a-zA-Z0-9-]+\\-[0-9]+\\.[0-9]+\\b/]',
     message:
-      '微信小程序兼容性：禁用 Tailwind 小数值类名（如 space-y-1.5、w-0.5），请用整数替代（如 space-y-2、w-1）。',
+      '微信小程序兼容性：禁用 Tailwind 小数值类名（如 mt-0.5、space-y-1.5、w-0.5、h-2.5），请用整数替代（如 mt-1、space-y-2、w-1、h-3）。',
+  },
+  {
+    selector:
+      'Literal[value=/\\b[a-zA-Z0-9-]+\\-[0-9]+\\/[0-9]+\\b/], TemplateElement[value.raw=/\\b[a-zA-Z0-9-]+\\-[0-9]+\\/[0-9]+\\b/]',
+    message:
+      '微信小程序兼容性：禁用 Tailwind 斜杠分数类名（如 h-3/5、w-1/2），请改用整数刻度或明确布局。',
+  },
+  {
+    selector:
+      'Literal[value=/^(?:\\/|\\.\\.\\/)assets\\//], TemplateElement[value.raw=/^(?:\\/|\\.\\.\\/)assets\\//]',
+    message:
+      '部署路径兼容性：根目录 assets 资源必须使用相对 URL（如 assets/logo.svg），禁止 /assets/... 或 ../assets/...，否则部署到 /p/{projectId}/ 子路径后资源会 404。',
   },
   {
     selector:

package/lib/cli.js

@@ -2109,7 +2109,7 @@ const EventBuilder = {
 };
 
 var name = "@kmlckj/licos-ai-cli";
-var version = "0.0.38";
+var version = "0.0.40";
 var description = "LICOS AI coding workspace CLI - project template engine and dev tools";
 var license = "MIT";
 var author = "kmlckj";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmlckj/licos-ai-cli",
-  "version": "0.0.38",
+  "version": "0.0.40",
   "description": "LICOS AI coding workspace CLI - project template engine and dev tools",
   "license": "MIT",
   "author": "kmlckj",