项目简介

在信息碎片化时代，每个人每天都会产生大量零散的想法——某个灵感一闪而过、一段值得收藏的代码、一篇需要稍后阅读的文章链接。传统的笔记软件往往过于「重」，打开一个客户端、等待同步、找到对应的笔记本——等做完这些操作，灵感早已消散。Blinko 正是为解决这一痛点而生的开源工具，它以「卡片式」轻量化记录为核心，让你在任何设备、任何时刻都能快速捕捉一闪而过的念头，并通过 AI 技术帮你后续高效检索。

Blinko 是一个完全自托管的 AI 笔记工具，基于 TypeScript 开发，融合了 Next.js 前端框架、Tauri 桌面端运行时以及 PostgreSQL 数据库。截至目前，它在 GitHub 上已经获得了超过 1 万颗星，这从一个侧面反映了社区对「隐私优先 + AI 增强」笔记方案的强烈需求。与云端笔记服务不同，Blinko 把所有数据都保留在你自己的服务器上，同时通过 RAG（检索增强生成）技术，让你用自然语言就能找到过去任何时候记录的笔记内容。

核心功能与架构

Blinko 的设计哲学可以归纳为三个关键词：轻量、私有、智能。这三个看似简单的要求，背后需要一套完整的架构来支撑。下面我们逐层拆解它最值得关注的几项能力。

AI 增强的语义检索

Blinko 内置了基于 RAG 的笔记检索能力。传统笔记软件通常依赖关键词匹配，你必须记得当初写了什么字才能搜到；Blinko 则不同，它会把你输入的笔记向量化后存入数据库，当你再次输入自然语言查询时，系统会把查询也转化为向量，在语义空间里找到最相关的内容。比如你搜「上次关于数据库迁移的笔记」，即使你当时的原文写的是「PG schema 升级注意事项」，也能被准确召回。这个能力对长期积累了大量笔记的用户尤其有价值——你不再需要费力维护标签体系或者严格的目录结构，AI 会帮你兜底。

数据完全自主可控

作为一款 self-hosted 工具，Blinko 的所有数据都存储在你自己的 PostgreSQL 实例中，不经过任何第三方服务器。对于注重隐私的个人用户，或者对数据合规有要求的小团队来说，这一点几乎是决定性的。项目提供了 Docker 一键部署方案，也支持 PikaPods 等托管平台，把部署门槛降到了最低。

闪电般的记录体验

Blinko 的笔记以「卡片」为单位，默认即开即写、全键盘操作友好。它支持完整的 Markdown 语法，包括代码块、表格、列表等常用元素，同时还支持快速粘贴图片和链接。对于程序员来说，这意味着你可以在记录一段报错信息的同时，完整保留代码格式和缩进，不会出现「粘贴就乱」的尴尬。

基于 Tauri 的跨平台支持

客户端部分，Blinko 使用了 Tauri 框架而非传统的 Electron，这意味着安装包体积更小、内存占用更低、启动速度更快。目前它已经覆盖了 macOS、Windows、Linux 以及 Android 平台，基本实现了「随时随地记一笔」的承诺。

架构层面的依赖清单

从技术栈来看，Blinko 主要由以下几部分组成：Next.js（前端 + SSR）、React（UI 组件）、Tauri（桌面端壳）、PostgreSQL（数据持久化）、OpenAI 兼容接口（用于 embeddings 和可选的智能问答）。这种组合既保证了现代 Web 应用的开发体验，又兼顾了本地部署的轻量化要求。

快速上手

Blinko 的安装流程被设计得尽可能简单。官方提供了一行命令的安装脚本，适合绝大多数 Linux 服务器环境。如果你的目标是先快速体验一下功能再决定是否长期使用，下面这条命令就是最直接的入口。

一键安装

在干净的服务器上直接执行以下命令即可：

curl -s https://raw.githubusercontent.com/blinko-space/blinko/main/install.sh | bash

该脚本会自动拉取 Docker 镜像、初始化 PostgreSQL 数据库、并启动 Blinko 服务。安装完成后，默认监听 3000 端口，你可以通过浏览器访问 http://your-server-ip:3000 进入 Web 界面。

Docker Compose 手动部署

如果你希望对部署过程有更精细的控制，推荐使用 Docker Compose。下面是一份最小可用的 docker-compose.yml 示例：

version: '3.8'
services:
  blinko:
    image: blinkospace/blinko:latest
    container_name: blinko
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://blinko:blinko@postgres:5432/blinko
      - OPENAI_API_KEY=sk-your-key-here
    depends_on:
      - postgres

  postgres:
    image: postgres:16-alpine
    container_name: blinko-db
    restart: unless-stopped
    environment:
      - POSTGRES_USER=blinko
      - POSTGRES_PASSWORD=blinko
      - POSTGRES_DB=blinko
    volumes:
      - ./data/postgres:/var/lib/postgresql/data

保存为 docker-compose.yml 后，执行 docker compose up -d 即可启动完整的服务栈。其中 OPENAI_API_KEY 是可选的——如果不填，AI 检索功能会被禁用，但基础笔记功能仍然可以正常使用，这给了那些暂未接入 AI 服务的用户一个平滑过渡的选项。

桌面客户端安装

对于希望获得原生体验的用户，可以前往 GitHub Releases 页面下载对应平台的安装包。目前官方提供了 macOS（.dmg）、Windows（.exe）、Linux（.AppImage/.deb）以及 Android（.apk）的构建产物。桌面端默认连接到你部署好的 Blinko 服务地址，第一次启动时填入服务端 URL 即可同步数据。

使用场景

Blinko 的设计初衷是「捕捉瞬时灵感」，但在实际使用中，它的应用场景远不止于此。下面列举几个典型用法，帮助你判断它是否适合你的工作流。

场景一：程序员的日常知识库

对于软件工程师来说，工作中会遇到大量需要稍后查阅的片段——某个库的 API 用法、一段调试成功的 SQL、一篇还没来得及细读的 RFC。Blinko 的 Markdown 支持和代码高亮让它特别适合这种技术内容沉淀，配合 AI 检索，几个月前随手记下的一条命令也能在需要时被快速找到。

场景二：内容创作者的灵感收件箱

如果你经常写文章、做视频或者运营自媒体，Blinko 可以作为你的「灵感收件箱」。看到一句好的引言、刷到一个值得展开的话题、甚至只是一张有意思的截图，都可以一键丢进去。等到真正动笔时，让 AI 帮你从这些碎片中提取相关素材。

场景三：团队的轻量级 Wiki

虽然 Blinko 主要面向个人用户，但它的自托管特性也让它可以作为小团队的内部知识库。团队成员各自记录自己的思考，AI 检索则充当了跨人协作的桥梁——任何人都能用自然语言查询团队积累下来的经验教训。

![项目贡献者](https://contrib.ro

项目信息

参考链接

• GitHub 仓库
• 项目主页