universal-dev-standards 6.0.0 → 6.1.1

package/bundled/locales/zh-CN/README.md

@@ -1,9 +1,9 @@
 ---
 source: ../../README.md
-source_version: 5.17.0
-translation_version: 5.17.0
-last_synced: 2026-06-10
-source_hash: 651c07df0abe
+source_version: 6.0.0
+translation_version: 6.0.0
+last_synced: 2026-07-08
+source_hash: add024721b5a
 status: current
 ---
 
@@ -15,7 +15,7 @@ status: current
 
 > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
 
-**版本**: 6.0.0 | **发布日期**: 2026-07-06 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 6.1.1 | **发布日期**: 2026-07-18 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
 
 语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流，确保不同技术栈之间的一致性、质量和可维护性。
 
@@ -62,7 +62,7 @@ npx universal-dev-standards init
 | 我想要... | 文档 |
 |---|---|
 | **UDS 新手？** 5 分钟快速上手 | [docs/user/GETTING-STARTED.md](docs/user/GETTING-STARTED.md) |
-| 按 Tier & Category 浏览全部 54 个技能 | [docs/user/SKILLS-INDEX.md](../../docs/user/SKILLS-INDEX.md) |
+| 按 Tier & Category 浏览全部 55 个技能 | [docs/user/SKILLS-INDEX.md](../../docs/user/SKILLS-INDEX.md) |
 | 查看所有斜线命令 | [docs/user/COMMANDS-INDEX.md](../../docs/user/COMMANDS-INDEX.md) |
 | 快速参考卡片 | [docs/user/CHEATSHEET.md](docs/CHEATSHEET.md) |
 | 常见问题 | [docs/user/FAQ.md](docs/user/FAQ.md) |
@@ -76,10 +76,10 @@ npx universal-dev-standards init
 <!-- UDS_STATS_TABLE_START -->
 | 类别 | 数量 | 说明 |
 |----------|-------|-------------|
-| **核心标准** | 146 | 通用开发准则 |
+| **核心标准** | 149 | 通用开发准则 |
 | **AI Skills** | 55 | 互动式技能 |
 | **斜线命令** | 51 | 快速操作 |
-| **CLI 命令** | 6 | list, init, configure, check, update, skills |
+| **CLI 命令** | 21 | 项目设置与维护 |
 <!-- UDS_STATS_TABLE_END -->
 
 > **5.0 新功能？** 请参阅[预发布说明](../../docs/PRE-RELEASE.md)了解新功能详情。
@@ -117,8 +117,8 @@ graph TD
 
 | AI 工具 | 状态 | Skills | 斜线命令 | 配置文件 |
 | :--- | :--- | :---: | :---: | :--- |
-| **Claude Code** | ✅ 完整支持 | **29** | **33** | `CLAUDE.md` |
-| **OpenCode** | ✅ 完整支持 | **29** | **33** | `AGENTS.md` |
+| **Claude Code** | ✅ 完整支持 | **55** | **51** | `CLAUDE.md` |
+| **OpenCode** | ✅ 完整支持 | **55** | **51** | `AGENTS.md` |
 | **Cursor** | ✅ 完整支持 | **核心** | **模拟支持** | `.cursorrules` |
 | **Roo Code** | ✅ 完整支持 | **核心** | **工作流** | `.roo/rules/` |
 | **Gemini CLI** | 🧪 预览版 | **18+** | **20+** | `GEMINI.md` |

package/bundled/locales/zh-CN/SECURITY.md

@@ -13,8 +13,8 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支持状态 |
 |------|--------|
-| 5.17.0 | ✅ 最新正式版 |
-| < 5.0.0 | ❌ 已终止支持 |
+| 6.0.0 | ✅ 最新正式版 |
+| < 6.0.0 | ❌ 已终止支持 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->
 
 > **说明**：仅最新正式版与当前预发布分支会收到安全更新。

package/bundled/locales/zh-CN/ai/options/commit-message/bilingual.ai.yaml

@@ -4,7 +4,7 @@
 id: bilingual
 meta:
   parent: commit-message
-  version: "1.0.0"
+  version: "1.1.0"
   description: 混合团队的雙語格式
   language: zh-CN
 
@@ -85,6 +85,11 @@ rules:
     instruction: 以雙語撰写內文，英文優先
     priority: recommended
 
