先搞清楚一件事：SKILLS 是什么

打开阅灵阅读的侧栏，你能看到一个叫「Agent 集成密钥」的面板，点开它，里面有个下载按钮，写着「下载阅灵阅读 SKILL（zip）」。这个 SKILL 呢，说白了就是一份说明书，它告诉外部的 AI 助手——比如你在用的 Cursor——该怎么跟你的阅灵阅读账号对话。

有了它，你就可以对着 AI 助手说"帮我看看今天有没有新文章"、“帮我搜一下阮一峰的博客"之类的话，AI 助手就能帮你操作阅灵阅读里的东西了。

图片

整个设置流程分三步：生成密钥、下载 SKILL 文件、把密钥配到 AI 助手那边。下面一步一步来。

第一步：生成你的专属密钥

密钥是啥？你把它理解成一把钥匙就行了。你的阅灵阅读账号是一扇门，AI 助手要进来帮你干活，就得有这把钥匙。没有它，谁也动不了你账号里的东西。

操作起来很简单。先登录阅灵阅读网页版，在左边侧栏找到「Agent 集成密钥」那个折叠面板，点一下展开它。

展开之后你会看到一个输入框，让你填个名字。这个名字其实就是个备注，方便你自己记的。比如你可以写"我的 Cursor”、“办公室用的"之类的，随便你，关键是以后你看到这个名字能想起来这把钥匙是干啥的。

图片

填好名字之后，点「创建密钥」按钮。这时候页面上会弹出一串以 yrss_ 开头的字符——这就是你的密钥了。

这里有个非常关键的事情：这串字符只显示这一次。关闭页面、刷新页面、随便点个啥，它就没了，再也不会出现了。所以你拿到手的第一件事，就是把它复制下来，存到一个你不会弄丢的地方。记事本、密码管理器、随便哪都行，但一定要存好。万一真丢了也不怕，把这把钥匙吊销掉，重新创建一把就行，不过之前那把就彻底作废了。

对了，密钥是可以创建多把的。比如你一台电脑上用 Cursor，另一台上也用，那就可以分别创建两把，互不干扰。每一把都有备注名字和前缀显示在列表里，管理起来很清楚。如果哪把不用了，点一下旁边的「吊销」按钮，那把钥匙就立即失效，AI 助手再用它就进不来了。

第二步：下载 SKILL 文件包

还是刚才那个「Agent 集成密钥」面板，在输入框上方有一个链接，写着「下载阅灵阅读 SKILL（zip）」。点击它，浏览器会下载一个 zip 压缩包。

这个压缩包里面有三个文件：

• SKILL.md：核心说明文件，告诉 AI 助手阅灵阅读是什么、能做什么、该怎么操作

• api-reference.md：详细的接口说明，列出了所有可以调用的操作和参数

• examples.md：实际的调用示例，方便 AI 助手理解怎么跟阅灵阅读对话

你不需要自己去读这些文件——它们是给 AI 助手看的，不是给你看的。你只要把这个压缩包解压，放到 AI 助手能找到的地方就行。

那放到哪里呢？这取决于你用的哪个 AI 助手平台。拿 Cursor 来说，一般是在项目目录下面创建一个 .cursor 文件夹，然后里面有个放 Skill 的目录。具体位置你可以查一下 Cursor 的文档，或者按照它提示的方式来添加。总之原则就一个：解压之后放到 AI 助手指定的 Skill 目录下。

放好之后，AI 助手下次启动或者刷新的时候就会自动识别到这个 SKILL，就知道"哦，原来我可以帮用户操作阅灵阅读了”。

第三步：把密钥配置到 AI 助手

前面两步你已经拿到了密钥、也放好了 SKILL 文件，现在就差最后一步：让 AI 助手知道你的密钥是什么。

这个操作通常是在 AI 助手的设置里配一个环境变量。变量的名字叫 YUELING_READING_TOKEN，值就是你第一步保存的那串 yrss_... 字符。

不同平台配环境变量的方式不太一样：

• Cursor：在设置界面找到环境变量配置的地方，添加一行 YUELING_READING_TOKEN=yrss_你的那串密钥

• 其他 Agent 平台：一般在项目根目录有个 .env 文件或者类似的配置文件，把 YUELING_READING_TOKEN=yrss_你的那串密钥 这一行加进去就行

配完之后，整个设置就算完成了。你可以试着跟 AI 助手说一句"帮我看看阅灵阅读的收件箱"，如果它能正常返回你的文章列表，那就说明一切搞定了。

能用 SKILL 做些什么

