Web Analytics

clip-save

⭐ 366 stars Spanish by snsogbl

ClipSave - Herramienta de gestión del historial del portapapeles

Una herramienta multiplataforma para la gestión del historial del portapapeles basada en Wails + Vue 3 + TypeScript.

Disponible en App Store

https://apps.apple.com/us/app/剪存/id6754015301

Características

Capturas del proyecto

Captura

Tecnologías

Instalación de dependencias

1. Instalar Wails CLI

go install github.com/wailsapp/wails/v2/cmd/wails@latest

2. Instalación de las dependencias del proyecto

# Go 依赖
go mod tidy
前端依赖

cd frontend
npm install

开发

启动开发服务器

wails dev

Esto iniciará el servidor de desarrollo con recarga en caliente:

Depuración durante el desarrollo

En modo desarrollo, la aplicación abrirá automáticamente las herramientas de desarrollador, donde se puede ver:

Construcción

Construcción de la versión de producción

wails build

Después de la compilación, el archivo ejecutable se ubicará en el directorio build/bin/.

Despliegue de scripts personalizados en Cloudflare Pages

El proyecto utiliza Cloudflare Pages para alojar la lista de scripts en línea, permitiendo a los usuarios instalar y actualizar scripts directamente desde el "mercado de scripts".

#### 1. Instalar Wrangler CLI

npm install -g wrangler
#### 2. Iniciar sesión en Cloudflare

wrangler login

Esto abrirá el navegador e iniciará sesión en tu cuenta de Cloudflare.

#### 3. Desplegar el script

wrangler pages deploy scriptingExample --project-name=clip-save-plugins

Después de la implementación, el script estará disponible en la siguiente URL:

#### 4. Actualizar el script

Cada vez que modifique un archivo en el directorio scriptingExample, vuelva a ejecutar el comando de implementación:

wrangler pages deploy scriptingExample --project-name=clip-save-plugins

#### 5. Consideraciones

Opciones de compilación para macOS

# 构建 Intel 版本
wails build -platform darwin/amd64
构建 Apple Silicon 版本

wails build -platform darwin/arm64
构建通用二进制（推荐）

wails build -platform darwin/universal

Construcción en Windows

wails build -platform windows/amd64

Construcción en Linux

wails build -platform linux/amd64

Estructura del proyecto

.
├── main.go                      # 主程序入口
├── app.go                       # Wails 应用结构和 API
├── wails.json                   # Wails 配置文件
├── go.mod                       # Go 依赖管理
├── common/                      # 共享代码
│   ├── clipboard.go             # 剪贴板逻辑
│   ├── clipboard_darwin.go      # macOS 特定代码
│   └── db.go                    # 数据库操作
├── frontend/                    # 前端代码
│   ├── src/
│   │   ├── App.vue              # 主应用组件
│   │   ├── components/
│   │   │   └── ClipboardHistory.vue  # 剪贴板历史组件
│   │   ├── main.ts              # 前端入口
│   │   └── style.css            # 全局样式
│   ├── index.html               # HTML 模板
│   ├── package.json             # 前端依赖
│   ├── vite.config.ts           # Vite 配置
│   └── tsconfig.json            # TypeScript 配置
└── build/                       # 构建资源和输出
    ├── bin/                     # 编译后的可执行文件
    ├── appicon.png              # 应用图标
    └── darwin/                  # macOS 特定配置

Descripción de la API

API Backend (Go)

Los métodos definidos en app.go se expondrán automáticamente al frontend:

Ejemplo de llamada desde frontend

import { SearchClipboardItems } from '../wailsjs/go/main/App'
// 搜索剪贴板项目
const items = await SearchClipboardItems('关键词', '所有类型', 100)

Instrucciones de uso

Función de reconocimiento OCR de texto

Almacenamiento de datos

El historial del portapapeles se guarda en: ~/.clipsave/clipboard.db

La base de datos se crea automáticamente y contiene los siguientes campos:

Requisitos del sistema

Consideraciones para el desarrollo

Después de actualizar la API de Go

Cada vez que se modifique un método en app.go, es necesario regenerar el enlace del frontend: 

wails generate module
O usar el modo de desarrollo, generará automáticamente:

wails dev

Desarrollo Frontend

El frontend utiliza Vite + Vue 3 + TypeScript:

Dependencias CGO

El proyecto usa CGO (para SQLite y operaciones del portapapeles), para compilar se necesita:

Preguntas Frecuentes

1. Fallo en la compilación

Asegúrese de tener instaladas todas las dependencias:

# macOS
xcode-select --install
Windows


安装 MSYS2 和 MinGW-w64
Linux

sudo apt-get install build-essential libgtk-3-dev libwebkit2gtk-4.0-dev

2. El front-end no puede llamar a la API del back-end

Asegúrate de haber ejecutado wails generate module para generar el enlace del front-end.

Licencia

Licencia MIT

Apoyo y agradecimientos

💗 Invita al autor a un café

Si este software te ha ahorrado tiempo (o al menos no te ha vuelto loco), ¡te invitamos a ofrecerle un café ☕ o una cerveza 🍺 al autor!

Cada taza de café se convierte mágicamente en: nuevas funciones, menos bugs (hago lo posible), y el soporte moral del autor durante las noches de codificación.

¡Tu Star ⭐ y donaciones son la fuerza que me impulsa a corregir bugs y añadir nuevas funciones (¡y también el presupuesto para comprar café!)!

Escanea con WeChat

Código de Agradecimiento

"Invítame a un café ☕"

Dale un Star ⭐ al proyecto

Si este proyecto te ha sido útil, ¡dale un Star ⭐! ¡Es el mayor apoyo que puedes darme!

Agradecimientos

--- Tranlated By Open Ai Tx | Last indexed: 2026-07-16 ---

Original README: View on GitHub

Translated by OpenAiTx | Last updated: 2026-07-16