小云的 AI 开发实践

外观

Copilot Release Notes 验证记录 ​

日期：2026-10-16。首次本地检查和临时分支预览通过后，ADV.JS PR #70 与 AI PR #2 已合并；正式入口复验发现分析 job 的浅克隆遗漏，修复和回归见下节。全程未创建测试 Release。

验证对象 ​

实现提交：2dff2b75。工作流使用 gh-aw v0.92.0 编译，Copilot CLI 版本由编译器锁定为 1.0.96，copilot-requests: write 提供内置 GITHUB_TOKEN 认证。未新增 PAT、模型 API key 或 Actions secret。

由于新工作流尚未出现在默认分支，GitHub API 不能直接按文件名 dispatch。在临时验证分支中，仅将已有 ci.yml 改为调用同一份 release-notes-zh.lock.yml；该验证入口不进入集成 PR，也不运行发布事务。

云端结果 ​

场景结果与证据
手动补丁版预览运行 38850664781，成功
预览参数tag=core-v0.1.2、dry_run=true、automatic=false
解析范围目标 8a62e9be8444496eaa4f0e7e1d9fa3bba95a1dd0；同系列无较早 tag，比较起点为空
实际执行pre-activation、activation、Copilot agent、检测、publish_release_notes、conclusion 全部成功
生成内容release-notes-zh-38850664781 artifact 内的 release-notes-zh-preview.md；中文摘要与管理区块已生成，核验其 commit 链接均属于目标历史
自动补丁版筛选运行 38850942124，成功；同一 tag、automatic=true，pre-activation 通过，agent、检测和发布 job 全部跳过

预览文件 SHA-256：4c7ab46ef6cb2223a6726a4204ed686ca8bb75e23302d25213d38923ce9d8431。摘要 artifact 默认保留 14 天；运行日志按仓库 Actions 保留策略保存。

验证时仓库尚无 GitHub Release。预览没有创建 Release，也未执行真实正文 PATCH。正式主／次版本自动筛选、原文保留、仅修改 body 和重复运行行为由下列回归测试覆盖；首次正式发布仍需检查页面最终呈现。

本地检查 ​

  • gh aw compile release-notes-zh --validate：通过，0 warnings；使用固定的 v0.92.0 原生二进制。
  • 四个发版测试文件合计 49 项：通过，覆盖真实 Git 历史、版本边界、预检查、幂等、管理区块替换及定向 API 更新。
  • 改动文件 ESLint、git diff --check：通过。
  • pnpm docs:check：通过，48 个文件。
  • pnpm docs:build：通过；TypeDoc 有既有标签告警，0 errors。
  • actionlint v1.7.12：其尚不支持 copilot-requests、concurrency.queue 和 gh-aw 生成的 job.workflow_* 字段；仅排除这三类诊断后通过，GitHub 云端也已接受并运行相同工作流。

gh-aw 的 Docker 扫描器未运行，本记录不将编译成功等同于容器扫描通过。

合并后复验与历史检出修复 ​

默认分支的自动补丁版筛选成功；首次手动预览失败，未发布摘要。代理先尝试本地 Git，得到目标提交 fatal: bad object，随后 GitHub MCP 的历史提交响应被完整性策略全部过滤，因而报告 missing_data。目标 SHA 已正确传入；首次发布的空起点不属于缺失数据。

原因是预检查和分析 job 使用不同的 checkout。初版只为预检查配置完整历史，分析 job 仍使用默认浅克隆。模板现已补上顶层 checkout.fetch-depth: 0，并明确优先读取本地 Git；原有 MCP 完整性过滤保留。

新增回归测试从实际编译的分析 job 读取 checkout 深度，以真实 Git 仓库复现历史提交读取：修复前连续出现 bad object，修复后通过。发版相关测试总数由 49 增至 50。修复后的云端运行可在 ADV.JS 中文 Release Notes 工作流查看；需要同时确认整体成功和预览 artifact，不能只看 agent job 成功。

双语设计与验证 ​

2026-10-16 的双语改动见 ADV.JS PR #72 与 AI PR #4。工作流文件名保留 release-notes-zh.lock.yml；显示名改为“AI Release Notes”。本节保留 PR 阶段的验证，默认分支的启用情况见下节。

默认 language=both，手动可选 zh-CN、en。一次分析后生成请求语言，已有另一语言作翻译对照；默认只补缺失语言，force 只重写所选语言。新生成摘要必须有可点击的 PR/commit 引用，双语同时生成时引用 URL 集合必须一致；这不替代语义审阅。

首轮双语预览 38866174171链路成功，但人工检查发现来源用了裸 SHA，因此增加可点击引用和双语引用集合检查，再运行最终预览。

