核心用法
Bear Notes 是一个面向 macOS 用户的技能封装，通过 grizzly CLI 工具将优雅的 Bear 笔记应用带入命令行工作流。用户可通过管道或参数快速创建笔记、追加内容、检索标签、打开特定笔记，实现与主流开发工具的无缝衔接。
典型工作流：
- 快速捕捉：将命令输出或剪贴内容直接创建为带标签的笔记
- 内容追加：向现有笔记动态添加内容，适合日志、灵感收集
- 结构化检索：通过标签系统组织和查找知识库
- 自动化集成：结合 Shell 脚本、Alfred、Raycast 等工具构建个人知识管理流水线
配置要点：
需从 Bear 应用获取 API Token 保存至 ~/.config/grizzly/token，部分操作（如追加文本、获取标签列表）必须认证。支持环境变量、TOML 配置文件等多层级配置管理。
显著优点
1. 原生 macOS 生态整合：Bear 本身以优雅设计著称，该技能填补了命令行与图形界面之间的空白
2. 零代码风险：纯 Markdown 文档类型，无可执行逻辑，安全性经 CLS-Certify S+ 认证
3. 灵活的数据流转：支持管道输入、JSON 输出、回调确认，易于与现有工具链集成
4. 开源透明：依赖的 grizzly 工具完全开源，可审计、可扩展
5. 本地优先架构：所有数据存储于本地 Bear 应用，无云端依赖
潜在局限
- 平台锁定：仅支持 macOS/iOS 生态，跨平台用户受限
- Token 管理成本：部分核心功能需手动配置 API Token，对新手有一定门槛
- Bear 付费墙：高级功能（如同步、主题）需 Bear Pro 订阅
- CLI 能力边界：grizzly 仅暴露 Bear x-callback-url 协议子集，复杂操作仍需图形界面
- 单点故障：Bear 应用必须处于运行状态，命令才能执行
适合人群
- 已深度使用 Bear 的 macOS 开发者、写作者
- 追求「键盘流」效率的极客用户
- 需要构建个人知识管理自动化管道的工程师
- 对数据隐私敏感、偏好本地存储的笔记用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| Token 泄露 | API Token 以明文存储于本地文件 | 确保 `~/.config/grizzly/` 目录权限为 700，避免同步到公有仓库 |
| 回调端口冲突 | 默认监听 127.0.0.1:42123 | 可通过配置自定义端口 |
| 误操作覆盖 | 管道重定向可能意外覆盖笔记 | 善用 `--dry-run` 预览操作，关键操作前备份 |
| 应用状态依赖 | Bear 未运行时命令失败 | 配合 `open -a Bear` 确保应用前置启动 |