Skip to content

build(charts): 通过 pnpm 接入 CRYChart 公开发行版 - #25

Merged
KyleHuangFromHZ merged 8 commits into
mainfrom
feature/crychart-npm
Nov 16, 2026
Merged

KyleHuangFromHZ merged 8 commits into
mainfrom
feature/crychart-npm

Conversation

@KyleHuangFromHZ

@KyleHuangFromHZ KyleHuangFromHZ commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

改了什么,为什么 / What changed and why

OpenTest 前端现在通过 pnpm 安装已公开发布的 @crysound/crychart@1.0.1。旧 tgz 保留作历史材料。更新了锁文件、主入口和主题导入、构建完整性校验,以及中英文接入文档。字体诊断使用当前锁定的安装入口。

OpenTest now installs the public CRYChart package through pnpm. The build checks the installed package and the chart bundle against the locked dependency and build record.

CRYChart 发布配置和 1.0.1 发行记录见 crysound/CRYChart#6。OpenTest 仍使用已经公开的 1.0.1。

制品对照:旧 1.0.1-opentest.30 tgz 与 npm 实际发布的 1.0.1 对比,忽略版本字符串和 source map 注释后,4 个运行入口和 72 个类型声明内容一致。发布归档及校验值见 crysound/CRYChart#6 的发行验收记录。

怎么验证的 / How it was verified

  • 冻结安装、前端生产构建、图表产物完整性校验通过 / Frozen install, production frontend build, and chart bundle integrity passed.
  • 1,209 项图表测试、19 项打包工具测试及 Chrome 字体诊断通过 / Chart and packaging tool tests and the Chrome font diagnostic passed.
  • 中英文文档策略检查通过 / Bilingual documentation check passed.
  • 真机采集或完整安装器验证 / Device acquisition or full installer acceptance.

pnpm typecheck:tests 以 CI 的 6 GB 堆上限运行,在本 PR 未改动的 6 个源文件中报告 9 处类型错误。本 PR 的前端生产构建和图表测试均通过。

影响 / Impact

不涉及插件 API、通信协议或数据格式改动。Plugin APIs, protocols, and data formats remain unchanged.

贡献授权 / Contribution license

  • 我已阅读并同意 OpenTest 社区许可协议第 11 条“社区贡献” / I have read and agree to section 11, Community Contributions, of the OpenTest Community License.

@KyleHuangFromHZ
KyleHuangFromHZ requested a review from a team November 16, 2026 05:17

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体方向合理:依赖改为 npm 公开发行版的精确版本,构建完整性记录升级到 schemaVersion 2,并补充了浮动版本、本地 tgz、缺失摘要和非 npmjs.com 制品的拒绝用例。合并前需要先处理以下问题。

1. 锁文件缺失(阻塞)

  • 描述称已更新锁文件,但本次 diff 中没有 pnpm-lock.yaml。
  • apps/frontend/package.json 已把 crychart: file:...tgz 改为 @​crysound/crychart: 1.0.1。如果锁文件未同步,pnpm install --frozen-lockfile 会直接失败。
  • 即使能安装,collectHostChartDependencyFacts 也会因找不到 @​crysound/crychart 的 importer 或 package 记录而抛错。
  • 请确认锁文件已提交,并且能看到 packages: 下 '@​crysound/crychart@​1.0.1' 的 resolution.integrity。

2. 上游修复是否完整

  • 原 THIRD-PARTY-NOTICES 列出了多项 OpenTest 专属修改,例如字体与布局、透明波形回退、3D 平面缓存和透视相机取景。
  • 本 PR 改为声明“已合入上游”,但 diff 中没有逐项证据。
  • 建议在描述中引用 crysound/CRYChart#6 里对应 1.0.1-opentest.30 全部补丁的合入记录,避免静默回退某项修复。
  • 1,209 项测试大多 mock 了 @​crysound/crychart,不能证明真实包包含这些修复。

3. 仍引用旧包名的配置(未在 diff 中出现,请确认)

  • ESLint 的 no-restricted-imports,用于把图表库导入集中在适配目录。
  • tsconfig/vitest 的 paths、alias、optimizeDeps、server.deps.inline。
  • tools/crychart-windows-e2e/ 中其他脚本硬编码的 node_modules/crychart 路径。
  • 其中 ESLint 限制规则若仍写 crychart,改名后会静默失效,不会报错。

4. 流程

  • 描述中“社区贡献”授权复选框未勾选,合并前需由提交者确认。

跳过 2 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:a66e27d。维护者可评论 /review 重新审查。

