Quick Note - 快速笔记#

激活词: 记一下 / 笔记 / 记个事

功能#

• 语音/文字快速记录
• 自动标签分类（idea / todo / readlater）
• 本地 JSON 持久化，私密可靠
• 按标签筛选检索

Python 实现#

python

import os, json
from datetime import datetime

NOTES_FILE = os.path.join(os.path.dirname(__file__), "quick_notes.json")

class QuickNote:
    def __init__(self):
        os.makedirs(os.path.dirname(NOTES_FILE), exist_ok=True)
        self.notes = self._load()

    def _load(self):
        if os.path.exists(NOTES_FILE):
            with open(NOTES_FILE, encoding="utf-8") as f:
                return json.load(f)
        return []

    def _save(self):
        with open(NOTES_FILE, "w", encoding="utf-8") as f:
            json.dump(self.notes, f, ensure_ascii=False, indent=2)

    def add(self, text: str, tags: list = None):
        """保存一条笔记"""
        if tags is None:
            # 自动标签：根据内容关键词判断
            tags = []
            if "?" in text or "为什么" in text:
                tags.append("readlater")
            if "todo" in text.lower() or "需要" in text or "要去做" in text:
                tags.append("todo")
            if not tags:
                tags.append("idea")

        note = {
            "id": len(self.notes) + 1,
            "text": text,
            "tags": tags,
            "created": datetime.now().isoformat(),
            "updated": datetime.now().isoformat()
        }
        self.notes.append(note)
        self._save()
        return note

    def search(self, keyword: str = "", tags: list = None):
        """搜索笔记"""
        results = self.notes
        if keyword:
            results = [n for n in results if keyword.lower() in n["text"].lower()]
        if tags:
            results = [n for n in results if any(t in n["tags"] for t in tags)]
        return results

    def delete(self, note_id: int):
        self.notes = [n for n in self.notes if n["id"] != note_id]
        self._save()

# 使用示例
note = QuickNote()
note.add("学习Transformer的FlashAttention机制，据说能加速3x", tags=["readlater"])
note.add("需要买牛奶和鸡蛋", tags=["todo"])
note.add("用Python写一个CLI工具来自动化部署", tags=["idea"])

# 搜索
for n in note.search(tags=["idea"]):
    print(f"[{n['id']}] {n['text']}")

命令行用法#

bash

# 添加笔记（直接传参）
python -c "from quick_note import QuickNote; QuickNote().add('读一下RAG论文', tags=['readlater'])"

# 列出所有 idea 标签
python -c "from quick_note import QuickNote; [print(n['text']) for n in QuickNote().search(tags=['idea'])]"

数据格式#

json

[
  {
    "id": 1,
    "text": "学习FlashAttention机制",
    "tags": ["readlater"],
    "created": "2026-05-28T10:30:00",
    "updated": "2026-05-28T10:30:00"
  }
]

使用场景#

1. 灵感捕捉: 正在洗澡突然想到好点子，说出来自动存
2. 阅读清单: 看到有趣的文章先标记 readlater，回头再读
3. 快速待办: 「记一下，记得买牛奶」自动归类为 todo
4. 知识碎片: 碎片化知识汇总，周末统一整理

依赖#

• Python 3.8+
• 无第三方依赖