用途
Bear Notes 技能用于在 macOS 上借助 grizzly 命令行工具创建、读取和管理 Bear 应用中的笔记。它适合需要在终端中操作 Bear 笔记、或将 Bear 笔记管理集成到自动化流程中的用户。
主要能力
- 创建笔记：可通过管道输入内容，并指定标题与标签。
- 按 ID 打开/读取笔记：使用 grizzly open-note 命令，配合 --enable-callback 与 --json 获取笔记数据。
- 向笔记追加文本：通过 grizzly add-text 命令，指定追加模式与 Token 文件。
- 列出所有标签：使用 grizzly tags 命令获取标签列表。
- 搜索笔记：通过 grizzly open-tag 按标签名打开并获取相关笔记。
使用方式
环境要求
- 需要安装并运行 Bear 应用。
- 部分操作（add-text、tags、open-note --selected）需要 Bear 应用 Token，Token 保存在 ~/.config/grizzly/token。
获取 Bear Token
- 打开 Bear → Help → API Token → Copy Token。
- 保存 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 Token 文件路径。
配置
Grizzly 按以下优先级读取配置：
- CLI 参数
- 环境变量（GRIZZLY_TOKEN_FILE、GRIZZLY_CALLBACK_URL、GRIZZLY_TIMEOUT）
- 当前目录下的 .grizzly.toml
- ~/.config/grizzly/config.toml
示例 ~/.config/grizzly/config.toml：
token_file = "~/.config/grizzly/token" callback_url = "http://127.0.0.1:42123/success" timeout = "5s"
适用场景
- 在终端中快速创建 Bear 笔记并打标签。
- 批量向已有笔记追加内容。
- 通过脚本或自动化流程读取、检索 Bear 笔记与标签。
限制
- Bear 必须正在运行，命令才能生效。
- 笔记 ID 为 Bear 内部标识符（可在笔记信息或回调中查看）。
- 需要读取 Bear 返回数据时，需使用 --enable-callback。
- 部分操作需要有效 Token（add-text、tags、open-note --selected）。
- 仅适用于 macOS 平台，因依赖 Bear 应用。