最终预览：运行 38866967520，实现提交 f45afb28，参数为 tag=core-v0.1.2、language=both、dry_run=true。整体及 pre-activation、Copilot agent、检测、预览发布、conclusion 均成功。

产物为 release-notes-38866967520 artifact 内的 release-notes-preview.md，SHA-256 为 1dd18baf0251511f50862a821d4911c7d4c536214b6c49480d4a0bad5f4719b4，默认保留 14 天。产物包含中英文、对应分类和六个完全一致的完整 commit URL，逐一确认均为目标 core-v0.1.2 的可达历史。未自动验证摘要完整覆盖所有变化。

另以相同实现提交运行仅英文预览 38868360367，参数 language=en、tag=core-v0.1.2、dry_run=true；整体成功。产物只有英文分区及 English 导航，没有中文区块或失效的中文链接。SHA-256 为 bcd43aeca3d83005abfd4b548554ae91599e925538233e3b16b86a172897a4a1。

本地及渲染检查：

  • 62 项发版回归通过，覆盖单双语、补缺失语言、旧中文区块按字节保留、按语言重写、请求语言完整性、引用集合、重复调用、原文保留和真实 Git 历史。
  • 通过真实 CLI 与本地 HTTP 模拟服务器验证：预检查输出为单行 JSON、旧中文仅补英文、dry-run 不 PATCH、正式调用仅 PATCH body、重复调用不写入、完整双语在模型前跳过。未向真实 Release API 写入。
  • GitHub Markdown API 实际渲染保留两个默认展开的 <details>；导航 fragment 均能匹配渲染后的锚点。GitHub 会给 ID 添加 user-content- 前缀，导航已相应适配。
  • 在 PR #72 正文样例中实测语言导航与折叠中文后阅读英文。GitHub 单一正文使用导航和折叠，不提供互斥标签页或语言偏好存储。
  • gh-aw v0.92.0 编译 0 warnings，改动文件 ESLint、ADV.JS 文档检查与构建通过；actionlint 使用前节相同的窄范围诊断排除。
  • 模板脚本与 ADV.JS 一致；本仓库 18 项测试、lint、类型检查和文档构建通过。

全程没有创建 GitHub Release、PAT、模型 API key 或 Actions secret。真实正文更新的保护通过回归与本地 HTTP 模拟验证；云端运行使用仓库所有者的 Copilot 额度，但只生成预览 artifact。

双语工作流默认分支复验 ​

2026-10-16，ADV.JS PR #72 合并到默认分支 dev，合并提交为 2e7cae5c。合并前最新提交的 28 项检查通过，另 3 项按配置跳过或中性结束。通用 E2E 首轮在仓鼠 Demo 的运行时初始化等待超时；相同提交重跑通过，没有修改游戏逻辑或测试断言，首轮超时的根因未确认。

GitHub 工作流注册信息为 id=386363504、name=AI Release Notes、state=active。默认分支的源码和编译配置均已核对：language 默认 both，手动选项为 both / zh-CN / en，现有发布流程仍在发布事务和桌面附件成功后以 automatic=true 调用该工作流。Copilot 继续使用 github.token，没有新增 PAT 或模型密钥。

复验运行与结果
省略 language 的默认双语预览运行 38870751064，整体及 Copilot、检测、预览发布、conclusion 均成功
自动补丁版筛选运行 38870746274，成功；只执行预检查，模型、检测与发布 job 均跳过

两次均从默认分支 dev 的合并提交运行，使用 tag=core-v0.1.2、dry_run=true。默认双语预览未传 language，确认默认值实际生效；自动补丁版运行另传 automatic=true，确认模型调用前的版本筛选生效。

产物 release-notes-38870751064 中的 release-notes-preview.md 已检查：包含中英文区块、两个默认展开的语言分区及对应导航，引用集合一致。六个 commit URL 均在目标 tag 历史内，两个 PR 引用均已合并，且其合并提交也在该历史内。产物 SHA-256 为 68b49c35b9da531bb0ce1d641ada7bdeea658149eabbdeee8078a26c36621e93。模板脚本与 dev 实现一致。

这确认了 ADV.JS 默认分支的双语工作流已启用，后续正式主／次版本可走现有发布流程，补丁版使用手动入口。本次仅做预览，没有创建或修改正式 Release；真实正文更新保护仍由前述回归与本地 HTTP 模拟验证。

npm 0.1.4 正式 Release 补生成 ​

2026-10-16，为用户指定的 npm 正式版补建 ADV.JS v0.1.4。此前没有 GitHub Release，也没有 v0.1.4 tag。advjs@0.1.4 与 @advjs/core@0.1.4 的 npm provenance 均指向提交 55584d6f3cd903d74c985e6b8fcd27dbbc3394db，其 subject digest 与 npm tarball integrity 一致；新 tag 指向该提交。采用 v 系列，不触发 core-v* 的 npm 发布流程。

