前言¶
开发或写作时，灵感、会议要点和待办往往散落在对话窗口、浏览器标签和本地草稿里。事后要进印象笔记手工新建笔记、选笔记本、打标签，再靠搜索翻旧内容，步骤多且容易断档。若你已在 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 条目。
