命令行笔记管理

技能简介

nb 是一款命令行笔记、书签和归档工具，采用纯文本存储数据，支持 Git 版本控制和 Wiki 式链接。用户可通过终端快速创建、搜索、编辑和组织笔记，同时管理多个独立笔记本。

业务背景

面向习惯终端操作的技术人员、开发者或知识工作者，nb 将笔记管理融入日常工作流。无需切换图形界面，在命令行即可完成记录、检索与归档，纯文本格式确保数据长期可读，Git 版本控制天然支持变更追溯与团队协作，大幅降低上下文切换成本。

落地案例：某后端工程师每日处理多个项目，需快速记录技术方案与待办事项。他通过 nb 创建独立笔记本区分工作区，用 Markdown 撰写设计文档并添加标签分类；遇到优质技术文章时，直接保存书签并附加学习心得。所有内容本地存储，配合 Git 同步至私有仓库，实现跨设备访问与历史回溯。

能做什么

• 创建和管理多个笔记本，支持笔记本间切换与移动内容
• 添加、编辑、删除 Markdown 格式笔记，支持标签分类
• 记录待办事项并设置截止日期，标记完成状态
• 保存网页书签并附加评论和标签
• 全文搜索笔记内容，支持布尔逻辑和标签过滤
• 自动 Git 提交，支持远程同步与版本回溯

使用说明

安装要求：需预先安装 nb 命令行工具（brew install nb 或从源码安装）。

基础操作步骤：

1. 查看所有笔记本：nb notebooks
2. 创建新笔记本：nb notebooks add <name>
3. 添加笔记：nb add -t "标题" -c "正文内容"
4. 列出笔记：nb list（加 -a 显示全部，-e 显示摘要）
5. 搜索内容：nb search "关键词"（支持 --and--or--not）
6. 编辑笔记：nb edit <id>（可用标题代替 ID）
7. 同步到远程：nb sync

注意事项：切勿手动编辑 ~/.nb/* 目录下的文件，必须通过 nb CLI 操作以保证索引和 Git 提交正确。

输入与输出

见下方输入与输出表格。

风险提示

• 直接修改 nb 的 Git 仓库文件会导致索引损坏，务必使用 CLI 操作
• 未配置远程仓库时，数据仅保存在本地，建议定期备份
• 删除操作默认有确认提示，强制删除（-f）不可恢复
• 长内容建议先写入临时文件再导入，避免命令行转义问题

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/bjesuiter/nb/SKILL.md
来源类型：GitHub 技能仓库