编程

blog-manager

试用

Manage Blog System API v1.0.0 via 27 CLI subcommands covering articles, tags, users, comments, messages, moods, uploads, and health checks.

它能做什么

Manage Blog System API v1.0.0 via 27 CLI subcommands covering articles, tags, users, comments, messages, moods, uploads, and health checks.

技能文档

blog-manager

封装 Blog System API v1.0.0，提供 8 模块管理能力，共 27 个子命令（26 操作 + 1 capability-list）。子命令采用 flat kebab-case 命名（动词-名词式）。

Overview / 概述

blog-manager 封装 Blog System API v1.0.0 的全部 26 个 API 端点，提供 27 个 CLI 子命令（含 capability-list）。

  • 目标系统 API 地址：通过环境变量 BLOG_MANAGER_BASE_URL 配置（不硬编码）
  • 认证方式：无认证（API 开放访问）
  • 凭据变量前缀：BLOG_MANAGER（仅 BLOG_MANAGER_BASE_URL）
  • 路径前缀：/api（健康检查端点 /health 在根路径）

Prerequisites / 前置条件

  • Python 3.8+
  • requests 库（pip install -r requirements.txt）
  • API 地址环境变量：BLOG_MANAGER_BASE_URL（须以 http:// 或 https:// 开头）

未设置时启动即抛 BlogConfigError（退出码 2）；地址不硬编码于源码中。

Workflow / 工作流

  1. 从环境变量 BLOG_MANAGER_BASE_URL 读取 API 地址（缺失抛 BlogConfigError，退出码 2）
  2. 按子命令调用对应的 REST API 端点（HTTP 客户端层 BlogClient）
  3. 输出 JSON + Markdown 双格式结果（formatter.format_output）

Core Commands / 核心命令

文章管理（7）

子命令HTTP 方法端点说明
list-articlesGET/api/articles分页列出文章
create-articlePOST/api/articles创建文章
get-articleGET/api/articles/{id}获取文章详情及评论
update-articlePUT/api/articles/{id}更新文章
delete-articleDELETE/api/articles/{id}删除文章（支持软删除）
restore-articlePOST/api/articles/{id}/restore恢复软删除的文章
top-articlesGET/api/articles/heat/top获取热门文章

标签管理（2）

子命令HTTP 方法端点说明
list-labelsGET/api/lables列出所有标签
create-labelPOST/api/lables创建标签

用户管理（2）

子命令HTTP 方法端点说明
list-usersGET/api/users列出所有用户
create-userPOST/api/users创建用户

评论管理（3）

子命令HTTP 方法端点说明
create-commentPOST/api/comments创建评论
list-commentsGET/api/comments/{aid}列出文章评论
delete-commentDELETE/api/comments/{comment_id}删除评论

留言管理（4）

子命令HTTP 方法端点说明
list-messagesGET/api/messages列出留言及回复
create-messagePOST/api/messages创建留言
reply-messagePOST/api/messages/reply回复留言
delete-messageDELETE/api/messages/{message_id}删除留言

说说管理（3）

子命令HTTP 方法端点说明
list-moodsGET/api/moods列出说说
create-moodPOST/api/moods创建说说
delete-moodDELETE/api/moods/{mood_id}删除说说

文件上传（4）

子命令HTTP 方法端点说明
upload-filePOST/api/upload上传单个文件（multipart file）
upload-filesPOST/api/upload/multiple批量上传文件（multipart files）
list-uploadsGET/api/uploads/list列出已上传文件
delete-uploadDELETE/api/uploads/{filename}删除已上传文件（filename URL 编码）

健康检查（1）

子命令HTTP 方法端点说明
health-checkGET/health健康检查

元信息（1）

子命令说明
capability-list列出全部 27 个子命令

使用示例

export BLOG_MANAGER_BASE_URL="http://your-blog-host:18080"

python3 scripts/blog_manager.py capability-list
python3 scripts/blog_manager.py health-check
python3 scripts/blog_manager.py list-articles --page 1 --size 10
python3 scripts/blog_manager.py create-article --title "标题" --content "正文"
python3 scripts/blog_manager.py delete-article --id 1 --soft false
python3 scripts/blog_manager.py upload-file --file /path/to/image.png
python3 scripts/blog_manager.py upload-files --files a.png b.png

Parameter Confirmation / 参数确认

