技能介绍

写 Markdown、README、博客或语雀/掘金笔记时，最常见的一个小卡点是：本地截图已经截好了，却还需要手动打开图床、粘贴文件、再回到文档补链接。这个技能解决的就是这一步——把本地图片或文件交给 PicGo 托管，返回一个可以直接插入文档、聊天或 issue 的 URL。

它解决什么问题

当你只说一句“帮我把这张图变成链接”“给这篇文档插图”，或者提到“图床”“传图”但没指定具体平台时，可以直接使用本技能。它面向的高频场景包括：

README、博客、wiki、Notion、Obsidian、语雀、掘金等文档中插入本地截图或图片。
需要把一个 PDF、zip、安装包或其他文件转成公开下载链接。
用户说“upload this image”“传图床”，但没要求上传到特定云盘、对象存储或自建 CDN。

技能如何工作

它不会绕过你本机已有的 PicGo 配置，而是优先复用当前环境里已经可用的上传方式。整体流程分三层回退：

PicGo 桌面应用：如果桌面端正在运行，它会先探测本地服务；成功时会返回类似 {"imgUrl":"...","type":"..."} 的结果，并告诉你实际使用的是哪个图床。
PicGo CLI：如果桌面端没运行或需要命令行处理，技能会确认 picgo 可用，并读取当前 uploader 配置。
CLI 上传：

- 如果 uploader 是 picgo-cloud，需要检查登录状态；没有 token 时，技能会引导你用浏览器完成登录，而不是在无头环境里卡住。
- 如果 uploader 是 github、smms 或你自己配置的图床，就直接上传，不需要重新登录 PicGo Cloud。

上传成功后，返回值统一为一个 JSON 数组，字段包括 imgUrl、fileName、type、size 等。默认直接返回裸 URL；如果上下文明显是 Markdown 或文档，则返回 Markdown 图片语法，例如 ![alt](https://...)。多文件上传时，结果按输入顺序对应；如果部分失败，会明确指出哪些文件没有成功，而不是静默丢弃。

适用边界

如果你已经指定了具体平台，比如某个网盘、对象存储、CDN、scp/ftp、npm publish，那就应该使用对应平台的工具，而不是本技能。它也不是用来“保存到本地”“下载远程文件”或“把 base64 写到磁盘”；这些都不是上传到托管服务。

还要注意，PicGo Cloud 返回的链接通常是公开可访问的：任何拿到 URL 的人都能打开，删除后仍可能被缓存。截图、文档插图这类日常内容可以直接上传；但如果是合同 PDF、包含内部数据的压缩包，或者看起来敏感、像备份而非分享的文件，应先确认用户是否接受公开链接。剪贴板上传只有在用户明确提到“剪贴板图片”或“刚截的图”时才触发，不应因为 PicGo 在机器上就自动猜测剪贴板内容。