SKILL 连通之后，你可以让 AI 助手帮你做下面这些事情。不用刻意去记，用着用着就熟了。

查看收件箱

跟 AI 助手说"看看我收件箱里有什么"，它就会把你订阅的所有源的最新文章拉出来。你可以指定只要未读的，或者只要收藏的，也可以搜关键词。比如"帮我看看收件箱里有没有关于 Rust 的文章"。

读文章

看到感兴趣的文章，跟 AI 助手说"帮我读一下这篇文章"，它会帮你把文章的完整内容拿过来。有些文章可能刚同步过来还没抓到正文，这时候它会告诉你"正在获取"，稍等一下再问就行。

看完之后想标记已读，直接说"帮我标记已读"。如果积攒了很多文章想一次搞定，说"把当前列表全部标记已读"也可以。

收藏和取消收藏

看到好文章想存起来，跟 AI 助手说"帮我收藏这篇文章"。之后想找收藏过的文章，说"看看我收藏的文章"。不想收藏了就说"取消收藏"。

发现和订阅新源

想找新的内容源？跟 AI 助手说"帮我搜一下阮一峰"或者"搜一下 https://rss.yuelinghub.com"，它会帮你搜索。搜索结果里会显示匹配的[1] RSS 源、微信公众号和本站已有的公开源。

找到想订阅的，直接说"帮我订阅这个"，AI 助手就会帮你加到订阅列表里。想看看自己现在订阅了哪些，说"列出我的订阅"就行。

取消订阅

不想继续关注某个源了，跟 AI 助手说"帮我取消订阅 xxx"就行。取消订阅只是不再接收更新，不会删除源本身，以后想重新订阅随时可以。

看专属信息茧房的内容

如果你之前在阅灵阅读里绑定了专属信息茧房，那通过 SKILL 也可以让 AI 助手帮你查看茧房里的文章。说"帮我看看茧房里今天有什么更新"，它就能拉出来。支持按分组筛选、按来源搜索，也支持标记已读。

如果还没绑定茧房，AI 助手会告诉你"还没链接茧房账号"，你去阅灵阅读的侧栏里绑定一下就好了。

几个要注意的地方

密钥别泄露。 你的密钥就是你的账号钥匙，谁拿到了谁就能操作你的阅灵阅读。所以千万别把它发到群里、贴到公开的代码仓库里、或者截图到处传。万一不小心泄露了，赶紧去侧栏里把那把钥匙吊销掉，然后重新创建一把新的。

密钥只显示一次。 再说一遍，创建密钥时弹出来的那串字符，关掉就没了。拿到手第一件事就是存好。

可以创建多把密钥。 不同的 AI 助手、不同的设备，可以分别用不同的密钥。这样万一某把钥匙泄露了，你只吊销那一把就行，不影响其他设备。

SKILL 文件不要改动。 下载下来的那三个文件，解压放好就行，不要自己改里面的内容。改了的话 AI 助手可能就读不懂了。

AI 助手操作前会跟你确认。 涉及到写操作——比如订阅、取消订阅、标记已读、收藏——AI 助手会先告诉你它打算做什么，等你确认了才执行。所以不用担心它偷偷帮你乱操作。

遇到问题怎么办

AI 助手说"密钥无效"： 可能是密钥已经被吊销了，或者复制的时候少复制了字符。去侧栏检查一下，必要时重新创建一把。

AI 助手读不到文章内容： 有些文章同步过来的时候正文还在加载中，稍等一下再试。如果一直读不到，可能是那个源本身的问题。

AI 助手说"茧房未链接"： 说明你还没在阅灵阅读里绑定专属信息茧房。先去侧栏的「链接专属信息茧房」面板完成绑定，然后再试。

其他问题： 阅灵阅读页面里有「联系客服」按钮，点开可以看到客服微信二维码，直接扫码联系就行。

以上就是阅灵阅读 SKILLS 的完整使用方式。三步搞定：生成密钥、下载 SKILL、配好环境变量，然后就可以用自然语言让 AI 助手帮你操作阅灵阅读了。

脚注

[1]https://rss.yuelinghub.com%22%EF%BC%8C%E5%AE%83%E4%BC%9A%E5%B8%AE%E4%BD%A0%E6%90%9C%E7%B4%A2%E3%80%82%E6%90%9C%E7%B4%A2%E7%BB%93%E6%9E%9C%E9%87%8C%E4%BC%9A%E6%98%BE%E7%A4%BA%E5%8C%B9%E9%85%8D%E7%9A%84