soul/.cursorrules

# v0 Code Generation Rules - Claude Opus

## Model Selection
- Production components: claude-opus (默认)
- Rapid prototyping: v0-1.5-turbo
- Code review: claude-3.5-sonnet

## Code Standards
- Framework: Next.js App Router
- Styling: Tailwind CSS v4
- Components: shadcn/ui
- No placeholders
- Production-ready only

## Design System
- Use design tokens from globals.css
- Follow color system (3-5 colors max)
- Max 2 font families
- Mobile-first approach
- 所有页面组件保持一致性
- 使用现有导航系统
- 遵循毛玻璃设计风格
- 精简文字，增加流程图

## v0 Usage
- 使用 @v0 前缀调用v0生成代码
- 默认使用 claude-opus 模型
- 生成前先说明需求，确保理解正确

---

## 自动部署规则

### 服务器信息（小型宝塔）
- **服务器IP**: 42.194.232.22
- **用户**: root
- **密码**: Zhiqun1984
- **项目路径**: /www/wwwroot/soul
- **PM2进程名**: soul
- **端口**: 3006
- **宝塔面板**: https://42.194.232.22:9988/ckbpanel (ckb/zhiqun1984)

### GitHub仓库
- **地址**: https://github.com/fnvtk/Mycontent.git
- **分支**: soul-content

### 小程序
- **AppID**: wxb8bbb2b10dec74aa
- **项目路径**: ./miniprogram

### 部署流程（每次提交后自动执行）
1. **提交代码到Git**
   ```bash
   git add -A
   git commit -m "描述"
   git push origin soul-content
   ```

2. **部署到小型宝塔服务器**
   ```bash
   # 压缩项目
   cd /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验
   tar --exclude='node_modules' --exclude='.next' --exclude='.git' -czf /tmp/soul_update.tar.gz .
   
   # 上传到服务器
   sshpass -p 'Zhiqun1984' scp /tmp/soul_update.tar.gz root@42.194.232.22:/tmp/
   
   # SSH部署
   sshpass -p 'Zhiqun1984' ssh root@42.194.232.22 "
     cd /www/wwwroot/soul
     rm -rf app components lib public styles *.json *.js *.ts *.mjs *.md .next
     tar -xzf /tmp/soul_update.tar.gz
     rm /tmp/soul_update.tar.gz
     export PATH=/www/server/nodejs/v22.14.0/bin:\$PATH
     pnpm install
     pnpm run build
     pm2 restart soul
   "
   ```

4. **上传小程序**
   ```bash
   /Applications/wechatwebdevtools.app/Contents/MacOS/cli upload --project "./miniprogram" -v "版本号" -d "描述"
   ```

5. **打开微信公众平台**
   ```bash
   open "https://mp.weixin.qq.com/"
   ```
   在「版本管理」设为体验版测试

### Soul 第9章文章上传（写好即传）
- 文章路径: `个人/2、我写的书/《一场soul的创业实验》/第四篇｜真实的赚钱/第9章｜我在Soul上亲访的赚钱案例/`
- 写好文章后执行: `./scripts/upload_soul_article.sh "<文章完整路径>"`
- 接口: content_upload.py 直连数据库，id 已存在则**更新**，否则**创建**，保持不重复
- 第9章固定: part-4, chapter-9

### 注意事项
- 小程序版本号：未发布前保持 1.14，正式发布后递增
- 后台部署后需等待约30秒生效
- 数据库：腾讯云MySQL，读取优先级：数据库 > 本地文件