SuperAPI AI 工具集

cnblogs

写作与研究

查看项目

更新于 10-15 09:54

技能介绍

用途

该技能用于通过 API 管理博客园(CNBlogs)的文章,包括发布、更新、读取和删除,适用于需要在博客园上以程序化方式操作内容的场景。

主要能力

  • 令牌验证与账号信息:whoami 命令用于验证令牌并查看账号的发布模板。
  • 分类与文章读取:categories 获取分类,posts --limit 列出最近文章,post POST_ID 查看指定文章。
  • 创建草稿或发布:create 命令支持 --title、--content-file、--category-ids、--tags 等参数,默认保存为私有草稿;公开发布还需 --publish,并需 --confirm 确认。
  • 更新与删除:update 需显式选择 --publish 或 --draft,delete 需 --confirm。
  • 记录输出:在确认的公开发布返回真实 URL 后,调用 publish_artifact 记录,kind="article",channel="cnblogs",status="delivered"。

使用方式

该技能使用捆绑的标准库 CLI:python3 "$SKILL_DIR/scripts/cnblogs.py"。连接器会注入用户的博客园个人访问令牌为 $CNBLOGS_TOKEN,且不会打印它。认证遵循官方 cnblogs/vscode-cnb 客户端契约,地址为 https://write.cnblogs.com/api,使用 Authorization: Bearer 加 Authorization-Type: pat。分类值为 categories 命令返回的数字 ID,标签为名称。首次调用(create 无 --confirm)始终为 dry run,不加载凭据也不调用 API。--confirm 只能作为最后一个参数。公开发布前需向用户展示标题、分类、标签、可见性与完整内容。若认证失败,提示用户在 https://account.cnblogs.com/settings/tokens 创建 PAT 并重新连接,不索取账号密码或 Cookie。写入超时不要自动重试,应先列出最近文章或检查文章状态。

适用场景

适用于需要批量或自动化管理博客园文章,例如通过命令行创建、更新、读取或删除文章,并在确认后公开发布及记录结果的使用场景。

限制

  • 创建与更新默认先执行 dry run,需用户确认后才加 --confirm 执行;公开发布还需额外添加 --publish。
  • 更新文章时必须显式选择可见性(--publish 或 --draft),避免已有文章被静默取消发布。
  • 写入超时不要自动重试,因为结果可能未知。
  • 不记录草稿或失败/未知的写入。
  • 需要有效的个人访问令牌,认证失败时需用户重新创建 PAT 并连接。
  • 不索取账号密码或 Cookie。