# PHITE NEUTRAL & NAVIGATION — TRAE 原则研究

> Phase 3 · 补充研究。原则提取自 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 重建 · 导航

| 提取原则 | PHITE 重建规则 | 状态 |
| --- | --- | --- |
| V1 活动栏 | 左缘常驻窄栏（仅图标），顶级上下文：工作台 / 文档 / 采购 / 控制 / 搜索 + 底部设置；**当前项 = 青墨（浅）/ 亮青（深）左指示条**（宪法 P2） | RECOMMENDED |
| V2 可折叠侧栏 | 活动栏右侧的上下文侧栏，可收起；模块徽标用 JetBrains Mono 等宽数字 | RECOMMENDED |
| V3 命令面板 | 顶栏 ⌘K 输入（mono），可搜索命令 / 文档 / 对象；结果是对象行（标识 → 标题 → 状态） | RECOMMENDED |
| V4 键盘优先 | 所有可聚焦元素有清晰 `:focus-visible`（浅=青墨，深=亮青）；导航可全键盘 | CANONICAL — LOCKED |
| V5 上下文密度 | 密集表/清单用微间距与发丝线；内容区（手册）用舒适行长与 1.75 行高 | CANONICAL — LOCKED |

---

## 06 · 应用映射

- **已重建为规范演示**：`project-workspace.html`（Light 工具面：活动栏 + 可折叠侧栏 + 命令面板 + 规范字体 + 精化中性）。
- **工具面 / 控制面（活动栏）**：`document-register.html`、`procurement-workspace.html`（Light 工具面）、`project-control.html`、`executive-control.html`（Dark 控制面）。
- **文档面（无活动栏）**：`handbook.html` 已批准为 Golden Sample，规则见 `phite-document-surface.md`。

---

## 07 · 开放决策

1. 导航模式（活动栏 + 可折叠侧栏 + 命令面板）是否批准为规范（当前 RECOMMENDED）。
2. 活动栏顶级上下文清单：工作台 / 文档 / 采购 / 控制 / 搜索（5 项）是否够用，是否加「证据」。
3. 命令面板检索范围：命令 + 文档 + 对象，是否纳入采购/风险/里程碑。
4. 背景面分组是否批准为规范中性手段（当前 PROPOSED）。