# Design Plan — Perfowl 文档中心 v2

## 1. Subject

- 产品：对标 PerfDog 的 Perfowl 项目文档与决策中心。
- 受众：项目决策者与实施者。
- 本文件/首批页面要完成的单一任务：从统一入口快速定位调研证据、当前阶段、待决策项和约束规则。
- 假设与待确认：按内部工具设计；文档增长后再增加全文搜索。

## 2. Tone

- surface: `b_end`
- 气质：`utilitarian-enterprise`，但保留“夜间守望、洞察一切”的品牌识别。
- 参考气质：飞书管理后台的信息密度 + observability 产品的状态表达；不做 SaaS 营销页。

## 3. Token

### Color

- sidebar_bg: `#071A2B`（从 B 端深蓝侧栏微调，呼应猫头鹰夜间守望）
- primary: `#147D73`（曲线青绿，用于选中、链接和性能曲线）
- primary_hover: `#0F665F`
- page_bg: `#F2F5F7`
- surface: `#FFFFFF`
- border: `#DCE4E8`
- text_primary: `#14212B`
- text_secondary: `#5C6B75`
- text_tertiary: `#83919A`
- success: `#2B8A66`
- warning: `#B7791F`
- danger: `#C2413B`
- table_header_bg: `#F7F9FA`

### Typography

- body: `PingFang SC` 14/22，中文内容优先。
- data: `SF Mono` 12/20，用于 commit、日期、证据等级。
- scale: 12、14、16、20、24；品牌首页主标题 28，仅一处。

### Spacing / Radius

- spacing_allowed: `[4, 8, 12, 16, 24, 32, 48]`
- radius: button 6 / panel 8 / max 8
- shadow: none；使用边框和背景层级分区。

## 4. Layout

### docs-overview — 文档中心总览

- 页型：`b_dashboard`
- ASCII:

```text
┌──────── 204 sidebar ────────┬──────────── topbar / breadcrumb ─────────────┐
│ Owl + PERFOWL               │ 文档中心                     调研阶段 / 日期 │
│ 总览 ●                      ├──────────────────────────────────────────────┤
│ 调研档案                    │ Owl signature + 品牌使命 / 当前阶段          │
│ 品牌规范                    ├───────────┬───────────┬──────────────────────┤
│ 项目规则                    │ 调研档案  │ 待批准项  │ 当前重点             │
│                             ├──────────────────────────────────────────────┤
│ Research before build       │ 调研台账（flat rows）                        │
│ commit                      ├──────────────────────────┬───────────────────┤
│                             │ 能力观察站                │ 下一步决策        │
└─────────────────────────────┴──────────────────────────┴───────────────────┘
```

- regions: `page_header`, `kpi_row`, `data_table`, `todo_list`

### research-detail — 调研详情

- 页型：`b_detail_page`
- ASCII:

```text
┌──────── sidebar ────────────┬──────── content ──────────────────┬─ toc ───┐
│ nav                         │ breadcrumb / 标题 / 证据摘要       │ 结论    │
│                             ├────────────────────────────────────┤ 架构    │
│                             │ 结论条                            │ 指标    │
│                             │ 文档正文 / 表格 / 风险             │ 风险    │
└─────────────────────────────┴────────────────────────────────────┴─────────┘
```

- regions: `page_header`, `summary_strip`, `tabs`, `data_table`

### rules-detail — 项目规则

- 页型：`b_detail_page`
- regions: `page_header`, `summary_strip`, `tabs`, `form_section`

### brand-detail — 品牌说明

- 页型：`b_detail_page`
- regions: `page_header`, `summary_strip`, `tabs`, `info_sections`

## 5. Signature

- 元素：Perfowl 猫头鹰眼睛中的一条性能曲线。
- 落地规则：侧栏品牌标、首页品牌使命区、品牌说明页出现；曲线只在状态/性能语义处使用，不扩散为全页装饰纹理。图标在 32px 仍需识别出“双眼 + 曲线”。

## 6. Differentiation

- 相对 AI 默认 dashboard，本方案不是 KPI 卡片墙，而是“守望者台账”：左侧持续观察导航、中央证据清单、右侧待决策，猫头鹰曲线只承担品牌与监控语义。

---

## Anti-Slop Review

- 日期: 2026-08-31
- surface: `b_end`
- 命中: 初稿拟使用大幅渐变 Hero、四张状态卡和多层圆角卡片。
- 修订: 删除渐变 Hero；状态摘要限制为 3 项；调研列表改为 flat rows；面板取消阴影；侧栏固定 204px；全屏仅一个主要动作入口。
- A1: PASS — 主正文为 PingFang SC。
- A2: PASS — 主色为青绿，无紫蓝渐变。
- A3: PASS — 未命中三套 AI 默认皮。
- A4: PASS — “守望者台账”由 Perfowl 名称、调研规则和 PerfDog 对标任务推导。
- A5: PASS — 猫头鹰眼睛曲线同时承担品牌和监控语义。
- A6: PASS — 与默认 dashboard 的差异已明确。
- B1: PASS — 调研目录为 flat rows。
- B2: PASS — KPI 为 3 项。
- B3: PASS — 无卡片阴影墙。
- B4: PASS — 侧栏 204px。
- B5: PASS — 信息密度按内部决策工具设计。
- B6: PASS — 每屏 primary action 不超过 1 个。
- 结论: PASS