完整 changelog 由仓库现有生成器按 v0.1.0-beta.1..55584d6f 恢复并作为 Release 初始正文，共 22,295 字节，SHA-256 为 52b08a71caae9c77b7b4ff6d5469de0e2e9d36b2e63752a6654fca0aa36c7564。这是累计变更范围，不代表只比较 npm 0.1.3 到 0.1.4。

从默认分支 dev 手动运行 38873463874，参数为 tag=v0.1.4、from_tag=v0.1.0-beta.1、language=both、automatic=false、dry_run=false、force=false。Copilot、检测、真实发布及 conclusion 全部成功。核对结果：

  • 两种语言引用 URL 集合一致，所有引用提交均属于指定范围；正文重复合并不会再写入。
  • AI 区块之外的 changelog 按字节完整保留；Release ID、标题、tag、目标提交、正式发布标记和附件未变。
  • 真实页面最初使用空 id 锚点，点击 English 后 fragment 已改变，但目标仍在视口下方约 1,061 像素。单独删除链接前缀、改用不带前缀的命名锚点均未修复。
  • 将目标改为 name 并保留链接的 user-content- 前缀后，英文目标进入视口顶部约 59 像素，中文回跳也正常。只修正布局，保留模型摘要与完整 changelog；修复同步到发布脚本与复用示例。
  • 实测中文、英文可分别折叠和展开；两种语言均折叠时，下方原始 changelog 仍可阅读。默认仍为两种语言展开，导航负责定位，折叠内容由读者展开。

此次真实写入继续使用 Actions 的 GITHUB_TOKEN 和仓库所有者的 Copilot 额度，没有创建 PAT、模型密钥或 Actions secret，也没有重新发布 npm 包。前两节的预览记录不等于本次真实 Release 页验收。

中文优先的折叠布局 ​

2026-10-16，按用户阅读偏好优化 v0.1.4 实际 Release 页：中文默认展开，英文和完整 changelog 默认折叠。此处替代前节“两种语言默认展开”的展示策略；历史验证记录保留当时状态。仅英文的生成结果仍默认展开英文，由回归测试覆盖。

命名锚点移入各自 <details> 的内容内，继续链接到带 user-content- 前缀的目标。实际页面复验：

  • 以不带 fragment 的 URL 重新加载，三个分区的状态分别为中文展开、英文折叠、完整记录折叠。
  • 点击 English 后自动展开英文并滚动到目标；点击“完整变更记录”同样自动展开并定位。展开完成后，目标位置分别约为视口顶部 0.008 和 0.203 像素。
  • 英文分区使用 Enter 可折叠和重新展开；中文、英文、完整记录分别使用原生分区控件。
  • 中英文管理区块逐字不变；折叠容器内的原始 changelog 仍为 22,295 字节，SHA-256 仍为 52b08a71caae9c77b7b4ff6d5469de0e2e9d36b2e63752a6654fca0aa36c7564。Release ID、标题、tag、目标提交、正式发布标记和附件未变。

发布脚本与复用示例提供独立 layout 入口，只更新排版，不读取模型输出或调用 Copilot。使用实际 Release 数据的 CLI 与本地 HTTP 验证确认：预览不 PATCH，正式写入只发送 body，重复执行不写入，预览结果与真实页面正文一致。损坏、重复或错位的 changelog 标记会停止更新；完整 changelog 不会重复嵌套折叠。

本地 65 项 ADV.JS 发版回归、相关 ESLint 和文档检查通过；AI 仓库 18 项测试、lint、类型检查与文档构建通过。脚本和模板一致，工作流认证与版本筛选规则不变，本次排版优化没有重新生成摘要或消耗 Copilot 额度。

跨仓库复用验证 ​

2026-10-16，经仓库所有者明确选择，YunYouJun/ai 已改为公开仓库。GitHub 的访问规则只允许公开调用方引用公开的 reusable workflow；此前 ADV.JS 的调用因此被拒绝，未调用模型或修改 Release。

公共入口为 .github/workflows/release-notes.lock.yml@release-notes-v1。首次发布时版本标签指向已通过验证的提交 8023830649c9050b3f41a81fd0f88452524cd253；当次 ADV.JS 固定引用相同的完整 SHA。后续兼容更新见下节。其他仓库只需安装 14 行的自动调用示例，或使用带手动输入的完整示例，不需要复制脚本、安装 gh-aw、配置 PAT 或 secrets: inherit。

预检查和发布 job 按 job.workflow_sha 加载同版本 ai 脚本，分析 job 则检出调用方完整历史。最初的云端试运行发现 gh-aw 默认跳过跨仓库的配置检出，导致 runtime-import 找不到提示词；修复后 activation 提前检出同一 ai 提交的提示词，并有回归检查保证其位于模板渲染之前。

