怎么做得可信

降低读者理解内容与形成判断的负担：把相关事实、可查看的结果和必要说明组织清楚，让用户容易看懂、选择和继续操作。可信来自内容有据、预期与实际一致、状态反馈准确。

降低理解与判断的负担

内容取舍、组织与句子表达遵循 document-writing 的《文档写作原则》。在界面中，结合读者当前需要、已有知识和眼前内容，判断文字应帮助他理解什么、作出什么选择。

让读者直接接触相关对象、具体事实和可查看的结果。抽象定位与自我评价若要求读者猜测含义、辨别宣传或另找依据，就用具体内容替换或删除。把宣传词换成中性措辞，可能仍留下同样的核实负担。例如，“最近在做 AI 和 Agent 相关的项目”需要读者继续寻找具体所指；首页已有项目与笔记时，可以直接呈现这些内容。

文字与标题、布局、内容和操作共同传达信息。把文案放回实际界面，连同字段、布局和操作判断哪些信息已经可见。说明放在读者需要它的位置，补足影响理解与选择的背景；页面已经表达清楚的内容，删去重复介绍。例如，表单没有姓名字段时，通常无需再写“无需填写姓名”。内部流程、制作工具与设计理由，按它们对读者当前任务的作用决定是否呈现。

把设计要求组织成适合阅读的内容。“用途、贡献、状态”用于检查信息是否充分，呈现时根据实际内容选择介绍、标记或入口。例如，合作成果可在介绍中说明各自贡献，维护状态在影响使用选择时就近标明。名称采用读者熟悉的说法，放进导航、标题、链接和反馈中检查完整表达，确保自然且去向清楚。

语气符合表达用途与说话者。个人记录可以呈现经历、观点和感受，操作提示清楚说明动作与结果。润色后对照原意，核对信息范围、确定程度和承诺是否改变。例如，“不在网站公开”改成“只有我能看到”，增加了对访问范围的承诺，不能仅因后者更口语就替换。事实准确，判断有依据，计划与演示样例如实区分；关键主张附近提供便于查看的材料或来源。修正错字和失效链接，让读者能够顺畅阅读与核实。

承诺必须与实际行为一致

操作名称、数据含义与实际行为一致；自动推断有不确定时允许检查和修正，不用猜测填补记录空白，不用无根据的结果冒充完成。沿一次操作理清：输入从哪里来、改变什么、何时生效、失败后保留什么、能否撤销，提供足以判断现状的信息。

提交时机由纠错需要、误发代价和已有授权决定，已授权的自动发送不必重复确认。

入口名称、分组和数量同样是对内容的承诺：用户据此预计会看到什么，到达后应与预期一致。作用范围在页面上就近交代，不塞进名称；同一对象在不同入口的含义保持稳定，不因内部实现或一次反馈悄悄改变。统一的是行为含义和控制边界，不是按钮数量或页面形式。

状态与错误如实反馈

反馈说明实际发生了什么，而不是系统希望用户相信什么。普通状态在相关对象附近被动显示；重要且需要立即决定的信息才打断，频繁无意义确认会训练用户直接略过。

状态	应说明什么
已受理或处理中	正在做什么、是否需要等待；只显示真实可得的进度
完成	哪个结果已生效；重要事务提供回执或可再次查到的结果
部分完成	成功与未完成的范围，哪些可继续或重试；避免重复执行
失败	用户能懂的问题、实际影响和下一步动作，保留可恢复输入
超时、取消或结果未知	区分本地停止等待与远端执行结果，提供实际可用的查询或恢复途径

失败信息定位到对象与原因：字段旁说明具体要求，避免笼统提示输入无效；无权限、服务不可用不伪装成用户填错，无法确认原因时如实说明。承诺要有机制支撑，只报告已经成立的状态。输入纠错的具体方法见怎么做得好用。自动化、命令行和对话回复遵守同一状态含义，区分“建议”“计划执行”“已实际完成”。

怎样验证

按读者的实际顺序浏览页面或输出，检查读完后还需要做什么：是否要猜测抽象词的含义、核实一句自我评价、把内部流程翻译成自己的用途，或从重复介绍中寻找有效信息？结合内容、命名、顺序与说明减少这些工作。对介绍和提示做删除比较，保留帮助理解与选择的信息；同时核对入口名称带来的预期与实际到达的内容是否一致。

再检查一条正常操作和一次失败：用户能否解释当前状态、理解错误原因并知道下一步？重复触发、超时后重试会不会重复执行？相同约定在相关入口中是否仍然成立？体验原型验证理解与操作，实际环境验证状态与结果是否如实兑现，分别报告证据与模拟范围。