# PHITE TOOL SURFACE GRAMMAR V1

> **CANONICAL — LOCKED · DS: V1.0 · 决策依据: D-035**
> **状态**: CANONICAL — LOCKED（D-035，Owner 批准）
> **Primary Tool Surface Composition Reference**: `golden-samples/project-workspace.html`
> **证据**: Project Workspace + Equipment Rebase + Document Rebase + PO Rebase（四页一致语法）
> **来源**: `validation/studies/tool-surface-grammar-study.md`（规范化研究，已批准）
> **关联规范**: Constitution P13（三类表面）· `navigation.md`（D-027/D-028 文本优先导航）· `records.md`（D-032 记录语法）· `system.md`（D-030 脊线语义、D-024/D-025 中性）
> **Note**: 本规范只形式化**跨 Project / Equipment / Controlled Document / PO 四对象均有证据**的 Tool Surface 视觉语法。对象专属语义（设备/文档/PO）与语义原则（非视觉组件）按 §5/§6 分离。

---

## 1. 目的

定义 PHITE Tool Surface（Operate · Light Engineering Environment）的**共享视觉语法**，使不同对象页面（Project / Equipment / Document / PO）属于同一视觉家族，同时保持对象语义专属。

Tool Surface 回答「用户在操作对象」——不是阅读（Document Surface）、不是监控状态（Control Surface）。

---

## 2. 工具面论点（TOOL SURFACE THESIS）

> 一套 Tool Surface 视觉语法支持多种工程对象：shell、命令栏、96px 文本优先导航、对象身份、对象摘要、节律、网格、面板、记录、状态徽章、条件式有序轨道。对象差异由**语义**承载，不由**视觉系统**承载。

---

## 3. 规范视觉语法（CANONICAL VISUAL GRAMMAR）

以下语法在四页上一致出现，构成 Tool Surface V1 规范。以 `project-workspace.html` 为主要组合参考（§4）。

| 语法 | 规范描述 | 关联决策 |
| --- | --- | --- |
| **Tool Surface Shell** | `.shell{display:grid;grid-template-columns:96px 1fr;min-height:calc(100vh - 50px);max-width:1500px;margin:0 auto}`；`.main{padding:24px 28px 60px;min-width:0}`；**`.main` 不得设页面级 `max-width`**（壳拥有工作区几何） | D-034 一致 |
| **Command Bar** | 50px `.cmdbar`：`.brand`（Logo）+ `.crumb`（上下文路径）+ `.cmd`（命令搜索 · ⌘K）+ `.pill`（状态）+ `.avatar`（用户） | — |
| **96px 文本优先主导航** | `.rail-text`：语义文字标签、96px、激活项 `.on`（青左线 + 青字 + 加粗）、`.nav-sep` 分隔、搜索为次级动作；≤960px 整条移出布局经命令栏抽屉访问 | **D-027 / D-028**（权威） |
| **`.pid` 对象身份** | 页面身份：`.crumb` overline（mono 大写）+ h1（对象名）+ `.meta`（mono 稳定元数据）。**只承载稳定对象真值**，不含瞬时状态 | — |
| **`.obj` 对象摘要** | 关键对象卡：`.o-top`（`.codeb` + `.o-tag` + `.revb` + `.chip`）+ `.o-name` + `.o-grid`/`.o-kv`（约 5 字段密度）。对象类型/代码/修订/状态 + 稳定识别字段 | — |
| **Section Rhythm 节律** | `.sec` + `.sec-head`（`.no` mono 编号 + h2 标题 + `.right` 右注） | — |
| **`.grid2`** | 两列配对布局（`grid-template-columns:1fr 1fr;gap:16px`），≤960px 单列 | — |
| **`.panel`** | 受控容器（`border + surface + radius + padding`），用于需要含界的信息组 | P10 Hierarchy before containers |
| **`.rec` 记录行** | 记录行（`.r-l`/`.r-id`/`.r-t`/`.sub`/`.r-r`/`.r-own`/`.r-time`/`.r-next`），语义分组靠间距与发丝线 | **D-032**（权威） |
| **`.codeb` / `.revb`** | 代码徽章 / 修订徽章（mono，边框） | — |
| **`.chip` 状态** | 淡色状态 chip（ok/late/warn/active/hold + 信号点），状态=文字+形状+颜色 | D-005 / D-010 / D-030 语义 |
| **Conditional `.spine` 有序轨道** | **PROVISIONAL**（§7）——运营有序阶段可用分布式脊线；修订/历史用记录行 | D-030（语义权威） |
| **响应式壳** | ≤960px：导航整条移除（D-028），经命令栏按需；`grid2` 单列；`.main` 收紧 padding | D-027/D-028 |
| **Control Chain 控制链（六节）** | 状态→例外→后果→决策→行动→证据；由共享原语（`.sys-strip`/`.spine`/`.exc`/`.row`/`.risk`/`.act`/`.audit`/`.rec`/`.sev`/`.chip`）表达，深色控制环境承载；**无新组件** | D-010/D-030/D-032 + system.md §15（固化） |

---

## 4. PRIMARY TOOL SURFACE COMPOSITION REFERENCE

**`golden-samples/project-workspace.html` 是 Tool Surface 主要组合参考。**

