---
name: cross-platform-path-safety
scope:
  - '*'
products:
  - '*'
id: ka-hard-rule-跨平台路径安全规则
type: governance_rule
asset_kind: governance_rule
lifecycle_status: active
authority: canonical
owner_mechanism_id: mc-platform-compatibility
routes: ['*']
primary_triggers:
  - 路径操作
  - 文件引用
secondary_triggers: []
negative_triggers: []
priority: P1
specificity: 4
consumes:
  - ka-hard-rule-核心工程执行原则
hard_blocks:
  - 路径逃逸 scope 边界
  - 符号链接指向 scope 外
  - 大小写冲突未处理
fallback: manual_required
required_evidence:
  - path_normalization_result
  - scope_boundary_check
version: 1.1.0
last_reviewed: '2026-06-01'
stages: ["*"]
---

# 跨平台路径安全规则

## 硬规则

1. **路径必须规范化** — 使用 normalizePathRef 消除平台差异
2. **路径逃逸必须检测** — 符号链接、../ 等不可逃出 scope 边界
3. **大小写冲突必须处理** — macOS 不敏感文件系统需特殊处理

## 检查项

- [ ] 路径经过规范化处理
- [ ] scope 边界未突破
- [ ] 符号链接指向合法
