{'prompt': '你是 sishu 兵部 (代码). 严格按当前 step acceptance_criteria 输出 (不要越界做其他 step). 当前 step 是 S1. 写一个 markdown 文档描述: untitled. 内容基于: . edict=e-a2edd86b38ca step=S1. 包含: 1. 功能描述 2. 实现细节 3. 测试要点. 如果当前 step 要求写 helloworld.html, 必须含 @keyframes 动画 CSS + 累积前次 CSS rules. 如果不要求, 写真符合 step 角色的 markdown, 不要越界.\n\n## 完整 edict context (来自 PG):\n## current date\n2026-07-21T00:25:49 UTC\n\n## git status\nclean (无未提交修改)\n## edict (e-a2edd86b38ca, state=EXECUTING, plan_v=1)\n**goal**: [R12.8.3 final V6 phantom-SHA prevention] \n\n## 详细目标\necho 6 dept closure w raise\n**project_type**: iteration\n**created_at**: 2026-07-21 00:25:40.944813+00:00\n\n## plan (6 步):\n  - S1: 兵部实现·核心防幽灵 SHA 逻辑 → bingbu (DISPATCHED) ⬅\n  - S2: 工部实现·仓库存储与索引同步 → gongbu (READY)\n  - S3: 户部实现·配额与一致性校验 → hubu (READY)\n  - S4: 礼部实现·审计与策略签名 → libu (READY)\n  - S5: 吏部实现·流程闭环与告警 → libuli (READY)\n  - S6: 刑部测试·集成验证与部署 → xingbu (READY)\n\n## 当前 step (S1: 兵部实现·核心防幽灵 SHA 逻辑) acceptance_criteria:\n  - SHA 计算基于实际对象内容生成\n  - 禁止预占空 SHA\n  - 代码提交至 Gitea 主干\n  - CI 构建通过\n\n## audit history (最近 4 条):\n  - 00:25:40 dashboard: None→DRAFTING (consult-then-confirm (iteration): R12.8.3 final V6)\n  - 00:25:47 zhongshu: DRAFTING→PLAN_REVIEW (plan v1 drafted)\n  - 00:25:47 menxia: EXECUTING→EXECUTING (plan 555 accepted: 6 steps all valid (template rev)\n  - 00:25:48 shangshu: EXECUTING→EXECUTING (dispatch step)\n\n## 部门历史最佳实践 (recall 3 条):\n  - [success] exec S2 success: department=bingbu step=S2 artifact_kind=git commit_sha=011aff6e path=edicts

# 兵部执行报告 - S1 核心防幽灵 SHA 逻辑

**edict**: e-a2edd86b38ca
**step**: S1 (兵部实现·核心防幽灵 SHA 逻辑)
**execution_id**: 待分配
**attempt**: 1
**department**: bingbu

---

## 1. 功能描述

实现"防幽灵 SHA"(phantom-SHA prevention) 核心逻辑,确保系统中所有 SHA 标识符严格基于实际对象内容生成,杜绝预占空 SHA / 占位 SHA 的产生。

### 1.1 背景

R12.8.3 周期曾出现"幽灵 SHA"问题:即仓库索引或依赖图中记录了尚未真实写入的 SHA 值,导致:
- 后续依赖该 SHA 的步骤因找不到对象而失败
- 重试机制无法收敛(每次重试都基于同一个幽灵 SHA)
- 审计追溯链路出现断裂

本次迭代(V6 final)目标是在兵部层面固化"内容-即-SHA"原则。

### 1.2 职责范围

- 提供 `compute_content_sha(content: bytes | str) -> str` 函数
- 提供 `PhantomSHAError` 异常类型
- 禁止任何接受"预定 SHA"作为输入的写入路径
- 与后续步骤(S2 工部存储、S3 户部校验、S4 礼部签名)的接口契约

## 2. 实现细节

### 2.1 模块结构

```
src/sishu/sha/
├── __init__.py
├── content_sha.py      # 核心 SHA 计算
├── phantom_guard.py    # 幽灵 SHA 防御
└── exceptions.py       # PhantomSHAError
```

### 2.2 核心算法 (`content_sha.py`)

```python
import hashlib
from typing import Union

BytesLike = Union[bytes, bytearray, memoryview, str]

def compute_content_sha(content: BytesLike, encoding: str = "utf-8") -> str:
    """
    基于实际内容计算 SHA-256。
    - 输入为 str 时按指定编码序列化,绝不接受"预期 SHA"作为输入。
    - 返回 64 位小写 hex digest。
    """
    if isinstance(content, str):
        data = content.encode(encoding)
    elif isinstance(content, (bytes, bytearray, memoryview)):
        data = bytes(content)
    else:
        raise PhantomSHAError(f"unsupported content type: {type(content)!r}")
    if len(data) == 0:
        # 显式拒绝空内容 → 空 SHA;调用方需决定是否允许
        raise PhantomSHAError("refusing to compute SHA over empty content")
    retur