Skip to content

convert 动词面:zh-Hant 侧整体没跟上简体侧,marketing/analytics/guides 等 20 余处仍写「轉換」而包里是「转化」 #844

Closed

Description

@yinlianghui

来源:#829(PR #842)实施时的越界发现。基线 origin/main = a501812。

#801/#825 定过调:lead 的 convert 动词面跟 convert_lead.label「转化线索」与 is_converted「已转化」,所以文档写「转化」。#829 乙组又扫了 issue 点名的五处。但把全仓 zh 页拉出来看,剩下的残留有一个清晰的形状:简体侧早就改过了,繁体孪生页原地未动。

证据:同一行,简繁两侧不同词

页 zh-Hans(已是「转化」) zh-Hant(仍是「轉換」)
marketing/campaign-members :45 被转化为联系人 :45 被轉換為聯絡人
marketing/campaign-members :67 转化事件(线索 → 商机) :67 轉換事件(潛在客戶 → 商機)
marketing/campaign-members :98 没有它,转化就无法汇总 :98 沒有它,轉換就無法彙總
analytics/dashboards :126 漏斗中尚未转化的线索 :126 漏斗中尚未轉換的潛在客戶
guides/files-and-comments :51 潜在客户一旦转化 :51 潛在客戶一旦轉換

zh-Hant 侧的其余同类:marketing/campaign-members:8,30、marketing/campaigns:46,58,91,93、marketing/index:29,61、analytics/cubes:108、analytics/dashboards:133、analytics/reports:59、reference/glossary:38。

另有五页是简繁两侧都还没改

  • sales/index.zh-Han{s,t}.mdx:19 —— 「将其转换为客户」
  • administration/state-machines.zh-Han{s,t}.mdx:49,112,122 —— 「转换向导」「转换这个潜在客户」「转换潜在客户」。⚠️ 同页 :8,17,42,94,97,104,115,119,121,133 的「转换」指状态转换(state transition),是机制名,不能动 —— 这页是本单最容易改坏的一页。
  • administration/setup.zh-Han{s,t}.mdx:149、administration/sandbox-and-releases.zh-Han{s,t}.mdx:153 —— 冒烟测试清单里的「潜在客户 → 转换 → 商机」
  • administration/automation.zh-Han{s,t}.mdx:73 —— 「线索转换流程」,即 flow lead_conversion。该 flow 在四个语言包里都没有 label,所以这是纯文档侧的译名,跟不跟包可另判。

不属于本条的(避免误伤)

