docs(tooling): 说明构建脚本、配置与 SDK 宿主示例 #6

2026-11-11T18:26:22Z

codex-bot commented

2026-11-11 18:26:22 +00:00

为构建工具和SDK宿主示例补充中文模块、函数及逻辑块注释，说明输入约束、处理顺序与实现边界，不更改执行逻辑。

涉及文件：

scripts/build-headless.mjs：清理产物、TypeScript输出、声明后缀、Worker URL与包文件复制。
scripts/loaders/xyflow-retained.cjs：固定版本与源码锚点校验、可见性/选择订阅改写。
next.config.ts：webpack/Turbopack loader装配与图标分片缓存头。
postcss.config.mjs：Tailwind PostCSS入口。
scripts/generate-canvas-icons.mjs、scripts/canvas-icon-labels.mjs：输入版本、SVG提取、中文检索、分桶与摘要、生成JSON和许可证。
headless/consumer.mjs：无UI宿主示例的内存port、协议回执、事务/历史/手势/复制/恢复/投影断言。

验证：7文件去注释AST与修改前一致；822项headless Node测试通过；6项图标Node测试通过；git diff --check通过。未执行构建、资源重生成或独立SDK consumer运行。

这是全项目注释阶段4的一个批次，测试、其余配置、CSS与最终覆盖审查仍需后续处理。等待用户手动合并。

为构建工具和SDK宿主示例补充中文模块、函数及逻辑块注释，说明输入约束、处理顺序与实现边界，不更改执行逻辑。涉及文件： - scripts/build-headless.mjs：清理产物、TypeScript输出、声明后缀、Worker URL与包文件复制。 - scripts/loaders/xyflow-retained.cjs：固定版本与源码锚点校验、可见性/选择订阅改写。 - next.config.ts：webpack/Turbopack loader装配与图标分片缓存头。 - postcss.config.mjs：Tailwind PostCSS入口。 - scripts/generate-canvas-icons.mjs、scripts/canvas-icon-labels.mjs：输入版本、SVG提取、中文检索、分桶与摘要、生成JSON和许可证。 - headless/consumer.mjs：无UI宿主示例的内存port、协议回执、事务/历史/手势/复制/恢复/投影断言。验证：7文件去注释AST与修改前一致；822项headless Node测试通过；6项图标Node测试通过；git diff --check通过。未执行构建、资源重生成或独立SDK consumer运行。这是全项目注释阶段4的一个批次，测试、其余配置、CSS与最终覆盖审查仍需后续处理。等待用户手动合并。

codex-bot added 1 commit 2026-11-11 18:26:23 +00:00

docs(tooling): explain SDK packaging and icon build configuration 9946142d5e

Zayden-Jung merged commit efcec4d603 into main

2026-11-11 18:39:22 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Zayden-Jung/Endoleap#6