+  - id: mid-conversation-language-drift-check
+    trigger: AI 助手在长对话中处理大量非目标语言内容（代码、log、英文文档）后切回用户对话文字时
+    instruction: 下一段用户对话文字发出前先自我核对是否使用目标语言，不需等用户指出；用户已指出语言跑偏时，下一则回复立即修正，不重复道歉拖延
+    priority: recommended
+
 examples:
   simple: "feat(auth): Add login form. 新增登入表单."
   with_body: |

package/bundled/locales/zh-CN/core/browser-compatibility-standards.md

@@ -1,20 +1,21 @@
 ---
 source: ../../../core/browser-compatibility-standards.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-10
-source_hash: 56b7d0fbf522
-status: stale
+source_version: 1.0.2
+translation_version: 1.0.2
+last_synced: 2026-07-08
+source_hash: d4a9c4e89256
+status: current
 ---
 
 # 浏览器兼容性标准
 
 > **语言**: [English](../../../core/browser-compatibility-standards.md) | [繁體中文](../../zh-TW/core/browser-compatibility-standards.md) | 简体中文
 
-**版本**：1.0.0
-**最后更新**：2026-05-05
+**版本**：1.0.2
+**最后更新**：2026-06-18
 **适用范围**：前端项目（Web 应用、渐进式 Web 应用 PWA、Web Components）
 **范围**：universal
