SuperAPI AI 工具集

bear-notes

办公与效率

查看项目

更新于 10-16 09:21

技能介绍

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

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

主要能力

  • 创建笔记:可通过管道传入内容,并指定标题和标签。
  • 按 ID 打开或读取笔记:使用 open-note 命令,配合 --enable-callback 和 --json 获取返回数据。
  • 追加文本:向指定笔记追加内容,需要 Bear API 令牌。
  • 列出所有标签:使用 tags 命令,需要令牌并启用回调。
  • 通过标签搜索笔记:使用 open-tag 命令按标签名打开或检索。

使用方式 前置要求:Bear 应用已安装并正在运行。部分操作(add-text、tags、open-note --selected)需要 Bear 应用令牌,令牌存放于 ~/.config/grizzly/token。 获取令牌:打开 Bear → Help → API 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
  • 通过标签搜索: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 令牌文件路径。

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

  1. 命令行参数
  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。
  • 部分操作(add-text、tags、open-note --selected)需要有效的令牌。
  • 该技能依赖 macOS 上的 Bear 应用,其他平台暂未提供支持信息。