cosense

cosense 技能是一個專為 Cosense（原 Scrapbox）知識管理平台使用者設計的強大工具包。它透過將 Cosense API 封裝為易於使用的命令列介面，實現了 AI 代理與您的專案資料之間的無縫互動。此技能非常適合希望自動化個人知識庫維護、同步文件或將 Cosense 整合到更廣泛研究與筆記工作流程中的進階使用者及開發者。它需要設定 COSENSE_SID 和 COSENSE_PROJECT 等環境變數來進行身分驗證並鎖定特定專案。

• 執行細緻的頁面操作，包括讀取頁面為 JSON 或純文字格式，以及列出專案內容。

• 直接透過代理介面使用關鍵字搜尋整個專案。

• 安全地建立新頁面，執行前會自動檢查標題衝突以避免覆蓋。

• 使用安全的 safe-import 協定更新現有頁面，該協定強制處理完整內容，防止意外資料遺失。

• 在每次寫入操作前執行自動備份，並將檔案儲存於指定目錄以便隨時復原。

• 在修改前產生差異對照 (diff)，讓您在執行前確認變更內容並取得明確同意。

• 本技能依賴 secure import API，該 API 將頁面內容視為完全覆寫；編輯時請確保保留所有行數，以免發生意外刪除。

• API 請求大小限制為 30MB，足以應付大多數標準頁面匯入需求。

• 請確保正確在您的 shell 環境設定檔（如 ~/.zshenv 或 ~/.zshrc）中匯出 COSENSE_SID 和 COSENSE_PROJECT，以確保代理能穩定存取。

• 工具採用 Cosense 專案結構，其中匯入的第一行會被視為頁面標題，遵循此語法對於成功執行至關重要。

• 強烈建議定期備份，內建的 backup 與 list-backups 指令可自動化此程序，確保專案資料完整性。