YI TUO HUB / LOCAL AGENT CAPABILITY

GZH CLI 使用文档

给 Agent 的微信公众号排版与存稿能力。文章写好以后，用一条命令选择风格、处理图片，并在需要时创建草稿。

01 / OVERVIEW

它是什么

它接收已经写好的 Markdown，可以带本地图片或远程图片；然后调用 YI TUO HUB STUDIO 的排版引擎生成公众号正文。用户明确要求存稿时，CLI 会直接调用微信公众号接口上传图片、创建草稿，并回读核对标题与封面。

边界先说清楚： CLI 请求直接发往微信接口，不经过 cli.yituohub.com 或其他中心服务器。draft 只创建草稿，不调用发布接口。

02 / INSTALL

需要 Node.js 20 或更高版本。安装脚本会下载发布包、安装运行依赖，并把 yituo-hub-gzh 放到本机的用户级 bin 目录。

TERMINAL

curl -fsSL https://cli.yituohub.com/install.sh | bash

CHECK

yituo-hub-gzh --help

发布包同时包含 agent-skill/yituo-hub-gzh。在支持技能的 Agent 中，把这个目录按其技能安装方式装入 skills 目录。

03 / COMMANDS

yituo-hub-gzh styles

yituo-hub-gzh layout article.md \
  --style violet-studio \
  --level L4 \
  --out article_gzh.html

yituo-hub-gzh draft article.md \
  --style violet-studio \
  --level L4 \
  --dry-run \
  --json

yituo-hub-gzh draft article.md \
  --style violet-studio \
  --level L4 \
  --cover assets/cover.jpg \
  --author '作者名' \
  --json

04 / WECHAT SETUP

第一次推稿前，准备目标公众号的 AppID、AppSecret，并把调用 CLI 的实际运行环境出口 IP 加入公众号的服务器 IP 白名单。

ENVIRONMENT

export WECHAT_APPID='你的 AppID'
export WECHAT_APPSECRET='你的 AppSecret'
yituo-hub-gzh doctor --json

05 / STYLE INDEX

基础主题不需要视觉等级，高级主题支持 L1–L6。运行 styles --json 可以拿到完整列表，适合由 Agent 展示给用户选择。

violet-studio紫灰工作室 · L1–L6

deep-sea深海终端 · AI / 技术

blueprint蓝图网格 · 教程 / 流程

swiss-signal瑞士信号 · 清单 / 工具

mono-gold黑金刊读 · 专业长文

06 / IMAGES

07 / SAFETY BOUNDARY