Comment thread tools/chart-build-integrity.mjs Resolved
Comment thread tools/chart-build-integrity.mjs Resolved
Comment thread docs/crychart-integration.md Resolved
Comment thread docs/crychart-integration.zh-CN.md Resolved
yangdekun2026
yangdekun2026 previously approved these changes Nov 16, 2026
cuimmm
cuimmm previously approved these changes Nov 16, 2026
@KyleHuangFromHZ
KyleHuangFromHZ dismissed stale reviews from cuimmm and yangdekun2026 via 7a04d4a November 16, 2026 05:58

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体方向合理:依赖从仓库内 tgz 改为 npmjs.com 精确版本,校验从「vendor 清单 + 制品摘要」改为「package.json / lock / 安装包三方一致 + lock 完整性摘要」。导入路径、mock 路径和构建记录字段的替换基本一致,也补了拒绝浮动版本、本地 tgz 和错误包名的测试。以下问题请处理或说明:

  • 锁文件不在本次 diff 中:描述说已更新 pnpm-lock.yaml,但审查数据里没有这个文件。请确认锁文件已提交,且其中满足三点:@​crysound/crychart@​1.0.1 带 integrity;没有非 npmjs.com 的 tarball;没有 patchedDependencies 等对该包的改写。
  • 类型检查结论不足:本 PR 改了大量 typeof import('@​crysound/crychart').X 形式的测试类型引用。Vite 生产构建通常不做完整类型检查。文档中的 pnpm --filter @​opentest/frontend typecheck 未在验证清单里列出。typecheck:tests 的 9 处错误需要在 main 上跑同样的命令对照,证明是存量问题,而不是公开包类型声明与原消费者版本不同所致。
  • 行为等价性证据不足:旧声明列出了字体、图例与坐标轴外观、透明波形回退、3D 平面缓存、透视相机取景等多项消费者修改。新文档只说包含「已合入上游的修复」,没有说明是否全部合入。现有 1,209 项图表测试大多 mock 了图表库,不能证明真实渲染行为不变。字体诊断脚本还被迫改了 API 用法,提示公开版 API 可能与 opentest.30 不同。建议附上 pnpm test:chart:browser 的真实 Chrome 报告,并逐项对照旧补丁是否已在 1.0.1 中。
  • 可能残留的旧包名引用:请全仓检索 'crychart' / "crychart" / node_modules/crychart / artifactSha256。重点检查以下几处:ESLint no-restricted-imports(项目要求图表库导入集中在适配目录,规则若仍写旧包名会静默失效)、optimizeDeps、vitest deps.inline、tsconfig paths,以及 tools/crychart-windows-e2e/ 下其他脚本。
  • 安装内容不再绑定发行摘要:删除 vendor.entrySha256 后,构建记录只证明「打包时文件与构建时一致」,不证明 node_modules 中的内容就是 npm 发行包。文档已说明这一点,可以接受。若需要更强保证,可在校验时比对 pnpm store 中该包的文件索引。
  • 流程:描述缺少 Refs #<编号>,社区贡献授权复选框未勾选。合入前需要补齐。

跳过 2 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:7a04d4a。维护者可评论 /review 重新审查。

Comment thread tools/chart-build-integrity.mjs Resolved
Comment thread docs/crychart-integration.zh-CN.md Resolved
cuimmm
cuimmm previously approved these changes Nov 16, 2026
yangdekun2026
yangdekun2026 previously approved these changes Nov 16, 2026
@KyleHuangFromHZ
KyleHuangFromHZ dismissed stale reviews from yangdekun2026 and cuimmm via 5ab7358 November 16, 2026 06:21

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体改动一致:导入路径、mock、Vite 分块规则、文档和构建完整性校验都已从 crychart 切到 @​crysound/crychart@​1.0.1。完整性校验新增了精确版本、禁止 pnpm patch、安装包名和 tarball 来源检查,并补了对应测试。

需要关注的问题:

  • 供应链校验比原方案弱。 原方案在 vendor/crychart/manifest.json 中独立固定了制品的 sha256。现在只要求锁文件中存在 sha512 格式的 integrity,不与任何已知值比对。修改锁文件 integrity 的拉取请求仍能通过构建校验,tarball 来源检查也无法证明制品出处。详见行内意见。
  • 旧验收脚本可能误导验收结论。 tools/crychart-windows-e2e/ 中仍有脚本读取旧 tgz 清单,文档已说明。这些脚本审计的是历史制品,不是当前安装的 npm 包。建议在脚本入口加明确提示,或尽快迁移到 verifyHostChartBuildIntegrity。
  • 旧构建产物需要重新构建。 schemaVersion 升到 2 后,已有的前端 dist 会被打包步骤拒绝。这是预期行为,建议在 PR 描述中说明。
  • 流程项未完成。 描述中的“贡献授权”复选框未勾选,真机采集和完整安装器验证也尚未进行。

跳过 2 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:5ab7358。维护者可评论 /review 重新审查。

