# aha-snippets

**Repository Path**: littlevv/aha-snippets

## Basic Information

- **Project Name**: aha-snippets
- **Description**: 在 AI 时代，本地积累了大量的代码片段和提示词片段，管理起来非常麻烦。AhaSnippets 是一款本地化的片段管理工具，帮助你高效分类管理这些片段，并通过参数化功能快速复用。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-01
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AhaSnippets

> 本地代码片段与提示词管理工具

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Platform](https://img.shields.io/badge/platform-macOS-lightgrey.svg)

## 简介

在 AI 时代，本地积累了大量的代码片段和提示词片段，管理起来非常麻烦。AhaSnippets 是一款本地化的片段管理工具，帮助你高效分类管理这些片段，并通过参数化功能快速复用。

## 核心功能

### 片段管理
- **分类管理**：通过标签系统对片段进行灵活分类
- **参数化支持**：使用 `$$${params.xxx|默认值|描述}$$` 语法定义参数
- **即时预览**：填写参数后实时预览最终内容
- **一键复制**：生成的内容可直接复制到剪贴板

### 标签系统
- **全局标签**：跨库使用的标签
- **灵活分类**：支持多个标签组合管理

### 便捷操作
- **智能识别**：自动从片段内容中提取参数
- **快速复用**：一键复制创建新片段
- **数据备份**：支持 YAML 格式导入导出

### 界面体验
- **简洁设计**：土黄色调，护眼舒适
- **深色模式**：支持浅色/深色主题切换
- **流畅动效**：页面切换平滑过渡

## 快速开始

### 安装

```bash
# 克隆项目
git clone https://gitee.com/your-username/aha-snippets.git
cd aha-snippets

# 安装依赖
npm install
```

### 开发运行

```bash
# 启动开发服务
npm run dev
```

### 构建打包

```bash
# 构建
npm run build

# 打包生成安装包
npm run package
```

## 使用示例

### 定义片段

在片段内容中使用参数语法：

```
请帮我编写一个 $$${params.语言|Python|编程语言}$$
的$$${params.功能|数据处理脚本|需要实现的功能}$$。
代码风格要求：$$${params.风格|简洁清晰|代码风格偏好}$$
```

点击「识别参数」后，系统会自动提取以下参数：

| 参数标识 | 参数名称 | 默认值 | 描述 |
|---------|---------|--------|------|
| 语言 | language | Python | 编程语言 |
| 功能 | function | 数据处理脚本 | 需要实现的功能 |
| 风格 | style | 简洁清晰 | 代码风格偏好 |

### 使用片段

1. 在主页选择需要的片段卡片
2. 在左侧参数面板填写各参数值
3. 右侧预览区实时显示生成的内容
4. 点击「复制」按钮即可复制到剪贴板

## 参数语法

片段中支持以下参数语法：

```
$$${params.参数标识|默认值|参数描述}$$
```

- `参数标识`：参数的唯一标识（英文），用于在片段中引用
- `默认值`：可选，填写后该参数为非必填
- `参数描述`：可选，用于说明参数的用途

## 技术栈

| 层级 | 技术 |
|------|------|
| 框架 | Electron |
| 前端 | React 18 |
| UI | Ant Design 5 |
| 状态管理 | Zustand |
| 动画 | Framer Motion |
| 数据库 | SQLite (better-sqlite3) |
| ORM | Prisma |
| 构建 | Vite |

## 开发

```bash
# 安装依赖
npm install

# 启动开发服务
npm run dev

# 类型检查
npm run type-check

# 代码检查
npm run lint

# 构建
npm run build

# 打包
npm run package
```

## 开源协议

[MIT License](./LICENSE)

## 贡献

欢迎提交 Issue 和 Pull Request！

## Star History

如果这个项目对你有帮助，请给个 Star ⭐