Web Analytics

clip-save

⭐ 366 stars Korean by snsogbl

剪存 - 클립보드 히스토리 관리 도구

Wails + Vue 3 + TypeScript 기반의 다중 플랫폼 클립보드 히스토리 관리 도구입니다.

App Store에 출시됨

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

기능 특징

프로젝트 스크린샷

Capture

기술 스택

의존성 설치

1. Wails CLI 설치하기

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

2. 프로젝트 의존성 설치

# Go 依赖
go mod tidy
前端依赖

cd frontend
npm install

开发

启动开发服务器

wails dev
이것은 핫 리로드 개발 서버를 시작합니다:

개발 시 디버깅

개발 모드에서 애플리케이션은 자동으로 개발자 도구를 엽니다. 확인할 수 있는 내용:

빌드

프로덕션 버전 빌드

wails build
빌드가 완료되면 실행 파일은 build/bin/ 디렉토리에 위치하게 됩니다.

맞춤 스크립트 Cloudflare Pages에 배포하기

프로젝트는 Cloudflare Pages를 사용하여 온라인 스크립트 목록을 호스팅하며, 사용자가 "스크립트 마켓"에서 직접 스크립트를 설치하고 업데이트할 수 있도록 지원합니다.

#### 1. Wrangler CLI 설치하기

npm install -g wrangler

#### 2. Cloudflare 로그인

wrangler login
이렇게 하면 브라우저가 열리고 Cloudflare 계정에 로그인합니다.

#### 3. 스크립트 배포

wrangler pages deploy scriptingExample --project-name=clip-save-plugins
배포가 완료된 후, 스크립트는 다음 URL을 통해 접근할 수 있습니다: #### 4. 스크립트 업데이트

scriptingExample 디렉토리 내 파일을 수정할 때마다 배포 명령어를 다시 실행하세요:

wrangler pages deploy scriptingExample --project-name=clip-save-plugins
#### 5. 주의사항

macOS 빌드 옵션

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

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

wails build -platform darwin/universal

Windows 빌드

wails build -platform windows/amd64

Linux 빌드

wails build -platform linux/amd64

프로젝트 구조

.
├── 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 特定配置

API 설명

백엔드 API (Go)

app.go에 정의된 메서드는 자동으로 프론트엔드에 노출됩니다:

프론트엔드 호출 예시

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

사용 설명

OCR 문자 인식 기능

데이터 저장

클립보드 기록은 ~/.clipsave/clipboard.db에 저장됩니다.

데이터베이스는 자동 생성되며 다음 필드를 포함합니다:

시스템 요구 사항

개발 주의사항

Go API 업데이트 후

app.go의 메서드를 수정할 때마다 프론트엔드 바인딩을 다시 생성해야 합니다:

wails generate module
또는 개발 모드를 사용하면 자동으로 생성됩니다:

wails dev

프론트엔드 개발

프론트엔드는 Vite + Vue 3 + TypeScript 사용:

CGO 의존성

프로젝트는 CGO(SQLite 및 클립보드 작업용)를 사용하며, 빌드시 필요:

자주 묻는 질문

1. 빌드 실패

모든 의존성이 설치되었는지 확인:

# macOS
xcode-select --install
Windows


安装 MSYS2 和 MinGW-w64
Linux

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

2. 프론트엔드에서 백엔드 API 호출 불가

wails generate module 명령어로 프론트엔드 바인딩이 생성되었는지 확인하세요.

라이선스

MIT 라이선스

후원 지원

💗 작가에게 커피 한 잔을

이 소프트웨어가 시간을 절약해주었거나(적어도 스트레스를 덜어주었다면) 작가에게 커피 ☕ 또는 맥주 🍺 한 잔을 후원해 주세요!

모든 커피 한 잔은 신기하게도 새로운 기능, 적은 버그(최대한 노력 중), 그리고 작가가 밤새 코딩할 때 정신적 지주가 됩니다.

당신의 Star ⭐ 와 기부는 제가 버그를 고치고 새 기능을 추가하는 원동력입니다(또한 커피 구매 자금이기도 합니다)!

위챗 스캔

후원 코드

"저에게 커피 한 잔 사주세요 ☕"

프로젝트에 Star ⭐ 주세요

이 프로젝트가 도움이 되었다면 프로젝트에 Star ⭐ 를 눌러주세요. 그것이 저에게 가장 큰 응원입니다!

감사의 말씀

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

Original README: View on GitHub

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