给 OpenClaw/Hermes Agent 装上「字根秀秀」网页托管 Skill 技能

想象一下：你只需要对 AI 说"帮我把这个 HTML 页面发布到网上"，几秒钟后它就把链接甩给你——这不是科幻，而是今天就能配置好的工作流。

---

背景：什么是「字根秀秀 ShowShow」？

字根秀秀（ShowShow） 是一款专注于 HTML 网页托管的平台，面向学生、教师和网页制作爱好者，提供一键发布、免费托管、稳定访问的网页服务。

• 官网：https://cuobiezi.net/showshow
• 支持接口：创建 / 更新 / 删除 / 列出 HTML 页面
• 鉴权方式：Bearer Token（API Key）

现在，我们把它封装成一个 Skill（技能文件），让 Claude Code、Gemini CLI、Codex、OpenClaw、Hermes Agent 等支持 Skill 的大模型 直接读懂接口规则，从此用自然语言操控网页托管。

---

第一步：获取 API Key

在开始之前，先申请一个 Bearer Token：

👉 https://cuobiezi.net/user/api_keys/list

申请后设置环境变量：

export SHOWSHOW_API_KEY=sk-你的token

---

第二步：下载 Skill 文件

Skill 包含两个文件：

文件	说明
SKILL.md	AI 读取的技能说明（YAML frontmatter + 操作手册）
showshow_api.py	Python API 客户端（零依赖，直接运行）

# 创建技能目录
mkdir -p ~/.skills/web-page-hosting-showshow
cd ~/.skills/web-page-hosting-showshow

# 下载文件（或手动复制）
curl -O https://cuobiezi.net/showshow/docs/api-doc   # 参考文档

或者直接从项目仓库取 SKILL.md 和 showshow_api.py，放到你的 skills 目录下。

---

第三步：加入各大 AI Agent

🔵 Claude Code

Claude Code 支持 .claude/skills/ 目录或全局 ~/.claude/skills/：

mkdir -p ~/.claude/skills/web-page-hosting-showshow
cp SKILL.md showshow_api.py ~/.claude/skills/web-page-hosting-showshow/

然后在对话中直接说：

“帮我把这段 HTML 发布到字根秀秀，页面名叫 hello-world”

Claude Code 会自动读取 Skill，调用 API，返回页面链接。

---

🟢 Gemini CLI / Gemini Agent

Gemini 支持通过 --skill-dir 参数或 SKILL_DIR 环境变量指定技能目录：

export SKILL_DIR=~/.skills
gemini chat --skill-dir $SKILL_DIR

或在 gemini.yaml 配置文件中添加：

skills:
  - path: ~/.skills/web-page-hosting-showshow/SKILL.md

---

🟡 OpenAI Codex / Codex CLI

Codex 可通过系统提示词（system prompt）注入 Skill 内容：

# 将 SKILL.md 内容作为 system prompt 注入
codex --system "$(cat ~/.skills/web-page-hosting-showshow/SKILL.md)" \
  "帮我发布一个 HTML 页面"

或在 .codex/instructions.md 中 @include 该文件。

---

🟠 OpenClaw

OpenClaw 支持在 agents/ 目录下放置 Skill 文件：

mkdir -p ~/.openclaw/agents/showshow
cp SKILL.md ~/.openclaw/agents/showshow/

启动时 OpenClaw 会自动加载，之后在对话框输入：

“列出我在字根秀秀上的所有网页”

---

🔴 Hermes Agent

Hermes 使用 skills.yaml 注册外部技能：

# ~/.hermes/skills.yaml
skills:
  - name: web-page-hosting-showshow
    path: ~/.skills/web-page-hosting-showshow/SKILL.md
    executor: python
    script: ~/.skills/web-page-hosting-showshow/showshow_api.py

---

第四步：用自然语言操作

配置完成后，你可以直接用中文（或英文）下达指令，AI 会自动转换为 API 调用：

📋 列出页面

“查看我在字根秀秀上有哪些页面”

AI 调用：GET /api/v4/showshow/html-page，返回页面列表。

---

🚀 发布新页面

“帮我把下面这段 HTML 发布到网上，页面名叫 my-resume，标题是「我的简历」”

AI 调用：POST /api/v4/showshow/html-page，返回：

✓ 页面已发布！
  链接：https://abc.wangye.domolo.cn/p/xxxxxxxx.html
  UUID：a1b2c3d4-...

---

✏️ 更新页面

“把 uuid 是 a1b2c3d4 的页面内容替换成这个新版本”

AI 调用：POST /api/v4/showshow/html-page/update/a1b2c3d4

---

🗑️ 删除页面

“删掉那个叫 test-page 的页面，uuid 是 a1b2c3d4”

AI 调用：POST /api/v4/showshow/html-page/delete/a1b2c3d4

---

也可以直接用 Python 脚本

不需要 AI Agent，直接命令行用：

# 列出页面
python showshow_api.py list

# 从文件创建页面
python showshow_api.py create --name my-page --file index.html --title "我的主页"

# 更新页面
python showshow_api.py update a1b2c3d4-... --file index.html

# 删除页面
python showshow_api.py delete a1b2c3d4-...

脚本零第三方依赖，Python 3.9+ 即可运行。

---

典型场景

场景	你说的话	AI 做的事
学生交作业	“帮我把这个 HTML 作业发布到网上”	创建页面，返回链接
教师发讲义	“把 ppt 转成的 HTML 挂到字根秀秀”	创建页面，私密模式
AI 生成落地页	“生成一个活动页面并发布”	生成 HTML → 调用 API → 返回链接
内容迭代	“把首页更新成新版本”	列出页面 → 找到 uuid → 更新内容

---

常见问题

Q：页面创建失败，返回 403？
A：页面配额已用完（默认 5 个）。删除旧页面，或联系管理员提升配额：https://cuobiezi.net

Q：AI 找不到这个 Skill？
A：检查 SKILL.md 是否放到了正确的目录，且 YAML frontmatter 格式完整（含 name 和 description）。

Q：支持上传图片吗？
A：目前 API v4 仅支持 HTML 内容托管。图片建议用 CDN 外链引用。

---

总结

申请 Token → 放入 SKILL.md → 告诉 AI Agent → 用自然语言发布网页

一次配置，永久受益。无论是 Claude Code、Gemini、Codex 还是自建 Agent，只要支持 Skill/工具调用，都能接入字根秀秀，让"发布网页"变成一句话的事。

---

🔗 相关链接

• 官网：https://cuobiezi.net
• API 文档：https://cuobiezi.net/showshow/docs/api-doc
• Token 申请：https://cuobiezi.net/user/api_keys/list
• 技能文件：SKILL.md + showshow_api.py（见本文配套仓库）