# 产品哲学

> **最后更新**: 2026-05-08
> **定位**: 元规则。约束"该不该做"，优先级高于其他 standards 文档（其他文档约束"怎么做对"）。
> 与 `06-documentation-system`、`05-development-workflow` 并列但更前置——产品形态决策先于实现规范。

## 核心范式：二常驻 + 一临时

FF AI Workspace 是企业信息系统，最终形态收敛为三件套：

| 层 | 角色 | 是否常驻 | 承担什么 | **不**承担什么 |
|---|---|---|---|---|
| **对话层** | 主入口 | 常驻 | 意图收集、自然语言下发操作、查询、批量调整、流程触发 | 高风险写操作的最终确认；空间型/比对型决策的全部推理 |
| **展示层** | 主舞台 | 常驻 | 状态、数据、关系的结构化呈现；轻交互（筛选、拖拽、选中、右键） | 创建/修改入口；表单链；向导式分步操作 |
| **确认层** | AI 临时调起 | 非常驻 | 写操作的 diff 预览、二次确认、审批轨迹落点；表单退化为"AI 预填 + 用户审阅" | 用户日常进出的页面入口 |

**关键判定线**：
- 第三层不是用户主动进出的页面，是 AI 在执行写操作前自动召唤的临时 UI。它的存在感越低越好，但不能没有——这是信任的底线。
- 一旦确认层变成用户日常需要点开的东西，就退回了传统三明治架构，范式破产。

## 适用边界

**会收敛到这套范式的**（FF AI Workspace 属于此类）：信息密度高、操作多样、用户意图复杂的系统——ERP / HR / CRM / OA / 数据分析平台 / 运维控制台。今天的痛点是"菜单深、表单多、学习曲线陡"，对话+展示+确认是天然解药。

**不应套用这套范式的**：
- **创作型工具**（Figma、IDE、剪映）——核心是手感与精确控制，主舞台必须是直接操作。
- **沉浸消费型**（游戏、视频流、社交）——没有"操作意图"要表达，是体验本身。
- **高频极简操作**（扫码付款、点赞、打车）——一个按钮比一句话快十倍。
- **强空间/物理交互**（CAD、医疗影像、3D 建模）——空间问题用语言描述是降维打击。

**区分线**：软件的核心价值是"帮用户决策和执行"还是"给用户表达/创造/体验的媒介"。前者收敛，后者不收敛。

## 设计准则（可落地的判断题）

每次新增一个用户操作，先依次问：

1. **能不能用对话表达？** 能 → 不要做表单入口。例：「把华东区 5 月没打卡的人全部标记异常」。
2. **是不是高风险写操作？** 是 → 必须有确认层（diff 预览 + 二次确认 + 审批落点）。例：schema 变更、权限分配、合同签署、薪资调整。
3. **是不是空间型/比对型决策？** 是 → 主舞台必须是可交互展示页（拖拽、框选、并排），对话当副驾。例：排班、看板、组织架构、Gantt。
4. **是不是用户的"探索"诉求？** 是 → 用菜单/导航；只为操作服务的菜单，应该删。
5. **能不能让 AI 预填表单？** 写操作中能让 AI 从对话生成结构化操作的，传统表单只是"用户填 → AI 填 + 用户确认"，不要让用户从零填。

## 反模式（主动避免）

- **深菜单**：超过 2 层的功能菜单，几乎都可以被对话替代。
- **模态表单链**：弹窗里点"下一步"再开一个弹窗，是把对话场景硬塞进 GUI。
- **向导式分步操作**：5 步表单的本质是 5 句话，对话原生表达更顺。
- **空状态引导跳传统创建流**：空列表的「+ 新建」按钮如果跳到独立创建页，应该改为唤起对话框预填。
- **每个实体配一套 CRUD 页**：CRUD 是数据库视角，不是用户视角。用户视角是任务，任务用对话表达。

## 与现有规范的关系

- 本文件约束**该不该做**（产品形态决策）。
- `05-development-workflow.md` 约束**怎么做对**（流程、契约、测试）。
- `06-documentation-system.md` 约束**怎么写文档**。
- 模块文档（`docs/modules/{module}/05-ui-interaction-spec.md` 等）约束**具体怎么实现**。

冲突时，**本文件优先**——如果某模块的 UI 规格违反本哲学（比如做了三层菜单 + 模态表单链），该改的是 UI 规格，不是哲学。

## 落地节奏

这是方向性元规则，不要求存量模块一次性改造：
- **新模块**：默认按本哲学设计，不再产出"传统创建页 + 列表页"这种结构。
- **存量模块**：遇到大改时按本哲学重构；不主动发起以"贴合哲学"为唯一动机的重构 PR。
- **优先级**：查询类、报表类、批量操作类最适合先改造（迁移成本低、价值高）；审批/合同类最后改（强契约、高风险）。