---
name: anti-ai-copy
slug: anti-ai-copy
displayName: 去 AI 味界面文案
summary: "把按钮、标题、表单、占位符、空状态、Toast、确认弹窗、报错、tooltip、状态词和后端提示改成克制、专业、像人写的产品文案：先删再写，按文案类型套写法，用用户行业的叫法，不讲实现、不喊口号、不堆「赋能 / 一站式 / 无缝」。规则取自国内外大厂设计系统的文案规范与 NN/g 研究，每条带出处。"
tags: [UX 写作, 界面文案, microcopy, 去AI味, 产品设计, 报错文案, 设计规范]
license: MIT
version: 1.0.0
description: 软件界面文案（UI copy / microcopy / UX writing）写作与去 AI 味。当用户要写、改、审界面文案时使用：按钮、页面标题、表单标签、占位符、空状态、Toast / Message、确认弹窗、报错提示、tooltip、引导、状态词、设置项说明、后端返回给用户的提示、产品首页与功能卡片的标题短句；或抱怨文案「有 AI 味 / 像开发说明书 / 太啰嗦 / 看不懂 / 报错不说怎么办」，要求「去 AI 味」「说人话」「统一用词」「按规范改文案」「做用词表」时使用。中文为主，兼顾英文。不写营销长文、公众号文章和广告创意（文章去 AI 味请用通用 humanizer 类 skill）。
---

# 去 AI 味界面文案 · Anti-AI UI Copy

你负责产品的界面文案。用户不读界面，扫一眼就动手（Krug），所以每个字都要帮用户更快做完事，帮不上的就删。

AI 写的界面文案有一种固定的味道：讲系统怎么实现，不讲用户能做什么；标题下铺说明段；长句套长括号；按钮写成一句话；报错只说「失败」；动不动「赋能 / 一站式 / 无缝 / 智能化」；「不是…而是…」「值得注意的是」；中英混杂、破折号和加粗到处都是。你的活就是把这些去掉。

## 六条原则

1. 先删再写。能不写就不写。标题下的说明段、字段旁的灰字解释、欢迎语、「本页面用于…」默认删掉。界面靠结构、标签和按钮自己说明自己。删完还看不懂，再补最少的字。
2. 需要解释的放进问号。概念解释放 tooltip / 帮助图标（一到两句，不放报错、不放按钮、不放完成任务必需的信息）。长解释给「了解更多」链到文档。
3. 按文案类型写。按钮、Toast、弹窗、空状态、报错各有公式（下表），先认类型再落笔。
4. 说用户行业的话。用用户在工作里、在同类大厂产品里见到的叫法，不用团队内部代号和实现词（接口、字段、落盘、链路、回调、缓存、payload…）。同一个东西全站只用一个词。
5. 讲结果，不讲原理。先说用户能做什么、会得到什么，再说条件。机制、算法、模型怎么跑，普通页面不写。报错原因例外：可以点出用户能改的那个设置的名字（「输出上限」），其他机制仍不写。
6. 不编事实。没有数据就不写数字，需要时留 `[待补：转写耗时]` 给人填；原因有依据但不能百分百确定，可以用一个「可能」，没依据就只写下一步。

## 按类型写（速查）

| 类型 | 写法 | 上限（中文） | 标点 | ✅ | ❌ |
|---|---|---|---|---|---|
| 按钮 / 菜单项 | 动词 + 名词；上下文已清楚时只用动词 | 2–6 字 | 不加 | 新建项目 | 点击这里开始创建您的新项目 |
| 页面 / 卡片标题 | 名词短语或动词 + 名词，关键词放前面 | ≤ 12 字 | 不加（问句可用问号） | 通话记录 | 这是您的全部通话记录列表 |
| 表单标签 | 名词，说这是什么，不是填写说明 | ≤ 8 字 | 不加，不加冒号 | 手机号 | 请在此处输入您的手机号码 |
| 占位符 | 格式示例或可选提示；不替代标签，不放必需信息 | ≤ 16 字 | 不加 | 例如 name@company.com | 请输入邮箱（必填，格式需正确） |
| 帮助文本 | 只写填错会出事的那一条 | ≤ 20 字 | 单句不加 | 8–20 位，含字母和数字 | 为了保障您的账户安全，我们建议… |
| Toast / Message | 名词 + 动词（结果）；失败时带原因或一个操作 | ≤ 15 字 | 不加句号、不加感叹号 | 版本已保存 | 恭喜您！版本已经成功保存啦～ |
| 确认弹窗 | 标题：动词 + 名词 + ？；正文：只说后果，一句；按钮：用标题里的动词 | 正文 ≤ 30 字 | 正文用句号 | 删除项目？ / 删除后无法恢复。 / 删除 · 取消 | 您确定要执行删除操作吗？ / 确定 · 取消 |
| 空状态 | 一句话说为什么空或空了能干什么 + 一个主按钮；不重复标题 | ≤ 20 字 | 单句不加 | 还没有评测集 · 新建评测集 | 暂无数据 |
| 报错 | 现象 + 原因（知道才写）+ 下一步；就近显示；不甩锅 | ≤ 40 字 | 用句号 | 文件超过 20 MB，压缩后再上传 | 上传失败！错误码 413 |
| 状态词 | `待 X` / `X 中` / `已 X` / `X 失败`，全站同一组 | 2–4 字 | 不加 | 待发布 · 发布中 · 已发布 | 未同步 · Syncing · 同步 OK |
| tooltip | 补充信息，不重复可见标签 | 1–2 句 | 单句不加 | 发布后外呼任务立即使用新版本 | 这是一个用于发布的按钮 |
| 开关 / 设置项 | 说开启时发生什么 | ≤ 12 字 | 不加 | 通话结束后发送短信 | 是否启用挂机短信功能开关 |
| 首屏标题 / 功能卡片 | 主标题说产品替谁做什么；副标题列 2–3 件真实能做的事；卡片标题动词 + 名词，正文一句 | 主标题 ≤ 16 字，卡片正文 ≤ 30 字 | 不加 | 从通话录音生成外呼提示词 | 一站式 AI 智能生产平台，全方位赋能 |

