Docs/MINI_PROGRAM_GUIDE.md

# 微信小程序开发指南

针对 Codex AI Platform，建议采用 **Taro** 框架进行小程序开发，因为它支持使用 React 语法，并能最大程度复用现有的业务逻辑和 Store。

## 1. 环境准备

- **Node.js**: 建议 v18+
- **WeChat DevTools**: 下载并安装 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
- **Taro CLI**: 
  ```bash
  pnpm add -g @tarojs/cli
  ```

## 2. 初始化小程序项目 (建议另建目录)

由于小程序对包体积和 API 有特殊限制，建议在根目录下创建一个 `mini-app` 文件夹或独立项目：

```bash
taro init mini-app
# 选择 React, TypeScript, Tailwind CSS
```

## 3. 复用核心逻辑

你可以通过 `path alias` 或 `monorepo` 的方式复用主项目中的以下内容：
- `shared/types`: 类型定义
- `src/store/useStore.ts`: 状态管理（需注意小程序不支持 `localStorage`，需替换为 `Taro.getStorageSync`）
- `api/`: API 定义

## 4. 启动开发

1. **编译代码**:
   ```bash
   cd mini-app
   pnpm run dev:weapp
   ```

2. **预览**:
   - 打开微信开发者工具
   - 导入 `mini-app` 文件夹
   - 在工具中即可看到预览效果

## 5. 注意事项

- **API 域名**: 小程序必须在管理后台配置服务器域名，且必须是 HTTPS。
- **本地调试**: 在开发者工具中勾选“不校验合法域名”即可在本地 `localhost` 调试。
- **文件监听**: 小程序环境不支持原生文件监听功能，该功能仅限桌面端 (Tauri) 使用。
- **Local-First**: RxDB 支持在小程序环境运行，但需要配置对应的 `storage` 适配器（如 `rxdb-adapter-weapp`）。