universal-dev-standards 5.17.0 → 6.1.0

package/bundled/locales/zh-CN/core/cd-deployment-strategies.md

@@ -0,0 +1,135 @@
+---
+source: ../../../core/cd-deployment-strategies.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-06-10
+source_hash: 0eeb697c2f07
+status: current
+---
+
+# CD Deployment Strategies（CD 部署策略）
+
+> **语言**: [English](../../../core/cd-deployment-strategies.md) | [繁體中文](../../zh-TW/core/cd-deployment-strategies.md) | 简体中文
+
+## 概述
+
+本标准定义四种主要部署策略的选用矩阵：Blue-Green、Canary、Rolling、Recreate。帮助团队根据流量规模、风险容忍度和基础设施成本，做出一致且有据可查的策略选择。
+
+---
+
+## 核心原则
+
+- **三维决策**：根据流量规模 × 风险容忍度 × 基础设施成本选择策略
+- **禁止直接上生产**：任何变更都必须先通过 staging 环境验证
+- **零停机目标**：除非为内部工具或开发环境，否则应追求零停机部署
+
+---
+
+## 策略选用矩阵
+
+| 策略 | 流量规模 | 风险容忍度 | 基础设施成本 | 停机时间 | 回滚时间 |
+|------|---------|----------|------------|---------|---------|
+| Blue-Green | 高 | 低 | 高 | 零 | < 30 秒 |
+| Canary | 中至高 | 中 | 中 | 零 | < 2 分钟 |
+| Rolling | 任意 | 中 | 低 | 极少 | 数分钟 |
+| Recreate | 低 | 高 | 极低 | 数秒至数分钟 | 数分钟 |
+
+---
+
+## 各策略详细说明
+
+### Blue-Green
+
+**适用场景**：有状态服务、数据库兼容性变更、高 SLA API
+
+**运作方式**：
+- 维护两个完全相同的环境（Blue = 现有线上版，Green = 新版本）
+- 完整部署并验证 Green 环境后，切换 Load Balancer 流量
+- 问题发生时立即切回 Blue
+
+**前置条件**：双环境基础设施、Load Balancer、健康检查
+
+---
+
+### Canary
+
+**适用场景**：功能验证、A/B 测试、高风险变更
+
+**流量渐进比例**：1% → 5% → 25% → 50% → 100%
+
+**运作方式**：
+- 先将少量流量导向新版本
+- 监控指标，符合自动晋升规则则继续扩大
+- 发现问题立即缩回 0%
+
+**前置条件**：流量切分机制、可观测性、自动晋升规则
+
+---
+
+### Rolling
+
+**适用场景**：无状态服务、标准更新、批处理 worker
+
+**运作方式**：
+- 依序更新每个实例，更新前进行健康检查
+- 允许新旧版本短暂共存
+- 资源效率最佳，但回滚需时较长
+
+**前置条件**：多个服务实例、健康检查
+
+---
+
+### Recreate
+
+**适用场景**：开发/测试环境、内部工具、单实例服务
+
+**运作方式**：
+- 停止所有现有实例，部署新版本，重新启动
+- 最简单，但有停机时间
+
+**前置条件**：无（最低门槛）
+
+---
+
+## 决策树
+
+```
+Q1: 需要零停機時間？
+  → 否 → Recreate
+  → 是 → Q2
+
+Q2: 流量 > 10k req/min？
+  → 是 → Q3（Blue-Green 或 Canary）
+  → 否 → Rolling
+
+Q3: 變更屬於高風險？
+  → 是 → Canary
+  → 否 → Q4
+
+Q4: 基礎設施預算有限？
+  → 是 → Rolling
+  → 否 → Blue-Green
+```
+
+---
+
+## 无 CI/CD 环境的替代做法
+
+| 策略 | 替代方案 |
+|------|---------|
+| Blue-Green | 参见 no-cicd-deployment.ai.yaml 的 Shell Script 实现 |
+| Canary | 使用 Nginx `split_clients` 或 HAProxy 做流量切分 |
+| Rolling | 使用顺序式 rsync + 健康检查循环 |
+| Recreate | 最简单 — 停止、部署、启动 |
+
+---
+
+## 相关标准
+
+- [deployment-standards.md](../../../core/deployment-standards.md) — 部署基础原则
+- [rollback-standards.md](../../../core/rollback-standards.md) — 回滚触发条件矩阵
+- [no-cicd-deployment.md](../../../core/no-cicd-deployment.md) — 无 CI/CD 部署策略
+- AI 格式：[../../../ai/standards/cd-deployment-strategies.ai.yaml](../../../ai/standards/cd-deployment-strategies.ai.yaml)
+
+
+**Scope**: universal

package/bundled/locales/zh-CN/core/chaos-injection-tests.md