子命令参数必填说明
list-articles--page否页码，默认 1
list-articles--size否每页条数，默认 10
list-articles--lid否标签 ID（0=全部），默认 0
list-articles--keyword否搜索关键词
create-article--title是文章标题
create-article--content是文章内容
create-article--uid否用户 ID，默认 1
create-article--lid否标签 ID，默认 1
create-article--img否封面图路径
create-article--heat否热度值，默认 0
get-article--id是文章 ID
update-article--id是文章 ID
update-article--title否新标题
update-article--content否新内容
update-article--lid否标签 ID
update-article--img否封面图路径
update-article--heat否热度值
delete-article--id是文章 ID
delete-article--soft否软删除 true/false，默认 true
restore-article--id是文章 ID
top-articles--limit否返回条数，默认 5
create-label--lname是标签名称
create-user--uname是用户名
create-user--phone否手机号
create-user--pwd否密码
create-user--email否邮箱
create-user--img否头像路径，默认 img/moren.jpg
create-comment--uid是用户 ID
create-comment--aid是文章 ID
create-comment--content是评论内容
list-comments--aid是文章 ID
delete-comment--id是评论 ID
create-message--uid是用户 ID
create-message--content是留言内容
reply-message--uid是用户 ID
reply-message--mid是留言 ID
reply-message--content是回复内容
delete-message--id是留言 ID
create-mood--content是说说内容
create-mood--title否标题
create-mood--src否媒体路径
delete-mood--id是说说 ID
upload-file--file是文件路径
upload-files--files是文件路径列表（空格分隔）
delete-upload--filename是文件名

Reference Documents / 参考文档

  • API 端点文档
  • 测试用例定义

特殊语义

  • 文章软删除/恢复：delete-article 默认软删除（--soft true），传 --soft false 执行硬删除；restore-article 恢复软删除的文章。soft 参数以小写字符串 true/false 传递给后端。
  • 批量上传：upload-files 使用 multipart files 字段名上传多个文件（实测 API 要求字段名为 files，非 files[]）。
  • 留言回复：reply-message 调用 /api/messages/reply 端点。
  • 文件名删除：delete-upload 对 --filename 做 URL 编码，支持中文及特殊字符。
    • --filename 需传服务端存储的哈希文件名，不是本地原始文件名。
    • 来源：list-uploads 返回的 filename 字段，或上传返回的 data.url 末段路径。
    • upload-file 返回的 data.filename 是原始文件名，DELETE 端点不识别。
    • 正确流程：先 list-uploads 取 filename，或从 data.url 末段提取哈希名。

排除的端点

端点 #26（GET / 博客首页）和 #27（GET /article/{id} 文章详情页）为 Web 页面，非 API，不生成子命令。

退出码

退出码含义
0成功
1API 错误 / 文件错误 / 其它异常
2配置错误（BLOG_MANAGER_BASE_URL 未设置或格式非法）

相关技能

blog-manager-kit

封装 Blog System REST API 的管理 skill，提供文章/标签/用户/评论/留言/说说/上传/健康检查 共 8 模块 28 个子命令的命令行能力。无认证（公开 API）。

blog-toolkit

管理 Blog System API v1.0.0 的文章/标签/用户/评论/留言/说说/文件上传/健康检查。 无认证公开 API，27 个子命令（26 API + 1 capability-list），输出 JSON 与 Markdown 表格。 纯 CLI 管理 skill，不含 Grape Agent 加载集成与自动回复 Issue 能力。

1 次安装

blog-mini-kit-mys

管理 Blog System (FastAPI) 全部 32 个 API 端点：文章/标签/用户/评论/留言/说说/ 文件上传/健康检查/博客页面/后台管理。无认证公开 API，支持 CLI 子命令调用。

blog-mini-kit-ljt2

博客系统 API 管理工具，覆盖文章/标签/用户/评论/留言/说说/文件上传/健康检查 8 大资源域 26 个端点。 无认证（公开 API），提供统一的内容管理能力。

blog-mini-kit-liufei

管理博客系统(FastAPI)全部 32 个 API 端点：文章 CRUD/恢复/热门、标签管理、用户管理、 评论/留言/说说管理、文件上传、后台管理、前端页面、健康检查。无认证，curl+JSON 示例。

blog-mini-ljt

管理博客系统全部 API（8 模块 28 端点：文章/评论/标签/留言/心情/用户/文件/后台）。 无认证公开 API，base_url 内置默认地址无配置即可用。供 AI Agent 完成博客内容全流程管理。