Docs/MINI_PROGRAM_GUIDE.md

微信小程序开发指南

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

1. 环境准备

• Node.js: 建议 v18+
• WeChat DevTools: 下载并安装 微信开发者工具
• Taro CLI:

  pnpm add -g @tarojs/cli
  

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

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

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. 编译代码:

   cd mini-app
   pnpm run dev:weapp
   

2. 预览:

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

5. 注意事项

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