@@ -0,0 +1,130 @@
+---
+source: ../../../core/chaos-injection-tests.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-06-10
+source_hash: 4aaf84b1c84c
+status: current
+---
+
+# 混沌注入测试
+
+> **语言**: [English](../../../core/chaos-injection-tests.md) | [繁體中文](../../zh-TW/core/chaos-injection-tests.md) | 简体中文
+
+## 概述
+
+混沌注入测试使失败场景可机器验证。`chaos-engineering-standards` 描述实验方法论，而本标准定义 AI Agent 系统所需的具体测试——LLM 超时、数据库断连、策略引擎失效，以及爆炸半径控制。
+
+## 为什么 AI Agent 系统需要专属的混沌测试
+
+传统软件只有少数外部依赖。AI Agent 系统使这一情况更加复杂：
+
+- **LLM API**：高延迟、速率限制、非确定性失败
+- **策略引擎**（OPA/Rego）：安全关键——必须在失败时关闭
+- **向量存储 / 知识库**：检索失败影响输出质量
+- **数据库**：操作中途断连可能损坏多步骤的 Agent 状态
+- **对等 Agent**：在多 Agent 管线中，一个 Agent 崩溃不得级联影响其他 Agent
+
+上述每种失败模式都需要专属测试，而不仅仅是操作手册中的一句说明。
+
+## 需求摘要
+
+| ID | 规则 | 依据 |
+|----|------|-----------|
+| REQ-CIT-001 | 每个外部依赖需要一个失败隔离测试 | 单一依赖失败不得级联 |
+| REQ-CIT-002 | LLM 客户端必须处理超时和速率限制 | LLM 是最高风险依赖 |
+| REQ-CIT-003 | 策略引擎不可用时必须默认为 DENY | 开放式失败是安全漏洞 |
+| REQ-CIT-004 | 操作中途数据库断连必须干净回滚 | 部分写入会造成数据损坏 |
+| REQ-CIT-005 | Agent 崩溃不得传播至不相关的 Agent | Agent 间爆炸半径必须有界 |
+
+## 注入模式
+
+### LLM 超时
+
+```typescript
+it('surfaces TimeoutError when LLM does not respond in time', async () => {
+  const slowLlm = { complete: () => new Promise(() => {}) } // never resolves
+  const agent = new PlannerAgent({ llm: slowLlm, timeoutMs: 100 })
+  await expect(agent.run(input)).rejects.toThrow('TimeoutError')
+})
+```
+
+### LLM 速率限制（429）
+
+```typescript
+it('retries with backoff on 429 and eventually surfaces RateLimitError', async () => {
+  const rateLimitedLlm = mockLlm({ status: 429, retryAfter: 1 })
+  const agent = new PlannerAgent({ llm: rateLimitedLlm })
+  await expect(agent.run(input)).rejects.toThrow('RateLimitError')
+  expect(rateLimitedLlm.callCount).toBeLessThanOrEqual(3) // respects retry policy
+})
+```
+
+### 策略引擎停机（失败关闭）
+
+```typescript
+it('returns DENY when OPA sidecar is unavailable', async () => {
+  const downOpa = { query: () => Promise.reject(new Error('ECONNREFUSED')) }
+  const guardian = new GuardianAgent({ opa: downOpa })
+  const result = await guardian.review(reviewable)
+  expect(result.decision).toBe('DENY')
+  expect(result.reason).toMatch(/policy engine unavailable/)
+})
+```
+
+### 数据库断连
+
+```typescript
+it('rolls back transaction on mid-operation DB disconnect', async () => {
+  const db = createTestDb()
+  await seedRows(db, [{ id: 1, name: 'alice' }])
+  
+  // Force disconnect after first write in the transaction
+  let writeCount = 0
+  const hookedDb = hookAfterWrite(db, () => {
+    if (++writeCount === 1) db.close()
+  })
+  
+  await expect(runner.executeWithDb(hookedDb, plan)).rejects.toThrow()
+  
+  const freshDb = createTestDb()
+  const rows = freshDb.prepare('SELECT * FROM records').all()
+  expect(rows).toHaveLength(1) // original row preserved, partial write rolled back
+})
+```
+
+### Agent 崩溃控制
+
+```typescript
+it('pipeline continues when one agent throws', async () => {
+  const crashingAgent = { run: () => { throw new Error('agent crash') } }
+  const pipeline = new Pipeline({ agents: { planner: crashingAgent, builder: realBuilder } })
+  
+  const result = await pipeline.run(input, { skipFailedAgents: true })
+  expect(result.completedAgents).toContain('builder')
+  expect(result.failedAgents).toContain('planner')
+})
+```
+
+## 安全规则
+
+1. 绝对不要对生产环境或共享的测试数据库执行混沌测试
+2. 在 `afterEach` 或 `finally` 块中始终清理注入的故障
+3. 为混沌测试加上标签（`@chaos`），以在开发工作流程的快速单元测试运行中排除
+4. 混沌测试可在 CI 的专属任务中运行，不纳入标准单元测试矩阵
+
+## 反模式
+
+- **在主处理器中捕获并忽略所有错误** — 这会对断言隐藏混沌失败
+- **断连后不验证数据库状态** — 仅断言错误被抛出是不够的；必须断言没有写入部分数据
+- **开放式策略引擎处理** — 策略路径中的任何模糊情况都必须解析为 DENY，而非 ALLOW
+
+## 另请参阅
+
+- `chaos-engineering-standards.ai.yaml` — 实验方法论与 SLO 集成
+- `testing.ai.yaml` — 通用测试结构
+- `secure-op.ai.yaml` — AI Agent 的失败关闭原则
+- `security-standards.ai.yaml` — 安全不变量
+
+
+**Scope**: universal

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

@@ -3,7 +3,7 @@ source: ../../../core/checkin-standards.md
 source_version: 1.6.0
 translation_version: 1.6.0
 last_synced: 2026-04-20
-status: current
+status: stale
 ---
 
 # 程序码签入检查点标准

package/bundled/locales/zh-CN/core/code-review-checklist.md

@@ -3,7 +3,7 @@ source: ../../../core/code-review-checklist.md
 source_version: 1.3.0
 translation_version: 1.3.0
 last_synced: 2026-01-12
-status: current
+status: stale
 ---
 
 # 代码审查检查清单