docs(sales): name the seven opportunity stages the way the locale pack ships them (#829)

[yinlianghui]

Fixes #829

按 PM 已 record 的裁定执行 方向 A：docs 跟包。唯一事实来源是 src/translations/zh-CN.ts 的 crm_opportunity.stage，语言包一字未动，src/**、en 页、content/docs/releases/ 均未触碰。也没有加守卫——那条闸挂在 #802 名下，其正文写明在「zh-Hant 无语言包」与「动词/机制名豁免判据」两个问题定下来之前不宜动手。

甲、七个阶段名

value	语言包	改前	改后
prospecting	寻找客户	开发期	寻找客户
qualification	资格审查	资格审核	资格审查
needs_analysis	需求分析	需求分析	未动
proposal	提案	提案	未动
negotiation	谈判	谈判	未动
closed_won	成交	赢单	成交
closed_lost	失败	输单	失败

锚点两页的阶段表（opportunities / pipeline-management × zh-Hans + zh-Hant）先对齐，随后逐句扫全部散文波及页：拖拽推进示例、关单原因表、$100K 大单提醒、审批终态、报价被接受时的推进、线索转化时创建商机的那一步、词汇表的 closed won/lost 条目。

判据：包里有没有这个词

这一单的散文面比 #794/#825 大一个量级，所以先立判据再动手：

• 包里根本不存在的词，出现在哪里都是漂移。 开发期、资格审核、输单 在 zh-CN.ts 中零命中，已从 zh 文档中清除。唯一放过的是 guides/integrations.zh-Han*.mdx:132 的「开发期」——那里指开发环境而非 prospecting 阶段，issue 正文已点名要放过。
• 包里确实发的词，只在「它被当作阶段名用」时才算漂移。 赢单／丢单 是语言包自己的成败词汇（赢单原因、丢单原因、赢/丢单详情、赢单数、丢单数、赢单概率），所以它们在指代原因、指标、成败结果时一律保留：「未赢单、未丢单的交易」「赢单率」「赢单原因」「赢单/丢单复盘」照旧；只有读者会拿它去界面上找阶段值的地方才改，例如「阶段会被自动设为赢单」→ 成交。

由此派生出一处值得单独说明的取舍：文档把 赢单 与非包词 输单 配对来指代两个原因字段（而非两个阶段）时——状态机的关单必填、cube 维度、Win/Loss 报表——包里的对应词是 丢单 而不是 失败，故这几处写作「赢单/丢单原因」。

⚠️ 资格审查 vs 资格评估：未互串

crm_opportunity.stage.qualification 是「资格审查」，crm_lead._sections.qualification 是「资格评估」，两者在包里是有意分开的（#793 追评、#825 定调）。本 PR 只把商机侧阶段表的「资格审核」改成「资格审查」；leads 三处与 sales/index 一处的「通过资格审核 / 应用 BANT 资格审核」是人做的动作、不是任一标签，#825 已明确保留，本次同样未动。leads 页的「资格评估」区块名也原样保留。

乙、convert 动词面

convert_lead 的 label 是「转化线索」，而 sales-copilot.zh-Hans.mdx:63 白纸黑字把这个按钮叫「转换线索」，已改为包里的写法。另按「行号按最新 main 重核」的要求复核了 issue 列出的其余四处，并顺带修正了 issue 正文的一处事实偏差：

issue 说「zh-Hant 版同段落没有这个写法」——实测有。sales-copilot.zh-Hant.mdx:63 写作「轉換潛在客戶」，同样在点名这个动作。

这四处的共同形状是简繁不同步：quick-tour.zh-Hans:54,64、introduction.zh-Hans:23、testing-and-ci.zh-Hans:266 早已是「转化」，只有繁体孪生页还停在「轉換」；accounts 则相反，简繁两侧都还是「转换」。本次把繁体侧补齐（quick-tour 同页 :60 属同一条线索转化链，一并处理），并按语言对偶补上 accounts.zh-Hant:62——#803 只修 quotes 页、留下 index 页给 #825 的教训就在这里。

文件面（25 个 zh 页 + changeset，62 行）

• 甲组锚点：sales/opportunities.zh-Han{s,t}.mdx、sales/pipeline-management.zh-Han{s,t}.mdx
• 甲组散文：sales/leads.zh-Han{s,t}.mdx、sales/index.zh-Han{s,t}.mdx、sales/quotes.zh-Han{s,t}.mdx、administration/state-machines.zh-Han{s,t}.mdx、reference/glossary.zh-Han{s,t}.mdx、analytics/cubes.zh-Han{s,t}.mdx、analytics/reports.zh-Han{s,t}.mdx
• 乙组：ai-copilot/sales-copilot.zh-Han{s,t}.mdx、sales/accounts.zh-Han{s,t}.mdx、getting-started/quick-tour.zh-Hant.mdx、getting-started/introduction.zh-Hant.mdx、customization/testing-and-ci.zh-Hant.mdx
• changeset：.changeset/zh-docs-opportunity-stage-names.md

一处同句连带，明确披露：pipeline-management.zh-Han{s,t}.mdx:87 原文是「归档输单交易并附上失单原因」。失单原因 严格说属于字段标签漂移（包里是「丢单原因」）而非阶段名族，但它与被改写的 输单 同在一个分句，且 失单 同样是包里零命中的词——留着会让这一行在改写后当场自相矛盾，故一并改为「归档失败的交易并附上丢单原因」。除此之外未越界改任何字段标签。

验证

一次性对照脚本（照 #825 先例，不入库），阶段名从 zh-CN.ts 现读、不硬编码，双向跑：

改后 worktree ：ALL CHECKS PASSED（24/24）
origin/main a501812e：16 CHECK(S) FAILED
  FAIL stage table rows follow pack: opportunities.zh-Hans   -- absent as a row: 寻找客户 / 资格审查 / 成交 / 失败
  FAIL stage table rows follow pack: opportunities.zh-Hant   -- absent as a row: 尋找客戶 / 資格審查 / 成交 / 失敗
  FAIL stage table rows follow pack: pipeline-management.zh-Hans / .zh-Hant （同上）
  FAIL word absent from zh docs: 开发期 / 開發期 / 输单 / 輸單
  FAIL names the convert action as the pack labels it: sales-copilot.zh-Hans
  FAIL lead-convert verb face follows the pack: 其余 6 页

基线恰好点出每页 4 个（而非 7 个）阶段名缺失，与 issue 正文的四行 ❌ 完全吻合，needs_analysis／提案／谈判 三个未报——这是对 issue 前提的独立复核。

反向验证的方向说明：8 条「资格审查/资格评估 不互串」断言在改前改后都是 PASS，并非我漏跑。改前文档用的是第三个词「资格审核」，它既不属于商机侧也不属于线索侧，因此这组断言在此基线上本就不具判别力——它们是防我自己改反方向的护栏，不是基线失败的预测项。照实报，不硬凑成翻转。

脚本第一版用的是「整页包含该词」的判据，基线只报出 3 个缺失——因为 成交 早已借 成交日期 出现在页面上。已收紧为「该词必须占据表格行首单元格」后，基线才如实报出 4 个。含义相反的弱判据没留在 PR 里。

全量四件套（flock /tmp/os-heavy-verify.lock，NODE_OPTIONS=--max-old-space-size=4096，vitest --maxWorkers=2）：

pnpm validate  ✓ 13 warning(s), 14 suggestion(s)（均为既有，与本 PR 无关）
pnpm typecheck ✓
pnpm lint      ✓
pnpm hygiene   ✓ source hygiene clean（控制字节扫描面含 content/ 与 .changeset/）
pnpm build     ✓ Build complete — 17 Objects / 24 Flows / dist 1921.3 KB
pnpm test      ✓ Test Files 66 passed (66) · Tests 1587 passed | 1 skipped (1588)

测试输出中的 ✗ source hygiene failed: ... 数行来自 test/source-hygiene-scan-surface.test.ts ——它故意用埋雷夹具跑 hygiene 脚本并断言其大声失败，是该元测试的预期 stderr，不是真失败。

控制字符自扫（越过 gate 的盲区，26 个改动文件 + 脚本本身）：grep -naP 扫 C0 控制字节（不含 tab/LF/CR）零命中。

与 origin/main 最新的 aacc75a（#841 改了 sales/accounts.zh-Han{s,t}.mdx）实测可干净合并：其改动落在同文件 :66 一带，本 PR 落在 :62。

越界发现（已去重后另立 issue，本 PR 一处不修）

• convert 动词面：zh-Hant 侧整体没跟上简体侧，marketing/analytics/guides 等 20 余处仍写「轉換」而包里是「转化」 #844 —— convert 动词面 zh-Hant 侧整体没跟上简体侧（marketing / analytics / guides / administration 共 20 余处）。同类残留，但自成一次可一遍扫完的工作；在本 PR 里再切一小片正是 #793 的同一缺陷类在其文件面之外还剩两处：sales/index.zh-Hant 的「已到期」，与 quotes.zh-Hans 的「过期日期」×4 #801 批评的半页对半页错。⚠️ 该单里 state-machines 页的「状态转换」是机制名不能动。
• crm_opportunity.forecast_category 的 best_case 在 zh 文档有三种写法：包里「最佳情况」，opportunities 写「最佳可能」，automation 写「最好情况」 #845 —— forecast_category.best_case 在 zh 文档有三种写法（包里「最佳情况」，opportunities.zh-Han{s,t}:128,134 写「最佳可能」，automation.zh-Han{s,t}:91 写「最好情况」）。其中 4 处就在本 PR 已经在改的锚点页上，但属 forecast_category 而非 stage，越界未动，故明确挂账。
• [观察] zh-CN.ts 的 help 串与它自己的 label 打架：help 说「线索转换」「关闭为赢单」，而 label 是「转化线索」「成交」 #846（finding）—— 语言包内部自相矛盾：zh-CN.ts 的 4 个 help 串用了自己 label 不用的词（name_normalized/company_normalized 说「线索转换」而 label 是「转化线索」；win_reason/loss_reason 的 help 引号点名「赢单」/「丢单」两个阶段值，而阶段 label 是「成交」/「失败」）。这是 zh 文档里 crm_opportunity 的 7 个阶段名有 4 个与语言包不符（开发期/资格审核/赢单/输单），且这一组该动哪边未定 #829 当初 A/B/C 之争里方向 B 唯一没被摆上台面的证据；建议 B1（help 跟 label），不产生文档返工。

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
hotcrm	Ignored		Aug 5, 2026 11:23pm