Comment thread tools/chart-build-integrity.mjs Resolved
Comment thread tools/chart-build-integrity.mjs Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体评价:依赖从本地 tgz 切换到 npm 公开发行版 @​crysound/crychart@​1.0.1,源码与测试的导入替换完整。chart-build-integrity.mjs 新增了精确版本、lock 一致性、integrity 存在性、pnpm patch 拒绝、安装包名和 tarball URL 校验,并有对应测试。schemaVersion 升级到 2,旧构建记录会被明确拒绝。中英文文档成对新增,文件名符合文档规范。

不能定位到具体行的意见:

  1. 锁文件改动不在本次 diff 中,无法审查。 描述称已更新锁文件,但给出的改动列表里没有 pnpm-lock.yaml。pnpm-lock.yaml 是本次唯一的完整性来源:chart-build-integrity.mjs 只校验 integrity 的格式,pnpm 按它校验下载内容。请确认它已随本 PR 提交,并确认:
    • 除 @​crysound/crychart 及其传递依赖外,没有其他包的解析结果变化;
    • 旧的 crychart@​file:vendor/... 条目已移除。
  2. 类型检查结果需要说明。
    • 描述称 pnpm typecheck:tests 报告 9 处类型错误,位于本 PR 未改动的文件。请确认这些错误在 main 上同样存在,以排除新包类型声明与旧 tgz 不同造成的回归。
    • 新文档的升级验证步骤要求运行 pnpm --filter @​opentest/frontend typecheck,但描述只列出了生产构建通过。建议补充该命令的结果。
  3. tarball 来源校验在常见情况下不会执行。 pnpm 对默认 registry 的包通常不在锁文件中写 tarball,因此 URL 校验多数情况下不触发。来源约束实际依赖 .npmrc 的作用域配置和锁文件 integrity。文档已如实说明这一点,这里只作提示,不要求修改。
  4. 描述中“贡献授权”复选框未勾选,请提交者按项目流程处理。

跳过 2 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:62440af。维护者可评论 /review 重新审查。

Comment thread docs/crychart-integration.zh-CN.md Resolved
Comment thread tools/__tests__/cry-chart.test.mjs Resolved

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AI 代码审查(claude-opus-5-5)

整体评价:本次将 CRYChart 从仓库内 tgz 切换为 npmjs.com 的 @​crysound/crychart@​1.0.1。导入路径替换完整。完整性脚本新增了精确版本、锁文件 integrity、tarball 地址、安装包名和禁止 pnpm patch 的检查,并补充了对应的正反例测试。整体方向合理。

以下问题无法定位到具体行,需要提交者确认:

  1. 锁文件未出现在本次 diff 中。描述称已更新 pnpm-lock.yaml,但待审改动里没有该文件。请确认:

    • 锁文件已随本 PR 提交;
    • 其中 importers.apps/frontend 的 specifier/version 均为 1.0.1;
    • packages 段带有 sha512 integrity,并且已移除旧 crychart@​file:... 条目。

    否则 CI 的 pnpm install --frozen-lockfile 和 chart-build-integrity 都会失败。

  2. typecheck:tests 的 9 处类型错误需要与 main 基线对比。描述称这些错误位于本 PR 未改动的 6 个源文件。由于本 PR 修改了模块名,如果仍有未改动的文件导入 'crychart' / 'crychart/themes',或者在 d.ts、declare module 中引用旧模块名,就会表现为“未改动文件出现类型错误”。请贴出 main 上同一命令的结果,证明这些错误是既有问题。另外,请全仓搜索残留的 'crychart' 导入。

  3. 请检查是否存在只针对旧包名的配置:

    • ESLint no-restricted-imports:README 称图表库直接导入集中在适配目录,若有规则限制 crychart,改名后会静默失效;
    • Vite optimizeDeps、vitest deps.inline / server.deps;
    • tsconfig paths。

    本 diff 只更新了 vite.config.ts 中的 chunk 规则。

  4. vendor/crychart/README.md 仍可能描述旧的 tgz 升级流程。开发文档已不再引用它,但建议在该文件顶部注明“仅作历史材料,当前接入见 docs/crychart-integration.zh-CN.md”,避免误导。

  5. 描述中“社区贡献”授权勾选项尚未勾选。按流程需要提交者确认。

跳过 2 个文件(锁文件、生成文件、二进制或无文本 diff)

由 AI 自动生成,仅供参考,不作为合并依据。审查提交:25c93b5。维护者可评论 /review 重新审查。

Comment thread tools/chart-build-integrity.mjs Resolved
Comment thread docs/crychart-integration.md Resolved
@KyleHuangFromHZ
KyleHuangFromHZ merged commit 26c5961 into main Nov 16, 2026
9 of 12 checks passed
@KyleHuangFromHZ
KyleHuangFromHZ deleted the feature/crychart-npm branch November 16, 2026 07:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants