infocard-build-and-deploy
build 超时时直接 push 源码,Actions 自动构建;index.html 锚点恢复用 febcfee。
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 2
- Forks
- 1
01 前言 Front Matter
- name
- infocard-build-and-deploy
- author
- Hermes Agent
- license
- MIT
- version
- 1.0.0
- metadata
- { "hermes": { "tags": [ "infocard", "build", "deploy", "github-actions" ], "related_skills": [ "infocard-publish-sop" ] } }
- description
- build 超时时直接 push 源码,Actions 自动构建;index.html 锚点恢复用 febcfee。
02 资源文件 1
03 SKILL.md 正文
When to Use
触发条件:npm run build 超时(>2 分钟)、报错 missing #app anchor for home-index-data injection,或本地构建阻碍发布进度。
npm run build 超时 → 直接 push 源码
Local build can timeout in two execution contexts:
terminal:npm run buildornode scripts/build-site.jstimes out (>120s) — common whencopyStaticTreeToDist()copies 799+ filesexecute_code: Python subprocess sandbox has a 120s hard cap and returnssubprocess.TimeoutExpired—build-site.jsis a Node.js script, not a shell wrapper, so it runs fine interminalbut times out inexecute_code
Correct path (always):
# Stage → commit → push (no local build needed)
REPO_ROOT="$(git rev-parse --show-toplevel)" || exit 1
cd "$REPO_ROOT"
git add docs/<slug>.html docs/<slug>.html.meta.yaml _index.yaml index.html
git commit -m "feat: add <slug> infocard (YYYY-MM-DD)"
git push origin main
# Wait for GitHub Actions + Pages deploy (~45s)
sleep 45
# Verify HTTP 200
curl -sI --max-time 15 "https://ccwq.github.io/infocard-pub/docs/<slug>.html" | head -1
GitHub Actions has its own build pipeline — the copyStaticTreeToDist() work is done by Pages automatically. The local build step is entirely skippable when pushing source.
npm run build 超时 exit 124 ≠ 构建失败
现象:npm run build 超时返回 exit 124,但实际构建产物已生成。
判断方法:检查 git status --short docs/<slug>.html — 如果文件显示 M(modified staged),则构建实际成功,直接 git add + commit + push 即可,无需重新 build。
Git commit 遭遇并发锁
现象:git commit 报错 Unable to create '/path/to/.git/index.lock': File exists,来自另一个正在运行 git push 的后台进程。
解法:
# 1. 等待后台 push 完成
ps aux | grep -E "git (push|send-pack|pack-objects)" | grep -v grep
# 重复直到返回空(通常 60-120s)
# 2. 清除锁
rm -f "$REPO_ROOT/.git/index.lock"
# 3. 重试 commit + push
git add docs/<slug>.html docs/<slug>.html.meta.yaml _index.yaml
git commit -m "feat: ..."
git push
index.html 锚点恢复
报错:index.html missing #app anchor for home-index-data injection
原因:源码 index.html 锚点被覆盖,从 <div id="app" class="app-shell"></div> 变成 <main id="app">
恢复:
cd /path/to/infocard-pub
git checkout febcfee -- index.html
grep 'app-shell' index.html # 验证:应返回 <div id="app" class="app-shell"></div>
诊断:
# 检查当前 HEAD
git show HEAD:index.html | wc -l
# ~313 行 → 被覆盖;~25000 行 → 正常
git show HEAD:index.html | grep -c 'home-index-data'
# 0 → 被覆盖;1 → 正常
锚点来源:febcfee(带 home-index-data 的最新完整版)。
公网验收
curl -s https://ccwq.github.io/infocard-pub/docs/<slug>.html | grep -c 'href='
# 预期:从 1 增长到预期数量
Deprecated compatibility entry
此旧入口仅作兼容转发,替代入口为 infocard-publish-pipeline#build。没有有效质量通过结果和发布授权时不得执行构建或部署副作用。
04 同仓库更多 Skills
authorized-infocard-execution
Use for authorized infocard runs after tool failures.
web-capture
Use when a web page needs screenshots or device simulation. Capture desktop, mobile, and tablet screenshots via agent-browser and return auditable image paths.
infocard-x-content-tracing
X content to upstream project/author tracing.
infocard-visual-pass-loop
Screenshot-and-fix loop when 200 passes but theme is broken.
infocard-topic-selection
Use when selecting or evaluating information-card topics from the user's profile or explicitly supplied themes; judge value and visual expression potential without choosing a concrete infocard theme or publishing.
infocard-theme-validation
Use when changing infocard theme CSS or pushing docs.