fix: 解决微信小程序开发版预览 2MB 限制问题

- 关闭 Taro 开发模式的 prebundle 功能，减少主包体积
- 修正 miniprogram-ci 发布脚本中的无效参数
- 更新技能文档，补充 2MB 限制问题说明

优化效果：
- 主包大小从 ~3MB 降至 ~650KB (减少 78%)
- 成功发布企业小程序和人才小程序开发版预览

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

.claude/skills/weapp-publish/references/config.md

@@ -163,3 +163,23 @@ mini: {
 ```
 
 **原因**：微信小程序的预览编译器不完全支持 ES6+ 语法（如可选链 `?.`），需要确保所有代码被转译为 ES5。
+
+### 5. 开发版预览 - 关闭 Prebundle（重要）
+
+微信小程序开发版预览有 **2MB 主包大小限制**，Taro 在开发模式默认开启 prebundle（依赖预编译），会导致主包超过限制。
+
+在 `config/dev.ts` 中添加以下配置关闭 prebundle：
+
+```ts
+compiler: {
+  // 关闭开发模式的依赖预编译，减少主包体积以支持微信小程序开发版预览（2MB限制）
+  prebundle: {
+    enable: false
+  }
+}
+```
+
+**注意**：
+- 此配置仅影响开发版预览，不影响体验版和生产版
+- 关闭 prebundle 后首次编译会稍慢，但主包体积可从 ~3MB 降至 ~650KB
+- 人才小程序 (`mini-talent`) 也需要同样配置

.claude/skills/weapp-publish/references/faq.md

@@ -44,6 +44,35 @@
 | **体验版** (experience) | 提交给测试人员体验 | 默认执行构建 | `dist/weapp/production/` |
 | **开发版** (dev) | 开发者自测 | 默认跳过构建 | `dist/weapp/development/` |
 
+### Q: 开发版预览上传失败，提示超过 2MB 限制
+
+**A**: 微信小程序开发版预览有严格的 **2MB 主包大小限制**，这是微信服务器端的硬性限制，无法通过配置参数绕过。
+
+**根本原因**：
+1. `maxUploadSourceSize` **不是** miniprogram-ci 的有效参数（只在 `project.config.json` 中对本地开发者工具有效）
+2. Taro 在开发模式默认开启 **prebundle（依赖预编译）**，预编译的依赖包会占用约 2MB 空间
+
+**解决方案**：关闭开发模式的 prebundle 功能
+
+在 `mini/config/dev.ts` 中添加：
+```typescript
+compiler: {
+  // 关闭开发模式的依赖预编译，减少主包体积以支持微信小程序开发版预览（2MB限制）
+  prebundle: {
+    enable: false
+  }
+}
+```
+
+**优化效果**：
+| 优化前 | 优化后 | 减少 |
+|--------|--------|------|
+| ~3MB | ~650KB | ~78% |
+
+**注意**：
+- 关闭 prebundle 后首次编译会稍慢（需要完整编译依赖）
+- 不影响体验版和生产版（这些版本本身就需要完整的依赖编译）
+
 ---
 
 ## 注意事项

.claude/skills/weapp-publish/scripts/publish-weapp.js

@@ -142,11 +142,13 @@ async function previewDevProject(config, options) {
       setting: {
         useProjectConfig: false,  // 不使用项目配置，完全使用下方自定义设置
         es6: false,
-        enhance: false,
-        minified: false,  // 禁用代码压缩
-        minifyWXSS: false,  // 禁用样式压缩
-        minifyWXML: false,  // 禁用模板压缩
+        es7: false,  // 增强编译
+        minify: true,  // 压缩所有代码
+        minifyWXSS: true,  // 压缩样式
+        minifyWXML: true,  // 压缩模板
+        minifyJS: true,  // 压缩JS
         codeProtect: false,
+        autoPrefixWXSS: false,
       },
       qrcodeFormat: 'image',
       qrcodeOutputDest: qrcodePath,

mini-talent/config/dev.ts

@@ -5,6 +5,12 @@ export default {
     quiet: false,
     stats: true
   },
+  compiler: {
+    // 关闭开发模式的依赖预编译，减少主包体积以支持微信小程序开发版预览（2MB限制）
+    prebundle: {
+      enable: false
+    }
+  },
   mini: {},
   h5: {
     devServer: {
@@ -19,7 +25,7 @@ export default {
       },
       open: false
     },
-    webpackChain(chain, webpack) {  
+    webpackChain(chain) {  
       // 确保在 HtmlWebpackPlugin 之后添加  
       chain  
         .plugin('iframeCommunicationPlugin')  

mini/config/dev.ts

@@ -5,6 +5,12 @@ export default {
     quiet: false,
     stats: true
   },
+  compiler: {
+    // 关闭开发模式的依赖预编译，减少主包体积以支持微信小程序开发版预览（2MB限制）
+    prebundle: {
+      enable: false
+    }
+  },
   mini: {
     compile: {
       include: [

mini/project.config.json

@@ -9,7 +9,8 @@
     "enhance": false,
     "compileHotReLoad": false,
     "postcss": false,
-    "minified": true
+    "minified": true,
+    "maxUploadSourceSize": 4
   },
   "compileType": "miniprogram",
   "maxSinglePackageSize": 4