bear-notes¶

Skill 简介¶

Bear Notes 是一款借助 grizzly 命令行工具，通过 OpenClaw Skill 平台与 Bear 笔记应用进行交互的技能。Bear 是一款广受欢迎的 macOS 笔记应用，以其简洁的界面和强大的标签系统深受用户喜爱。然而，对于开发者而言，频繁切换应用界面进行笔记操作可能会影响工作效率。Bear Notes 旨在通过命令行方式简化与 Bear 的交互流程，让开发者能够更加高效地创建、搜索和管理 Bear 中的笔记内容。

OpenClaw Skill 平台为 Bear Notes 提供了跨平台支持，使其能够在 macOS 环境下无缝运行。通过集成 grizzly CLI，Bear Notes 实现了对 Bear 笔记的全面操控，包括创建、读取、编辑和搜索等功能。这不仅提升了开发者的生产力，还为自动化脚本和集成工作流提供了新的可能性。

主要功能¶

Bear Notes 提供了多项核心功能，帮助开发者高效管理 Bear 笔记：

• 创建笔记
  通过 grizzly create 命令，用户可以快速创建新的 Bear 笔记。例如，使用以下命令可以创建一个带有标题和标签的笔记：
  bash echo "Note content here" | grizzly create --title "My Note" --tag work
  该命令将 "Note content here" 作为内容，标题为 "My Note"，并添加 "work" 标签。

• 读取笔记
  使用 grizzly open-note 命令，用户可以根据笔记的 ID 打开并读取笔记内容。例如：
  bash grizzly open-note --id "NOTE_ID" --enable-callback --json
  该命令将指定 ID 的笔记内容以 JSON 格式输出，并等待 Bear 的回调响应。

• 追加文本到笔记
  grizzly add-text 命令允许用户向现有笔记追加文本内容。例如：
  bash echo "Additional content" | grizzly add-text --id "NOTE_ID" --mode append --token-file ~/.config/grizzly/token
  该命令将 "Additional content" 追加到指定 ID 的笔记中。

• 管理标签
  Bear Notes 提供了对 Bear 标签的全面管理功能。通过 grizzly tags 命令，用户可以列出所有标签：
  bash grizzly tags --enable-callback --json --token-file ~/.config/grizzly/token
  该命令将以 JSON 格式输出所有标签信息。

• 搜索笔记
  通过 grizzly open-tag 命令，用户可以根据标签名称搜索相关笔记。例如：
  bash grizzly open-tag --name "work" --enable-callback --json
  该命令将列出所有带有 "work" 标签的笔记，并以 JSON 格式输出。

• 配置与权限管理
  Bear Notes 支持多种配置方式，包括 CLI 标志、环境变量和配置文件。用户可以通过编辑 ~/.config/grizzly/config.toml 文件来设置默认参数，例如：
  toml token_file = "~/.config/grizzly/token" callback_url = "http://127.0.0.1:42123/success" timeout = "5s"

使用场景¶

Bear Notes 适用于多种开发场景，帮助开发者提升工作效率：

1. 自动化笔记管理
   通过脚本或自动化工具，开发者可以定期备份 Bear 笔记内容，或根据特定条件自动创建和更新笔记。

2. 集成开发工作流
   在开发过程中，开发者可以将 Bear Notes 集成到现有的工作流中。例如，在代码提交时自动记录笔记，或在构建失败时记录错误信息。

3. 快速笔记创建
   开发者可以在命令行中快速创建笔记，而无需打开 Bear 应用。这对于记录临时想法或任务非常方便。

4. 批量操作
   通过 Bear Notes，开发者可以对多个笔记进行批量操作，例如批量添加标签或批量删除笔记。

5. 数据分析与处理
   Bear Notes 支持以 JSON 格式输出笔记内容，开发者可以结合其他工具对笔记数据进行进一步处理和分析。

如何使用¶

安装与配置¶

1. 安装 grizzly CLI
   Bear Notes 依赖于 grizzly CLI 工具。可以通过以下命令使用 Go 安装：
   bash go install github.com/tylerwince/grizzly/cmd/grizzly@latest
   确保 Go 环境已正确配置，并将 grizzly 的安装路径添加到系统的 PATH 中。

2. 获取 Bear API Token
   Bear Notes 需要 Bear 的 API Token 进行身份验证。按照以下步骤获取：

3. 打开 Bear 应用
4. 导航到 Bear → Help → API Token → Copy Token

5. 将 Token 保存到 ~/.config/grizzly/token 文件中：
   bash echo "YOUR_TOKEN" > ~/.config/grizzly/token

6. 配置 grizzly
   可以通过编辑 ~/.config/grizzly/config.toml 文件进行配置。例如：
   toml token_file = "~/.config/grizzly/token" callback_url = "http://127.0.0.1:42123/success" timeout = "5s"

前置条件¶

• Bear 应用已安装并运行
• 已获取并配置 Bear API Token
• grizzly CLI 已安装并配置到 PATH 中

示例¶

示例 1：创建并管理笔记¶

# 创建新笔记
echo "This is a new note" | grizzly create --title "New Note" --tag example

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

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

# 搜索带有 "example" 标签的笔记
grizzly open-tag --name "example" --enable-callback --json

示例 2：批量操作笔记¶

假设需要为所有带有 "work" 标签的笔记添加一个新的标签 "urgent"：

# 获取所有带有 "work" 标签的笔记 ID
grizzly open-tag --name "work" --enable-callback --json | jq -r '.[].id' | while read id; do
    grizzly add-tag --id "$id" --tag "urgent" --token-file ~/.config/grizzly/token
done

总结¶

Bear Notes 通过 grizzly CLI 工具为开发者提供了一种高效管理 Bear 笔记的方式。它不仅简化了笔记的创建和编辑流程，还为自动化和集成工作流提供了强大的支持。无论是快速记录想法，还是批量处理笔记内容，Bear Notes 都能满足开发者的多样化需求。对于那些希望在命令行环境中高效管理笔记的开发者来说，Bear Notes 是一个不可或缺的工具。