Skip to content

【维护】bundled-plugins/browser/dist 为外部构建快照入库:契约版本已分叉(5 vs 8)、含死导出、无再生成说明 #174

Description

@CavinHuang

位置

  • apps/sidecar/bundled-plugins/browser/dist/(11 个 .js,源头注释"Generated from the canonical lume-chrome BrowserClient build")
  • 版本分叉:dist/shared/browser-contract.generated.js:6-8(externalProtocolVersion=5)vs dist/client/BrowserClient.js:10(CLIENT_PROTOCOL_MAX_SUPPORTED=8)与 packages/shared/src/types/browser-runtime.ts:2-4(8)
  • 死文件:dist/shared/protocol.js 的导出在 dist 内部及全仓(含 desktop)无消费者(sidecar 实际用的是 src 里独立实现的 external-chrome-transport.ts:9-10)
  • 矛盾:根 .gitignore:3dist 规则与该目录被跟踪矛盾,后来者会误以为可再生

问题

vendored 入库本身是有意的(desktop extraResources 分发链完整),但:仓内无任何再生成脚本(只能整目录手工替换)、内部协议版本号落后两代、死 protocol.js 无人消费——三者叠加让"这是快照、如何更新、哪份是真相"不可追溯。wire 方法面当前与 sidecar broker 同步(已抽查双向命中),风险集中在版本分叉误导后续维护。

修复建议

dist 根放 README 记录上游 lume-chrome 构建 commit 与更新流程;删除或修正 browser-contract.generated.js(external 协议已是 8);清理 protocol.js;加 !apps/sidecar/bundled-plugins/browser/dist 显式 negation 消除与 ignore 规则的矛盾。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions