跳到主要内容

当 92% 表示的含义不同

一份关于纯文本界面中自述语境文案的 UX 写作案例研究。

Sweepy 是一款基于终端的求职工具。界面用制表符线条和彩色文本绘制,并读取键盘输入。解释必须写进文本本身,因为此处没有位置显示工具提示。启动台在边框处截断状态行,而不换行。一段文案要么在宽度内写完,要么丢掉结尾。

一条规则由此而来。每段文案都自述其语境。 评分标签说明数字由谁写出。状态文案遵循同样的纪律,从启动台底部那一行一直到每个提示的格式说明。评分是最难的一例,因为无论读者是否知道工具如何得出该数字,一个百分比看上去都像是给出了信息。

两个百分比,两个问题​

Sweepy 用两种不同方式为简历评分一份招聘信息。

第一种是确定性评分器,每次扫描都会运行它。sweepy 打开启动台,START SWEEP 为扫描找到的每张卡片评分。sweepy --run 重跑上次保存的配置文件,不打开向导。这一遍比较两份文档。它统计简历与招聘信息之间的共有词,把占比 60% 的需求重合度与占比 40% 的关键词重合度混合,再按 resume.keywords_weight 缩放结果。一个词只有同时出现在两边才计入。评分器从不论断读者能否胜任这份工作。

第二种是智能体评估,通过模型上下文协议(MCP)提供。智能体把解析后的简历与招聘信息放在一起阅读,然后论断读者与该职位的契合程度。它通过 submit_judgments 提交自己的百分比。

共有词计数和智能体判断回答的是不同问题。共有词计数衡量的是重合度,不是契合度,所以标签必须写明作者是谁。计数报告简历与招聘信息共享了多少文本。智能体判断一个人与一份工作的契合程度。一份简历可以逐词复述招聘信息,却仍然描述一种较弱的契合。另一份简历用不同的词汇,却可以描述一种很强的契合。词数计数能发现第一种情况,会漏掉第二种,而智能体可以衡量两种情况。

卡片只显示一个分数。最近一次写入者决定它,一次评估会让报告围绕新数值重新排序。判断替换确定性评分,而不是并排显示。一个孤立的百分比掩盖了读者手里是两者中的哪一个。

文案必须在徽标行内、读者打开招聘信息之前说明作者。界面其余部分遵循同一条规则。

从启动台到结果​

流程为启动台 → 设置向导 → 扫描 → 结果。当一次扫描超出客户端的工具调用时限时,它会交接给一个可轮询的状态,该状态持续保持运行,直到扫描结束。

第 3 到第 8 张卡片遵循这一顺序。第 2 张卡片讲评分,评分只在扫描结束后才存在,也是整页其余部分所指向的情形。第 1 张卡片提出问题,第 9 张卡片说明它们之间每段文案背后的约束。

边框宽度截断长文案​

终端定下条件。文本是唯一解释事物的层,边框会截断任何过长内容。错误必须在同一段文案里说明问题与解决办法。读者无法离开这一行去读另一行。

文案自己承担语境成本。Could not parse salary %r. Enter a number like 65000, 65,000, or 65k. 报告什么失败了以及该改输什么,其中 %r 会被替换为被拒绝的输入。Current profile: none loaded / build one to start 对缺失的配置文件做了同样的事。图形界面可以把这两句话的后半段放进工具提示。在这里,同一行包含两半。

标签是唯一的解释​

评分标签说明数字由谁写出。文档把它说得很直白:「MATCH 卡片反映判断。KEYWORD OVERLAP 卡片反映共有词。」一张卡片上只有一个分数旁打印一个标签。读者在打开招聘信息前就知道自己拿到的是哪一种主张。

每个词还告诉读者,是哪种比较产生了这个数字。KEYWORD OVERLAP 针对两份文档。MATCH 针对一个人和一份工作。期待这两个数字对得上的读者会误读其中一个。

标签跟随作者,而不是界面。智能体可以提交判断而不带百分比。那张卡片仍然显示 KEYWORD OVERLAP,因为扫描写入了那个数字。执行路径存在于卡片之外。报告文件名用 mcp 标记 MCP 运行,日志页头打印执行方式。

卡片命名遵循同一条规则。BUILD PROFILE 说明动作,其副标题 Set up your job search 去掉内部术语,换成读者的目标。LOAD PROFILE 写 Open a search you saved,描述这张卡片做了什么。

我写了什么,以及如何核对​

角色: 本案例研究引用的产品文案的唯一作者。先写启动台副标题和向导提示,再写进度消息和校验文案。评分来源标签和客户端转发的 MCP 交接 message 最后完成。我借助 Copilot 和 Gemini 指导构建,遵循仓库级智能体准则和 CI 质量门。我对照 Sweepy 源代码核对了字面产品文案。

先校准信任,再行动​

读者应先校准信任,再依据分数行动,并在等待时知道系统正在做什么。界面无法解释 Sweepy 如何得出一个数字,也无法解释某个过程需要多久。标签和状态文案用最少的词说明这一点,采用不依赖视觉提示也能工作的形式。

十五个提示,按顺序​

向导运行十五个步骤。十五个顶层提示按顺序出现,是非题渲染为是/否选择器。

向导提示
? What is your name?
>

? What job titles are you looking for?
(Separate multiple titles with a comma)
>

? Where do you want to work? (City, State):
>

? Do you want to see remote-only roles? (Y/n)

? Do you want to include hybrid roles? (Y/n)

? What is the path to your resume PDF?
>

? What is your minimum target salary? (Leave blank to skip):
>

? Which boards do you want to search? Pick from any engine; downloaded engines are labeled.

? Do you want to add custom platforms or ATS domains? (Y/n)

? Enter must-have skills or keywords to prioritize
(comma-separated, leave blank to extract from resume):
>

? What export formats do you want?
[x] PDF Report
[x] CSV Spreadsheet
[ ] JSON Data

? Add job-tracking columns to the CSV? (date applied, status, interview stage,
offer, follow-up date, contact, notes) (Y/n)

? Do you want to configure multiple resume tracks
(e.g. Tech Writer vs UX Writer)? (Y/n)

? Do you have a portfolio, writing samples, or case studies to submit
with applications? (Y/n)

? Enable debug logging? (Logs are saved under logs/ in the application
directory): (Y/n)

在哪里核对文案​