0、先破后立：别把软件 VI 当"改个 Logo、换套颜色"，那只是皮；真正的 VI 是让产品长期"长得一致、说得一致、做得一致"。
很多团队写 VI，写着写着就变成"视觉资产打包"：给几个色值、放几张示例图，然后结束。结果是页面越做越多，风格越漂越远；新同事接手时靠猜，外包交付时靠运气。合格的软件 VI 文字文档，目标很直白：降低沟通成本，减少返工，让每一次新增页面和每一次改版都更可控 。
下面这份"简单版"，按工程口径写：交付、可控、复现、成本、安全，再加一个"品牌一致性"（因为 VI 不讲这个就失焦）。每段只讲能落地的内容。
1、交付：一份合格的 VI 文档，第一要件是"能直接拿去做"，而不是"看完感觉对"。
文档里要把交付件列死，别含糊。最少包含这些条目：
- 品牌一句话：产品是什么、给谁用、想让人记住什么气质（3 行以内）。
- 命名规则：产品名、模块名、功能名怎么写；中英文、大小写、空格、连字符统一口径。
- 基础视觉资产：Logo 规范（留白、最小尺寸、禁用示例）、主辅色、字体与字号层级、图标风格一句话定义。
- 核心组件口径：按钮、输入框、表单、弹窗、表格、通知、空状态、加载态、错误态------每个给"何时用 + 不要怎么用"。
- 文案基调：提示语、报错、确认弹窗的语气；能不能用感叹号，能不能用俚语，默认怎么称呼用户。
- 输出形式：PDF/在线文档链接/设计稿入口/组件库入口/更新日志入口，一次交齐。
写 VI 不怕短，怕"交付不完整"。只要能让别人照着做，就合格了一半。
2、可控：VI 不是审美表达，是约束系统；约束越清楚，风格越不跑偏。
可控的关键是"边界"。你要明确哪些能改，哪些不能动：
- 固定项：Logo 使用、主色、字体体系、间距网格、圆角、阴影、图标线宽等，写成"禁止项 + 例外条件"。
- 可变项：活动页允许更活泼？营销位能用渐变？插画能不能换风格？把弹性范围写清。
- 优先级规则：冲突时听谁的------可用性优先还是品牌优先？无障碍优先还是视觉优先？给一句硬规则，别让团队现场吵架。
- 审查口径：什么程度需要设计 review，什么程度产品经理就能放行；把门槛写出来。
一句话：可控的 VI，是把"我觉得"变成"按规则"。
3、复现：合格的 VI 文档要能"复刻同一种效果"，让新人和外包也能做出同款。
复现靠的是"步骤"和"示例"，而不是长篇概念。建议写三类最有用的东西：
- 页面模板：后台列表页、详情页、表单页、移动端信息流页，各给一个骨架：栅格、边距、标题区、操作区、信息区怎么排。
- 状态全家桶：成功/失败/警告/处理中/禁用/空/无权限/网络错误------每种状态的颜色、图标、文案、按钮策略写清。
- Do / Don't：每个关键点给 1--2 个正例和反例，反例越具体越省时间。
复现的判断标准很简单：把文档扔给一个没参与项目的人，他能不能做出和你们差不多的页面。
4、成本：VI 文档的价值不在"写得多"，在"减少重复劳动、减少返工"。
成本控制靠三件事：
- 组件优先：先规定组件，再谈页面。页面是组件的组合，组件稳定，页面就不会乱。
- 最小可用集：别一口气把所有场景写全，先把 80% 高频场景写到能用：按钮、表单、表格、弹窗、提示、空状态。其余用"扩展条款"挂着。
- 版本与变更机制：写清楚谁维护、多久更新一次、如何提改动、如何废弃旧规范。没有变更机制的 VI，半年就变成古董。
一句话：VI 写得越像"团队公共资产"，后期越省钱。
5、安全：软件 VI 也有安全线，尤其是"信息展示"和"误操作"两类雷。
很多人以为安全只在后端，其实界面一样能埋坑。VI 文档至少要写这些底线：
- 敏感信息展示规则：手机号、身份证、邮箱、金额、定位、密钥类字段，默认如何脱敏；什么场景允许全量展示；截图风险怎么提示。
- 权限与不可见：无权限是"隐藏入口"还是"展示但置灰"，不同产品不同策略，但必须统一。
- 高危操作样式：删除、清空、解绑、转账、发布、回滚等，危险按钮颜色、二次确认文案、默认焦点放哪、是否需要输入校验（如输入"DELETE"）写清。
- 错误信息口径：前台提示要对用户友好，后台日志要对排查友好；哪些信息不能在前台暴露（例如内部路径、表名、堆栈片段）。
一句话：VI 不是只管好看，也要管"不出事"。
6、品牌一致性：软件 VI 的终点是"用户认得出这是你"，不靠花哨，靠一致。
品牌一致性落到文字文档里，最有效的是把"气质"翻译成可执行规则：
- 语气词典：哪些词常用、哪些词禁用；同义词选哪一个（例如"保存/提交/确认"统一用哪个）。
- 信息层级：主标题怎么写，副标题怎么写，按钮文案用动词还是名词；长度上限建议。
- 插画与动效：能不能用拟物、能不能用夸张表情、动效节奏偏快还是偏稳；动效使用场景边界写清。
- 跨端一致：Web、iOS、Android、桌面端是否同一套组件口径；差异允许在哪些点出现（如导航样式、系统字体）。
一句话：一致性不是"都一样"，而是"变化有规则"。
快速测评清单（拿这张表，你就能自己验收 VI 文档合不合格）
- 交付完整度：是否明确列出交付件清单，并能一键找到入口（文档、设计稿、组件库、更新日志）。
- 可控性：是否写清固定项/可变项/例外条件/审查门槛，团队争议点能否按规则裁决。
- 复现能力：给新人 2 小时，他能否按文档做出列表页+表单页，并且样式接近现有产品。
- 返工概率：同一页面改三次后，是否还在改"风格不对"而不是改"需求变化"。
- 组件覆盖率：按钮/表单/表格/弹窗/通知/空状态/错误态是否齐全，缺口是否有扩展条款承接。
- 安全底线：脱敏、高危操作、权限态、错误提示是否有统一口径，并给出示例文案。
- 跨端一致：多端差异是否被允许且被记录，还是靠各端"自己理解"。
- 可维护性：是否有版本号、维护人、变更流程、废弃策略；能否追溯每次改动原因。
- 可读性：是否短句为主、规则清晰、示例够用；读者扫一遍能抓住要点。
- 落地结果：随机抽 5 个页面，视觉与文案是否能看出同一套体系，组件是否复用而非手搓。