# PHITE NAVIGATION V1 — 文本优先主导航（含 TRAE 原则研究记录）

> **CANONICAL — LOCKED · DS: V1.0 · 决策依据: D-027 / D-028 / D-029 / D-031**
> 状态：**CANONICAL — LOCKED**（D-027/D-028 文本优先导航；D-029 图标活动栏/上下文侧栏归档）
> V1.0 Foundation Freeze Audit 修订：§05 旧「图标活动栏（V1）/ 可折叠侧栏（V2）」行已归档；中性原则（N1–N5）与键盘/密度原则（V4/V5）继续有效。
> 背景：原则提取自 TRAE（IDE 与 SOLO 模式）与 AI IDE 三栏收敛趋势；**不模仿外观**，不复制其颜色、图标、布局比例或视觉资产。
> 重建语境：PHITE 宪法（P1/P2/P10/P12）+ 规范字体（Archivo + Source Han Sans SC + JetBrains Mono）+ 双环境。

---

## 01 · 研究范围与方法

- 研究对象：TRAE 的活动栏、可折叠侧栏、命令面板、低饱和中性、背景面分组。
- 方法：把「它怎么做」翻译为「原则是什么」，再把原则重建为 PHITE 语法。
- 约束：不照搬 TRAE 的浅灰蓝、图标集、字号或间距；PHITE 仍是 engineered，不是 themed。

---

## 02 · 提取 · 中性原则

| # | 提取原则 | TRAE 表现（供理解，非复制） |
| --- | --- | --- |
| N1 | **内容优先，克制外框** | 编辑器/内容主导，应用外框退后 |
| N2 | **低饱和中性** | 近白/浅灰面，极低彩度；颜色只给状态与内容 |
| N3 | **背景面分组 > 边框/卡片** | 用微妙的灰面分区，少用硬边框与卡片 |
| N4 | **排版层级 > 装饰** | 靠字号/字重/间距，不靠颜色与盒子 |
| N5 | **语义化克制的状态色** | 只有有意义的状态才上色，其余保持中性 |

---

## 03 · 提取 · 导航原则

| # | 提取原则 | TRAE 表现（供理解，非复制） |
| --- | --- | --- |
| V1 | **活动栏 Activity Rail** | 常驻、仅图标、切换顶级上下文 |
| V2 | **可折叠次级侧栏** | 当前上下文内的次级导航，可收起以让位内容 |
| V3 | **命令面板为通用导航** | ⌘K / ⌘P 搜索命令与跳转，作为可见外框之外的兜底 |
| V4 | **键盘优先** | 深导航走命令，而非深层菜单 |
| V5 | **上下文密度** | 列表面板密、内容区舒；导航不打扰内容 |

---

## 04 · PHITE 重建 · 中性

| 提取原则 | PHITE 重建规则 | 状态 |
| --- | --- | --- |
| N1 内容优先 | 与宪法 P10「层级先于容器」、P1「精准先于装饰」一致；外框仅承载身份/面包屑/命令 | CANONICAL — LOCKED |
| N2 低饱和中性 | 维持冷调「工程纸面」与夜蓝系统面；中性值见 `neutral-system-review.html` | PROPOSED（值） |
| N3 背景面分组 | 新增「背景面」为一等分组手段：区块用 `surface` / `surface-2` 区分，硬边框仅用于强结构 | PROPOSED |
| N4 排版层级 | 展示 Archivo 700/800、正文 Archivo 400、标识 JetBrains Mono；中文 Source Han Sans SC | CANONICAL — LOCKED（字体） |
| N5 语义状态色 | 与状态五轴一致：灰/蓝/绿/琥珀/红/青，青只表示当前/实时/选中 | CANONICAL — LOCKED |

---

## 05 · PHITE 重建 · 导航（V1）

| 提取原则 | PHITE 重建规则 | 状态 |
| --- | --- | --- |
| V1 活动栏（旧） | ~~左缘常驻仅图标活动栏~~ | **ARCHIVED — NON-CANONICAL**（D-029；被文本优先导航取代） |
| V2 可折叠侧栏（旧） | ~~活动栏右侧可折叠上下文侧栏~~ | **ARCHIVED — NON-CANONICAL**（D-029；「Context Navigation is earned, not default」） |
| —（新增）**文本优先主导航** | 语义文字标签（工作台/文档/采购/项目控制/执行控制 + 搜索动作组）；≈96px；**Labels carry meaning. Icons are optional reinforcement.**；无图标依赖、无默认上下文侧栏、无折叠/迷你/数字态；活跃项 = 青左线 + 字重 600 + 青墨/亮青文字（P2） | **CANONICAL — LOCKED**（D-027） |
| —（新增）**响应可见性** | 空间不足时整条移除主导航（不压缩）；按需经命令栏入口以抽屉呈现同一导航；**断点改变呈现，不改变导航语义** | **CANONICAL — LOCKED**（D-028） |
| V3 命令面板 | 顶栏 ⌘K 输入（mono），可搜索命令 / 文档 / 对象；结果是对象行（标识 → 标题 → 状态） | RECOMMENDED |
| V4 键盘优先 | 所有可聚焦元素有清晰 `:focus-visible`（浅=青墨，深=亮青）；导航可全键盘 | CANONICAL — LOCKED |
| V5 上下文密度 | 密集表/清单用微间距与发丝线；内容区（手册）用舒适行长与 1.75 行高 | CANONICAL — LOCKED |

## 06 · 应用映射

- **工具面 / 控制面（文本优先主导航）**：`project-workspace.html`（已迁移，规范参照）；`document-register.html`、`procurement-workspace.html`、`equipment-register.html`、`design-deliverable-register.html`、`project-control.html`、`executive-control.html` 列入冻结后迁移（D-027）。
- **文档面（无主模块导航）**：`handbook.html` 已批准为 Golden Sample，规则见 `phite-document-surface.md`。
- **中性原则**：N1–N5 并入宪法 P1/P10/P2 与 `phite-system.md` §12（中性 V1）。

---

## 07 · 开放决策

1. 命令面板检索范围：命令 + 文档 + 对象，是否纳入采购/风险/里程碑（V3 仍为 RECOMMENDED）。
2. 主导航顶级上下文清单：工作台 / 文档 / 采购 / 项目控制 / 执行控制（5 项）是否够用，是否加「证据」。
3. 背景面分组已随中性 V1（D-024）与宪法 P10 生效；具体中性值见 `phite-system.md` §12。