它不是「一个项目专属页面」——Equipment / Document / PO 三个 Rebase 均由其组合语法派生（shell、命令栏、96px 导航、`.pid`、`.obj`、节律、`.grid2`、`.panel`、`.rec`、`.codeb`/`.revb`/`.chip`、脊线几何、密度、响应式）。

新 Tool Surface 页应从该参考派生组合，再代入对象语义。

---

## 5. 语义原则（SEMANTIC PRINCIPLES — 非视觉组件）

以下为**语义原则**，**不是**新视觉组件。必须通过既有 Tool Surface 语法（`.pid`/`.obj`/`.sec-head .right`/`.rec`/`.chip`/来源文字）表达，除非未来证据证明需要另一组件：

- **Stable Object Identity**：身份区只承载稳定对象真值（标识/分类/标题/权威），不含瞬时操作状态。
- **Current Truth**：单一权威「当前状态」阅读；语义角色而非面板。内容对象专属（设备=阶段/进度/例外；文档=修订/发布/有效性；PO=承诺+引用履约）。
- **Owned vs Referenced Truth**：数据治理原则——引用对象不得创建/推进另一对象真值的平行副本；引用以来源文字标注（如「来源 R-201」）。
- **State Provenance**：状态应可追溯其来源；用普通 `.rec` 记录/证据行表达。
- **Next Action**：如实、从属、有归属的单一当前动作；用 `.rec` 行表达（标签必须与其真实行为一致）。

---

## 6. 对象专属语义（OBJECT-SPECIFIC — 不规范化进 Tool 语法）

以下为对象类型语义，通过共享视觉语法表达，**不**属于 Tool Surface 语法：

- **Equipment**：工程指纹/参数（P/T、材料、容积）· 设备生命周期阶段（ENG→MFG→FAT→LOG→INS→COM）· 设备文档 · 采购关系。
- **Controlled Document**：修订 · 发布状态 · IFC · 取代（supersession）· 复核意见 · 文档权威模型。
- **PO**：商业承诺 · 供应商 · PO 金额 · PR/RFQ 本源 · 物理履约（引用）· GR · 发票/付款边界。
- **固定关系角色分类法**（如 Governing/Commercial/Risk、Governs/References 等）——对象专属，不统一。

---

## 7. 有序轨道（ORDERED TRACK — PROVISIONAL）

**不**将 `.spine` 完全规范化为强制性 Tool Surface 语法。记录为 **PROVISIONAL**：

| 类型 | 表达 | 证据 |
| --- | --- | --- |
| 运营有序阶段 | 分布式 PHITE 脊线（`.spine`/`.node`） | Project 交付阶段 · Equipment 生命周期 · PO 履约 |
| 修订 / 历史记录 | 记录/表格结构（`.rec` 行） | Document 修订历史（REV 0→A→B→C，无脊线） |

**脊线状态语义继续依赖 D-030**（Current=青唯一 · Traversed=resolved 中性 · Delayed=红 · Hold/Future=subordinate 中性）。边界本身待更多对象类型（Control Surface 等）验证后再考虑提升。

---

## 8. 被否 / 降级模式（REJECTED / DEMOTED — 不入规范）

以下视觉实验**不**进入 Tool Surface 语法：

- 独立 Object Detail 视觉系统（对象详情无独立系统，只有 Tool 语法 + 对象语义）。
- 专属 Current Truth 仪表盘 / 面板（降级为语义原则 §5）。
- 专属 Relationship 组件（普通 `.rec` + 分组即足够）。
- Provenance feed（普通记录/证据行即足够）。
- Mandatory drawer（rebase 已移除；非必需）。

---

## 9. 参考与关联

- Constitution P13（三类表面：Tool / Document / Control）——本规范不与之冲突。
- `navigation.md` D-027/D-028（文本优先导航、响应可见性）——本规范引用为权威。
- `records.md` D-032（记录解剖、间距分组、状态表达）——本规范引用为权威。
- `system.md` D-030（脊线状态语义）、D-024/D-025（中性）、D-010（状态五轴）——权威。
- `system.md` §15（Control Chain 六节语法，固化）——本规范引用为权威。
- `validation/studies/tool-surface-grammar-study.md`（规范化研究，证据来源）。
- `validation/studies/object-detail-grammar-study.md`（语义研究历史，保留不改写）。

---

## 10. 控制链（CONTROL CHAIN — 固化）

Control Chain 六节链（状态→例外→后果→决策→行动→证据）由**共享语法**表达，正式语法见 `system.md` §15：

- 全部链节映射既有 Tool/Control 原语（`.sys-strip`/`.spine`/`.exc`/`.row`/`.risk`/`.act`/`.audit`/`.rec`/`.sev`/`.chip`），**不新增视觉组件**。
- 深色控制环境承载（宪法 P4 · `system.md` §12.2 token）；决策 = 记录行 + Activity 青；例外 = 文字 + 形状 + 颜色（§14.2）。
- 固化依据：`validation/studies/control-surface/control-chain-validation-report.md`（PASS · 结果 1）+ `validation/studies/control-surface/control-chain-implementation-candidate.html`。
- 本规范不引入新表面；Control = Dark Control Environment（同一语法，换环境）。

---

_本规范为 D-035 产物；形式化既有已实现并验证的 Tool Surface 语法（四页证据），不引入新视觉。_