taro-template/AGENTS.md

AGENTS.md

项目概述

微信小程序开发模板，基于Taro框架。

技术栈

• 框架: Taro 4.1.11 (基于 React)
• 语言: TypeScript 5.9.3
• UI 框架: React 18.3.1
• 构建工具: Webpack 5.105.4
• 包管理器: pnpm

项目结构

taro-template/
├── src/                      # 源代码目录
│   ├── app.ts               # 应用入口组件
│   ├── app.config.ts        # 应用全局配置
│   ├── app.css              # 全局样式
│   ├── index.html           # HTML 模板（用于 H5）
│   ├── components/          # 公共组件
│   │   └── BottomNav/       # 底部导航组件
│   ├── pages/               # 页面组件
│   │   ├── index/           # 首页
│   │   │   ├── index.tsx    # 首页组件
│   │   │   ├── index.config.ts
│   │   │   └── index.css
│   │   ├── mine/            # 我的页面
│   │   │   ├── index.tsx
│   │   │   ├── index.config.ts
│   │   │   └── index.css
│   │   └── xhs/             # 小红书平台特定工具
│   │       └── utils/
│   │           └── is-xhs.ts
├── config/                  # 构建配置
├── types/                   # TypeScript 类型定义
├── project.xhs.json         # 小红书 IDE 配置
├── project.config.json      # 微信 IDE 配置
├── project.tt.json          # 字节跳动 IDE 配置
├── tsconfig.json            # TypeScript 配置
├── babel.config.js          # Babel 配置
├── kevisual.json            # Kevisual 平台配置
└── package.json             # 项目依赖

开发指南

配置文件说明

app.config.ts

全局应用配置，包括页面注册、导航栏等。

app.ts

应用入口组件，包含 useLaunch 生命周期钩子，用于应用初始化。在微信环境下会自动调用 Taro.login。

AI 代理注意事项

1. 修改平台特定代码时，使用环境检测确保跨平台兼容性
2. 避免使用浏览器专用 API，应使用 Taro 提供的统一 API
3. 遵循现有的代码风格和目录结构
4. 添加新依赖时，确保与所有目标平台兼容
5. 项目使用 pnpm 作为包管理器

避免

1. 不能使用 ?. 和 ?? 操作符, 因为不支持
2. 不能使用 TextDecoder 和 TextEncoder, 因为不支持
3. 不能使用 Buffer, 因为不支持