分发与维护指南
这个目录用于在 CloudBase 静态托管上分发多个 skills。首页负责发布列表,单个 skill 使用独立详情页,维护说明放在这个 HTML 页面里;skill.md 保留为 ASCII-only 索引,避免浏览器直接打开 Markdown 时乱码。
目录结构
skill/
├── home.html
├── aitproxy-image.html
├── skill.html
├── skill.md
├── packages/
│ └── aitproxy-image.zip
└── src/
└── aitproxy-image/
├── SKILL.md
├── agents/openai.yaml
└── scripts/
├── generate.py
└── list-models.sh
更新 skill 源文件
源文件来自本机 Codex skill:
SRC="$CODEX_HOME/skills/aitproxy-image"
DST="/Users/liuzimu/claude-proxy/skill/src/aitproxy-image"
rm -rf "$DST"
mkdir -p "$(dirname "$DST")"
rsync -a --exclude='__pycache__' --exclude='*.pyc' "$SRC/" "$DST/"
如果也维护 Claude Code 版本,可以同步到:
rsync -a --exclude='__pycache__' --exclude='*.pyc' \
"$CODEX_HOME/skills/aitproxy-image/" \
"$HOME/.claude/skills/aitproxy-image/"
重新打包
cd /Users/liuzimu/claude-proxy
rm -f skill/packages/aitproxy-image.zip
mkdir -p skill/packages
(cd skill/src && zip -qr ../packages/aitproxy-image.zip aitproxy-image)
shasum -a 256 skill/packages/aitproxy-image.zip
wc -c skill/packages/aitproxy-image.zip
打包后,把新的 SHA-256 和大小同步更新到 skill/home.html 和对应的详情页,例如 skill/aitproxy-image.html。
本地检查
python3 "$CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py" \
"$CODEX_HOME/skills/aitproxy-image"
python3 -m py_compile \
"$CODEX_HOME/skills/aitproxy-image/scripts/generate.py"
bash "$CODEX_HOME/skills/aitproxy-image/scripts/list-models.sh" | grep -Ei 'image|banana'
部署到 CloudBase
环境 ID:cloud1-4g15muqveb93768b
cd /Users/liuzimu/claude-proxy
cloudbase hosting:deploy skill /skill -e cloud1-4g15muqveb93768b
cloudbase hosting:deploy index.html /index.html -e cloud1-4g15muqveb93768b
CloudBase CLI 提示 cloudbase hosting:deploy 将废弃时,可换成:
tcb hosting deploy skill /skill -e cloud1-4g15muqveb93768b
tcb hosting deploy index.html /index.html -e cloud1-4g15muqveb93768b
线上地址
分发页:
https://base.wilsonsliu.cn/skill/home.html
维护指南:
https://base.wilsonsliu.cn/skill/skill.html
ASCII Markdown 索引:
https://base.wilsonsliu.cn/skill/skill.md
AITProxy Image 详情页:
https://base.wilsonsliu.cn/skill/aitproxy-image.html
zip 下载:
https://base.wilsonsliu.cn/skill/packages/aitproxy-image.zip
凭证规则
不要把 API Key 写进 zip 包或页面。对外分发时只要求用户配置一个 key 变量:
AITPROXY_API_KEY="..."
AITPROXY_BASE="https://aitproxy.wilsonsliu.cn"
常见维护动作
- 新增模型:改
src/aitproxy-image/SKILL.md的模型列表,必要时调整scripts/generate.py路由逻辑。 - 修复接口:优先改
scripts/generate.py,再本地跑一次 Gemini 和 GPT 图像生成。 - 更新首页:只改
home.html的列表、发布清单和分层说明。 - 更新详情页:改对应的
{skill-name}.html,例如aitproxy-image.html。 - 更新 zip:重新
zip,更新首页和详情页的 SHA-256 与大小,再部署。