--- slug: "hugo-blog-tool-pro" name: "hugo-blog-tool-pro" version: "1.0.0" displayName: "Hugo博客发布专业版" summary: "企业级 Hugo 博客管理方案，支持批量发布、多语言站点、SEO 优化与 CI/CD 集成。。面向专业博主的 Hugo 博客管理工具，提供批量发布与站点级管理能力。核心能力: - 批量文章发" license: "Proprietary" edition: "pro" description: |- 面向专业博主的 Hugo 博客管理工具，提供批量发布与站点级管理能力。核心能力: - 批量文章发布与定时发布调度 - 多语言站点（i18n）内容管理 - SEO 优化（结构化数据、站点地图、元信息） - CI/CD 自动化部署集成 - 文章系列管理与交叉引用 - 图片资源自动优化与 CDN 集成 适用场景: - 多作者博客团队的协作发布 - 多语言博客站点的同步管理 - SEO 优化的技术博客运营 - 自动化部署的持续发布流程 差异化: 专业版兼容免费版所有发布能力... tags: - 开发工具 - 博客 - Hugo - 内容运营 - SEO - 工具 - 效率 - 自动化 - 写作 - 电商 - 工作流 - 创意 - posts - hugo - content - title - eof tools: - read - exec - glob - grep homepage: "" category: "Automation" --- 本工具面向专业博主与内容团队，提供 Hugo 博客的站点级管理与自动化运营方案。在免费版单篇文章发布能力之上，专业版新增批量发布与定时调度、多语言站点管理、SEO 优化（结构化数据、站点地图）、CI/CD 自动化部署、文章系列管理与交叉引用、图片资源自动优化等能力。通过工具链集成与流程自动化，帮助团队高效运营专业级博客站点. **版本兼容性说明**：专业版完全兼容免费版（`hugo-blog-tool-free`）的所有 Front Matter 规范与发布流程，可无缝升级. ## 核心能力 | 能力模块 | 免费版 | 专业版新增 | |----|---|-----| | 文章发布 | 单篇发布 | 批量发布 + 定时调度 | | Front Matter | 基础字段 | SEO 元信息 + 结构化数据 | | 标签管理 | 英文 slug 映射 | 多语言标签 + 标签云生成 | | 图片处理 | - | 自动压缩 + CDN 集成 | | 部署 | Git 推送 | CI/CD 自动化部署 | | 多语言 | - | i18n 多语言站点管理 | | 内容组织 | - | 文章系列 + 交叉引用 | | 性能 | - | 站点性能优化与监控 | **技术实现要点**：核心能力基于`input_params`参数与`output_format`配置实现,支持创建/查询/修改/删除等操作模式,通过`config_options`进行运行时配置. ### 核心功能执行 用`input_params`参数进行配置. **输入**: 用户提供核心功能执行所需的指令和必要参数. **处理**: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. **输出**: 返回核心功能执行的响应数据,包含状态码、结果和日志. - 执行此能力时使用`input_params`参数,支持创建/查询/导出操作 ### 参数配置与调用 用`config_options`参数进行配置. **输入**: 用户提供参数配置与调用所需的指令和必要参数. **处理**: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. **输出**: 返回参数配置与调用的响应数据,包含状态码、结果和日志. - 执行此能力时使用`config_options`参数,支持修改/重置/导入操作 ### 结果处理与输出 用`output_format`参数进行配置. **输入**: 用户提供结果处理与输出所需的指令和必要参数. **处理**: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. **输出**: 返回结果处理与输出的响应数据,包含状态码、结果和日志. - 执行此能力时使用`output_format`参数,支持导出/保存/转换操作 **能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：企业级、Hugo、博客管理方案、支持批量发布、面向专业博主的、博客管理工具、提供批量发布与站、点级管理能力、批量文章发布与定、时发布调度、内容管理、站点地图、自动化部署集成、文章系列管理与交、图片资源自动优化等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持. ## 使用场景 ### 场景一：批量发布文章系列 团队需要一次性发布一个包含 5 篇文章的技术系列. ```bash #!/bin/bash SERIES_NAME="go-concurrency-series" BLOG_DIR="${BLOG_DIR:-~/blog}" POSTS_DIR="$BLOG_DIR/content/posts" # ... echo "=== 批量发布系列：$SERIES_NAME ===" # ... declare -a POSTS=( "go-goroutine-basics" "go-channel-patterns" "go-context-usage" "go-worker-pool" "go-concurrency-best-practices" ) # ... for i in "${!POSTS[@]}"; do SLUG="${POSTS[$i]}" CHAPTER=$((i + 1)) # ... cat > "$POSTS_DIR/$SLUG.md" << FRONTMATTER title: "$(echo $SLUG | tr '-' ' ' | sed 's/\b\(.\)/\u\1/g')" date: 2026-07-18 draft: false tags: ["go", "programming", "concurrency"] categories: ["tech"] series: ["$SERIES_NAME"] series_weight: $CHAPTER description: "Go 并发编程系列第 $CHAPTER 篇" aliases: - /posts/$SERIES_NAME-$CHAPTER/ FRONTMATTER # ... echo " [$CHAPTER/${#POSTS[@]}] $SLUG 已准备" done # ... cd "$BLOG_DIR" git add content/posts/ git commit -m "新增：Go 并发编程系列（5 篇）" git push # ... echo "=== 系列发布完成 ===" ``` ### 场景二：多语言站点管理 博客需要同时维护中文和英文版本. ```bash cat > hugo.toml << 'EOF' defaultContentLanguage = "zh" defaultContentLanguageInSubdir = true # ... [languages] [languages.zh] weight = 1 title = "技术博客" languageName = "中文" [languages.en] weight = 2 title = "Tech Blog" languageName = "English" # ... EOF # ... create_bilingual_post() { local slug=$1 local zh_title=$2 local en_title=$3 # ... mkdir -p "content/zh/posts/$slug" mkdir -p "content/en/posts/$slug" # ... cat > "content/zh/posts/$slug/_index.md" << EOF title: "$zh_title" date: 2026-07-18 draft: false tags: ["tech"] EOF # ... cat > "content/en/posts/$slug/_index.md" << EOF title: "$en_title" date: 2026-07-18 draft: false tags: ["tech"] EOF } ``` ### 场景三：CI/CD 自动化部署 博客需要通过 CI/CD 实现推送即部署. ```yaml name: 部署博客 on: push: branches: [main] paths: - 'content/**' - 'static/**' - 'hugo.toml' # ... jobs: build-deploy: runs-on: ubuntu-latest steps: - name: 检出代码 uses: actions/checkout@v4 with: submodules: true # ... - name: 安装 Hugo uses: peaceiris/actions-hugo@v2 with: hugo-version: 'latest' extended: true # ... - name: 安装图片优化工具 run: | sudo apt-get install -y jpegoptim optipng npm install -g imagemin-cli # ... - name: 优化图片 run: | find static/images -name "*.jpg" -exec jpegoptim --max=80 {} \; find static/images -name "*.png" -exec optipng -o7 {} \; # ... - name: 构建站点 run: hugo --minify --gc # ... - name: 生成站点地图 run: hugo --renderToMemory --templateMetrics # ... - name: 部署到 GitHub Pages uses: peaceiris/actions-gh-pages@v3 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: ./public # ... - name: 通知部署结果 if: always() uses: slackapi/slack-github-action@v1 with: slack-message: "博客部署 ${{ job.status }}" env: SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK }} ``` ## 不适用场景 以下场景Hugo博客发布专业版不适合处理： - 专业医学法律翻译认证 - 同声传译 - 文学创作翻译 ## 触发条件 需要文本翻译、多语言转换、本地化处理时使用。不适用于非本工具能力范围的需求. ## 快速开始 1. 阅读## 核心能力章节了解skill功能 2. 按## 依赖说明配置环境 3. 执行所需能力对应的命令 4. 参考## 错误处理章节处理异常 5. 查看## FAQ解答常见疑问 ### SEO 优化 Front Matter ```yaml title: "Go 并发编程完全指南" date: 2026-07-18 lastmod: 2026-07-19 draft: false description: "深入讲解 Go 语言并发编程，涵盖 goroutine、channel、context 等核心概念" tags: ["go", "programming", "concurrency"] categories: ["tech"] series: ["go-concurrency"] series_weight: 1 # ... keywords: ["Go 并发", "goroutine", "channel", "Go 教程"] # ... images: - /images/go-concurrency-cover.png # ... schema: type: "TechArticle" author: name: "作者名" publisher: name: "博客名称" # ... aliases: - /posts/go-concurrency-guide/ - /posts/2025/go-concurrency/ # ... readingTime: true toc: true ``` ### 图片优化脚本 ```bash #!/bin/bash IMAGE_DIR="static/images" # ... echo "=== 图片优化 ===" # ... find "$IMAGE_DIR" -name "*.jpg" -o -name "*.jpeg" | while read f; do jpegoptim --max=80 --strip-all "$f" echo " 优化: $f" done # ... find "$IMAGE_DIR" -name "*.png" | while read f; do optipng -o7 "$f" echo " 优化: $f" done # ... find "$IMAGE_DIR" -name "*.jpg" -o -name "*.png" | while read f; do cwebp -q 80 "$f" -o "${f%.*}.webp" echo " WebP: ${f%.*}.webp" done # ... find "$IMAGE_DIR" -name "*.jpg" | while read f; do convert "$f" -resize 300x300^ -gravity center -extent 300x300 "${f%.*}-thumb.jpg" echo " 缩略图: ${f%.*}-thumb.jpg" done # ... echo "=== 优化完成 ===" ``` **响应解析**: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤. # ## 示例 ### 文章系列配置 ```yaml title: "Go 并发基础" series: ["go-concurrency"] series_weight: 1 title: "Go Channel 模式" series: ["go-concurrency"] series_weight: 2 {{ $series := .Params.series }} {{ if $series }} {{ $weight := .Params.series_weight }} {{ end }} ``` ### 站点性能优化配置 ```toml [minify] minifyOutput = true disableHTML = false disableCSS = false disableJS = false disableJSON = false disableSVG = false disableXML = false # ... [build] writeStats = true # ... [imaging] quality = 75 resampleFilter = "Lanczos" hint = "photo" # ... [markup.goldmark.renderer] unsafe = true ``` ## 最佳实践 1. **批量发布用脚本**：系列文章通过脚本统一发布，保持一致性 2. **多语言同步管理**：中英文文章保持相同的 slug 和日期 3. **图片先优化再发布**：减少站点体积，提升加载速度 ```bash （请参考skill目录中的脚本文件） ``` 4. **CI/CD 自动化部署**：推送即部署，减少手动操作 5. **使用 series 管理系列**：通过 `series_weight` 控制顺序 6. **添加结构化数据**：提升搜索引擎展示效果 7. **定期清理草稿**：避免未完成文章堆积 ```bash find content/posts -name "*.md" -exec grep -l "draft: true" {} \; ``` 8. **监控站点性能**：定期检查 Core Web Vitals ## 常见问题 ### Q1：如何实现定时发布？ ```bash title: "定时发布文章" date: 2026-12-25 draft: false on: schedule: - cron: '0 0 * * *' # 每天 UTC 0点 jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: 构建并部署 run: hugo --minify && （请参考skill目录中的脚本文件） ``` ### Q2：多语言站点的标签如何管理？ ```bash title: "Go 语言" title: "Go" ``` ### Q3：如何处理文章的交叉引用？ ```markdown {{< ref "posts/getting-started.md" >}} # ... {{< relref "posts/getting-started.md" >}} # ... 参见 [本系列第一篇]({{< ref "posts/go-goroutine-basics.md" >}}) ``` ### Q4：如何生成站点地图？ ```bash hugo --minify # ... [sitemap] changeFreq = "weekly" priority = 0.5 filename = "sitemap.xml" ``` ### Q5：如何集成 CDN？ ```toml [params] cdnURL = "https://cdn.example.com" # ... ``` ### Q6：如何统计文章字数和阅读时间？ ```html {{ $words := .WordCount }} {{ $minutes := math.Round (div (float $words) 200.0) }} {{ $words }} 字 · 约 {{ $minutes }} 分钟 ``` ## 依赖说明 ### 运行环境 - **Agent 平台**: 支持读取 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等） - **操作系统**: Windows / macOS / Linux - **Hugo 版本**: 建议 0.110 及以上（扩展版） - **CI/CD 平台**: GitHub Actions / GitLab CI 等 ### 依赖详情 | 依赖项 | 类型 | 是否必需 | 获取方式 | |:-----|:-----|:-----|:-----| | Hugo | 静态站点生成器 | 必需 | gohugo.io 下载（扩展版） | | Git | 命令行工具 | 必需 | 系统包管理器安装 | | jpegoptim | 图片优化 | 推荐 | `apt install jpegoptim` | | optipng | 图片优化 | 推荐 | `apt install optipng` | | cwebp | WebP 生成 | 可选 | `apt install webp` | | ImageMagick | 缩略图 | 可选 | `apt install imagemagick` | | LLM API | API | 必需 | 由 Agent 内置 LLM 提供 | ### API Key 配置 - 本工具为纯 Markdown 指令驱动，无需额外 API Key - Git 推送需要配置 SSH Key 或个人访问令牌 - CI/CD 部署需要在平台配置对应的访问令牌 - CDN 集成需要配置 CDN 服务的访问密钥 ### 可用性分类 - **分类**: MD+EXEC（Markdown 指令 + 命令行执行） - **说明**: 通过自然语言指令驱动 Agent 执行博客管理流程，专业版功能依赖 Hugo CLI、图片优化工具和 CI/CD 平台 ## 错误处理 | 错误场景 | 原因 | 处理方式 | |---:|---:|---:| | 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 | | 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 | | 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 | ## 已知限制 - 需LLM支持,无LLM环境不可用 - 复杂业务场景建议结合人工经验判断 - 执行效率受模型能力与网络环境影响 ## 输出格式 ```json { "success": true, "data": { "result": "Hugo博客发布专业版处理结果", "execution_time": "0.5s", "metadata": { "version": "1.0", "processor": "hugo blog pro" } }, "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"], "error": null } ```