笔记/知识库管理 (note)
Headless 命令 — 不依赖桌面 GUI，直接使用核心包运行。适用于服务器、CI/CD、容器化等无桌面环境。
核心特性
- 📝 完整 CRUD: 笔记的创建、查看、搜索、删除
- 🏷️ 标签分类: 支持多标签和分类管理
- 🔍 全文搜索: 基于内容的关键词搜索
- 🗑️ 软删除: 删除可恢复，数据安全有保障
- 📊 JSON 输出: 支持
--json格式，便于脚本集成
系统架构
note 命令 → note.js (Commander) → @chainlesschain/core-db
│
┌────────────────────┼────────────────────┐
▼ ▼ ▼
note add note list/show note search
│ │ │
▼ ▼ ▼
INSERT notes 表 SELECT + 分页 LIKE 全文匹配
按分类/标签筛选命令参考
bash
chainlesschain note add "我的笔记" -c "笔记内容" -t "标签1,标签2"
chainlesschain note list # 列出最近笔记
chainlesschain note list --category dev --tag 重要
chainlesschain note list --json # JSON格式输出
chainlesschain note show <id> # 按ID前缀查看笔记
chainlesschain note search "关键词" # 全文搜索
chainlesschain note delete <id> # 软删除子命令说明
add
创建新笔记，支持标题、内容和标签。
bash
chainlesschain note add "学习笔记" -c "今天学了 WebRTC" -t "学习,webrtc"list
列出笔记，支持按分类和标签筛选。
bash
chainlesschain note list
chainlesschain note list --category dev --tag 重要
chainlesschain note list --jsonshow
按 ID 前缀查看笔记详情。
bash
chainlesschain note show abc123search
全文搜索笔记内容。
bash
chainlesschain note search "关键词"delete
软删除笔记（可恢复）。
bash
chainlesschain note delete abc123关键文件
packages/cli/src/commands/note.js— 命令实现@chainlesschain/core-db— 数据库核心包
安全考虑
- 笔记存储在本地 SQLite 数据库，支持 SQLCipher 加密
delete为软删除（设置deleted_at），数据可恢复- 标签和分类数据不会上传到任何外部服务
故障排查
| 问题 | 解决方案 |
|---|---|
add 失败 | 确认数据库已初始化：chainlesschain db init |
search 无结果 | 检查关键词是否匹配，尝试更短的关键词 |
show 找不到笔记 | ID 前缀需至少 4 个字符 |