Repository navigation
对应 SKILL.md 与 agents/openai.yaml 的 version: 1.3.0。
本次发布集中加固 64 个维修 Playbook 的安全边界、安装器的路径保护和失败恢复,
并上线中英文静态官网、可重复构建与自动发布流程。
Added
- 新增
Release工作流与tools/release_notes.py:SKILL.md的version变化并合入
main后自动打 annotated tag 并发布 GitHub Release,说明正文从本文件对应版本条目摘录。
发布前会先跑tools/extract_data.py --check、tools/build_site.py --check与
tests/validate_skill.py,任一失败就不发布;
对应 Release 已存在时跳过;仅有 tag 时从该 tag 验证并补发,因此可重试中断的发布。 - 新增
tools/build_site.py:由中文页docs/index.html和tools/i18n_en.json的译文
生成静态英文页docs/en/index.html,以及两个页面的 JSON-LD、docs/sitemap.xml和
docs/llms.txt;--check已接入Validate与Release工作流。 - 官网新增
docs/llms.txt,给 AI 检索爬虫提供纯文本索引:能力说明、安装方式、
四级风险模型、七步流程和 64 条 Playbook 的路由 ID 与中英标题。 - 官网结构化数据由单个
SoftwareSourceCode扩成@graph,中英各一份:WebSite、
Person、WebPage+FAQPage(页面上的七条问答)、SoftwareApplication+
SoftwareSourceCode、HowTo(七步排障流程)和ImageObject。 docs/robots.txt显式放行 GPTBot、OAI-SearchBot、ClaudeBot、PerplexityBot、
Google-Extended 等会抓取并引用来源的 AI 爬虫;docs/sitemap.xml补上两种语言的
xhtml:link备用链接,页脚新增「最后更新」日期。- 新增 16 项核心回归测试,覆盖安装异常恢复、失效链接、并发锁、生成器和发布状态判定,
并接入 Windows / Ubuntu CI;新增独立的中英文官网浏览器回归脚本和AUDIT.md审计记录。
Changed
- 官网中英文改为
/与/en/两个静态页面并互相声明 hreflang。此前语言在同一 URL 上
由 JavaScript 按navigator.language切换:Googlebot 渲染器默认en-US,会把中文
首页索引成英文页;而不执行 JavaScript 的 AI 爬虫根本读不到英文内容。旧的?lang=
链接会跳转到对应页面,不会失效。 - 英文正文移到只在构建期使用的
tools/i18n_en.json(按data-i18n前缀分组),
docs/assets/js/i18n.js只保留运行时界面字符串,浏览器少下载约 8 KB(gzip)。 - 文案和首屏徽标里的 Playbook 总数改由
tools/build_site.py按站点数据统一改写,
不再手工维护;章节标题改写成更接近真实搜索提问的说法。 - 安装器现在拒绝包含符号链接或 Junction 的安装路径。由 Skills CLI 等工具维护的链接安装,
请通过原工具更新;自定义安装请使用实际目录。
Fixed
- 安装器拒绝源码重叠、文件目标和链接路径;增加独占安装锁、完整分发文件检查及失败恢复测试,修复 Bash 对带引号
~/...路径的展开。 - 发布失败但 tag 已存在时可从该 tag 补发 Release;API 错误不再当作版本不存在。
- 官网筛选后保留键盘焦点,连续复制后正确恢复按钮文字,剪贴板权限失败时尝试回退,提示卡片在焦点仍停留时保持暂停;数据加载失败时保留静态索引。
- 数据生成器支持重建缺失产物并拒绝重复索引;英文纯文本译文进行 HTML 转义。
- 修正 macOS 清理与调优、浏览器凭据审计、CUDA 和 OpenClaw 清理中的破坏性捷径或错误说明;移除缺少证据来源的修复成功率数字。
- 备份恢复测试使用私有唯一目录,修正 Borg 提取命令并区分 RPO/RTO 目标与实际测量;
应用修复先核验来源、签名和数据恢复路径,Windows 更新不再按等待时长建议强制重启。 - 首屏徽标上的 Playbook 总数此前只有
scripts/sync_docs_table.py会同步,而该脚本不在
CI 中运行,数字可能静默过期;现在由tools/build_site.py --check把关。 scripts/sync_docs_table.py与新生成器显式以 LF 写文件,不再在 Windows 上产出与
.gitattributes的eol=lf冲突的 CRLF。- 英文视图的
og:image:alt与twitter:image:alt此前始终是中文。
完整变更记录见 CHANGELOG.md。