maiknote

KO | EN

gitlite — search

#react #go #android #deep-learning #docker #macos #nodejs #windows #awesome #cli #kubernetes #awesome-list #vue #security

(★ 13)

一个vibe coding的笔记软件，即来即走～

maiknote 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="right">
  <a href="README_EN.md">English</a>
</div>

<div align="center">
  <h1>MaikNote</h1>
  <p>一款 macOS 原生的 AI Markdown 悬浮便签应用</p>
  <p>
    <img src="https://img.shields.io/badge/Platform-macOS-black?style=flat-square&logo=apple" />
    <img src="https://img.shields.io/badge/Tauri-2.x-blue?style=flat-square" />
    <img src="https://img.shields.io/badge/Vue-3.x-42b883?style=flat-square&logo=vue.js" />
    <img src="https://img.shields.io/badge/iCloud-同步-0071e3?style=flat-square&logo=icloud" />
  </p>
</div>

---

## 简介

MaikNote 是一款 macOS 原生悬浮便签应用，支持所见即所得 Markdown 编辑、AI 辅助写作与 iCloud 自动同步。灵感来源于 [Antinote](https://antinote.io/)，在其基础上深度整合了 AI 能力。感谢 Antinote 的启发！

> 本项目完全通过 vibe coding 方式开发。

## 设计理念

- **召之即来，挥之即走** — 全局快捷键随时唤起/隐藏
- **所见即所得** — 实时渲染 Markdown，无需切换预览
- **如无必要，勿增实体** — 极简界面，专注内容本身

## 主要界面

![主页面](https://raw.githubusercontent.com/Aprilming/maiknote/main/resources/demo1.png)
![demo1-dark.png](https://raw.githubusercontent.com/Aprilming/maiknote/main/resources/demo1-dark.png)

|                文件夹                |             搜索             |             主题             |
|:---------------------------------:|:--------------------------:|:--------------------------:|
| ![demo6.png](https://raw.githubusercontent.com/Aprilming/maiknote/main/resources/demo6.png) | ![搜索](https://raw.githubusercontent.com/Aprilming/maiknote/main/resources/demo3.png) | ![搜索](https://raw.githubusercontent.com/Aprilming/maiknote/main/resources/demo4.png) |

|                背景                 |               AI设置                |            快捷键             |
|:---------------------------------:|:---------------------------------:|:--------------------------:|
| ![demo2.png](https://raw.githubusercontent.com/Aprilming/maiknote/main/resources/demo2.png) | ![demo5.png](https://raw.githubusercontent.com/Aprilming/maiknote/main/resources/demo5.png) | ![搜索](https://raw.githubusercontent.com/Aprilming/maiknote/main/resources/demo7.png) |

## AI演示
> 选中文字，只会把选中的发送给AI
> 
> 未选中文字，将当前笔记所有内容发送个AI

![xw_20260611145459.gif](https://raw.githubusercontent.com/Aprilming/maiknote/main/resources/xw_20260611145459.gif)

## 快捷键

| 快捷键 | 功能 |
|:---|:---|
| `Cmd+Opt+A` | 唤起 / 隐藏主窗口 |
| `Shift+Opt+Cmd+A` | 强制居中窗口（全局，隐藏时也可触发） |
| `Cmd+N` | 新建笔记 |
| `Cmd+F` | 搜索笔记 |
| `Cmd+[` / `Cmd+]` | 切换上 / 下一条笔记 |
| `Cmd+Backspace` | 删除当前笔记 |
| `Cmd+P` | Pin 置顶 |
| `Cmd+,` | 打开设置 |
| `Esc` | 清除搜索 |

> 触摸板左右滑动 / 鼠标横向滚动也可切换笔记。

## 功能特性

**已实现**

- ✅ 无边框悬浮窗口
- ✅ 所见即所得 Markdown 编辑器
- ✅ 自动保存（防抖）
- ✅ 全局快捷键唤起
- ✅ 笔记搜索
- ✅ 笔记置顶（Pin）
- ✅ 关键词系统
- ✅ AI 辅助写作（右键菜单）
- ✅ iCloud 目录文件存储
- ✅ 导入 / 导出
- ✅ 深色 / 浅色主题切换
- ✅ 自定义笔记背景颜色
- ✅ 文件夹、目录树
- ✅ mcp联网搜索操作
- ✅ `/ip` 出口IP & 本地网卡查询

## 数据存储

笔记存储在 iCloud 目录下，天然支持多设备同步：

```
~/Library/Mobile Documents/com~apple~CloudDocs/MaikNote/
├── metadata.json       # 笔记索引
├── note_<uuid>.md      # 笔记内容
└── ...
```

## 技术栈

| 层级 | 技术 |
|:---|:---|
| 框架 | Tauri 2.x + Vue 3.x + TypeScript |
| 编辑器 | Tiptap（Notion 风格块操作） |
| 状态管理 | Pinia 2.x |
| 样式 | UnoCSS |
| 存储 | 本地 `.md` 文件（iCloud 目录） |
| AI | DeepSeek API

## 开发指南

### 前置要求

- Node.js 20+
- Rust 1.70+
- macOS 12+

### 快速开始

```bash
# 安装依赖
npm install

# 开发模式:q
npm run tauri dev

# 构建（Apple Silicon）
npm run tauri build -- --target aarch64-apple-darwin

# 构建（Intel）
npm run tauri build -- --target x86_64-apple-darwin
```

## 常见问题

### 提示"无法打开"（签名问题）

macOS Gatekeeper 阻止了未签名的应用，执行以下命令解除隔离：

```bash
sudo xattr -r -d com.apple.quarantine /Applications/MaikNote.app/
```

---

## 许可协议

本软件仅供个人学习、研究和私人使用，禁止用于任何商业目的。

### 允许的行为

- ✅ 个人学习、研究和私人使用
- ✅ 修改源代码供个人使用
- ✅ 分享给其他人个人使用（需保持原有版权声明）

### 禁止的行为

- ❌ 任何形式的商业使用
- ❌ 商业产品或服务中集成本软件
- ❌ 销售、转让或授权本软件
- ❌ 去除或篡改版权信息

### 免责声明

本软件按"原样"提供，不提供任何明示或暗示的保证。使用本软件产生的任何风险由用户自行承担。

如有任何疑问，请联系作者。

maiknote

maiknote 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

maiknote

maiknote 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README