nb CLI 笔记书签知识库

解决什么问题

大多数笔记工具要么锁定在封闭格式里，要么依赖云端同步，笔记一旦离开特定生态就很难迁移和追溯。散落在浏览器书签、本地 Markdown、各类 App 里的知识缺乏统一版本管理：改错一句话、误删一段内容，往往只能靠「撤销」碰运气。对于工程师来说，笔记也应该像代码一样可追踪、可回滚、可搜索。

核心能力与工作原理

nb 的核心思路是把笔记、书签、归档统一存成纯文本文件，再用 Git 做版本记录与同步。整个工具打包在一个便携的 Bash 脚本里，不依赖重型服务端。

关键能力包括：

• Wiki 式链接：笔记之间可以用 [[链接]] 互相引用，形成知识网络而非孤立文档
• 标签与搜索：通过 tag 打标，配合本地全文搜索快速定位
• 加密：敏感内容可做本地加密存储
• 导入/导出：借助 Pandoc 在多种格式（Markdown、HTML、PDF 等）之间转换
• Git 版本同步：所有变更走 Git 仓库，天然支持回滚、分支和远程同步

典型工作流： 在终端用 nb 命令快速记录想法或书签，编辑纯文本笔记，用 wiki 链接关联相关条目，需要时用 Pandoc 导出为其他格式，所有变更自动纳入 Git 版本管理。

适用边界与注意点

• 需要本地有 Bash 和 Git 环境，Windows 原生环境需借助 WSL 或 Git Bash
• 更适合习惯纯文本和命令行的用户，没有 WYSIWYG 编辑器
• 加密与 Pandoc 依赖外部工具，需提前安装
• 单脚本架构意味着功能聚焦，不适合需要复杂协作或实时多端同步的场景