文档中心页面联调（需要时再看）
这页用于让 Agent 把本地 UX1 自定义组件或电子表格 JS 放进测试页面验证。
对 UX1 自定义组件，代理直接读取组件工程构建出的 dist/，不需要另做调试 ZIP，也不读取最终的 package.zip。开发、调试和上传产物的关系见开发包、调试包与上传包。
什么时候需要
本地代码需要结合真实页面数据、页面表现与本地检查不一致，或 Agent 需要查看页面报错和网络请求时，再使用页面联调。
UX1 自定义组件联调顺序
代理按 <PACKAGES_DIR>/*/public/data.json 发现组件。PACKAGES_DIR 应指向“直接子目录是组件工程”的目录，例如物料仓的 packages/，不能直接指向某个组件根目录。
-
在每个需要联调的组件工程中完成构建，确认
dist/文件齐全。 -
核对
public/data.json与dist/data.json的name、version一致。 -
设置正确的
PACKAGES_DIR，并将临时鉴权信息放进被版本控制忽略的本地环境文件。 -
启动代理，在代理地址中打开真实编辑页或使用页。
-
修改源码后重新构建并刷新；联调结论只对应当前这份
dist/。
发给 Agent
工具包路径：<解压后的目录>
本地代码位置：<UX1 自定义组件工程或电子表格 JS 文件>
页面链接：<测试页面链接>
临时 Cookie：<需要登录时填写>
需要确认：<页面应该出现什么、操作后应该发生什么>
请使用工具包中的页面联调能力，在可见浏览器中验证本地代码。
线上页面只读，不要保存、提交、发布或删除任何数据。
最后说明验证结果、发现的问题和待确认项。
对于 UX1 自定义组件任务，Agent 会先构建组件，再启动本地代理，让页面临时使用这份 dist/，并检查页面效果、报错和网络请求；它不会替你导入组件。电子表格任务按对应 Skill 的方式加载本地 JS。
如果 Agent 判断不需要联调，你不必手动启动任何工具。
常见问题
|
现象 |
优先检查 |
|---|---|
|
组件没有出现在列表中 |
|
|
组件文件返回 404 |
是否已构建，组件名、版本和目标空间是否一致 |
|
文件已命中但组件白屏 |
SystemJS 格式、三个入口的默认导出、外部模块是否可用 |
|
整个页面无法打开 |
临时鉴权是否失效，代理的目标页面是否正确 |
|
修改后仍显示旧内容 |
当前代理读取的 |
线上页面只查看，不保存、提交、发布或删除数据。
回到顶部
咨询热线
400-821-9199