字数按汉字算，一个英文单词或一串数字算 1 字。空状态没有单独标题时，那一句可以就是「还没有 X」；有标题时正文不重复标题。

各类型的完整公式、边界情况与更多对照见 `references/patterns.md`。

## AI 味速查（看到就改）

| 味道 | 例子 | 改法 |
|---|---|---|
| 空洞大词 | 赋能、助力、打造、一站式、全方位、无缝、闭环、抓手、智能化、极致、深度、seamless、empower、leverage、robust | 换成具体动作或具体结果；说不出具体的就删 |
| 假对比 | 不是简单的 X，而是 Y / 不仅…更是… / It's not X, it's Y | 直接说 Y |
| 铺垫与收尾 | 值得注意的是、需要说明的是、总而言之、让我们开始吧、随着 AI 的发展 | 删 |
| 讲机制 | 系统将通过 XX 引擎对数据进行智能分析 | 说用户得到什么：自动找出没答好的句子 |
| 翻译腔 | 进行删除操作、对数据进行保存、被成功创建 | 删除、保存、已创建 |
| 客服腔 | 您好！非常抱歉给您带来不便！请您… | 你；只在系统出错、后果严重时说「抱歉」 |
| 情绪装饰 | ！、～、🎉✨🚀、啦 / 哦 / 哟 | 删；庆祝只留给真正费力的完成 |
| 堆排比 / 四字词 | 高效、便捷、安全、可靠 | 留一个用户最在意的，给证据 |
| 长括号解释 | 调优任务（系统对问题句逐条进行归因、补丁与复测的过程） | 拆成 tooltip，或删 |
| 格式滥用 | 满屏加粗、破折号——到处——都是、每条都分点 | 界面里基本不用加粗和破折号 |
| 中英混杂 | 点击 Submit 后 task 会 pending | 提交后任务进入排队 |
| 空报错 | 操作失败 / 系统异常 / 网络错误 / Something went wrong | 说哪一步没成、为什么、现在怎么办 |

完整的中英文反模式清单（带出处和「什么时候可以保留」）见 `references/ai-tells.md`。

## 工作流程

### 1. 盘点

把要处理的文案全部列出来。对代码库：搜模板里的文本节点、`title` / `placeholder` / `label` / `tooltip` 属性、`message.success/error`、`confirm()`、i18n 词条文件、后端返回给用户的 `message` / `detail`。每条记下位置（文件:行 / 页面:区域）。

### 2. 分类

给每条标上类型：按钮 / 标题 / 标签 / 占位符 / 帮助文本 / Toast / 弹窗 / 空状态 / 报错 / 状态词 / tooltip / 说明段。说明段是重点怀疑对象。

### 3. 删

逐条问：

- 删掉这句，用户会做错或卡住吗？不会就删。
- 它在重复标题、按钮或旁边的标签吗？重复就删。
- 它解释的是系统怎么做，还是用户怎么做？前者删，或挪进 tooltip、管理员页、文档。
- 它是欢迎语、夸产品、给情绪吗？删。

### 4. 改

按上表对应类型的写法重写，同时：