真实 Copilot 跨仓库预览 38887751780 的预检查、activation、agent、检测、预览发布和 conclusion 全部成功：

  • 调用方为 YunYouJun/advjs，目标为 core-v0.1.2，SHA 为 8a62e9be8444496eaa4f0e7e1d9fa3bba95a1dd0；激活产物中的实际提示词与范围一致，未使用 ai 仓库的历史。
  • 中英文摘要的 8 个提交引用集合完全一致，均可从目标提交追溯。中文展开、英文折叠；此 tag 没有 GitHub Release，因此预览不包含原 changelog。
  • release-notes-38887751780 artifact 中预览为 3,766 字节，SHA-256 为 bed72c2b360031ca0ac555fce99ec25ecb85abbccdf1cac6c95cf2a2bdc8cb8d。
  • 调用链使用 ADV.JS 的 GITHUB_TOKEN 和 Copilot 请求权限，无 PAT 或模型密钥；dry_run=true 不执行正文 PATCH。

已有双语版本复验 38887796355 使用 tag=v0.1.4、language=both、force=false、automatic=false。预检查成功，所有模型和发布 job 均跳过，证明手动补丁版调用可以在摘要齐全时结束。

前后对比确认，现有 v0.1.4 Release 的 ID、tag、标题、目标、正文、附件、草稿和预发布标记、创建时间、发布时间和更新时间全部不变。正文 SHA-256 为 06a7b18f0e771c10d12b7fdc63c56a72167727556157f908ae32f5137e8d881e。集中渲染器对该正文返回 changed=false，中文优先的折叠布局和原 changelog 原文保持不变。

本地验证包括 gh-aw v0.92.0 编译、actionlint、ai 的 73 项测试、lint、类型检查和文档构建，以及 ADV.JS 的 17 项调用与发版回归。生成器测试集中在 ai；ADV.JS 只维护调用接口和原有发布事务。

手动输入的集中维护 ​

2026-10-16，新增 release-notes.yml 事件入口。调用方用 15 行配置同时支持自动发布与手动 tag，只有一个必须声明的 tag 字段，不再复制多个输入或 with 映射。高级使用只增加可选 options JSON；既有 release-notes.lock.yml typed API 保持兼容，发版事务直接调用它，不需要中间仓库再次声明 workflow_call.inputs。

发布 release-notes-v1.1.0，并将兼容别名 release-notes-v1 快进到实现提交 d62e0cf890a0999c027c8e2589808b0f314d2de9；ADV.JS 两个入口固定引用相同提交。别名更新使用 force=false，没有覆盖分叉历史。GitHub 的手动表单仍需在调用方声明，未使用不存在的输入 schema 继承能力，也未改用 ai 仓库的令牌。

只填 tag 的验证 38891625132 使用 tag=v0.1.4，没有 options。请求允许进入补丁版手动检查，随后因 already-generated 跳过，所有模型和发布 job 均未运行。

JSON 英文预览 38891611437 使用 tag=core-v0.1.2 和 options={"language":"en","dry_run":true}，预检查、activation、真实 Copilot 分析、检测、预览发布和 conclusion 全部成功：

  • 实际提示词指向调用方 YunYouJun/advjs，目标 SHA 8a62e9be8444496eaa4f0e7e1d9fa3bba95a1dd0，请求语言只有 en。
  • 预览仅包含英文区块，英文默认展开；7 个提交引用均属于目标历史。产物 release-notes-38891611437 共 2,110 字节，SHA-256 为 5588c0caf4b31b6765f5194614af3ad466229d2c52cc62c1e033395148ac722e。
  • options JSON 在预检查和发布端使用同一解析器。未知键、无效类型和无效语言在模型前失败；不能改写 tag 或自动模式，不能用 JSON 关闭已启用的 dry-run／staged 保护。
  • 现有 v0.1.4 的正文、附件、tag、标题、目标、正式标记、创建时间、发布时间和更新时间全部不变；正文 SHA-256 仍为 06a7b18f0e771c10d12b7fdc63c56a72167727556157f908ae32f5137e8d881e。

本地 78 项集中测试、编译、actionlint、lint、类型检查和文档构建通过；包含真实 CLI + 本地 HTTP 的 JSON 选项验证，确认预览只 GET、不 PATCH，原文逐字保留。ADV.JS 的 17 项调用与发版回归及文档检查通过。用户界面与 CLI 的进阶选项统一为 options，例如旧的 -f language=en -f force=true 改为 -f options='{"language":"en","force":true}'。

运维入口 ​

日常操作、补生成、强制替换及额度说明见ADV.JS AI 双语 Release Notes。复用模板和个人／组织计费差异记录在 复用指南。