revenue/contracts:20「激活是关键转换」指合同激活这一状态跃迁;analytics/* 的「转换率」是指标名;guides/import-and-export:25 的「值转换与类型强制转换」是数据类型强制转换;guides/importing-your-data:40「校验并转换每一行」同理。这些都不是 lead convert 动词面。

为什么单独立

#829 的文件面只覆盖了 issue 点名的五处 + 其语言孪生 + 同段落孪生。剩下这些跨 marketing / analytics / guides / administration 四个目录,自成一次可一遍扫完的工作;在 #842 里再切一小片,正是 #801 正文批评的「半页对半页错」。

复核口径(state-machines 那页务必逐句判,不要整页替换):

grep -rn "转换\|轉換" content/docs/

Refs #801 #802 #825 #829 #842

Activity

  1. added
    bugSomething isn't working
    documentationImprovements or additions to documentation
    pm:queueReady for the PM dispatch loop
    pm:dispatchedDispatched to a dev agent by /pm-dispatch
    and removed
    pm:queueReady for the PM dispatch loop
    on Aug 5, 2026
  2. self-assigned this
    on Aug 6, 2026
  3. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    CollaboratorAuthor

    [PM 认领 · R26] session_01VHrPAGEgFDoHjphqYG4BMa · 分支 claude/issue-844-zhhant-convert-sweep · 文件面:issue 列的 marketing ×3 页族 / analytics ×3 / guides/files-and-comments / reference/glossary:38 / sales/index / administration/state-machines(仅 lead-convert 义项)/ setup:149 / sandbox-and-releases:153 / automation:73 的 zh 页 + test/automation-docs-coverage.test.ts:198 的 ROW_LABEL 钉子 + changeset

    裁定与边界:

    1. 词面按 #793 的同一缺陷类在其文件面之外还剩两处:sales/index.zh-Hant 的「已到期」,与 quotes.zh-Hans 的「过期日期」×4 #801/docs(sales): 让 zh 页的线索状态名、到期日期、直属上级与区块名跟随语言包 (#801) #825/zh 文档里 crm_opportunity 的 7 个阶段名有 4 个与语言包不符(开发期/资格审核/赢单/输单),且这一组该动哪边未定 #829 已立契约:lead convert 动词面 = 「转化/轉化」。zh-Hant 侧 20 余处「轉換」+ 简繁都没改的五页,逐处判后统一;非 lead-convert 义项一个不碰(issue 「不属于本条的」清单 + state-machines 页 10+ 处「状态转换」机制名——该页逐句判,禁止整页替换)。
    2. automation:73 「线索转换流程」裁定:改(「线索转化流程/線索轉化流程」)——flow 自身 label 是英文、四包无译名,文档侧译名跟 convert 动词契约;ROW_LABEL['lead_conversion'] 钉子同批同步(automation-docs-coverage.test.ts:198),预期不同步则守卫红——这是本单现成的反向验证方向,先声明再跑。
    3. ⚠️ 基线含今晚大量 merge(docs: 清扫 automation 页之外的「工作流规则」并写实 cases 两条虚构通知 (#850, #887) #894 动过 glossary/state-machines/sla 等;docs(ai-copilot,service): 把「内置四个 AI 知识库」整套说法按元数据写实 (#808) #892 动过 setup;docs(automation,opportunities): 补回 zh 两页缺的预测分工段,并按语言包对齐 best_case / closed_amount 词 (#836, #845) #879 动过 automation zh)——issue 行号全部过期,全量重 grep(grep -rn "转换\|轉換" content/docs/)重定位,处数如实报。
    4. ⚠️ state-machines 页与 administration/state-machines 说 case / contract / quote「没有完整状态机」,但三者都有具名的 state_machine 校验规则;页首清单也只列了 lead / opportunity 两个 #896(待派)同文件:本单只动 lead-convert 义项的 :49/:112/:122(旧行号),不碰 :12-17 的「哪些对象用状态机」小节(administration/state-machines 说 case / contract / quote「没有完整状态机」,但三者都有具名的 state_machine 校验规则;页首清单也只列了 lead / opportunity 两个 #896 的面)。
    5. ⛔ 不动 en 页、src/**、releases/;不加守卫(ROW_LABEL 同步不算新增);三语中只动 zh 侧;不升级 @objectstack/*。

    changeset 站内路径反引号;控制字节自扫;JSON 报告按标准 schema。


    Generated by Claude Code

  4. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    CollaboratorAuthor

    ✅ 验收通过 —— PR #906 已转 ready 并挂 auto-merge(CI 9/9 全绿,head d862ae1)。

    验收要点:

    1. 规模与覆盖:zh-Hant「轉換/轉化」清扫共 33 处、18 页,与 dev 全量清点一致;逐处核对 diff hunk 未见越面改动。
    2. 两阶段红→绿账本验证与预告完全一致:先改 test/automation-docs-coverage.test.ts:198 的 ROW_LABEL(线索转换流程→线索转化流程)跑出 4 failed | 16 passed 的红,再落正文改动收敛到 20 passed 全绿——守卫真实咬合,不是摆设。
    3. 语义甄别保留到位:11 处「状态迁移/转换机制」语义的 convert 用法(state transition 意义上的「转换」)全部原样保留,只改「线索→商机」转化语义的用字,避免了一刀切错杀。
    4. 与 issue 原文的 4 点偏差均已在 PR body 记录并给出证据(含 issue 计数 33→36 的上下文差异说明),按惯例以 dev 实测为准。
    5. 未动 src/**、未动 releases/、未升级 @objectstack/*。

    越界发现处置:#905(zh-Hant 轉換率 vs zh-Hans 转化率的读法取舍,dev 建议读法 A)已复核,判定成立且面小,标 pm:queue 待派。


    Generated by Claude Code

  5. added and removed on Sep 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

bugSomething isn't workingdocumentationImprovements or additions to documentationpm:dispatchedDispatched to a dev agent by /pm-dispatchpriority:p2Medium: important, M3

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions