blinko
SHA-256AI 驱动的卡片笔记工具,快速捕捉灵感,支持自托管数据隐私和多平台。
用 AI 帮你搜笔记的轻量级笔记应用,数据自己管。
核心功能
- AI 自然语言搜索笔记(RAG 技术)
- 数据完全自托管,隐私可控
- 支持 Markdown 快速格式化
- Tauri 原生跨平台(Win/Mac/Linux/安卓)
- 开源透明,社区协作
避坑指南
- •macOS 未公证的应用可能被系统拦截,需手动移除隔离属性;自托管需要基本的服务器或 Docker 知识;AI 功能依赖本地或远程 LLM 配置。
适用场景
- 快速记录一闪而过的想法
- 个人知识库管理与 AI 辅助检索
- 替代 Notion/Obsidian 的轻量隐私方案
详细介绍
Blinko 是一款开源的、AI 增强的卡片笔记应用。它利用检索增强生成(RAG)技术,让你可以用自然语言搜索笔记。Blinko 强调数据所有权,所有笔记都存储在你的自托管环境中。基于 Tauri 构建,轻量高效,支持 macOS、Windows、Android 和 Linux 多平台。完整支持 Markdown,便于快速格式化和分享。项目代码透明,社区驱动,欢迎贡献。
常见问题与排障 (2)
故障排除为什么在Blinko中将笔记切换为想法时,webhook未触发?
Blinko 中存在一个已知错误:当你更改笔记类型时(例如,从 'note' 改为 'thought' 或反之),webhook 无法触发。根本原因:server/routerTrpc/note.ts 中的 upsert 函数在 content 为 null 时提前返回,而仅更改类型的操作会省略 content,从而跳过了 SendWebhook 调用。要修复此问题,请按如下方式修改约第 668–735 行的代码:
if (content == null) {
SendWebhook({ ...note, attachments }, isRecycle ? 'delete' : 'update', ctx);
return note;
}
这样可确保即使只更新类型时也能触发 webhook。请跟踪该问题以获取永久性版本修复。
故障排除为什么Docker从源码构建时会因monorepo依赖项出现‘Could not resolve’错误?
这是因为项目中的esbuild.config.ts在其外部列表中缺少许多必需的包(例如,mime-types、zod、dayjs、lodash/submodules、@langchain/*)。作为替代方案,请使用官方预构建的Docker镜像(例如ghcr.io/blinko-space/blinko:latest),而不是从源代码构建。要修复构建,请将所有缺失的依赖项添加到server/esbuild.config.ts的external数组中,并确保在Dockerfile中使用bun install --frozen-lockfile标志。
标签
快速上手
安装软件
根据你的发行版安装对应的包(dpkg / rpm / AppImage)
Docker 一键部署:在终端执行 curl -s https://raw.githubusercontent.com/blinko-space/blinko/main/install.sh | bash
桌面端下载:前往 Releases 下载对应系统安装包并双击安装
macOS 用户若提示损坏,运行 sudo xattr -rd com.apple.quarantine /Applications/blinko.app
- Docker 一键部署:在终端执行 curl -s https://raw.githubusercontent.com/blinko-space/blinko/main/install.sh | bash
- 桌面端下载:前往 Releases 下载对应系统安装包并双击安装
- macOS 用户若提示损坏,运行 sudo xattr -rd com.apple.quarantine /Applications/blinko.app
已提供 SHA-256 校验码,下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
624d343107e5de4b302240e379eea5b2bba6dae15cfce20db943f0ef2c94a376该校验码提取自 GitHub Release 页面,下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
Docker 部署:docker stop blinko && docker rm blinko && 删除数据目录。桌面端:将应用拖入废纸篓并清除缓存。
无额外依赖
下载后即可直接使用,无需安装其他运行环境
遇到问题?查看下方 FAQ
2 FAQs