v1.2.0 — macOS/Linux 应用清理与审计修复

对应 SKILL.md 与 agents/openai.yaml 的 version: 1.2.0。

本次发布补齐 macOS 与 Linux 的应用清理能力，复核并同步了 NOTICE 记录的全部上游项目，
并修掉一轮整体审计发现的缺陷。

Added

• 新增 macos-application-cleanup：区分沙盒与非沙盒数据根，TCC 拒读判定为
  unknown 而非「目录为空」，偏好由 cfprefsd 拥有需先退出应用，覆盖 APFS 本地快照
  与克隆对可回收空间的影响，并给出「可删缓存与同级登录态」的相邻目录对照表。
• 新增 linux-application-cleanup：先确认打包方式（原生包 XDG / Flatpak ~/.var/app /
  Snap ~/snap / Wine prefix）再定位数据根，回收站按 XDG 规范分级降级；明确 Linux 上
  微信没有跨发行版标准路径，必须从运行进程、包文件清单和用户配置实地发现。
• tools-macos.md 与 tools-linux.md 新增清理与操作记录工具别名（路径元数据、
  有界清单、SHA-256、废纸篓/回收站、隔离 JSON 操作日志）。
• playbook-windows-configuration-review.md 新增 Windows AI（Recall/Copilot）审查路径，
  要求只写回记录下来的具体策略值，不删除整棵 WindowsAI 策略键，也不按包名子串批量删 Appx。
• playbook-windows-browser-policy-audit.md 新增 AI、分享与扩展可用性策略维度，
  并说明 Manifest v2 开关只是过渡桥而非修复。
• tests/validate_skill.py 新增四类断言：表格单元格竖线转义、platform 与工具别名
  归属一致、last_reviewed 不得为未来日期（容忍一天时区差）、官网触发词跟随路由索引、
  无 JS 回退表格与站点数据逐行一致、官网 data-i18n 键的英文文案覆盖。
• 新增 scripts/sync_docs_table.py，由站点数据幂等重建 docs/index.html 的无 JS 回退表格。
• 官网新增 macOS 与 Linux 示例提问，安全红线新增「用脚本运行时绕过宿主删除护栏」一条。

Changed

• cleanup-protocol.md、rule-source-contract.md 与 safety-policy.md 同步上游清理器
  的最新行为与安全边界：动作分级不得升级、本机白名单只排除批量执行、单点拒绝访问不终止
  整次盘点、行为标签不构成厂商身份、卸载器打开前三重校验、清空回收站与回收站回滚互斥、
  提权后必须重新确认、Winapp2 字段真实作用域（RECURSE/REMOVESELF/ExcludeKey 的
  FILE 与 PATH 差异）、规则库更新前本地对比两版。
• 三个平台的应用清理统一要求先按设备号与 inode 去重再报可回收字节，硬链接、
  reflink/CoW 克隆与稀疏文件会共享块。
• NOTICE 记录全部上游项目的本轮复核提交与版本；上游基线在 d5e3a81 复核后确认
  playbooks 与编写指南自基线未变。
• playbook-setup-openclaw-install-node.md 不再固定 nvm 的旧版本号，改为先解析当前发布 tag。

Fixed

• tools-windows.md 转义 win_cancel_print_jobs 单元格内的裸竖线，原本会把表格行拆散。
• playbook-setup-wifi-profile.md 的 platform 为 all 却声明 macOS 专属工具，
  改为按当前平台映射。
• playbook-windows-migration-history-recovery.md 的跨卷恢复改为「复制 → 校验 → 回收源」：
  Move-Item 跨卷会退化成复制后删源且非原子，中断会留下半份副本而源已删。

---

完整变更记录见 CHANGELOG.md。

v1.1.0 — 审计修复与发布元数据基线

对应 SKILL.md 与 agents/openai.yaml 的 version: 1.1.0。

本次发布集中修复第三方审阅报告中确认成立的问题，并补上审阅遗漏的同类缺陷。
所有命令与配置字段均按官方文档核对，不再依赖记忆推断。

Added

• SKILL.md 新增 when_to_use，列出常见中文求助说法（C 盘变红、开机很慢、
  把应用迁到 D 盘、蓝屏进不了系统等），提升中文提问的命中率。
• SKILL.md 与 agents/openai.yaml 新增 version 字段，并新增本 CHANGELOG。
• playbook-index.md 新增「存储与迁移：先选对入口」决策清单，把六个都会被
  「C 盘满了」命中的流程按真实诉求分流。
• 六个存储/迁移 Playbook 新增统一的「相邻流程」互链区块。
• playbook-setup-openclaw-config-reference.md 补齐当前支持的
  groups.<group-id>.requireMention、gateway.mode 字段，并写清环境变量解析优先级。
• playbook-windows-printer-repair.md 在安装厂商驱动前要求校验 SHA256 与
  Authenticode 签名。
• playbook-setup-wifi-profile.md 补上可执行的 Windows WLAN 配置文件分支，
  并要求验证后立即删除含密码的临时 XML。
• tests/validate_skill.py 新增三类断言：路由表表头与列数一致、站点数据
  （docs/assets/js/playbooks.js）与 frontmatter 同步、版本号在 SKILL.md
  与 agents/openai.yaml 之间一致且 CHANGELOG 有对应条目。
