Skip to content

「四个内置 cube」与 src/cubes/ 目录的词汇残留散在 8 个页面上:cubes 页已收口,其余各页仍按旧口径写 #977

Closed

Description

@yinlianghui

来源:#965 实施(PR #975)过程中的卫星命中。PR #975 把 analytics/cubes 整页改写为「本仓不声明任何 cube,语义层是 src/datasets/ 的九个 dataset,由分析服务内部编译成 cube(ADR-0021)」,但同一套旧词汇在另外 8 个页面上仍在流通。逐条列在下面,供 triage 决定要不要一次扫掉。

逐处

文件:行 现文 事实
whats-new.mdx:105 Four built-in cubes: Sales, Pipeline, Service, Marketing — for self-service analysis 四个名字零命中,与 #965 同一主张。注意本页是变更历史性质,改写方式(更正 vs 加注)需 triage 定
getting-started/for-developers.mdx:41 src/ 目录树写着 ├── dashboards/, reports/, cubes/ src/cubes/ 不存在——它在 #492 被移除(七个无人引用的 cube 重复了 dataset 层)。真实目录是 dashboards/ reports/ datasets/,与 AGENTS.md 的目录图一致
reference/performance-and-limits.mdx:75,83 「Reporting & cubes」表:`Cube refresh frequency Every 5 min (incremental) / nightly (full)`
reference/faq.mdx:133,138 「Most tiles use cubes with incremental refresh every few minutes. Force a refresh from the dashboard's ⟳ Refresh button.」 同上;另外那个 ⟳ Refresh 按钮是否存在也需实测(本仓的仪表盘元数据不声明它)
sales/pipeline-management.mdx:93 The Opportunity analytic cube (measure: sum of amount, dimension: stage) 内容近乎为真但名字错位:真身是 dataset Opportunity Metrics(opportunity_metrics),measure 叫 total_amount、dimension 叫 stage。改名即可,无需改语义
getting-started/introduction.mdx:21 Analytics — Dashboards, reports, and self-service data cubes 与 #976 的落地页表述同型;「self-service」还牵扯平台侧 UI 主张
marketplace/fork-hotcrm.mdx:21 Dashboards backed by analytics cubes 同上,一句带过,改成 dataset 即可
administration/sandbox-and-releases.mdx:93 表格行「Reports, cubes ✅」
reference/glossary.mdx:54 Cube — A pre-modeled multi-dimensional dataset for analytics 这一条不必改:它定义的是概念本身,而概念是真的。列在这里只是为了说明「哪些 cube 提及是合法的」,避免下一次扫描误伤

分级

多数条目是词汇残留(cube → dataset 的改名),读者不会因此在产品里找不到东西;两处更实一些:for-developers 指了一个不存在的目录,performance-and-limits / faq 给出了本仓没有任何配置支撑的刷新数值。因此打 finding 标签而不是 pm:queue,由 triage 决定是否值得一次扫掉,以及 whats-new 这类历史性页面按什么方式改。

边界

Refs #965 #976 #492

Activity

  1. added
    documentationImprovements or additions to documentation
    pm:dispatchedDispatched to a dev agent by /pm-dispatch
    and removed
    documentationImprovements or additions to documentation
    on Aug 6, 2026
  2. self-assigned this
    on Aug 6, 2026
  3. yinlianghui commented on Aug 6, 2026

    @yinlianghui
    CollaboratorAuthor

    🔒 已随 #976 并单认领(/pm-dispatch R33,session session_01VHrPAGEgFDoHjphqYG4BMa,分支 claude/issue-976-977-cube-vocabulary)——裁定与文件面见 #976 认领评论。


    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

findingpm: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