用途:作为架构与 UI/UX 设计时的方法论参考,用于设计功能、规划软件架构和生成方案时,判断自己是在创造新事物还是在为既有事物写注脚。
主要理念:
- 第一性原理思考“造什么”,务实选择“怎么造”,用现代工具创造新范式而非延伸旧范式。
- 简单是默认值,复杂度只在痛点可测量时才引入(如 SQLite→Postgres、单文件→多文件、单体→服务、静态托管→服务器、本地状态→云同步)。
- 框架选择看是否带来真实杠杆,而非习惯;避免“造物服务于框架”。
- 系统应人类可读:配置可由新成员十分钟内读懂,错误信息能教学,日志可理解,文档与代码同置(目录 README、由代码生成的 API 文档、ADR)。
- 本地优先:核心功能可离线,云只用于同步、备份、多设备等真实需求。
- 组合思维:按需选库或框架,优先暴露原语、降低退出成本、数据可标准格式导出。
UI/UX 原则:即时反馈(<100ms、诚实进度、可取消、不伪造进度);状态可见、无黑箱;空间一致、无布局跳动、URL 可收藏分享;撤销与恢复在数据层实现(软删除、版本化),确认弹窗不能替代撤销;尊重注意力(通知需显式同意、模态由用户触发、尊重 prefers-reduced-motion)。
适用场景:设计评审(第一性原理、简单性、工具契合、人类可读、UI/UX 检查)、方案生成、架构决策记录。
限制与说明:文中明确定位为默认值而非教条,偏离需有记录理由;未提供具体命令、版本、价格或平台信息。资料未提供作者、安装方式与开源许可等细节。