# ai-clip

**Repository Path**: JoinXin/ai-clip

## Basic Information

- **Project Name**: ai-clip
- **Description**: init撒旦，名难民代码是
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Revol AI Clip

AI 切片自动生成 Agent — 桌面客户端（Electron + TypeScript + Vite + React）。

## 环境要求

- Node.js 18+
- npm 或 pnpm

## 安装与运行

```bash
# 安装依赖
npm install

# 若报错 "Electron uninstall"：重新下载 Electron 二进制后再试
npm run electron:install

# 开发模式（启动 Electron + Vite 热更新）
npm run dev

# 构建（或使用 npm run electron:build）
npm run build

# 打包 Windows exe（先构建再使用 electron-builder 打包）
npm run electron:pack

# 预览构建结果
npm run preview
```

**国内网络**：项目已配置 `.npmrc`，使用 [npmmirror](https://npmmirror.com/mirrors/electron/) 作为 Electron 下载镜像，直接 `npm install` 即可加速。若仍失败，可手动执行 `npm run electron:install` 重试。打包 exe 时已设置 `signAndEditExecutable: false`，不会从 GitHub 下载 winCodeSign，避免超时；生成的 exe 使用默认 Electron 图标，若需自定义图标可配置代理或镜像后改为 `true`。

**Windows 报错 `EBUSY` / “resource busy or locked” / “正由另一进程使用”**：`node_modules\electron` 被占用，常见为 Cursor/VS Code 或本机 Electron 进程占用。按顺序尝试：
1. 关掉本项目的 Electron 窗口和 `npm run dev` 所在终端。
2. **完全退出 Cursor（或 VS Code）**，用系统自带的 **PowerShell**（可右键「以管理员身份运行」）进入项目目录，执行：
   ```powershell
   cd E:\code\ai-clip-master
   Remove-Item -Recurse -Force node_modules\electron
   npm install
   ```
3. 若仍提示被占用：打开任务管理器，结束所有 **“Electron”**、**“Node.js”** 进程后再执行上一步；或直接删除整个 `node_modules` 后重装：`Remove-Item -Recurse -Force node_modules`，再 `npm install`。

## 项目结构

- `electron/` — 主进程（main.ts、preload.ts）及后续 IPC、流水线、服务
- `src/` — 渲染进程（React 前端）
- `shared/` — 主进程与渲染进程共享类型与常量
- `doc/` — 产品与目录设计文档

详见 [doc/directory-design.md](doc/directory-design.md)。