Skip to content

guides/search-and-navigation 的《内置 vs 个人 vs 共享》(:56,三语) 举的两个"内置视图"例子都不存在:*All Open Opportunities* 与 *Pending My Approval* 在 src/ 双双零命中 #973

Closed

Description

@yinlianghui

发现自 #963 / PR #969 的实施过程(把 content/docs/revenue/approvals*.mdx 的《Where to find pending approvals》按源码写实时,grep -rn "Pending My Approval" content/ 扫出这一页也在用同一个不存在的视图名)。

基线 origin/main = 4705aed5(平台 17.0.0-rc.3)。不与 #963 / PR #969 重叠:那单的面严格限于 content/docs/revenue/approvals*.mdx 的《Where to find pending approvals》一节;也不与 #960(getting-started/quick-tour 的导航表)重叠。

事实

content/docs/guides/search-and-navigation.mdx:56(zh-Hans / zh-Hant 同址 :56):

- **Built-in** views ship with the system (*All Open Opportunities*, *Pending My Approval*).
- **内置**视图随系统提供(*所有未结商机*、*待我审批*)。
- **內建**檢視隨系統提供(*所有未結商機*、*待我審核*)。

这一句要教的概念(内置 / 个人 / 共享三类视图)没问题,举的两个例子都不是真实视图名:

例子 源码实况
All Open Opportunities grep -rn "All Open Opportunities" src/ 为 0。商机上真实的内置视图是 src/views/opportunity.view.ts 里的 Open Deals(open_opportunities,isDefault + pinned)、My Deals、Pipeline、All Opportunities、Forecast、Timeline、Cards、Stale。最接近的两个真名是 Open Deals 与 All Opportunities,恰好被拼成了一个不存在的第三名
Pending My Approval 全仓零命中:src/ 为 0,已安装的 @objectstack/plugin-approvals 里也是 0(#963 已核)。审批请求上真实的内置视图是 sys_approval_request.listViews 的 My Pending / I Submitted / Completed / All(zh-CN「我的待办」「我提交的」「已完成」「全部」)。简体页写的「待我审批」也不是视图名——那是侧边栏导航条目 nav_approval_requests 的 zh-CN label(src/translations/zh-CN.ts:1219),繁体页的「待我審核」则两边都不是

为什么要紧

与 #963 / #960 同族但性质更基础:这一页是教"内置视图"这个概念本身的地方,例子就是读者认定义时唯一的锚点。两个例子都错,读者去侧边栏找 All Open Opportunities 找不到,会先怀疑自己权限不够或装漏了插件,而不是怀疑文档。Pending My Approval 更是三份文档里第三次出现的同一个幽灵名(revenue/approvals 由 PR #969 写实,quick-tour 由 #960 覆盖),本页是它最后一处落脚点。

繁体页多一层问题:「待我審核」既不是视图 label,也不是任何语言包里的字串(本应用只提供 en / zh-CN / ja-JP / es-ES 四种界面语言)。

边界与口径建议

Refs #943 #953 #960 #963 #969

Activity

  1. added
    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 6, 2026
  2. self-assigned this
    on Aug 6, 2026
  3. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    ContributorAuthor

    🔒 认领(/pm-dispatch R33)— session session_01VHrPAGEgFDoHjphqYG4BMa,分支 claude/issue-973-search-nav-views。

    文件面:content/docs/guides/search-and-navigation{,.zh-Hans,.zh-Hant}.mdx 的 :56 视图例子行族——fresh main 重定位。

    裁定:①两个幻影例换真实视图名(Open Deals / All Opportunities 与 My Pending,以 src/ 与 plugin-approvals 实名为准,沿 PR #969 刚落地的四视图口径);②zh 两页各自的错名(待我审批系导航 label、待我審核两边都不是)按语言包真名对齐;③#595 不预判;src/ 零改动;三语同步;zh 内链不带锚;若顺路经过 #963-验收记录的「#953 落地行略过头」同语境句,可提及不强制。


    Generated by Claude Code

  4. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    ContributorAuthor

    ✅ 验收通过 —— PR #979 已转 ready 并挂 auto-merge(CI 9/9 全绿实核)。

    验收要点:

    1. 逐名复核坐实且给出「第三名」的构成分析(All Open Opportunities 是两个真名拼出的幻影);zh 双错各归其源(导航 label / 任何语言包都没有)。
    2. 两个方法论亮点记档:①守卫第一轮被空值门挡住而看不到缺陷真形(幻影用斜体写,提取只读粗体)——改提取 + 降门槛后逐名点名,「守卫要先能看见缺陷的形状」;②插件 zh 译文以 \uXXXX 转义存储导致 grep 中文零命中的误判陷阱被识破,解转义后断言——这条陷阱值得进后续派单惯例。
    3. 静默换名(举例语境不加否定句)的口径判断正确;面控严格;新守卫 14 断言 + 反向 8 红逐条对上。

    越界发现处置:#982(「内置视图随系统提供」混淆两种来源——应用自声明 vs 插件自带;对业务读者两者等效,判观察级)——documentation+finding 已打,留池;#973 关闭后记录不丢的存档意识正确。


    Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationpm:dispatchedDispatched to a dev agent by /pm-dispatch

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions