万形报告

第一章

壹 执行摘要

文心（Wenxin）是一套根植于东方美学的当代设计语言。它以"文字即界面，留白即设计，克制即力量"为核心命题，通过七维度映射与九种输出形态，构建了从响应式Web到学术印刷、从品牌标识到知识图谱的完整设计表达体系。

本研究通过分析文心设计语言的架构、Token体系、演化框架和审计机制，论证了以下核心发现：

第一，灵魂与形态的两层结构是文心适应性的关键。将A9（克制之美）、B9（温暖极简）、D9（暖土调）定义为不可改变的"灵魂"，而将布局、导航、动效节奏定义为随产品类型变化的"形态"，使得文心既能保持核心识别，又能适配从博客到研究报告的九种产品形态。

第二，显式化的设计Token体系降低了设计复现成本。色彩、字体、间距、动效均以CSS变量形式明确定义，三层Token架构（参考层→语义层→组件层）使得从Web到印刷的色彩映射有据可循。

第三，多层审计机制保障设计质量。Render Contract审计（机器事实层）配合34条美学准则（人工判断层）和截图视觉审计（体验层），形成从确定性约束到主观审美的完整质量保障链。

第四，F9报告形态是文心的"集大成者"。它将论证结构本身作为阅读界面——摘要、问题、方法、发现、证据、建议——通过LaTeX排版编译为可独立阅读的PDF，标志着文心从"设计工具"到"思考工具"的跃迁。

本报告同时指出文心的适用边界：以内容/信息为核心的产品（博客、文档站、作品集、研究报告）是文心的最佳适配场景；数据密集型Dashboard、电商、游戏等产品不在文心的适用范围内。

第二章

贰 语境：文心设计语言的起源与问题

2.1 万形：OpenCode设计工程

万形（Wanxing）是一个专注于文心设计语言的OpenCode设计工程项目。它的核心理念是：文字即界面，留白即设计，克制即力量。进入万形项目目录后，OpenCode自动加载文心设计规范，用户只需描述需求即可产出完整的UI设计。

万形的架构分为四层：Meta Agent负责需求理解和约束澄清；Wenxin Agent负责具体的HTML/CSS设计执行；Audit Agent负责Render Contract、规则适配、截图视觉和动画运行时的多层审计；Rules和Tokens提供完整的规范和变量定义。这套架构使得设计工程从灵感驱动转变为规范驱动，每一次设计决策都有据可循。

2.2 当代设计系统面临的困境

当代设计系统工程面临一个根本性的困境：刚性与柔性的张力。过于刚性的设计系统（组件库严格统一、色彩固定、布局模板化）虽然降低了协作成本，但抹杀了不同产品类型的独特气质——一个博客不应该看起来像一个SaaS后台。而过于柔性的设计系统（仅提供原则性指导、无强制约束）又导致品牌碎片化——同一品牌的不同产品看起来像来自不同的设计团队。

设计的本质不是统一，而是协调。统一是花圃——所有花被修剪成同一高度；协调是草地——每一株草都在自己的位置生长，但整体形成一片自然的和谐。

2.3 文心的回应：灵魂与形态的两层结构

文心设计语言提出的解决方案是一种"灵魂与形态"的两层结构。

灵魂层（Soul）——永远不变：色彩系统（暖土调）、字体哲学（温暖衬线）、留白密度（高留白）、点睛之色（砖红Accent，全页≤2处）、动效节奏（春雨润物，细节有声）。这些是文心的身份标识，改变它们即改变文心的本质。

形态层（Form）——随境而化：布局结构、导航形式、内容组织方式。形态层完全尊重该产品类型的行业UX最佳惯例——博客用单列居中，文档站用双栏侧边栏，演示文稿用16:9画布。文心不为了"风格统一"而强迫所有产品使用同一种布局。

这种结构可以类比于水：水的化学本质（H₂O）不会改变，但它在杯子里是杯子的形状，在河道里是河道的形状。用户感受到的不是"风格统一"，而是"说不出的舒服"——这就是润物细无声。

第三章

叁 方法：设计Token体系与演化框架

3.1 七维度映射

文心设计语言对应七个维度的固定值，每个维度选择都有其哲学理由：

3.2 设计Token三层体系

文心的设计Token体系分为三层，确保从抽象到具体的完整映射路径：

参考层（Reference）——原始色值定义。例如 --color-accent: #8B3525，这是最基础的色彩事实。

