微软Skill Recorder v0.7.0

10 个主要问题Q&A

Q1：v0.7.0 有没有 exe 安装包？ A1：没有，是仅源码发布版本，只有源码压缩包。

Q2：本次最主要新功能是什么？ A2：增加 SKILL.md 预览弹窗，部署前可只读审阅完整技能文件。

Q3：预览后修改技能规划，预览内容还能用吗？ A3：不能，修改规划会让已生成预览直接失效，需要重新生成。

Q4：预览安装会额外调用大模型吗？ A4：不会，直接使用已经预览好的文本执行安装 / 导出。

Q5：老的 “Add to Scout” 导出流程改了吗？ A5：完全保留不变，不想预览可以继续使用原有操作。

Q6：哪些底层配置在本次版本没有改动？ A6：自动化创建、工具权限策略、安装脚本依赖均无变更。

Q7：修复了什么 Windows 相关问题？ A7：稳定 Windows 安装程序文件锁回归测试，规避 PowerShell 冷启动检索带来的不稳定。

Q8：支持哪些操作系统安装？ A8：Windows11 x64/ARM64、macOS、Ubuntu。

Q9：为什么要用 SHA256 哈希？ A9：用来校验安装脚本完整性，防止脚本被篡改，保障安全。

Q10：自己本地编译出来的源码包属于官方发行版吗？ A10：不属于，本地编译包不能作为官方分发二进制，安装仍受企业和系统策略管控。

发布者：GiorgioUghini｜发布时间：9 月 21 日

本版本仅提供源码发布，没有附带安装程序或便携二进制包。GitHub 自动生成的压缩包仅包含该标签对应的仓库源代码。

更新内容

1. 在技能安装 / 导出操作旁新增可选的【查看 SKILL.md】按钮：弹出只读弹窗，用户在确认部署前，可以完整预览文件内容，包括文件前置元信息以及已替换填充后的变量值。
2. 原有「添加到 Scout」和导出流程保持不变，不想预览文件的用户可以照常使用原有操作。
3. 安装或导出时，直接使用预览窗口里展示的文本，不会再额外调用大模型生成内容；关闭再重新打开预览弹窗，会复用已经生成好的文件；一旦修改了技能规划方案，这份预览缓存就会失效。
4. 弹窗与主界面的进度、报错、完成状态保持同步：在预览弹窗里执行安装，弹窗会自动关闭，界面展示的最终状态和从主界面安装完全一致。
5. 新增支持仅导出模式的技能目标位置、全键盘无障碍导航、超长文件滚动展示；导出被取消后支持重试；预览过期时提供明确的恢复机制。
6. 妥善处理操作取消、延迟返回的边界场景：不会复用已经过期失效的预览内容，同时也不会掩盖已经成功完成的安装记录。

兼容性与校验说明

• 文件预览仅作只读查看；如果需要修改生成后的技能内容，需要修改规划方案并重新生成预览。
• 自动化任务创建、工具权限策略、安装脚本以及依赖项均无改动。
• 修复 Windows 安装程序文件锁回归测试的稳定性问题：调整测试逻辑，避免在模拟文件锁持有期间，PowerShell 冷启动检索命令，安装逻辑和重试断言规则保持原样。
• 本地验证全部通过：共 267 项测试、正式构建包、类型检查、锁文件可移植性校验，以及 285 个软件包的许可证清单核验。
• 独立浏览器验证覆盖：直接安装、弹窗 / 主界面状态联动、仅导出目标、预览复用与失效、原始文本查看、键盘焦点、长内容展示、预览过期、取消操作并发竞争场景；同时启动本地应用完成人工实测。
• 本次发布提交对应的流水线任务： https://github.com/microsoft/skill-recorder/actions/runs/35583653885https://github.com/microsoft/skill-recorder/actions/runs/35583653497 流水线全部通过，校验内容包含固定提交源码安装、单元测试、构建、合规检查以及对应打包和架构校验。

你可以运行下方固定提交版本的安装脚本进行升级。自行本地编译的源码构建包不属于官方发行二进制版本。安装行为仍受企业策略与操作系统权限管控。

安装脚本 SHA-256 哈希值

哈希值由本次发布提交对应的 Git 原始文件计算得出：

7678f7f8d38d600f2fb732f95afeadc8aa4f9b9802989d26e2f932970795770c  install.ps1
bd8b5200a2c140c5a5ed9299d565ac72cee5420181774008977eaf75f210db1d  install.sh

锁定提交版本的安装命令

Windows 11 x64 / ARM64

$commit="b05d59036182e897e1a60e90651e775cf5f97e8d"; $env:SKILL_RECORDER_COMMIT=$commit; irm "https://raw.githubusercontent.com/microsoft/skill-recorder/$commit/install.ps1" | iex

macOS / Ubuntu

commit="b05d59036182e897e1a60e90651e775cf5f97e8d"; curl -fsSL "https://raw.githubusercontent.com/microsoft/skill-recorder/$commit/install.sh" | SKILL_RECORDER_COMMIT="$commit" bash

执行脚本前，如需先查看脚本源码、核验哈希，参考文档： https://github.com/microsoft/skill-recorder/blob/b05d59036182e897e1a60e90651e775cf5f97e8d/INSTALL.md#inspect-first-installation

完整变更日志：https://github.com/microsoft/skill-recorder/compare/v0.6.2...v0.7.0

附件

• v0.7.0.zip（源码包）｜9 月 21 日
• v0.7.0.tar.gz（源码包）｜9 月 21 日

术语备注

• Skill Recorder：微软的 Skill Recorder，用于录制、生成 Scout 智能体 Skill（技能）
• Scout：微软智能体 Scout
• frontmatter：Markdown 文件头部的 YAML 前置元信息
• commit-pinned：绑定固定 Git 提交号，保证安装的代码版本精确不变
• regression test：回归测试
• race：并发竞态问题