bear-notes

Bear Notes 技能透過 grizzly CLI 實現與 macOS 上 Bear 應用程式的深度整合，為個人知識管理與筆記自動化提供強大的介面。此技能專為進階使用者與開發人員設計，允許透過程式化方式與您的筆記、標籤及內容進行互動，有效地將您的筆記軟體轉化為 AI 助理的可程式化資料庫。無論您是需要批次處理研究資料、同步每日日誌，還是建立需要持久化文字儲存的複雜工作流程，此工具皆能提供必要的命令掛鉤，讓您無需手動操作即可讀取、寫入與組織資訊。

• 直接從終端機輸出建立包含特定標題、自訂標籤與內文的新筆記。

• 使用唯一的 Bear 筆記識別碼將文字附加至現有筆記，適用於自動化日誌記錄或日常記帳。

• 列出、搜尋並導覽現有的標籤結構與筆記 ID，以維護組織良好的知識庫。

• 支援 JSON 輸出與基於回呼（callback）的通訊，利於在執行複雜作業時進行資料擷取與狀態監控。

• 提供高度可配置的行為，包含預覽模式（dry-run）、自訂 Token 管理及全域逾時設定，確保自動化指令碼穩定運作。

• 支援透過環境變數、TOML 設定檔或直接傳遞 CLI 旗標進行配置，展現良好的跨環境適應性。

• 請確保 Bear 應用程式處於執行狀態，因為此技能的讀取操作與資料擷取依賴 x-callback-url 互動。

• 請將 Bear API Token 放置於指定設定檔（~/.config/grizzly/token）中，以啟用寫入與管理指令，確保您的工作流程安全。

• 筆記 ID 是鎖定現有內容的關鍵；請透過搜尋查詢或回呼機制取得識別碼以進行更新。

• 當您需要解析 Bear 應用程式回傳的資料（例如獲取筆記內容或列出當前標籤）時，請務必使用 --enable-callback 旗標。

• 此技能專為原生 Bear 應用程式所在的 macOS 環境打造，透過本地路徑與標準 Shell 管線作業，以實現效能與安全性的最大化。