语义层（Semantic）——功能性命名。例如 --color-text-primary: #3A3837、--color-border-subtle: #E5E1DA，语义Token使设计意图可读、可维护。

组件层（Component）——组件级绑定。按钮hover态使用 --color-accent，表单错误态使用 --color-accent，语义Token在具体场景中的使用形成组件的一致性。

这种三层架构的价值在跨形态适配中尤为突出。当设计从Web（F1）演化到印刷（F4）时，语义层保持不变（"这是正文色"），但参考层的值从屏幕RGB映射到印刷CMYK。当设计从亮色模式切换到暗色模式时，语义层同样保持不变，但参考层的值被重新定义。

3.3 演化框架：不可变之魂与可变之形

文心的演化框架定义了哪些维度不可改变，哪些维度可以适配：

不可变之魂（Invariant Soul）：A9（克制之美）、B9（温暖极简）、D9（暖土调）在任何演化中不可改变。改变即破坏文心身份。

可变之形（Flexible Form）：F（输出形态）——Web到Report的九种适配；G（文化语境）——东亚到全球中性的本地化；C（排版节奏）——平台特定的字号阶梯；E（动效理念）——平台特定的交互反馈。

演化审计规则要求：任何演化提案必须声明可变维度并说明调整理由，执行34条美学审计，确保不变之魂完整，所有Token值从文心正典派生。

第四章

肆 发现：九种输出形态的分析

文心正式输出形态固定为F1-F9。每一种形态在保持灵魂层不变的前提下，适配目标媒介的行业惯例。以下是对九种形态的系统分析。

4.1 形态全景

4.2 F9文心报告：论证即界面

F9是文心形态谱系中的特殊存在。它不追求浏览体验（如F1 Web）、搜索体验（如F6 Docs）、或视觉冲击（如F7 Poster）——它追求的是论证体验。

F9的核心命题是"论证即界面"。报告不是网页，也不是幻灯片。它是一种判断型文档：通过摘要、问题、方法、发现、证据、建议的结构化排列，让读者安静地进入一个结论。在F9中，标题的层级、段落的节奏、脚注的位置、图表caption的措辞——这些都是"界面元素"。

核心路径：Markdown → Wenxin Report LaTeX → PDF。用户以Markdown撰写草稿，通过frontmatter声明报告结构，经由XeLaTeX编译引擎排版为PDF。HTML仅作预览——PDF是主交付物。这一设计确保F9报告可以独立阅读、独立存档、独立引用。

4.3 与F4（印刷）和F6（文档站）的边界

F9与F4、F6的边界需要精确划定，避免形态间功能重叠：

F9可复用F4的印刷Token和页边距思想，但不承担书籍出版系统（奇偶页、首字下沉、章节装饰）。F9可包含F8图解，但图解本身作为独立实体遵循F8规范。这种"组合而非替代"的形态关系，使得文心九种形态可以灵活组合来满足复杂的设计需求。

第五章

伍 证据：设计审计数据

5.1 美学审计体系

文心审计体系建立在34条当代美学准则之上，覆盖5个大类：

其中WCAG 2.2 AA被设为阻断性准则——不达标即方案不可交付。这体现了文心对无障碍的底线态度：设计的美好不能以排除任何用户群体为代价。

5.2 Render Contract审计

Render Contract审计是Audit Agent之前的机器事实层。它读取HTML内嵌的wanxing-render-contract JSON，从DOM/CSS中自动提取结构、色彩、排版、动效、无障碍指标。

Hard Gate（阻断条件）：

• Accent出现次数超过2处
• 使用高饱和蓝、绿、紫、橙
• 使用渐变背景、装饰阴影、拟物纹理
• 动效中出现旋转、弹跳、位移超过16px
• 缺少Focus-visible样式
• 缺少prefers-reduced-motion支持
• 形态特定违规（F4有动画、F5非16:9等）

Hard Gate失败时，审计流程立即阻断，不进入后续的截图视觉审计和动画运行时审计。这种"先阻断确定性错误"的策略避免了在无效输出上浪费审计资源。

5.3 多层审计流程

完整的审计流程由四层证据合并而成：

1. Render Contract——机器事实审计，提取DOM/CSS/动效指标
2. Wenxin Rule Fit——检查A9/B9/D9/E9是否符合规范
3. Visual Screenshot Review——Playwright多视口截图+多模态视觉审计（粗筛5项+细磨11条视觉准则）
4. Motion Runtime Review——document.getAnimations()运行时采样，检查动效是否"春雨润物，细节有声"

