# ai-code

**Repository Path**: daiend/ai-code

## Basic Information

- **Project Name**: ai-code
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai-code

`ai-code` 是一个基于 pnpm workspace 的前端 monorepo，用于统一管理 Web 应用、Uni App 应用和跨应用工具包。

## 当前状态

- `apps/vue-web`：主要开发应用，已包含系统管理、基础信息示例、布局、权限、接口封装、状态持久化和基础测试。
- `apps/uni-app`：Uni App + Vue 3 + TypeScript 安卓应用，当前目标仅为 Android APK。
- `packages/utils`：共享 TypeScript 工具包，包含类型判断、正则、响应式换算、请求取消、存储封装和 AES 混淆工具。

## 环境要求

- Node.js `>=20.19.0`
- pnpm `10.33.2`

安装依赖：

```bash
pnpm install
```

## 常用命令

```bash
pnpm dev:vue-web
pnpm dev:uni-app
pnpm build
pnpm format
pnpm format:check
pnpm lint
pnpm typecheck
pnpm test:unit
pnpm check
```

Uni App 安卓应用常用命令：

```bash
pnpm --filter uni-app dev:app
pnpm --filter uni-app build:app
pnpm --filter uni-app typecheck
```

`pnpm --filter uni-app build:app` 会生成 Uni App App 平台资源；APK 打包和运行到安卓模拟器仍按 DCloud/HBuilderX 的 App 运行与发行流程处理。

## Uni App 约定

`apps/uni-app` 只面向 Android APK，不维护 H5 或小程序作为交付目标。新增源码使用 TypeScript：普通模块使用 `.ts`，Vue SFC 使用 `<script lang="ts">` 或 `<script setup lang="ts">`。`apps/uni-app/tsconfig.json` 继承根 `tsconfig.json`，根 `pnpm typecheck` 已覆盖该应用。

`apps/uni-app` 的服务地址通过 `VITE_UNI_APP_SERVE_IP` 配置，开发默认值位于 `apps/uni-app/.env.development`，生产默认值位于 `apps/uni-app/.env.production`。本地真实服务地址写入 `.env.development.local` 或 `.env.production.local`，不要提交；不要使用 `.env.local` 覆盖 uni-app 地址，避免同时影响开发和生产 mode。

不要在 `apps/uni-app` 目录中生成或保留 `.log` 文件。调试日志应输出到控制台，确需写文件时写到系统临时目录并在任务结束后清理。

## 环境变量

`apps/vue-web` 的示例变量在 `apps/vue-web/.env.example`。本地私有配置请写入：

```text
apps/vue-web/.env.local
apps/vue-web/.env.development.local
```

不要提交真实服务地址、账号、token 或私有密钥。`VITE_STORAGE_AES_KEY` 和 `VITE_STORAGE_AES_IV` 只用于前端本地存储混淆，`VITE_` 变量会进入浏览器包，不能作为真实安全边界。

## 协作入口

- 仓库级规则：`AGENTS.md`
- Web 应用规则：`apps/vue-web/AGENTS.md`
- 工具包规则：`packages/utils/AGENTS.md`
- Uni App 安卓应用规则：`apps/uni-app/AGENTS.md`
- 仓库内 Codex skill：`.agents/skills/ai-code/SKILL.md`

提交前建议运行：

```bash
pnpm check
pnpm build
```