使用 Agent 安装 SKILL 并管理 Joplin 笔记

本文记录如何通过 AI Agent 一键安装 Skill 插件，并实现 Joplin 笔记的智能整理与同步。

一、安装 Skill

向 Agent 发送安装指令，指定 SkillHub 源地址和要安装的插件名称：

请根据 https://skillhub.cn/install/skillhub.md，安装 joplin-api。

Agent 会自动完成下载、依赖安装和配置：

二、配置令牌与端口

安装完成后，需要将 Joplin 的 API 令牌和本地服务端口告知 Agent。

获取方式：打开 Joplin → 工具 → 选项 → Web Clipper → 复制令牌，确认端口号。

注意： 如果默认端口 41184 被系统服务占用，Joplin 会自动切换到其他端口（如 41185），可通过 netstat -ano | findstr "LISTENING" 确认实际端口。

三、整理单篇笔记

3.1 复制笔记的 Markdown 链接

在 Joplin 中右键目标笔记 → 复制 Markdown 链接，格式如下：

[笔记标题](:/笔记ID)

3.2 告知 Agent 整理并同步

将链接发给 Agent，说明需求（如"整理成结构化笔记并同步回 Joplin"），Agent 会：

1. 通过 API 读取笔记原文
2. 按需求重新排版整理
3. 调用 PUT 接口将整理后的内容写回 Joplin

可以看到已经笔记被更新

四、小结

整个流程无需手动编辑文件，Agent 全程通过 Joplin Data API 完成读取和写入。

我使用的阿里的qoder实现对应的agent功能，如有帮助 帮忙点个邀请。
https://qoder.com.cn/referral?referral_code=ZkDN2RKHQCTmS0vNzcZees8rSZIDup28