colibri 这个词西语里是蜂鸟的意思我第一次在 GitHub 上刷到这个同名笔记软件时第一反应是这名字取得真妙。蜂鸟体型小、翅膀扇得快、悬停时精准得像静止而这个叫 colibri 的开源笔记工具走的也正是这么一条路安装包只有几十兆基于 Qt 写的原生界面启动几乎不需要等待编辑 Markdown 时反馈极快整个软件没有半点花架子。我大概从它还是早期版本的时候就开始用了中间换过 Notion、Obsidian、语雀兜兜转转最后日常速记还是回到了 colibri 这里。这篇文章不是官方文档的中文翻译而是我把它当主力速记工具用了几年之后的完整复盘。我会从名字背后的设计哲学讲起把安装配置、日常使用、同步方案、常见坑位、以及怎么把它锻造成一个轻量个人知识库的进阶玩法全部过一遍。适合两类人看一类是厌倦了 Electron 笔记软件动辄占用几百兆内存、想找一个纯粹本地纯文本笔记工具的朋友另一类是已经在用其他 Markdown 笔记软件但希望有更轻量的第二入口来做快速捕捉的玩家。如果你只是需要一个打开就写、写完就关、数据完全捏在自己手里的笔记工具colibri 大概率不会让你失望。1. colibri 整体设计与思路拆解1.1 蜂鸟哲学为什么“轻”本身就是一种核心功能很多人选笔记软件时第一反应是看功能列表有没有双链、有没有看板、有没有数据库视图、能不能嵌入 PDF。这些功能当然有价值但它们也带来了一个隐性成本——每一次打开软件你得先等它加载完那一大堆模块再等着界面响应你的每一次点击。这在桌面上还能忍但当你只是想随手记一个快递单号、一个突然冒出来的灵感、一个会议里临时提到的文件名时这种等待就非常劝退。colibri 的思路是把“轻”做成最重要的功能。它从底层上就不给你那些重的选项没有插件市场没有双链图谱没有云服务绑定。它的核心定位就是“极简的本地 Markdown 笔记编辑器”每个笔记就是一个 .md 文件文件夹结构就是你的笔记本分类软件只负责把这些文件展示得整齐、支持快速搜索、提供趁手的编辑体验。这种设计让我想到一个类比你不需要一辆房车去买菜你需要的是一辆自行车能快速到达、好停放、不耗油。colibri 就是那辆自行车。从工程角度看这种取舍也很有讲究。Qt 写的原生应用在冷启动速度上比 Electron 快一个数量级内存占用通常只有 Electron 笔记软件的十分之一左右。我实测过开着 colibri 挂一整天内存稳定在两三百兆以内取决于打开的笔记数量和窗口复杂度而同类 Electron 工具动辄 500MB 起步。对于内存只有 8GB 的老笔记本这个差距是决定性的。1.2 核心特性盘点够用但不将就别看 colibri 主打轻量它覆盖了笔记工具最核心的几项刚需Markdown 编辑与实时预览双模式支持标准 CommonMark 语法表格、代码块、引用、任务列表都能正常渲染。标签系统可以在笔记中打标签并在侧边栏按标签快速筛选。全文搜索支持标题搜索和内容搜索中文检索表现良好笔记量过万之后依然能秒出结果。待办事项管理支持在 Markdown 里用- [ ]/- [x]写任务并汇总到专门的任务视图。外部编辑器联动可以在 colibri 里一键调用 VS Code、Typora 等外部工具打开当前笔记。跨平台支持Windows、macOS、Linux 都有构建版本而且三端界面行为保持一致。便携化使用Windows 版可以直接以绿色模式运行数据目录、配置目录都能自定义。如果你拿它和 Obsidian 比确实少了很多“知识网络”的高级玩法拿它和 Notion 比更是一个天上一个地下。但 colibri 的用户本来就不是奔着那些去的它的价值在于把最常用的 20% 功能做到极致稳定剩下 80% 的复杂需求留给其他工具去解决。这几年我把它当作“捕捉层”来用深度的知识整理交给 Obsidian临时灵感、会议记录、待办速写全部在 colibri 里完成两者形成互补效率反而更高。2. 安装与界面细节三平台部署与工作区定制2.1 不同操作系统的安装方法colibri 的安装根据不同平台差别不小我挨个说下我实际验证过的路径。Windows 上最简单去官方仓库的 Release 页面下载对应版本的安装包或者便携压缩包都行。我一般用便携版解压到一个专门放绿色软件的目录里桌面上放个快捷方式就完事。便携版的好处是换电脑时直接整个文件夹拷走笔记和配置全在里面不用重新装。安装版则会写注册表、自动关联 .md 文件适合小白用户。macOS 用户可以通过 Homebrew 一条命令装完brew install --cask colibri如果不想用 Homebrew也可以直接下 dmg 安装包。首次打开时如果遇到“已损坏无法打开”的提示多数情况是因为没有给执行权限在终端里执行xattr -cr /Applications/colibri.app再打开即可这是 macOS 对非 App Store 应用的常见限制不算 bug。Linux 用户的选择更灵活AppImage 版本下载后需要先加执行权限再运行chmod x colibri-*.AppImage ./colibri-*.AppImage部分发行版还提供了 Flatpak 包或者 AUR 包我个人推荐 Flatpak隔离性好更新也方便。如果你用的是 Debian 系也可以直接下载 .deb 包安装依赖少几乎不会遇到缺库的问题。2.2 界面布局与快捷键上手第一天的配置建议colibri 的界面默认是“三栏结构”左侧是导航栏包含笔记分类树和标签列表中间是笔记列表显示当前分类下的所有笔记右侧是编辑区也是 Markdown 渲染区。整套布局很像十年前的博客后台没有任何学习成本打开就知道怎么用。深入用下来有几个配置是我建议所有人第一时间调整的编辑器字体默认等宽字体有时对中文支持不好我在设置里把编辑区字体换成 “JetBrains Mono” 或 “Sarasa Mono SC”中文和英文混排时舒服很多。自动保存间隔colibri 默认会自动保存但间隔可以调在设置里把自动保存周期改成 1 秒几乎不会丢任何内容。新建笔记的默认存储位置建议单独建一个Inbox文件夹作为默认接收区所有速记先进收件箱之后再归档整理这是 GTD 的自由收件箱思路移植到笔记软件里一样好使。快捷键方面记住这几个就够了CtrlN新建笔记、CtrlF搜索、CtrlP快速切换笔记、CtrlB加粗、CtrlE在编辑和预览模式间切换、CtrlShiftT插入当前时间戳。macOS 上把 Ctrl 换成 Command 即可。时间戳插入这个功能看起来不起眼但对于写工作日志和会议记录的人来说简直是救命稻草我每次开会都会先敲一条带时间戳的笔记回来再慢慢补内容。3. 核心配置流程从下载到多设备同步的一次性到位3.1 数据目录规划所有笔记都是普通文件我不管你之前用的是什么笔记软件用 colibri 之前第一件事是建立一个清晰的数据目录结构。colibri 的数据组织方式非常“朴实”一个笔记对应一个 .md 文件文件夹嵌套就是笔记分类嵌套不存在任何私有数据库格式。这意味着你随时可以用系统自带文件管理器浏览和备份所有笔记哪怕有一天 colibri 这个软件彻底不维护了你的笔记也还是普通 Markdown 文件拿任何编辑器打开都能读。我的推荐目录结构是这样的Notes/ # 笔记根目录 ├── Inbox/ # 速记收件箱 ├── Projects/ # 按项目归类 │ ├── 博客建设/ │ └── 家庭装修/ ├── Knowledge/ # 知识积累 │ ├── Programming/ │ └── Cooking/ ├── Journal/ # 日志与日记 └── Attachments/ # 附件文件夹设置里的“数据目录”直接指向 Notes 根目录。新建笔记时默认落在 Inbox 里每篇笔记可以用拖动标题到左侧分类树的方式快速移动到其他文件夹colibri 支持图形化操作不需要手动去文件系统里移动。附件方面拖拽图片进笔记会自动复制到当前笔记同级的media子目录并写入相对路径引用这样整个 Notes 目录拷走也不会丢图。3.2 同步方案本地优先与多设备协同的平衡colibri 本身不带任何云同步功能这反而是它的优点。数据文件全是普通文件你可以选择任何一种你信任的同步机制完全掌握数据流转。我最推荐的组合是Git 版本管理 同步盘。Git 负责历史版本与回滚。在 Notes 根目录初始化仓库后每天或每周 commit 一次配合git log、git diff能追踪每次修改误删段落、改坏结构都不怕。我个人的习惯是每天结束时提交一次commit message 写成当天的日期比如2025-03-21晚上巡检一遍当天笔记顺手清理草稿顺便就完成了日常复盘。同步盘负责多设备实时同步。Windows 上用坚果云或者 OneDrive 都行macOS 上直接用 iCloud DriveLinux 上可以用 Syncthing 自建。把 Notes 目录丢进同步盘目录其他设备上同样指向这个目录就实现了多端同步。需要注意一点同步盘无法解决“同时编辑同一篇笔记”的冲突问题所以我的实践规则是重要笔记尽量同一时间只在一台设备上编辑手机上需要快速查看时用同步盘的客户端看渲染后的文件而不是在手机上直接编辑。观看我个人踩过的一个坑某次出差时我在地铁上用手机改了一篇笔记回到酒店打开电脑又改了同一篇两个版本冲突后同步盘自动生成了一个副本文件文件名带着(冲突)后缀。从那以后我就把手机端的编辑权限关掉了手机只读电脑端写宁可用备忘录先记录灵感回家再统一整理进 colibri。3.3 一键速记与外部编辑器联动colibri 的速记能力比它表面上看起来强很多。设置里可以定义“全局快捷键”注册一个组合键比如CtrlShiftC之后不管你在哪个窗口只要按下这个组合键colibri 就会从系统托盘中唤起一个迷你速记窗口输入内容回车即可保存。这个功能我每天至少用十几次正在写代码时突然收到一个电话号码、浏览网页时看到一个需要稍后研究的术语、打电话时对方报了一个邮箱地址这些碎片信息全部通过速记窗口收进收件箱等到晚上统一整理。它比打开完整的笔记软件再新建一条要快一个量级几乎接近于实体便利贴的响应速度。外部编辑器联动是另一个隐含生产力功能。colibri 内置了一个“在外部编辑器打开”的选项配置好路径后可以一键调用 VS Code 或 Typora 打开当前笔记。什么时候用外部编辑器当你在写一篇长度超过三千字的深度长文时colibri 的编辑器功能相对基础没有字数统计、没有全局大纲、没有块拖拽但 VS Code 结合 Markdown 插件可以提供沉浸式写作体验。我把 colibri 当成“文件管理器和快速预览器”把 VS Code 当成“深度写作台”两者通过同一个 Markdown 文件无缝衔接。这种双编辑器的搭配比任何单工具都顺手。4. 常见问题与排查技巧实录4.1 搜索没结果或索引异常先分清是数据问题还是索引问题用 colibri 最常遇到的一个假故障是“明明有这篇笔记但搜索关键词就是搜不到”。第一次碰到时我差点把整个软件卸载了后来排查下来十有八九是搜索索引没有刷新。colibri 为了搜索速度会为笔记目录建立一个索引缓存这个缓存存储在数据目录的 cache 子文件夹里。当你用同步盘同步笔记或者直接通过文件管理器往目录里手动拷入大量新文件时索引可能没有及时更新。解决办法也很粗暴在设置里找到“重建索引”按钮点一下它会重新扫描所有笔记文件通常几秒钟就能完成全量索引。如果是索引文件本身损坏了更彻底的做法是退出 colibri手动删除 cache 目录然后重新打开软件它会自动重建全部索引。删除 cache 不会碰你的笔记元数据只是多花一点重建时间而已完全可以放心操作。注意如果搜索时发现单篇笔记的内容显示为空但文件资源管理器里确认 .md 文件存在且有大小这种大概率不是缓存问题而是文件路径中包含特殊字符导致读取失败。检查文件名里是否有#、%、等字符重命名去掉后再搜索就能恢复正常。4.2 多设备同步产生的重复与冲突文件前面提到的“手机电脑同时编辑”只是冲突的一种来源。更隐蔽的冲突来源是同步盘的文件版本回调没有完全完成时colibri 的自动保存抢先写入了文件导致同步盘判定为冲突。遇到冲突时colibri 的目录里可能会出现类似我的笔记冲突.md这样的副本文件。处理步骤我建议这样先不要急着删除任何一方用 diff 工具比如 VS Code 的文件比较功能对比两个版本把双方的新增内容合并到一起然后保留一个文件另一个移入临时目录。如果冲突文件太多一个取巧的办法是以修改时间最新的文件为准但前提是你确认那两个小时内只在一台设备上有过编辑另一台设备只是空闲同步触发了写入。从根上解决的话我建议把自动保存间隔调长一点比如 30 秒同时禁用多设备同时在线编辑的习惯性动作。笔记软件的实时协同是云端产品才解决的问题本地优先工具最好的策略就是“错峰编辑”。这件事我在团队里也很强调用 colibri 的成员之间碰到同一篇共享笔记时主动在群里说一声“这篇我正在改”比任何技术方案都管用。4.3 卡顿与启动变慢笔记量暴增后的应对策略colibri 虽然轻但如果你把几万篇笔记全都堆在一个扁平的目录里再快的软件也会出现卡顿。我记得有一阵子我嫌整理麻烦所有笔记都往 Inbox 里扔两个月攒了三千多篇搜索开始有肉眼可见的延迟启动时间也从原来的 1 秒涨到 3 秒左右。排查后我做了三件事问题立刻缓解文件夹分类归整把 Inbox 里的旧笔记按项目和时间批量移到Projects/2025、Knowledge等子目录保持每个目录下的文件数不超过 1000 个这项操作立竿见影。图片附件单独存放让所有图片都落入Attachments目录而不是每一篇笔记的 media 子目录里避免大量小文件散布在目录树各处延长文件系统索引时间。定期重建索引每月一次“重建索引”操作相当于给笔记库做一次瘦身按摩清除索引碎片。如果你的笔记量确实大到搜索都救不了那要考虑的不是优化 colibri而是更新你的整理策略。笔记工具的定位是“捕捉与检索”不是“无限堆积”每季度做一次大扫除、归档不活跃项目、合并重复主题这才是维持长期流畅的正道。4.4 常见问题速查表下面这张表汇总了我遇到过的其他小问题和对应解法都是实际验证过的问题可能原因解决方案中文输入法打完字没有候选词编辑器键盘事件处理与输入法冲突在系统输入法设置里切换为“原生输入模式”或关闭 colibri 的设置“自动补全括号”macOS 上复制粘贴快捷键失效系统快捷键被其他软件抢占检查是否开启“应用内快捷键覆盖”恢复默认设置后重试笔记中图片显示为裂图相对路径因为移动文件夹失效检查图片是否还在对应 media 目录重新插入图片并确保使用“复制到笔记目录”选项新建笔记后文件名是乱码文件系统编码设置问题将系统区域设为 UTF-8尤其在中文 Windows 环境下需要开启 Beta 版“使用 Unicode UTF-8 提供全球语言支持”外部编辑器打开报错路径配置错误确认外部编辑器的可执行文件路径和参数是否按要求填写5. 进阶玩法把 colibri 打造成个人速记中台5.1 与 Obsidian 共存同一份数据两种打开方式colibri 和 Obsidian 共用同一个 Notes 文件夹是可行的而且是两者结合的绝佳方案。因为 colibri 存储的就是标准 Markdown 文件Obsidian 也能直接读取这个目录作为 Vault。colibri 负责快速捕捉和简单检索Obsidian 负责知识网络、关系图谱和深度复盘两边的数据和双链都基于纯文本文件不会互相干扰。实际使用时有一个小差异要注意colibri 的标签体系是基于某种特定约定的Obsidian 的标签也是基于 Markdown 正文的两者在同步解析时会因为语法差异出现部分标签遗漏。我的做法是在 colibri 里尽量少用标签主要依赖文件夹分类标签只用在 Obsidian 端做主题聚合。两边共用文件时只要你不把标签语法混用得太特殊基本不会出大问题。最终原则是文件是主软件是仆一份数据多点打开是本地优先工具的最大红利。5.2 用脚本批量整理笔记文件名与标签的自动化colibri 没有脚本 API但它的数据是普通文件这就给了你无限的脚本操作空间。我用 Python 写过一个批量整理脚本作用是把按标题生成的文件名里的特殊字符和日期前缀规范化为统一的YYYY-MM-DD-标题.md格式。写这种脚本时要注意不要随意改写文件内容只动文件名否则容易破坏 colibri 记录的笔记内部链接。import os import re from pathlib import Path notes_root Path(/path/to/Notes) def normalize_name(name: str) - str: name re.sub(r[#%\{\}\$!«»\\], , name) name name.strip().replace( , -) return name for md_file in notes_root.rglob(*.md): new_name normalize_name(md_file.stem) if new_name ! md_file.stem: target md_file.with_name(new_name .md) md_file.rename(target) print(fRenamed: {md_file.name} - {target.name})这类脚本适合在季度大扫除时跑一遍但跑之前务必先做 Git 提交或整体备份。脚本操作文件系统一旦正则写错可能批量把文件名改坏所以务必备份了再执行。另外一个经验是小步慢跑先在一个子目录上试运行确认输出符合预期后再扩展到整个目录树。5.3 用快捷键和自动化工具扩展速记入口colibri 自带的全局快捷键速记窗口已经很好用了但我还是额外配置了一些系统级的快捷入口进一步提升输入效率。Windows 上我用 AutoHotkey 写了一个小脚本作用是当我在任意软件里选中一段文本并按下CtrlShiftR时自动启动 colibri 新建一篇笔记并把选中文本作为标题选中的内容作为正文。这样我浏览网页时想收藏一段重要资料只需选中内容按两个键就完成了一次“剪报”操作不用切换窗口复制粘贴。AHK 脚本的核心逻辑是^r:: ClipSaved : ClipboardAll Clipboard : Send, ^c ClipWait, 1 Run, C:\path\to\colibri.exe --new-note %Clipboard% Clipboard : ClipSaved return这只是一个雏形具体的参数要看你的 colibri 版本支持的命令行参数而定。核心思路是任何效率工具只要能唤起 colibri 并传入文本就能让速记入口无处不在。平时我还会用手机上的“快捷指令”生成一个文本备忘录再通过同步盘把它转存到 Inbox 目录这样在地铁上偶发的灵感也能在回到电脑后出现在 colibri 里实现全平台覆盖。5.4 搭建个人速记模板会议记录、灵感卡与日报colibri 本身不带模板功能但“新建笔记”时可以预制模板内容这个模板存在配置目录里。我自定义了三种最常用的模板按需新建会议记录模板# 会议记录 - 日期 / 项目 日期{{date}} 参与人 主题 - 议题一 - 讨论要点 - 结论 - 议题二 - 待办事项 - [ ]灵感卡片模板# 灵感{{title}} 时间{{date}} 触发来源 核心想法 可能的应用场景 下一步行动日报模板# 工作日报 - {{date}} 今日完成 1. 今日进展 - 明日计划 - 风险与阻塞 -模板的意义不在于格式本身而在于倒逼你在记录时把信息结构化。碎片信息进 Inbox 不整理过一周再看基本上等于没记但如果是按模板生成的笔记至少时间、主题、待办这几项信息是完整的后续归档和检索都省了很多力气。写在使用 colibri 这么久之后的一点心里话如果有人问我笔记软件到底应该追求什么我的回答是减少摩擦尊重数据。colibri 在这两点上做得非常彻底。它让我习惯了“任何想法先落进本地文件再说”也让我对“软件会永远存在、云端内容永不丢失”这种假设始终保持警惕。它的定位注定不会成为一个爆款产品因为它的克制在这个什么都想做的软件时代太另类了。但恰恰是这种克制让它成为我每天真正打开次数最多的一个工具——它像一个安静的书桌抽屉拉开就能写字合上就静静待着从不打扰你。如果你也在寻找这样一个稳定的本地速记位给 colibri 一个机会用一个月再来评价它我想你大概率会和我一样把它当成桌面上那个最不起眼但最离不开的图标。
