create-miniprogram-scaffold 1.0.5 → 1.0.7

package/bin/cli.js

@@ -39289,6 +39289,13 @@ var SERVERS = {
 };
 
 // src/scaffolder.js
+function renderTemplate(templatePath, vars) {
+  let content = import_fs_extra.default.readFileSync(templatePath, "utf-8");
+  for (const [key, value] of Object.entries(vars)) {
+    content = content.replaceAll(`{{${key}}}`, value);
+  }
+  return content;
+}
 function generateAppConfig(pages, tabbar) {
   const pagesStr = pages.map((p) => `    '${p}'`).join(",\n");
   let tabbarStr = "";
@@ -39335,6 +39342,10 @@ async function scaffold(projectName, config) {
   const mDir = import_path.default.join(dir, "miniprogram");
   const layoutCfg = LAYOUTS[layout];
   const serverCfg = SERVERS[server];
+  const serverLabel = serverCfg.label;
+  const serverExt = server === "python" ? "py" : "go";
+  const startCmd = server === "python" ? "pip install -r requirements.txt && python main.py" : "go mod tidy && go run main.go";
+  const startCmdFull = server === "python" ? "cd server && pip install -r requirements.txt && python main.py" : "cd server && go mod tidy && go run main.go";
   await import_fs_extra.default.ensureDir(mDir);
   await import_fs_extra.default.ensureDir(import_path.default.join(dir, "server"));
   await import_fs_extra.default.copy(import_path.default.join(tDir, "miniprogram"), mDir, {
@@ -39370,6 +39381,21 @@ async function scaffold(projectName, config) {
     await import_fs_extra.default.writeFile(envPath, env);
     await import_fs_extra.default.writeFile(envExamplePath, env);
   }
+  const repoRoot = import_path.default.join(tDir, "..", "..");
+  await import_fs_extra.default.copy(import_path.default.join(repoRoot, "reusable"), import_path.default.join(dir, "reusable"));
+  await import_fs_extra.default.copy(import_path.default.join(repoRoot, "docs"), import_path.default.join(dir, "docs"));
+  const metaDir = import_path.default.join(tDir, "meta");
+  const tplVars = {
+    PROJECT_NAME: projectName,
+    SERVER_LABEL: serverLabel,
+    SERVER_EXT: serverExt,
+    LAYOUT: layout,
+    START_CMD: startCmd,
+    START_CMD_FULL: startCmdFull
+  };
+  const claudeContent = renderTemplate(import_path.default.join(metaDir, "CLAUDE.md"), tplVars);
+  await import_fs_extra.default.writeFile(import_path.default.join(dir, "CLAUDE.md"), claudeContent);
+  await import_fs_extra.default.writeFile(import_path.default.join(dir, "AGENT.md"), claudeContent);
   await import_fs_extra.default.writeFile(import_path.default.join(dir, "README.md"), generateReadme(projectName, layout, server));
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-miniprogram-scaffold",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Create Taro + Go/Python mini program projects",
   "repository": {
     "type": "git",

package/templates/meta/CLAUDE.md

@@ -0,0 +1,74 @@
+# {{PROJECT_NAME}}
+
+## 技术栈
+
+- 前端：Taro 3 + React + TypeScript + Sass
+- 后端：{{SERVER_LABEL}}
+- 布局：{{LAYOUT}}
+
+## 常用命令
+
+```bash
+cd miniprogram && pnpm install && pnpm dev:weapp   # 前端开发
+cd server && {{START_CMD}}                         # 后端开发
+```
+
+## 项目规范
+
+- CSS 字号用变量 `var(--fs-xxl)`，禁止写死 px
+- 类名 BEM：`.block__element--modifier`
+- API 返回 `{ code: 0, message, data, pagination? }`
+- 纯展示组件用 `memo()` 包裹
+- PNG only，不用 SVG
+- `<Image>` 容器必须有显式 width/height
+
+## 项目结构
+
+```
+├── miniprogram/     # Taro 前端
+│   ├── src/layouts/ # 布局组件
+│   ├── src/pages/   # 页面
+│   └── config/      # 构建配置
+├── server/          # {{SERVER_LABEL}} 后端
+├── reusable/        # 可复用组件和工具
+├── docs/            # 项目文档
+├── CLAUDE.md        # AI 协作规范
+└── AGENT.md         # Agent 使用指南
+```
+
+## 可复用资产
+
+`reusable/` 包含可直接复用的组件、工具和踩坑文档：
+
+### 组件（reusable/components/）
+
+| 组件 | 说明 |
+|------|------|
+| CachedImage | 远程图本地缓存 |
+| AppNoticeModal | 公告弹窗 |
+| AnnouncementModal | 系统公告 |
+| PageHeader | 页面标题区 |
+| Page | 页面容器壳 |
+| GlobalFab | 全局浮动按钮 |
+| Confetti | 撒花特效 |
+| SearchBar | 搜索输入条 |
+| DetailCard | 详情卡片壳 |
+
+### 工具（reusable/utils/）
+
+- `subscribeMessage.ts` — 微信订阅消息统一封装
+- `obfuscate.ts` — Base64 + JSON 混淆
+
+### 踩坑文档（reusable/patterns/）
+
+- bundle-size-optimization / ios-date-parse / wxss-compatibility
+- taro-build-gotchas / local-image-imports / page-scroll-and-tabbar
+- css-variables-and-bem / cached-image-container-size
+- api-response-format / subscribe-message-flow
+- blue-green-deployment / smoke-test
+
+## 注意事项
+
+- 部署前确认用户意图，不要主动 deploy
+- 不要手动 push 到 main
+- 只跑 build 验证编译，不要起服务