SuperAPI AI 工具集

bear-notes

办公与效率

查看项目

更新于 10-16 06:56

技能介绍

Bear Notes 是一个面向 macOS 的 Bear 笔记管理技能,通过 grizzly 命令行工具对 Bear 中的笔记进行创建、读取和管理。

用途 该技能用于在 macOS 上以命令行方式操作 Bear 笔记,适合需要自动化或脚本化处理 Bear 笔记的场景。

主要能力

  • 创建笔记:可通过管道传入内容,并指定标题与标签。
  • 按 ID 打开/读取笔记:使用 open-note 命令,配合 --enable-callback 与 --json 获取返回数据。
  • 向笔记追加文本:使用 add-text 命令,指定 --mode append。
  • 列出所有标签:使用 tags 命令。
  • 搜索笔记:通过 open-tag 按标签名打开,从而检索相关笔记。

使用方式 前置要求:Bear 应用已安装并正在运行。部分操作(add-text、tags、open-note --selected)需要 Bear 应用 Token,Token 存放于 ~/.config/grizzly/token。

获取 Bear Token:打开 Bear → Help → API Token → Copy Token,然后保存:echo "YOUR_TOKEN" > ~/.config/grizzly/token。

常用命令示例: 创建笔记: echo "Note content here" | grizzly create --title "My Note" --tag work grizzly create --title "Quick Note" --tag inbox < /dev/null

按 ID 打开/读取笔记: grizzly open-note --id "NOTE_ID" --enable-callback --json

向笔记追加文本: echo "Additional content" | grizzly add-text --id "NOTE_ID" --mode append --token-file ~/.config/grizzly/token

列出所有标签: grizzly tags --enable-callback --json --token-file ~/.config/grizzly/token

搜索笔记(通过 open-tag): grizzly open-tag --name "work" --enable-callback --json

常用选项: --dry-run:预览 URL 而不执行 --print-url:显示 x-callback-url --enable-callback:等待 Bear 的响应(读取数据时需要) --json:以 JSON 输出(使用回调时) --token-file PATH:指定 Bear API Token 文件路径

配置 Grizzly 按以下优先级读取配置:

  1. CLI 参数
  2. 环境变量(GRIZZLY_TOKEN_FILE、GRIZZLY_CALLBACK_URL、GRIZZLY_TIMEOUT)
  3. 当前目录下的 .grizzly.toml
  4. ~/.config/grizzly/config.toml

示例 ~/.config/grizzly/config.toml: token_file = "~/.config/grizzly/token" callback_url = "http://127.0.0.1:42123/success" timeout = "5s"

适用场景 适用于在 macOS 上通过命令行自动化管理 Bear 笔记,例如批量创建笔记、按标签检索、向已有笔记追加内容等。

限制

  • Bear 必须正在运行,命令才能生效。
  • 笔记 ID 是 Bear 的内部标识符(可在笔记信息中或通过回调查看)。
  • 需要从 Bear 读取数据时,应使用 --enable-callback。
  • 部分操作需要有效 Token(add-text、tags、open-note --selected)。
  • 该技能面向 macOS 平台。