• 新增 tools/extract_data.py 和 tools/site_catalog.json，官网数据现在可从
  Playbook 元数据、路由索引和明确的文案目录重复生成；--check 已接入验证器与 CI。

Changed

• playbook-setup-openclaw-china-models.md 对 Volcengine 仍要求从当前
  OpenClaw/provider catalog 确认 provider 和模型，同时恢复可复制的 Moonshot
  插件、Kimi、DeepSeek 示例，并明确这些 ID 需要运行时复核；配置示例的 api
  值改为 openai-completions。
• playbook-setup-openclaw-config-reference.md 将 typingIndicator 与
  resolveSenderNames 放回 Feishu 专属小节，并注明 Google Chat 的类型差异。
• playbook-setup-openclaw-uninstall.md 以官方 openclaw uninstall 为主路径，
  补上 Windows 计划任务与桌面端清理，手工删除降级为兜底。
• playbook-setup-openclaw-add-feishu.md 的批量导入权限收敛到最小租户权限，
  文档/表格/知识库权限改为显式可选。
• playbook-windows-boot-failure-triage.md 改为按实际屏幕文案分流，移除无法
  在真实机器上出现的固件字符串。
• playbook-setup-ssh-key.md 默认要求交互式输入口令，配合 ssh-agent 与
  钥匙串；空口令改为需要显式记录的例外。
• playbook-setup-homebrew.md 改为探测实际安装前缀与当前 Shell 配置文件，
  不再依赖 uname -m 推断。
• playbook-index.md 的 OpenClaw 路由表补齐「平台」与「触发症状」列，八张
  路由表统一表头。
• tool-contract.md 明确 knowledge_search 为规范名称，search_knowledge
  仅作兼容别名保留。
• .github/workflows/star-history.yml 把第三方 Action 从可变标签 v1 固定到
  v1.3.5 对应的提交 SHA。

Fixed

• playbook-windows-update-troubleshooting.md 不再把第三方 PSWindowsUpdate
  的 Get-WindowsUpdate 当作内置命令，改用 Get-HotFix 与内置
  Microsoft.Update.Session 搜索器；补齐未标注语言的代码块。
• 停止通过命令行参数传递机密：飞书、飞书官方插件、Telegram、国产模型、
  基础配置和排错共 6 个 Playbook 改为写入 ~/.openclaw/.env 后用单引号
  引用变量名，避免机密进入进程列表、Shell 历史或明文配置文件。
• 移除 macOS 上已不存在的命令与路径：com.apple.alf plist 直读（4 处）、
  MRT.app、security find-generic-password -D "AirPort network password"。
• playbook-backup-verify-restore.md 不再调用无 -status 开关的
  fhmanagew.exe，改用计划任务与配置文件状态判断文件历史记录。
• playbook-browser-security-audit.md 不再用文件大小推测密码条数，改为复制
  数据库后用 sqlite3 计数（Chrome 会锁定在用数据库）。
• 后续审阅补强了 Chrome/Edge 临时数据库的唯一文件名与失败清理，并同步修正
  credential-cleanup 中遗留的文件大小误判。
• Windows WLAN 配置现在对 SSID 和密码做 XML 转义，临时路径不再使用用户输入，
  且导入失败时也会清理秘密文件；密码会去除秘密文件换行，profile 使用真实
  SSID，写入 XML 时不带 BOM。发现同名 profile 时会先展示（不读取明文密钥）并
  询问，只有用户确认后才由 netsh wlan add profile 原地覆盖；SSID 含 "、=
  或 > 时在收集密码前改用 Windows Wi-Fi UI，避免 netsh name= 解析错误。
• 官网生成器为 25 个 local Playbook 恢复原有 emoji，校验器现在拒绝缺失图标；
  弹窗在未来缺失图标时也不会产生前导空格。
• OpenClaw 卸载的状态/配置删除块自包含路径解析与安全检查，不依赖上一段
  shell 会话中的变量。
• Volcengine 流程改为先确认当前 provider/model catalog，避免引用不存在的插件或
  过期模型；健康基线同时接受 macOS 防火墙 State = 1 与 State = 2。
• OpenClaw 的密钥文件权限说明改用当前用户 SID 与 *S-1-5-18，并要求
  write_secret 在写入前建立安全权限；卸载覆盖 OPENCLAW_HOME、
  OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH、多 profile 服务，并保留路径安全检查。
• playbook-windows-partition-resize-audit.md 把已停止支持的 Windows To Go
  改为 WinRE/WinPE/厂商启动介质。
• playbook-windows-network-diagnostics.md 补上 WinHTTP 与 WinINET 的区别，
  只有在受影响层复现故障时才把不一致判定为问题。
• playbook-windows-application-lifecycle-audit.md 区分 Windows 精简工具
  Sparkle 与 macOS 更新框架 Sparkle。
• playbook-setup-backup.md 为 USB 与 SMB 目标补齐 sudo，网络目标改用
  sudo tmutil setdestination -ap 的非回显密码提示，不依赖 Finder 登录钥匙串。
• 同步 docs/assets/js/playbooks.js 中本次修改文件的 last_reviewed。

Known issues

• 2026-03 引入的上游 Playbook 中，本次未涉及的文件仍待逐个复核。

---

完整变更记录见 CHANGELOG.md。