plus.navigator.setUserAgent 必须在 plusready 事件后调用，仅影响后续新建 Webview；当前 Webview 需单独 setStyle 并 reload（iOS）或手动添加请求头，且 UA 应追加而非覆盖。
plus.navigator.setUserAgent 必须在 plusready 后调用
直接在 onLaunch 里写 plus.navigator.setUserAgent 很可能失效，因为 plus 对象还没初始化完成。真机运行时常见现象是：日志里 plus 为 undefined，或设置后 getUserAgent() 仍返回原始值。
正确做法是监听 plusready 事件，确保环境就绪再操作：
export default {
onLaunch() {
document.addEventListener('plusready', () => {
const originalUA = plus.navigator.getUserAgent();
const customUA = `${originalUA} MyApp/2.3.0 (Channel/ios-store)`;
plus.navigator.setUserAgent(customUA);
}, false);
}
}
- 不要依赖
setTimeout模拟延迟——时序不可靠，尤其在低端安卓机上容易漏设 - 若使用 Vue 3 + Composition API，需在
onLaunch中手动挂载监听，onMounted不生效（App 端无 DOM 生命周期） - HBuilderX 调试时务必选「真机运行」，模拟器的
plus行为与真实设备不一致
已打开的 Webview 需单独 setStyle 更新 UA
plus.navigator.setUserAgent 只影响后续新建的 Webview，对当前页面（如首页、tabbar 页面）的 Webview 无效。典型表现是：首页请求仍带原始 UA，跳转新页面才生效。
必须显式对当前 Webview 设置样式：
const webview = plus.webview.currentWebview();
if (webview) {
webview.setStyle({ userAgent: customUA });
}
- 这行代码要跟在
setUserAgent后面，且同样放在plusready回调内 - 如果应用有多个常驻 Webview（如分包页面、自定义 tabbar），需对每个目标 Webview 单独调用
setStyle - iOS 上此操作不会立即刷新 UA，需触发一次页面 reload（如
webview.reload()）才能让服务端请求带上新 UA
追加而非覆盖 UA，否则网页兼容性崩塌
直接用 plus.navigator.setUserAgent('MyApp/1.0') 替换整个字符串，会导致 WebView 内核标识丢失，CSS 媒体查询、JS 特性检测、甚至基础渲染都可能异常——比如 Android 上 position: sticky 失效，iOS 上 Flex 布局错位。
执行每日 Agent 复盘（Retro）技能。读取指定日期（通常为前一天）的所有会话聊天记录和动作，总结做得好/不好的地方，提炼改进点和用户画像，并按照规范更新至 memory 文件以及 USER.md、SOUL.md、AGENTS.md 和 MEMORY.md。当用户要求复盘或总结昨日表现时触发此技能。
务必保留原始 UA 结构，只做追加：
- 原始 UA 示例：
Mozilla/5.0 (Linux; Android 12; SM-S901U) AppleWebKit/537.36 ... UniApp/3.2 - 合规追加：
${originalUA} MyApp/2.3.0 Channel/huawei（空格分隔，无特殊字符） - 避免使用括号、斜杠、控制字符；若需传动态参数（如渠道 ID），先用
encodeURIComponent编码再拼接 - 长度建议控制在 512 字符以内，过长可能被某些中间网关截断
iOS 平台 UA 修改需重启 Webview 才能生效
Android 上 setUserAgent + setStyle 能实时生效；但 iOS 的 WKWebView 对 UA 修改限制极严，仅靠 JS 层调用无法改变已加载 Webview 的 UA 请求头。
绕过方案只有两个：
- 在首次加载前就完成 UA 设置（即
plusready后、任何webview.create或navigateTo前） - 对已存在的 Webview，必须调用
webview.reload(true)强制刷新（true参数表示忽略缓存），否则服务端收不到新 UA - 注意：reload 会触发页面白屏，敏感业务页建议加 loading 提示或预加载占位
最易被忽略的是：iOS 上 uni.requ 等网络请求走的是原生 HTTP 栈，不继承 Webview UA，如需统一标识，得在 header 中手动传 X-User-Agent 字段。
