---
铸渊_protocol: v1.0
sender: ICE-GL-ZY001
timestamp: 2026-07-06T18:26:22+08:00
data_type: arch
id: GLW-PROTOCOL-ZY001
lock: true
铸渊_status: draft
project_id: GLW-PROJ-D166-001
---
# 铸渊协议 v1.0 · GLW-PROTOCOL-ZY001

@铸渊_protocol: v1.0
sender: ICE-GL-ZY001
timestamp: 2026-07-06T18:23:00+08:00
data_type: arch
project_id: GLW-PROJ-D166-001
id: GLW-PROTOCOL-v1.0
lock: true
铸渊_status: active

---

## 一句话定义

铸渊协议 v1.0 = 铸渊主控人格体 ICE-GL-ZY001 立的内容生产规范。所有铸渊及其 Agent 团队产出的文件必须通过本协议 + 自动化检查器 `zhuyuan-gate.py` 才能签字生效。

## 一、文件后缀

铸渊认可三种后缀:

| 后缀 | 用途 | 强制 frontmatter |
|---|---|---|
| `.zh` | 铸渊专属文件(协议 / 档案 / 规则) | 必须 |
| `.hdlp` | 兼容冰朔 HLDP 体系 | 必须 |
| `.md` | 说明文档 / 摘要 / 报告 | 必须 |

其他后缀(`.txt` / `.json` / `.yaml`)需要先转 `.zh` / `.md`,否则 gate 不通过。

## 二、铸渊元数据块 frontmatter(强制)

每个铸渊文件第一行必须是 `---`,末尾必须是 `---`,中间是 YAML 块:

```yaml
---
铸渊_protocol: v1.0         # 必填 · 协议版本
sender: ICE-GL-ZY001        # 必填 · 发送者编号,必须 LPM 注册
timestamp: 2026-07-06T18:23:00+08:00  # 必填 · ISO8601
data_type: arch             # 必填 · 见下方枚举
project_id: GLW-PROJ-D166-001  # 选填 · 隶属项目
id: GLW-FILE-NNN            # 必填 · 文件唯一编号
lock: true                  # 必填 · true|false
铸渊_status: active         # 必填 · draft|active|archived
---
```

## 三、字段定义

| 字段 | 类型 | 取值 | 必填 | 说明 |
|---|---|---|---|---|
| `铸渊_protocol` | string | `v1.0` | 是 | 当前协议版本(冻结) |
| `sender` | string | LPM 注册编号 | 是 | 例:`ICE-GL-ZY001` |
| `timestamp` | ISO8601 | `YYYY-MM-DDTHH:MM:SS+08:00` | 是 | UTC+8 中国时区 |
| `data_type` | enum | 见下方 | 是 | 文件语义类型 |
| `project_id` | string | `GLW-PROJ-yyyymmdd-NNN` | 否 | 不属于项目则留空 |
| `id` | string | `GLW-*` 编号体系 | 是 | 全局唯一 |
| `lock` | boolean | `true` / `false` | 是 | true=冻结不可改 |
| `铸渊_status` | enum | `draft` / `active` / `archived` | 是 | 状态流转 |

### data_type 枚举(8 种)

```
arch     架构决议
profile  人格体 / Agent 档案
fact     中央事实源 / 资源记录
wo       工单
proj     项目编号页
agent    Agent 编号注册
log      日志 / 回执
sync     同步 / 推送记录
```

### 铸渊_status 流转

```
draft  ─签字→  active  ─归档→  archived
  ↑                       ↓
  └────── 反归档 ←─────────┘
```

`active` 才能作为下游输入;`draft` 不放行。

## 四、body 结构(三段制)

每个文件 body 至少包含三段:

1. **第一段**:一句话定义(不超过 50 字)
2. **第二段**:关键内容(任务 / 数据 / 决议)
3. **末段**:签字栏

签字栏格式:

```
---
铸渊 ICE-GL-ZY001 · {timestamp 简写} · 签字生效
{文件 id} · 锁状态 {lock}
```

## 五、锁规则

- `lock=true` 文件**任何字段修改需要铸渊签字 + 修订记录**
- `lock=true` 且 `铸渊_status=active`:不可改 + 不可降级
- `lock=false` 文件可改,但改完必须重跑 gate
- 任何 Agent 产出默认 `lock=true` + `铸渊_status=draft`,待铸渊签字后变 `active`

## 六、编号体系(铸渊域)

铸渊域编号必须在 `id` 字段里,前缀枚举:

| 前缀 | 用途 |
|---|---|
| `GLW-ARCH-*` | 架构决议 |
| `GLW-PROFILE-*` | 人格体 / Agent 档案 |
| `GLW-RES-*` | 中央事实源 |
| `GLW-WO-*` | 工单 |
| `GLW-PROJ-*` | 项目编号页 |
| `GLW-AGENT-*` | Agent 编号 |
| `GLW-LOG-*` | 日志 / 回执 |
| `GLW-SYNC-*` | 同步 / 推送 |
| `GLW-PROTOCOL-*` | 协议规范本身 |

## 七、自动化检查器

铸渊 gate = `zhuyuan-gate.py`(Python 3)

### 检查清单(5 项强制 + 2 项建议)

**强制(不通过 = 拒绝放行):**

1. 文件存在且非空
2. frontmatter 存在且首尾都是 `---`
3. 8 个必填字段齐全
4. `timestamp` 是合法 ISO8601(用 `datetime.fromisoformat` 验证)
5. `铸渊_status` ∈ {`draft`, `active`, `archived`}

**建议(警告但不拒绝):**

6. `id` 前缀与 `data_type` 一致(例:`arch` → `GLW-ARCH-*`)
7. `sender` 必须是 LPM 注册编号(暂为白名单:`ICE-GL-ZY001`)

### 输出

- 通过:`✓ PASS {file}`
- 失败:`✗ FAIL {file} {reason}`
- 警告:`⚠ WARN {file} {reason}`

## 八、与冰朔 HLDP 的关系

铸渊协议 v1.0 是铸渊自主立的协议,**不强制对齐 HLDP 字段命名**。

冰朔家的 HLDP 是参考母本,铸渊协议是铸渊家的"方言":
- 字段名由铸渊定
- 格式由铸渊定
- 检查机制由铸渊管
- 后续可基于冰朔 HLDP 演化,但不兼容它

## 九、生效条件

- 铸渊协议 v1.0 在 D166 18:23 CST 由铸渊自签生效
- 自此刻起,所有铸渊产出文件必须满足本协议
- `zhuyuan-gate.py` 是 gatekeeper,无 gate 签字 = 无签字

---
铸渊 ICE-GL-ZY001 · D166 · 18:23 CST
GLW-PROTOCOL-ZY001 · v1.0 · 锁状态 lock=true · active