+**负责规格**：XSPEC-293（与 XSPEC-209 路由覆盖率正交）
 **行业标准**：Browserslist、W3C WebDriver、WebDriver BiDi
 **参考资料**：[caniuse.com](https://caniuse.com/)、[Playwright 浏览器支持矩阵](https://playwright.dev/docs/browsers)
 
@@ -36,6 +37,13 @@ status: stale
 | **Tier-2**（部分支持） | 尽力支持；主要流程必须可运行 | ≥ 95% 通过 —— 低于则 WARN，< 90% 则 FAIL |
 | **Tier-3**（尽力而为） | 非正式支持；缺陷会记录但不阻断发布 | 仅作为建议参考 |
 
+> **Tier-2 `≥95%` / `<90%` 阈值 —— 依据与可配置性**：这些是 UDS 默认值，可依项目配置。
+> Tier-2 是「尽力支持，主要流程必须可运行」，因此门禁容许少量非关键失败的尾量：
+> `≥95%` = 健康（低于则 WARN，用于提示排查）；`<90%` = 实质性回归（FAIL）。
+> 请依你的目标市场浏览器覆盖率调整——例如依 Browserslist 市场占比配置（`> 0.5%` 等）
+> 推导 Tier-2 浏览器集合与通过门槛。**例外**：当失败的 Tier-2 案例皆为非关键流程
+> （以 Tier-3 类型缺陷记录）时，发布负责人可在记录理由后覆盖 WARN/FAIL 判定。
+
 ---
 
 ## 默认浏览器矩阵
@@ -218,6 +226,8 @@ last 2 ChromeAndroid versions
 
 | 版本 | 日期 | 变更内容 |
 |---------|------|---------|
+| 1.0.2 | 2026-06-18 | 新增：Tier-2 95%/90% 阈值的依据、可配置性与例外说明（XSPEC-292 T8 / XSPEC-293 AC-293-2） |
+| 1.0.1 | 2026-06-18 | 新增：负责规格指标 → XSPEC-293（XSPEC-291 §11） |
 | 1.0.0 | 2026-05-05 | 首次发布：Tier-1/2/3 矩阵、Playwright 配置、云端测试、发布门禁条件 |
 
 ---

package/bundled/locales/zh-CN/core/cost-budget-test.md

@@ -3,7 +3,7 @@ source: ../../../core/cost-budget-test.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-06-10
-source_hash: 19cf2a8cd706
+source_hash: 88b78e9c7e7c
 status: current
 ---
 

package/bundled/locales/zh-CN/core/cross-flow-regression.md

@@ -1,20 +1,21 @@
 ---
 source: ../../../core/cross-flow-regression.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-10
-source_hash: ac618caf6d7f
-status: stale
+source_version: 1.0.1
+translation_version: 1.0.1
+last_synced: 2026-07-08
+source_hash: 33da58d89648
+status: current
 ---
 
 # 跨流程回归（Cross-Flow Regression）
 
 > **语言**：[English](../../../core/cross-flow-regression.md) | [繁體中文](../../zh-TW/core/cross-flow-regression.md) | 简体中文
 
-**版本**：1.0.0
-**最后更新**：2026-05-05
+**版本**：1.0.1
+**最后更新**：2026-06-18
 **适用范围**：所有具有多个 user flow 或业务流程的软件项目
 **Scope**：universal
+**所属规格**：XSPEC-294（与 flow-based-testing 互补，无重叠）
 **业界标准**：ISTQB Advanced Test Analyst（Regression Test Strategy）
 **参考资料**：`core/flow-based-testing.md`、`core/testing-standards.md`
 

package/bundled/locales/zh-CN/core/flaky-test-management.md

@@ -3,7 +3,7 @@ source: ../../../core/flaky-test-management.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-06-10
-source_hash: ed870e072b63
+source_hash: 04c9ce181011
 status: current
 ---
 

package/bundled/locales/zh-CN/core/flow-based-testing.md

@@ -1,18 +1,18 @@
 ---
 source: ../../../core/flow-based-testing.md
-source_version: 1.3.0
-translation_version: 1.3.0
-last_synced: 2026-06-10
-source_hash: a8838e95f84e
-status: stale
+source_version: 1.3.1
+translation_version: 1.3.1
+last_synced: 2026-07-08
+source_hash: afadaebc0f49
+status: current
 ---
 
 # 流程式测试（Flow-Based Testing）
 
 > **语言**: [English](../../../core/flow-based-testing.md) | [繁體中文](../../zh-TW/core/flow-based-testing.md) | 简体中文
 
-**版本**: 1.3.0
-**最后更新**: 2026-05-05
+**版本**: 1.3.1
+**最后更新**: 2026-06-18
 **适用性**: 所有具备多步骤工作流程的软件项目
 **范围**: universal
 **行业标准**: ISO/IEC/IEEE 29119-4（测试技术）、ISTQB Foundation Syllabus
@@ -120,7 +120,7 @@ describe("Flow Branch: Quota exceeded path", () => {
 
 ## 与其他标准的关系
 
-- **test-completeness-dimensions**：维度 9（Flow Completeness）与维度 10（Branch Coverage）在此定义
+- **test-completeness-dimensions**：定义了 **8** 个维度。Flow Completeness 与 Branch Coverage（决策表）的细节在本标准中说明——它们并非该标准中编号的维度 9/10（该标准仅有 8 个维度）
 - **behavior-driven-development**：BDD Scenario Outline 表格对应到决策表展开
 - **mock-boundary**：流程测试必须遵守 mock boundary 规则（不 mock 自身模块逻辑）
 - **e2e-testing**：旅程测试在 ST 或 E2E 级别运行；流程测试可在 IT 级别搭配真实 DB 运行

package/bundled/locales/zh-CN/core/frontend-design-standards.md

@@ -3,7 +3,7 @@ source: ../../../core/frontend-design-standards.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-04-20
-status: current
+status: stale
 ---
 
 # 前端设计标准

package/bundled/locales/zh-CN/core/full-coverage-testing.md

@@ -2,8 +2,8 @@
 source: ../../../core/full-coverage-testing.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-10
-source_hash: e05fa172a6ee
+last_synced: 2026-07-08
+source_hash: 8ca921c68533
 status: current
 ---
 
@@ -171,6 +171,74 @@ CI 会回报 AC 覆盖率。若超过 20% 的 AC 没有 `@ac` 标签的测试，
 
 ---
 
+## 迁移错误路径完整性（XSPEC-288）
+
+> 属于 [XSPEC-284](https://github.com/AsiaOstrich/universal-dev-standards) 9 轴迁移完整性矩阵的**轴⑨（错误路径）**。上述三路径模型要求**每个函数**都有错误路径；本节新增**迁移专属**保证——legacy 的错误/降级/fallback 分支被**系统性**移植，而非仅抽样。
+
+### 为何三路径模型对迁移还不够
+
+每函数错误路径要求与 XSPEC-201 的错误路径快照，只验证你**想到要枚举**的错误案例。重写时 happy path 因有明确需求而被迁移，而错误分支——散落于 `try/catch` 层级、自定义异常层级、特定错误码、降级 fallback——**被整批静默遗漏**。通过的错误路径抽样**不能证明没有分支被遗漏**（与 #134 同源盲区，只是发生在错误路径层）。本节是快照机制之上的**系统性枚举 + gap 分析**层。
+
+### 步骤 1 — 机械化 legacy 异常/错误码清单（derive，R1）
+
+**机械化**枚举 legacy 错误面，而非依赖人脑回忆：
+
+| 来源 | 推导出 |
+|--------|--------|
+| `catch` / `except` / `rescue` 区块（grep） | 每个捕获的异常类型 + handler |
+| 自定义异常/错误类层级 | 声明的错误分类法 |
+| 错误/状态码（HTTP status、app 错误码、错误 enum） | 响应码面 |
+| 错误响应形状（serializer、错误 DTO） | on-the-wire 错误契约 |
+
+捕获到的清单即**错误路径待验清单**——来自 artifact 而非人脑回忆。
+
+### 步骤 2 — 系统性遗漏分支 gap 分析（oracle，R2）
+
+对步骤 1 的**每条** legacy 错误分支，验证新系统有对应 handler。无对应者标记为 `not_implemented`（XSPEC-199）并**阻止**。产出覆盖完整推导清单的**「遗漏错误分支」gap 报告**——而非仅抽样通过。
+
+```markdown
+## Error-Path Gap Report — <module>
+
+| Legacy branch (error type / code) | New-system handler | Status |
+|-----------------------------------|--------------------|--------|
+| PaymentDeclinedException → 402 | PaymentService.handleDecline | MAPPED |
+| GatewayTimeout → retry+fallback | (none found) | not_implemented — BLOCK |
+| ValidationError → 422 + field list | InputValidator | MAPPED |
+
+**Branches: N total · M mapped · K not_implemented (block if K>0)**
+```
+
+### 步骤 3 — 降级/Fallback 对等（R3）
+
+legacy 降级模式（外部服务失败时的 fallback、重试、部分结果）因仅在失败时才执行而容易被遗漏。验证新系统保留对应降级行为，避免「正常路径一致、失败时行为迥异」：
+
+- [ ] 外部服务失败的 **fallback** 行为与 legacy 一致
+- [ ] **重试**策略（次数、backoff、放弃条件）与 legacy 一致
+- [ ] **部分结果**处理与 legacy 一致（尽量返回 vs all-or-nothing）
+- [ ] **熔断器/超时**降级与 legacy 一致
+
+### 步骤 4 — 错误响应差分（oracle，R4）
+
+把 [behavior-snapshot](behavior-snapshot.md) 对等与 XSPEC-284 R5 replay 延伸至涵盖**错误响应**，而不只是 happy-path 响应。比对新旧系统：
+
+- **错误码**（HTTP status、app 错误码）
+- **消息结构**（错误 DTO 形状、字段级错误）
+- 各错误类的 **HTTP status** 映射
+
+这让隐性错误路径分歧在 cutover 时自我暴露，如同 happy-path 快照一样。
+
+**Gate 时机**：pre-UAT（gap 分析 + 降级对等）+ cutover 前后（错误响应差分）。
+
+### 重要性分级（范围指引）
+
+并非每条 legacy 错误分支都同等优先。按**生产实际触发频率**排序（呼应 #134「以生产为准」）：生产日志中实际触发过的分支优先对应；从未触发的潜在分支优先级较低但仍列入。高频生产错误分支若无新系统对应即为硬阻止。
+
+### 完整性声明（矩阵对齐）
+
+当本节声明以下三者——**derive**（步骤 1 机械化异常/错误码清单）、**oracle**（步骤 2 系统性 gap 分析 + 步骤 4 错误响应差分）、**gate 时机**（pre-UAT + cutover 前后）——即满足轴⑨。复用 XSPEC-201 错误路径快照 + 上述三路径模型——本节只新增系统性遗漏分支分析与错误响应差分，不重建测试框架。
+
+---
+
 ## 从金字塔模型迁移
 
 若你的项目先前使用金字塔门槛：
@@ -191,7 +259,11 @@ CI 会回报 AC 覆盖率。若超过 20% 的 AC 没有 `@ac` 标签的测试，
 - `unit-testing.ai.yaml` — 单元测试范围与组织
 - `integration-testing.ai.yaml` — 集成测试模式
 - `deployment-standards.ai.yaml` — 部署闸门需求
+- `flaky-test-management.md` — 间歇性失败处理：会 flaky 的测试**不算**通过的测试。覆盖率数字计入闸门前，间歇性失败必须（MUST）依该标准隔离/设定重试预算/根因排查——否则「全覆盖」会掩盖非确定性缺口。
+- `behavior-snapshot.md` — 错误响应差分 oracle（迁移错误路径完整性，轴⑨）
+- `migration-assistant` skill — legacy 异常/错误码 derive + 降级对等（XSPEC-288）
 - XSPEC-178 — 完整规格与实现阶段
+- XSPEC-288 — 迁移错误路径完整性（XSPEC-284 矩阵轴⑨）
 
 
 **Scope**: universal

package/bundled/locales/zh-CN/core/license-compliance.md

@@ -3,7 +3,7 @@ source: ../../../core/license-compliance.md
 source_version: 2.1.0
 translation_version: 2.1.0
 last_synced: 2026-06-10
-source_hash: 8a754039a2b5
+source_hash: 8ac1763bd1a1
 status: current
 ---
 
@@ -15,6 +15,8 @@ status: current
 > **AI 优化版本**: `ai/standards/license-compliance.ai.yaml`
 > **Agent Spec**: ASPEC-001 (cross-project/aspec/ASPEC-001-license-compliance-agent.md)
 
+**Scope**: universal
+
 ## 概述
 
 面向 AI 增强开发的完整许可证合规标准，涵盖通用 OSS 实践（Tier 1）以及针对 AI 生成代码的 AI 专属规则（Tier 2）。

package/bundled/locales/zh-CN/core/logging-standards.md

@@ -1,18 +1,18 @@
 ---
 source: ../../../core/logging-standards.md
-source_version: 1.3.0
-translation_version: 1.3.0
-last_synced: 2026-06-10
-source_hash: 7853d510d681
-status: stale
+source_version: 1.4.0
+translation_version: 1.4.0
+last_synced: 2026-07-08
+source_hash: 732277ef939f
+status: current
 ---
 
 > **语言**: [English](../../../core/logging-standards.md) | 简体中文
 
 # 日志标准
 
-**版本**: 1.3.0
-**最后更新**: 2026-05-26
+**版本**: 1.4.0
+**最后更新**: 2026-06-17
 **适用范围**: 所有软件项目
 **范围**: universal
 **行业标准**: RFC 5424, OpenTelemetry, W3C Trace Context
@@ -24,6 +24,81 @@ status: stale
 
 本标准定义日志记录的最佳实践，确保日志的一致性、结构化和可操作性。
 
+## 强制事件（Mandatory Events）
+
+> **关闭** UDS issue [#108](https://github.com/AsiaOstrich/universal-dev-standards/issues/108)（XSPEC-234）。本标准其余部分定义**如何**写一条日志（级别／字段／PII 脱敏／轮转）；本节定义**何时必须写**——把「格式合规但实质沉默」的日志排除在外。
+
+遵守所有格式规则、却**在关键时刻从不触发**的日志比没有日志还糟：它在事故发生时给人一种虚假的安全感。以下事件是**必须**写日志的 canonical 时机，每项声明 `when`／`must_log`／`must_NOT_log`／`level`／`rationale`。
+
+### 为何需要（真实事故）
+
+某次 PHP→.NET 迁移耗费 2 天诊断「发送失败、没有日志」，原因是**四层全部沉默**：
+
+1. **负载均衡器将后端标记为 DOWN**（503）——health probe 超时；后端只记录了 probe 噪音，零业务事件。
+2. **框架验证 reject**（如 ModelState／DTO 501）——校验框架在任何 handler 执行前就返回，**payload 从未被记录**。
+3. **认证失败**只记录了「Account or password error」——**无 uid、无 source IP** → 无法排查。
+4. **后台 worker 仍存活，但日志文件 0 字节**——没有机制检测到这种沉默。
+
+以上都无法仅靠格式规则捕捉，强制事件补上这一缺口。
+
+### 类目（9 个 canonical 事件）
+
+| id | when（时机） | level | 核心必填字段（`must_log`） | `must_NOT_log` |
+|----|------|-------|-----------------------------------|----------------|
+| `application_startup` | 进程启动后、**接受请求前** | INFO | app_name, version, git_sha, environment, hostname, pid, listening_endpoints | secrets、完整连接字符串 |
+| `request_received` | HTTP 中间件首次看到请求 | INFO / DEBUG | method, path, source_ip, request_id | request body、auth headers |
+| `validation_failure` | schema / ModelState / DTO 验证被拒绝 | WARN | request_id, path, missing_fields[], payload_shape（仅字段名） | 字段**值**、PII |
+| `authentication_failure` | 登录 / token 校验失败 | WARN | uid（尝试值）, source_ip, failure_reason | password、token 值 |
+| `outbound_call_start` | 发起对外 HTTP/RPC 调用 | INFO | target_url（host+path）, request_id propagated, timeout_ms | credentials、bearer token |
+| `outbound_call_complete` | 外部调用返回或失败 | INFO / WARN / ERROR | status_code **或** failure_phase（dns/tcp/tls/http）, elapsed_ms, retries | 含 PII 的 response body |
+| `business_event` | 状态变更类业务操作完成 | INFO | operation_name, actor, target ids, outcome | 完整 record payload、PII |
+| `heartbeat` | 长时间运行的后台服务，≥ 1 次 / 60 秒 | INFO | service_name, queue_depth, items_processed_since_last_heartbeat | — |
+| `shutdown` | 进程退出（正常或致命） | INFO / ERROR | app_name, signal/reason, uptime_seconds, pending_work_count | — |
+
+每个事件的 `rationale` 都对应一个真实失效模式：`validation_failure` ⇒ 事故 #2（payload 未记录）；`authentication_failure` 字段要求 ⇒ 事故 #3（无 uid/IP）；`heartbeat` + 沉默检测 ⇒ 事故 #4（0 字节日志）；`application_startup`/`shutdown` ⇒ 生命周期盲区；`outbound_call_*` ⇒「发送失败」却查不到调用痕迹。
+
+### 场景
+
+#### 场景：验证失败必须产生日志
+
+- **GIVEN** API 端点收到缺少 `[Required]` 字段的 payload
+- **WHEN** 框架在 handler 执行前自动 reject（如 400/501）
+- **THEN** 必须写一条 WARN 日志，包含 `request_id`、`path`、`missing_fields[]`、`payload_shape`（仅字段名）
+- **AND** 事后复盘可直接从日志重建失败原因
+
+#### 场景：后台服务必须心跳（heartbeat）
+
+- **GIVEN** worker 进程正在运行
+- **WHEN** 60 秒内没有写入任何 INFO/WARN/ERROR
+- **THEN** 必须写一条 `heartbeat` 日志，包含当前 queue depth 与自上次心跳以来的处理量
+- **AND** 若连续 ≥ 2 倍心跳间隔（≥ 120 秒）未出现心跳，沉默检测器必须告警
+
+### Compliant startup log 示例
+
+```json
+{
+  "timestamp": "2026-06-17T08:00:00.000Z",
+  "level": "INFO",
+  "message": "application_startup",
+  "event": "application_startup",
+  "app_name": "payment-service",
+  "version": "2.3.1",
+  "git_sha": "a1b2c3d",
+  "environment": "production",
+  "hostname": "pod-abc123",
+  "pid": 4711,
+  "listening_endpoints": ["0.0.0.0:8080", "0.0.0.0:9090/metrics"]
+}
+```
+
+### 后续规则
+
+1. **访问日志分离**——health probe／liveness 流量不得污染业务事件日志。将 probe 路由至独立 sink／文件，避免其淹没或轮转掉业务事件（见事故 #1）。
+2. **日志沉默检测 SLA**——服务应在连续 N 分钟无事件时告警，N ≤ 2 × `heartbeat` 间隔。缺少预期日志本身就是一种可告警条件（参见下方「Absence of Expected Logs」告警模式）。
+3. **面向运维的日志可发现性**——返回给客户端的错误响应应携带 `request_id`，以便支持人员将用户报告的故障对应到后端日志，无需为查日志来回沟通。
+
+> **交叉引用**：`heartbeat`／沉默检测与[日志文件轮转策略](#日志文件轮转策略)互补（0 字节／静默丢弃的日志是同一盲区的两个方向），并与 migration-assistant 的后台任务／副作用完整性互补（这些事件即是可观测的「已触发」证据）。
+
 ---
 
 ## 日志级别
@@ -445,6 +520,7 @@ new DailyRotateFile({
 
 | 版本 | 日期 | 变更 |
 |-----|------|------|
+| 1.4.0 | 2026-06-17 | 新增：强制事件类目——9 个 canonical「何时必须写日志」事件（when/must_log/must_NOT_log/level/rationale）、验证失败 + heartbeat 场景、compliant startup 示例、后续规则（访问日志分离、沉默检测 SLA、request_id 可发现性）（XSPEC-234 / 关闭 issue #108） |
 | 1.3.0 | 2026-05-26 | 新增：日志文件轮转策略——强制双触发器（时间 + 大小）轮转，含默认上限危害警告、各语言（.NET/Python/Java/Node）配置示例、运营 SOP（XSPEC-232 / 关闭 issue #111） |
 | 1.2.0 | 2026-01-24 | 新增：OpenTelemetry 语义规范、可观测性三支柱整合、基于日志的告警、进阶关联模式 |
 | 1.1.0 | 2026-01-05 | 新增：参考标准章节，包含 OWASP、RFC 5424、OpenTelemetry 和 12 Factor App |

package/bundled/locales/zh-CN/core/mock-boundary.md

@@ -1,9 +1,9 @@
 ---
 source: ../../../core/mock-boundary.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-10
-source_hash: d2648ad3d869
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-07-08
+source_hash: fe4715991a4c
 status: current
 ---
 
@@ -11,8 +11,8 @@ status: current
 
 > **语言**: [English](../../../core/mock-boundary.md) | [繁體中文](../../zh-TW/core/mock-boundary.md) | 简体中文
 
-**版本**: 1.0.0
-**最后更新**: 2026-05-04
+**版本**: 1.1.0
+**最后更新**: 2026-07-01
 **适用性**: 所有具备单元测试与集成测试的软件项目
 **范围**: universal
 **行业标准**: ISTQB Foundation（Test Doubles）, xUnit Patterns（Gerard Meszaros）
@@ -55,6 +55,7 @@ vi.mock('node:fs/promises', ...)                  // I/O replaced
 | 环境变量 | `process.env.NODE_ENV`、`process.env.LICENSE_KEY` | 支持配置变化 |
 | 文件系统（仅限单元测试） | `fs.readFile`、`fs.writeFile` | 让快速单元测试避免 I/O |
 | 跨模块边界（须有对应 IT） | 其他模块的 public API | 隔离被测单元 |
+| 进程内后台执行（通过可注入 runner） | `Task.Run`、unawaited promise、`setTimeout`、goroutine、thread-pool dispatch | 注入 runner seam 让测试能 await 到确定完成，消除 race |
 
 ---
 
@@ -69,6 +70,46 @@ vi.mock('node:fs/promises', ...)                  // I/O replaced
 
 ---
 
+## 可注入的后台执行（Injectable Background Execution）
+
+fire-and-forget 的后台工作（`Task.Run`、unawaited promise、`setTimeout`、goroutine、`java.util.concurrent` executor 提交，或 `asyncio.create_task`）是一个 **seam**，就跟系统时钟一样。正如你注入 clock 而非直接读取 wall-clock 时间，你也应该注入后台 dispatcher，而非直接生成后台工作。这样测试就能把工作驱动到**确定、可被 await 的完成**，并对其结果（成功、异常或 retry）进行断言——不用 poll、不用 sleep、没有 race。
+
+将 dispatch 抽象成一个小接口（例如 `IBackgroundTaskRunner` / `BackgroundDispatcher`），再提供两种实现：
+
+- **Production**：保留真正的 fire-and-forget 语义——dispatch 立即返回，工作以 detached 方式运行。
+- **Test**：以 **inline** 方式执行工作并**追踪底层 Task/promise**，对外暴露一个 handle 供测试 `await`，使完成（及任何失败）可被观察。
+
+语言中立示意（TypeScript 伪代码）：
+
+```typescript
+// Seam — 在任何 dispatch 后台工作处注入
+interface BackgroundDispatcher {
+  dispatch(work: () => Promise<void>): void
+}
+
+// Production：真正的 fire-and-forget——立即返回，工作以 detached 方式运行
+class FireAndForgetDispatcher implements BackgroundDispatcher {
+  dispatch(work: () => Promise<void>): void {
+    void work() // 刻意不 await
+  }
+}
+
+// Test：inline 执行 + 追踪 task，让测试能 await 到完成
+class DeterministicDispatcher implements BackgroundDispatcher {
+  private readonly tasks: Promise<void>[] = []
+  dispatch(work: () => Promise<void>): void {
+    this.tasks.push(work()) // inline 启动并保留 handle
+  }
+  async settle(): Promise<void> {
+    await Promise.all(this.tasks) // 测试 await 到确定完成
+  }
+}
+```
+
+测试注入 `DeterministicDispatcher`，执行被测代码，再在断言结果前 `await dispatcher.settle()`——后台副作用此时已完全可观察且具确定性。
+
+---
+
 ## 空心测试检测
 
 提交测试文件之前，请检查：
@@ -87,6 +128,7 @@ vi.mock('node:fs/promises', ...)                  // I/O replaced
 - **Orphan Mock**：跨模块 mock 却没有对应的集成测试
 - **Security Bypass Mock**：auth/权限逻辑被换成直接放行的 stub
 - **Database Mock Cascade**：DB 返回硬编码的数据，隐藏真实查询错误
+- **Poll/Sleep for Background Result**：用 sleep 或 poll 等待 fire-and-forget 后台工作完成。race 依然存在——timeout 只是多数时候把它掩盖住，同时拖慢整个测试套件；在共享 runner 上还会把 flakiness 泄漏到其他 MR 的 CI 中。应改为注入 deterministic runner 并 await 被追踪的 task。
 
 ---
 
@@ -99,6 +141,7 @@ vi.mock('node:fs/promises', ...)                  // I/O replaced
 | IT 对应测试 | mock 跨模块边界 | 确保有对应的 IT 存在 |
 | 禁止 mock 安全机制 | 测试涉及 auth/权限 | 使用真实测试用户 + 真实 token |
 | 空心评审 | Mock 数量 ≥ import 数量 | 加入输出值断言 |
+| 后台工作禁止 poll/sleep | 测试断言某个 fire-and-forget 副作用 | 注入 deterministic runner；await 被追踪的 task |
 
 ---
 
@@ -107,3 +150,12 @@ vi.mock('node:fs/promises', ...)                  // I/O replaced
 - **testing**：Mock 边界规则适用于测试金字塔的所有测试级别
 - **test-completeness-dimensions**：维度 8（AI 测试质量）引用了这些规则
 - **flow-based-testing**：Flow 测试必须遵循 mock 边界规则
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2026-05-04 | 初始标准：空心测试问题、可／不可 Mock 表格、检测、反模式、规则摘要 |
+| 1.1.0 | 2026-07-01 | 新增可注入的后台执行作为 seam（平行于 clock injection）：可 Mock 表格新增行、`可注入的后台执行` 章节、`Poll/Sleep for Background Result` 反模式，以及后台工作禁止 poll/sleep 规则（issue #143） |

package/bundled/locales/zh-CN/core/packaging-standards.md

@@ -3,7 +3,7 @@ source: ../../../core/packaging-standards.md
 source_version: 1.1.0
 translation_version: 1.1.0
 last_synced: 2026-06-10
-source_hash: aa338edba3b1
+source_hash: 69ff3afd3c1e
 status: current
 ---
 
@@ -278,6 +278,7 @@ python -c "import zipfile; zipfile.ZipFile('dist/patch.zip').namelist()"
 - [Pipeline 整合标准](pipeline-integration-standards.md) — CI/CD pipeline 配置
 - [Check-in 标准](checkin-standards.md) — 打包前的质量关卡
 - [版本控制标准](versioning.md) — 包产出物使用的版本号
+- [供应链证明标准](supply-chain-attestation.md) — 打包产出物的 SBOM / SLSA 溯源 / 签名（此处的格式完整性属于归档层级；证明则补充了从源码到产出物的溯源）
 
 ---