前言¶
開發或寫作時，靈感、會議要點和待辦往往散落在對話窗口、瀏覽器標籤和本地草稿裏。事後要進印象筆記手工新建筆記、選筆記本、打標籤，再靠搜索翻舊內容，步驟多且容易斷檔。若你已在 Cursor、Claude Code、Codex 或 WorkBuddy 等環境裏用 AI，更理想的做法是把「記一筆、搜一條、整理筆記本」交給同一套對話完成，而不是在應用之間來回切換。
下面介紹印象筆記在 SkillHub 發佈的官方 Skill，以及如何在支持 Skill 的客戶端裏安裝與使用。
這是什麼¶
印象筆記官方 Skill（座標 @yinxiang/yinxiangskill，當前版本 1.0.4）由 印象筆記 發佈，分類爲 knowledge-management，來源標註爲 enterprise。它讓支持 Skill 協議的 AI 助手（官方說明中列舉 OpenClaw、Claude Code、Cursor、Codex、WorkBuddy 等）通過賬號授權連接你的印象筆記，在對話裏完成記錄、檢索與整理。
SkillHub 頁面標註該 Skill 帶有 requires_api_key=true，實際使用前需完成印象筆記側的賬號授權與相關憑據配置（具體字段以安裝後 Skill 包內說明爲準）。
核心功能¶
以下能力均來自 SkillHub 官方簡介，未在資料中出現的細節不展開。
記錄與剪藏
- 完成賬號授權後，可用自然語言保存內容，例如說明「幫我記到印象筆記」，可寫入靈感、會議記錄、待辦等，並指定筆記本與標籤。
- 可將網頁提交到印象筆記進行剪藏。
查找與閱讀
- 按關鍵詞、標題、標籤、筆記本或時間範圍搜索筆記。
- 查看最近筆記與筆記完整內容。
編輯與整理
- 修改筆記標題與正文。
- 移動筆記、更新標籤。
- 創建筆記本，以及批量整理筆記本。
安裝與啓用¶
安裝流程遵循 SkillHub 通用說明（skillhub.md）。Skill 詳情頁給出的安裝提示爲：根據該文檔安裝 @yinxiang/yinxiangskill。
1、檢查或安裝 SkillHub CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 文檔執行完整安裝（CLI + 默認 Skill）或僅安裝 CLI：
# 完整安裝（CLI + 默認 Skill，推薦）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 僅安裝 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝印象筆記 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 AI 客戶端實際讀取的 skills 目錄；默認裝到 ./skills/ 可能不會被識別。
skillhub install @yinxiang/yinxiangskill --dir <skills 目錄>
常用客戶端的 skills 路徑（摘自 SkillHub 安裝文檔）：
| 客戶端 | skills 目錄 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| workbuddy | ~/.workbuddy/skills/ |
也可在 Skill 詳情頁將安裝提示詞發給當前 AI，讓其按 skillhub.md 完成安裝；無論 CLI 還是對話安裝，最終都應落到上述對應目錄。
3、授權與啓用¶
資料中強調需先完成賬號授權。安裝後按 Skill 包內指引綁定印象筆記賬號並配置 API 相關項（requires_api_key=true）。配置完成後重啓或重新加載 Agent，使 Skill 被加載。
典型用法¶
官方未提供逐條 API 示例，但簡介中的交互方式可直接復現：
- 隨手記錄：在對話中說「幫我記到印象筆記」，附上正文，並說明目標筆記本與標籤（若需要）。
- 剪藏網頁：提供值得收藏的 URL，讓助手提交到印象筆記剪藏。
- 找回資料：說明搜索條件，例如關鍵詞、標題片段、標籤名、筆記本名或時間範圍，再讓助手列出結果或打開某條筆記全文。
- 整理：要求修改標題或正文、移動筆記、更新標籤，或創建/批量整理筆記本。
以上均以自然語言驅動，具體工具名與參數以 Skill 實現爲準。
適用場景與注意¶
適合誰
- 已長期使用印象筆記，希望把「記、搜、改、整理」收口到 AI 工作流的用戶。
- 在 Cursor、Claude Code、Codex、WorkBuddy 等環境中寫作、開會記錄或做知識管理的人。
需要注意
- 依賴 SkillHub CLI 與正確的
--dir；裝錯目錄會導致 Skill 不生效。 - 需完成印象筆記授權；涉及
requires_api_key=true，請勿將密鑰寫入公開倉庫或對話日誌。 - SkillHub 頁面顯示版本爲 v1.0.4；功能以當前安裝包與印象筆記服務側能力爲準。
結尾¶
印象筆記官方 Skill 把個人知識庫的寫入、檢索和整理接到支持 Skill 的 AI 助手上，減少在筆記應用與編碼環境之間的切換。安裝座標爲 @yinxiang/yinxiangskill，詳情與安裝入口見 SkillHub 技能頁 與 API 條目。
