ADV.JS 发布依赖与公开源码

2026-10-16，当前工作区使用 vendor/advjs/ workspace 快照 0.1.4-dayun.8：在原固定运行时基础上，选择性引入可移植创作模块、主题无关 GUI 控件、预览会话控制和对白 / 变量 / 轨迹面板，以及 Editor SDK 声明，并保留固定 lib。本批集成改动尚未提交或发布，来源清单以源文件及 lib 的精确哈希标识工作区内容。独立 checkout 不需要旁边存在 YunYouJun/advjs 仓库。

依赖边界

应用的 @advjs/core 与 @advjs/types 使用 workspace:*。pnpm-workspace.yaml 纳入 vendor/advjs/*；core 的 parser / types 依赖同样指向这份固定快照，外部依赖使用固定版本并由锁文件记录 integrity。常规游戏构建读取预编译 lib，没有重新实现 ADV.JS 运行时。

core 提供游戏所需 /runtime、构建用 /compiler，以及独立编辑工具使用的 /authoring。parser 保留根入口与 /fs，types 保留完整共享定义。游戏按需加载 headless 运行时，Markdown 编译器只在构建脚本中使用，不向游戏引入 ADV.JS Client、默认主题或编辑器。

npm @advjs/core@0.1.2 缺少两个子入口，@advjs/parser@0.1.3 缺少当前编译器使用的 AdvScriptSyntaxError，因此不能直接替换为这些旧发布版。后续优先切换到覆盖所需公共入口的正式上游固定版本。

来源与对应源码

上游：YunYouJun/advjs，基线提交 8c6557e9dbd5f84a16b8268d3ac83a11a5665b2a，上游版本 0.1.4。固定快照由游戏提交 1a8e00b build(story): pin the ADV.JS SDK for standalone builds 引入；原集成包含上游尚未提交的 headless 入口与独立 end 节点编译修复，记录在 vendor/advjs/upstream-integration.patch，不称为干净上游提交的构建。

MPL-2.0 许可证、对应 preferred TS 源码、包 / 构建元数据及集成补丁保留在已提交的 vendor 中。网页公开相同的普通源码文件：

• /third-party/advjs-NOTICE.md
• /third-party/advjs-source/README.md
• /third-party/advjs-source/PROVENANCE.json
• /third-party/advjs-source/core/src/、parser/src/、types/src/、gui/authoring/、editor-sdk/src/
• 各包的 LICENSE、package.json、build.config.ts，以及共享 tsconfig.json、两份集成补丁和 authoring-snapshot.json

公开文件逐字节取自固定 vendor，provenance 记录来源与源码 / lib 的 SHA-256。没有 node_modules、隐藏文件、账号配置、测试数据或凭据，也没有压缩包、Base64 或扩展名伪装。源码保持原来的 .ts 文件与目录结构，服务于许可证分发与检查；按现有 Git 资源策略检查，不增加归档例外或修改体积上限。

与原集成的差异

最初固定快照保留原本机集成的运行时、解析器和类型。此次新增可移植创作入口、Flow 纯编辑模块、布局及预览会话；authoring-snapshot.json 记录选择性同步的上游基线、文件及 SHA-256，authoring-integration.patch 记录对应通用修改。它与旧运行时补丁的目标基线不同，不能盲目依次应用。运行时 schema 仍为 1，未整体同步上游 schema 2。多个入口重建会改变 lib 拆块，不能称全部 JS 逐字节相同；未经编辑的章节编译程序及语义 hash 通过回归保持一致。

发布前继续用现有剧情产物校验、剧情与存档测试、类型检查、游戏构建和性能预算确认行为及加载边界；源码相同不代替实际验证。

更新与发布校验

更新方式沿用 固定 workspace 快照说明：同步指定上游版本的源码、lib、来源和锁文件，复核公开源码及许可证，再检查剧情和发布产物。不要自动同步本机上游工作区。

pnpm install --frozen-lockfile --offline
pnpm story:check
pnpm typecheck
pnpm test
pnpm build
pnpm verify:performance
pnpm verify:release

网页发布候选还需确认 dist/third-party/advjs-source/ 包含对应源码和来源；本机成功不代替独立 checkout 与正式部署验证。

Editor SDK 为最小私有源码快照，游戏运行包不依赖它。GZA 工作台插件作为本地构建输入接入 ADV.JS Editor，业务插件不复制进通用上游或公开 SDK 对应源码目录；Editor 构建入口改动记录在集成补丁。原运行时 lib 及 JSON 编译协议保持原样。