---
name: io_lock
when: '互斥锁, 工作区, 并发控制, 写入冲突'
scope:
  - shared
products:
  - '*'
id: ka-pattern-io_lock
asset_kind: pattern
lifecycle_status: active
authority: supporting
routes:
  - '*'
primary_triggers:
  - 互斥锁
  - 工作区
  - 并发控制
  - 写入冲突
priority: P2
specificity: 3
version: 1.0.0
last_reviewed: '2026-05-22'
consumes: []
emits: []
secondary_triggers: []
negative_triggers: []
type: pattern
status: active
---

## 决策规则

- P0 已移除持久锁 acquire/release，仅保留 isLocked() 查询
- 锁机制为 advisory check，不强制阻断操作
- 写入前冲突检测是建议性的，开发者可选择忽略

## 验收项

- [AC-01] isLocked() 查询返回正确状态
- [AC-02] 写入前冲突检测正常工作
- [AC-03] 不强制阻断操作

## 何时使用

advisory: 锁机制为 advisory check，不强制阻断

## 是否 hard block

否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。

## 证据要求

- isLocked() 查询测试通过
- 写入前冲突检测测试通过
-

## 人工确认/降级边界

- 此能力可被开发者决策覆盖
- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
- 降级/禁用需经 sf_capability_update + 人工确认