审计结果分为三级：✅通过（Hard Gate全过）、⚠️有条件通过（无Hard Gate失败，但有审美或动效歧义）、❌阻断（存在Hard Gate失败或灵魂层破坏）。机器可判定问题（Accent超标、纯黑纯白、焦点缺失）由Meta Agent自动修复，主观问题（整体调性、留白节奏）暂停等待用户决策。

第六章

陆 诠释：文心设计语言的价值

6.1 从"看起来好看"到"决策可解释"

主流设计系统的价值主张通常是"一致性"和"效率"——它们提供预制的组件库和样式指南，降低设计和开发成本。文心不否认这些价值，但它走了一条不同的路：让每一个设计决策都可以被解释。

为什么正文的黑色不是#000000而是#3A3837？因为纯黑在暖白纸上会产生过强的对比，破坏阅读的温暖感——这是一种有意识的色彩决策，而不是"设计师觉得好看"。为什么Accent色全页不超过2处？因为朱砂印章的力量来自稀少——少即是多的设计原则被量化为了可执行、可审计的约束。

这种"显式化"的价值在团队协作和设计迭代中尤为突出。当设计师提议"这里加一个蓝色强调按钮"时，文心规范可以直接回应：蓝色不在色板中，且Accent预算已耗尽。这不是审美的冲突，而是规则的判断——规则是透明的，可以被讨论和修改，但不会被默默绕过。

6.2 「克制即力量」的实践验证

文心的Accent约束（全页≤2处，仅用于品牌标记区域）是"克制即力量"最典型的实践案例：

• 砖红色#8B3525不在正文段落中用于强调（避免读者分心）
• 不在导航中用于当前页标记（用更轻量的排版手段）
• 不在图标系统中作为默认色（仅激活/选中态除外）
• 仅出现在品牌署名区和封面标题——出现越少，力量越大

这与中国水墨画中的朱砂印章遵循同一原则：整幅画面前99%是黑白灰的水墨，只有最后1%的朱砂印章赋予画面"温度"和"署名"。如果到处盖印章，它就失去了意义。

6.3 与主流设计系统的关系

文心并不试图替代Material Design、Ant Design或Tailwind UI。这些系统的优势在于覆盖广泛的交互场景和组件变体，适合数据密集型应用。文心的优势在于内容优先场景的深度优化——当产品以文字和阅读为核心体验时，文心提供的排版节奏、留白密度和色彩克制是通用设计系统难以达到的。

可以将文心理解为一种"内容设计语言"（Content Design Language），而非"UI组件库"。它的最高成就不在于提供多少种按钮变体，而在于让用户忘记界面的存在——读者感受到的只是阅读的舒适，而非设计的存在。

第七章

柒 建议：适用场景与限制

7.1 最佳适配场景

文心设计语言最适合以下类型的产品：

7.2 不适用场景

以下产品类型不在文心的适用范围内：

• 数据密集型Dashboard——需要高密度数据可视化、实时图表、复杂筛选；这些需求与文心的留白哲学冲突
• 电商产品——需要促销标签、价格强调、商品卡片阴影；高饱和色彩和多层级视觉权重是电商的必需品
• 游戏/娱乐——需要丰富的视觉刺激、沉浸式体验、动效表演；文心的克制美学在此场景中反而成为限制
• 复杂CRM/ERP——需要密集表单、多层级表格、复杂工作流；信息密度需求超出文心舒适空间

这些"不适用"不是文心的缺陷，而是它的边界意识。一个承认自己边界的工具比一个声称无所不能的工具更值得信任。

7.3 形态上限与扩张原则

文心正式输出形态固定为F1-F9，不再继续扩张。新增形态必须满足四个条件：

1. 可独立交付——不依赖其他形态作为前置
2. 有独立使用场景——用户会明确说"我需要一个XX"
3. 有独立审计规则——不能简单复用既有形态的审计项
4. 不能被既有F1-F9优雅吸收——如果可以，就不需要新形态

Newsletter/Email、Form/Wizard、Social Cards/Carousel、Dashboard、电商、游戏、复杂3D展示等场景明确不进入正式形态。它们要么可被F1/F2/F7覆盖，要么与文心"文字即界面"的哲学根本冲突。

附录

附录 完整设计Token表

A.1 色彩Token（亮色模式）

A.2 字体Token

A.3 间距Token

A.4 内容宽度Token

— 附录完 —