zsxq-note은(는) 무엇을 하나요?
知识星球公開筆記管理：創建筆記、編輯筆記、查看筆記詳情、查看筆記列表、刪除筆記。當用戶需要在知識星球創建可分享的公開筆記、編輯筆記、查看筆記詳情、刪除筆記、或查看歷史筆記時使用。注意：筆記是公開內容，任何持有鏈接的人都可訪問。
概述
該技能允許 AI agent 直接管理知識星球上的公開筆記。公開筆記無需登錄即可被訪問，適合用於分享技術文檔、知識片段、公告等場景。
支持平台
- Claude Code
- Cursor
- Codex
- 其他支援 tool-use 的 AI agent
可用操作
| 操作 | 描述 |
|---|---|
create-note | 創建一篇新的公開筆記 |
list-notes | 列出所有公開筆記 |
get-note | 查看指定筆記的詳細內容 |
update-note | 編輯已有的公開筆記 |
delete-note | 刪除一篇公開筆記 |
使用方法
注意：所有筆記均為公開內容，任何持有鏈接的人均可訪問。
環境變數
ZSXQ_TOKEN：知識星球的 API Token（必填）ZSXQ_GROUP_ID：目標星球或群組 ID（選填，若未指定則使用默認值）
範例指令
# 創建筆記
agent run create-note --title "我的技術分享" --content "這是筆記正文"
# 列出筆記
agent run list-notes
# 獲取筆記詳情
agent run get-note --note-id 12345
# 更新筆記
agent run update-note --note-id 12345 --title "更新後的標題" --content "更新後的內容"
# 刪除筆記
agent run delete-note --note-id 12345
實現細節
該技能使用 Node.js 撰寫，主要模組包括：
zsxq-api：封裝知識星球公開 API 的客戶端note-service：負責筆記的 CRUD 邏輯cli-handler：處理來自 agent 的指令呼叫
日誌輸出為 JSON 格式，方便 agent 解析。所有 API 請求均使用 HTTPS 加密。
安全提醒
由於筆記是公開內容，請勿在其中存放敏感資訊（如密碼、私鑰、個人隱私等）。