# vibestart

**Repository Path**: webhwh/vibestart

## Basic Information

- **Project Name**: vibestart
- **Description**: vibestart-帮普通人快速入行 AI  - VibeCoding开发。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VibeStart

零基础 AI 编程向导（Tauri 2 + React）。支持 **macOS** 与 **Windows**。

## 环境要求

- Node.js 20+
- Rust（[rustup](https://rustup.rs/)）
- macOS：Xcode Command Line Tools；Windows：Visual Studio Build Tools（MSVC）

## 本地运行

```bash
# 安装依赖
npm install

# 开发模式（热更新）
npm run tauri -- dev
# 或
./node_modules/.bin/tauri dev
```

开发窗口默认约 1280×720。前端 Vite：`http://localhost:1420/`。

仅跑前端（不启桌面壳）：

```bash
npm run dev
```

## 构建安装包

```bash
# 当前平台
npm run tauri -- build

# Windows 交叉编译（在 macOS 上，需已装 cargo-xwin）
npm run build:win
```

产物：

- macOS：`src-tauri/target/release/bundle/dmg/`
- Windows：`src-tauri/target/release/bundle/nsis/` 或 `msi/`

发版（打 tag、同步下载页配置等）：

```bash
./scripts/release.sh        # patch
./scripts/release.sh minor
```

## 仓库结构（简）

| 路径 | 说明 |
|------|------|
| `src/` | React 向导 / 工作台 |
| `src-tauri/` | Rust 后端（安装、探测、部署） |
| `site/` | 产品下载页（静态，发版时同步版本） |
| `scripts/` | 发版与同步脚本 |

推广视频素材与 Remotion 工程在本地 `video/`（已 gitignore，不进仓库）。

## 平台说明

- 安装：macOS 优先 Homebrew；Windows 优先 winget / npm（CLI 默认前缀 `~/.vibestart/tools/npm`）
- 部署上线：默认 **Vercel**；可选 GitHub Pages。Gitee 仍可代码托管，**不再使用 Gitee Pages**
- Codex 桌面端：macOS 上可能显示为 `ChatGPT.app`（Bundle ID `com.openai.codex`），应用按 Bundle ID 识别

## 下载页本地预览

```bash
open site/index.html
# 或任意静态服务器指向 site/
```