印象笔记官方助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @yinxiang/yinxiangskill。
技能介绍
要解决的问题
在工程工作流里,印象笔记常被用来沉淀文档、网页剪藏、标签和笔记本。但当 AI 代为操作时,容易出现几类问题:用本地文件、模拟数据或猜测 token 代替真实 API,导致结果不可信;把更新、移动、改标签这类副作用操作当成普通查询,直接批量执行造成误改;搜索、列表和详情混用,展示正文或接口字段,既不清晰也不安全。
技能如何工作
这个 skill 的核心是调用印象笔记官方 API,而不是生成假结果。它先检测 bash/zsh 或 PowerShell 环境,再加载 token;token 为空时要求用户通过授权地址完成授权。所有请求都带 source:"skill",并按场景执行:创建笔记、更新/移动笔记、网页剪藏、创建笔记本/标签、搜索笔记、列出笔记/笔记本/标签、获取笔记详情。批量任务会拆成原子能力,按依赖顺序执行;若需要 AI 搜索或推断目标,必须先让用户确认。
关键点在于字段约束:更新标签传最终完整 tagNames,清空标签必须传 clearTags:true;修改正文前必须确认会替换原内容;搜索只支持创建时间范围,startTime 和 endTime 用 UTC 毫秒。输出时用自然语言说明结果,不展示原始 JSON、code、status 或 message。
适用边界
它适合需要真实读写印象笔记的自动化笔记管理,不适合未接入的能力,例如按更新时间查询、批量删除或导出。涉及未确认的搜索、列表、移动、标签变更时,应先确认再执行。
使用场景
- 在写方案时把零散结论、参考链接和待办整理成一条可搜索的 Markdown 笔记
- 看到一篇技术文章后,把 URL 剪藏到指定笔记本,方便稍后按笔记本复查
- 项目复盘时,按创建时间范围搜索最近三天提到的关键词笔记,并只查看标题和 ID 来确认条目
- 整理旧笔记时,先搜索确认目标笔记,再批量移动或设置完整标签列表
适合人员
- 维护个人知识库、需要把网页剪藏和笔记分类的工程师
- 负责项目文档沉淀、需要按关键词和时间查找历史笔记的技术负责人
- 做竞品调研、需要把来源 URL 和结论存入同一笔记本的产品经理
- 使用 AI 助手批量整理笔记、但要求先确认再改标签的移动研发