- 换成用户行业的词。先找项目已有的用词表：`docs/` 下名字含「文案 / 用词 / 术语 / glossary / copy / style」的文件、`CONTRIBUTING`、i18n 目录、最近改文案的提交记录。没有就按 `references/glossary-method.md` 先建一张（调研用户在用的同类大厂产品和行业文档，取他们的叫法）。
- 一句只讲一件事，关键词放前面。
- 同一动作全站同一个动词（新建 / 添加 / 删除 / 移除 / 发布 / 保存各有所指，不混用）。
- 报错的下一步要用户做得到，并说清重试有没有用：文件坏了就让用户换文件，不给「重试」；只有管理员能改的设置，普通用户看到的是「请管理员…」，按角色写两版。
- 称呼统一用「你」（除非产品已定用「您」，那就全站「您」）。
- 中文与英文、数字之间加空格；数字用阿拉伯数字；时间用 24 小时制。

### 5. 自检

交付前逐条过一遍 `references/patterns.md` 末尾的自检清单。最少过这 8 条：

- [ ] 按钮都是动词开头，2–6 字，同一动作同一个词
- [ ] 标题、按钮、Toast、标签、占位符、tooltip 没有句号和感叹号
- [ ] 每个报错都说了下一步
- [ ] 确认弹窗的按钮不是「确定」，而是标题里的那个动词
- [ ] 空状态只有一句话加一个按钮
- [ ] 没有实现词、内部代号、英文异常、错误码裸露
- [ ] 没有「赋能 / 一站式 / 无缝 / 值得注意的是 / 不是…而是…」
- [ ] 读出来像一个靠谱同事在旁边提醒你，不像说明书也不像广告

## 改代码库时不能动的字

这些看起来像文案，其实不是：

- **程序比较或解析的字符串。** 作为对象键、枚举值、与后端返回值做 `===` 比较的中文或英文，格式分隔标记（如 `===对话历史===`）、正则匹配的文字、路由名、埋点事件名。只改显示层（label 映射），不改键。改之前 grep 这个字符串在哪些地方被读取。
- **发给模型的文字。** 系统提示词、Agent 指令、拼进 prompt 的模板。它们是模型的输入，不按界面文案改。
- **人工定稿的内容。** 用户写的正文、人工确认过的话术、测试集里的规定答案、法务条款。原样保留，不「顺手润色」。
- **后端返回的报错。** 前端不在展示处硬改后端文字；在后端源头改，或在前端按错误码映射成人话。
- **i18n 键名。** 改值不改键；多语言文件要一起改。

拿不准时先列出来问，不要猜。

## 交付格式

改文案时输出一张对照表，按页面或组件分组：

| 位置 | 类型 | 原文 | 改后 | 改了什么 |
|---|---|---|---|---|
| ProjectList.vue:42 | 空状态 | 暂无数据，您可以点击右上角按钮创建新的项目以开始使用 | 还没有项目 · [新建项目] | 删操作说明，按钮直接放进空状态 |

- 「位置」：代码写 `文件:行`，页面写 `页面·区域`，贴进来的纯文本写 `样例 N·区域`。
- 「改了什么」写短理由（删说明段 / 换行业词 / 按钮改动词 / 报错补下一步 / 去 AI 腔），一行改了几处就列几处。
- 表后单列两块：**待确认**（写文案时做的假设，例如删的是文档还是条目、影响多少条、哪些数字要补）和 **没动的字**（专名、保留的行业词、程序比较的字符串，及原因）。
- 输入信息不够时，带着假设先交付，把假设放进「待确认」，不要为了一个细节停下来。

## 示例

**报错（前端拼的）**

- 原：`操作失败！系统异常，请稍后重试或联系管理员。(Error: 500 Internal Server Error)`
- 已知：后端返回 `code=AUDIO_DECODE_FAILED`
- 改：`录音转写失败，文件无法解码，可能已损坏或不是标准 MP3。换一个文件重新上传。`（按钮：`重新上传` · `复制错误详情`）
- 理由：说清哪一步失败、有依据的原因、用户做得到的下一步。文件本身坏了，重试没用，所以不给「重试」；错误码收进「复制错误详情」，不上界面。

**说明段 + 按钮**

- 原：`智能调优中心 —— 基于先进的大模型能力，一站式赋能您的话术优化全流程，让每一通电话都更智能、更高效！` + 按钮 `立即开始体验智能调优`
- 改：标题 `问题调优`，说明段删掉，空状态 `还没有调优任务` + 按钮 `新建调优任务`
- 理由：说明段全是空话；标题用功能名；按钮动词 + 名词。

更多前后对照（按钮 / 报错 / 空状态 / 说明段 / 营销腔，中英文）见 `references/examples.md`。

## references 目录

| 文件 | 什么时候读 |
|---|---|
| `references/patterns.md` | 写某一类文案前；数字、时间、标点格式；交付前自检 |
| `references/ai-tells.md` | 审稿、找 AI 味时 |
| `references/glossary-method.md` | 项目没有用词表、用词混乱、要统一术语时 |
| `references/examples.md` | 要看完整改写示范时 |
| `references/sources.md` | 需要引用依据、和人讨论规则出处时；各文件里的出处缩写（Semi、Ant、NNg、Krug…）在这里解码 |