# 常见问题

# Q：开发者工具或真机上看不到入口，怎么办？

先确认当前小程序是否已在「微信公众平台 - 基础功能 - AI 能力」选择了「开发模式」并申请通过，然后确保开发者工具更新到最新 Nightly 版本且调试基础库切至 3.16.1，若在真机上，则确保 iOS 微信版本更新到 8.0.74。

# Q：安卓和鸿蒙支持吗？

除 iOS 平台外，其他平台暂不支持。

# Q：AI 回复的内容支持 markdown 格式吗？

支持。

# Q：AI 回复的内容支持流式输出吗？

不支持。

# Q：AI 回复的文本与卡片支持任意混排吗？

不支持。目前支持两种格式，只回复文本内容，或者以先文本后卡片的固定格式回复。

# Q：支持多模态吗？

支持。用户可发送图片或文件，AI 可识别图片内容，也可以将图片或文件发给开发者声明的原子接口处理。

# Q：半屏页是必须使用的吗？

不是的，半屏是为了展示更多信息，在信息可在原子组件完整呈现的情况下，无需使用半屏。

# Q：半屏页是否允许跳转到其他半屏页？

不允许。

# Q：半屏页是否支持加载 H5 页面？

支持。通过 web-view 组件加载 H5 页面。

# Q：原子组件右上方的入口，如果原子组件没有对应小程序页面，应该如何配置？

可以配置上一级的页面，如为 AI 模式独有功能，则配置小程序首页。

# Q：是否支持同时推出多个原子组件？

支持。可在 SKILL.md 或者原子接口返回的 content 字段做一些输出引导。

# Q：什么情况下可以使用文字链？

文字链用于承载部分不适用于 AI 模式的功能，小程序的主功能应避免使用文字链，否则可能会被平台视为导流行为，不予通过。

# Q：是否支持封装已有小程序功能外的 SKILL？

支持，但需要确保 SKILL 的功能服务在已有的小程序资质范围内。

# Q：一个 SKILL 只能放在一个分包吗？

是的。一个分包可以放多个 SKILLs，但一个 SKILL 只能放在一个分包，如果单包体积上限 2M 不足，可以使用异步分包机制从另一个分包引入原子接口或原子组件的代码。

# Q：原子组件的 UI 是否支持自定义？

支持，遵从设计规范即可。

# Q：原子组件的宽高比是否支持自定义？

支持，原子组件宽度随屏幕宽度而固定，高度最小为 4:1，高度最大为 1:1，不超出最小最大高度时，随内容自动撑高。

# Q：原子组件内容支持滑动吗？

支持横向滑动，不支持竖向滑动。

# Q：能否通过全局状态的方法将原子接口的数据传递给原子组件？

不可以。原子接口、原子组件、实时动态组件运行在三个不同的 JavaScript 上下文，其全局变量不共享。只能通过原子接口返回的 content、structuredContent、_meta 字段传递给原子接口使用。

# Q：所有原子接口都需要实现登录态校验逻辑，有什么方式可以复用？

可以使用原子接口的中间件机制。

# Q：在开发者工具进行预览时，出现编译错误提示，怎么解决？

目前在代码预览、上传时，会对代码配置进行一些强校验，如 SKILL.md / mcp.json / AGNETS.md 的文件大小超限、原子组件的关联页面没有配置等，可仔细查看错误提示，检查下是否是相关问题。

# Q：打开半屏页面获取的场景值为何不是 1433 / 1434 ?

打开半屏页面可能是热启动，需要通过 wx.getEnterOptionsSync() 接口来获取场景值。

# Q：在开发调试时，控制台出现 wx.modelContext 为 undefined 的相关报错，如何解决？

请确认小程序项目是否引入过 uni-app，uni-app 会替换全局的 wx，这里会漏掉 wx.modelContext 新增的对象，可以用 patch-package 工具改一下 @dcloudio/uni-mp-weixin 这个依赖，在 @dcloudio/uni-mp-weixin/dist/wx.js 里面把 modelContext 加进去。

# Q：开发者可以用评测 SKILLs 做什么？

可基于已生成的原子接口、原子组件，模拟真实用户对话完成效果评测，自动分析问题、提供优化建议并输出完整评测报告。

# Q：评测 SKILLs 是否支持开发者自定义评测集和 CheckList ？

支持。在调用评测 SKILLs 时会出现一个本地网页链接，在网页链接的对应表单中上传自定义评测集和 CheckList 即可。

# Q：如何保证评测 SKILLs 能评测到 AI 模式代码包含的各类业务流程？

建议开发者准备好需要跑评测的微信测试号，该微信测试号需要包含各类业务流程信息（如登录权限、业务数据等），建议提前使用该账号登录微信开发者工具。

# Q：评测 SKILLs 是纯自动化运作的吗？需要人工干预吗？

调用评测 SKILLs 的大部分过程是自动化运作的，但建议开发者在电脑端关注进度和实时结果。评测过程中可能会遇到少量需要人工干预的流程（比如在开发者工具扫码人脸识别登录、操作微信支付等），开发者需关注并主动干预，完成后可继续进行自动化评测。

# Q：评测 SKILLs 需要配置开发者自己的模型资源吗？建议使用什么类型的模型？

需要。开发者需在自己的 Coding Agent 中输入对应的模型配置信息，该信息微信团队不会获取。建议使用较高智能度、参数量较大的模型来进行评测，模型智能度越高，评测质量会越好。 微信开放社区-小程序AI能力专区

# Q：如果开发者 SKILLs 中存在「下单」「支付」「发票」等接口，会真实操作吗？

会，但「微信支付」等能力最终需用户确认才会真实支付，并不会直接扣费。为避免真实资金损失，建议使用测试号进行测试，关闭免密支付等能力。

# Q：评测 SKILLs 支持半屏页面、卡片最大化、卡片操作相关的评测吗？

暂未支持，我们会尽快支持相关能力上线。

# Q：哪些情况评测不支持？

在图片（如P图）、文件操作类（如文件转化）的场景，如果开发者配置的模型本身不支持对图形、文件类的分析，则无法评估效果。需要开发者自行真机测试。

# Q：支持硬件类评测吗？

硬件类评测，如开发者的设备需要近场联网，建议将设备放在操作评测工具的电脑附近。

# Q：调用评测 SKILLs 过程中遇到问题怎么办？

可在微信开放社区 - 小程序AI能力专区提交反馈问题，微信团队会尽快跟进处理。

# Q：如何查看和解读评测 SKILLs 的报告结果？

评测 SKILLs 运行完成后，开发者会获得一个「html」格式的报告结果。建议开发者重点关注缺陷详情和每条 Case 的运作轨迹，查看是否存在问题。

# Q：评测 SKILLs 的结果可以直接用于提审上线吗？

不能，评测 SKILLs 的结果仅用于开发者自测。

# Q：我已经开发好了 AI 模式代码，可以向微信提交代码提审评测吗？

暂未开放提审评测。微信团队后续会发布评测工具方便开发者提审评测。

# Q：微信团队针对小程序 AI 模式代码提审的评测通过标准是什么？

希望开发者的小程序 AI 模式在可用性、好用度、功能覆盖度、运营安全性上均有良好的表现。微信团队后续会发布具体评测标准供开发者参考。