hookehuyr

feat(tabbar): AI答疑按钮改为跳转到腾讯元宝小程序

功能变更:
- 移除本地开发的AI页面
- 点击AI答疑按钮跳转到腾讯元宝AI小程序
- 使用 Taro.navigateToMiniProgram API

需要配置:
- 腾讯元宝小程序 AppID
- 小程序页面路径
- 在微信后台关联元宝小程序

相关文档:docs/腾讯元宝AI接入说明.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
# 腾讯元宝AI小程序接入说明
## 📌 功能说明
点击底部导航栏的"AI答疑"按钮,将跳转到腾讯元宝AI的小程序进行智能问答。
## 🔧 配置步骤
### 1. 获取腾讯元宝小程序 AppID
联系公司技术团队或腾讯元宝AI客服,获取:
- **小程序 AppID**:格式如 `wxXXXXXXXXXXXXXXXX`
### 2. 配置跳转参数
`src/components/TabBar.vue` 文件中,找到 AI 答疑按钮的点击处理函数:
```javascript
// 文件位置: src/components/TabBar.vue
// 行数: 约第 96 行
} else if (item.key === 'ai') {
Taro.navigateToMiniProgram({
appId: 'wxXXXXXXXXXXXXXXXX', // 👈 替换这里为实际的元宝小程序 AppID
path: 'pages/index/index', // 👈 根据元宝小程序实际路径填写
extraData: {
// 如果需要传递参数,在这里配置
// from: 'manulife-weapp'
},
envVersion: 'release', // 打开正式版
success: (res) => {
console.log('跳转元宝小程序成功', res)
},
fail: (err) => {
console.error('跳转元宝小程序失败', err)
Taro.showToast({
title: '跳转失败,请稍后重试',
icon: 'none'
})
}
})
}
```
### 3. 微信小程序后台配置
在微信小程序后台添加关联:
1. 登录 [微信小程序后台](https://mp.weixin.qq.com/)
2. 进入"开发" → "开发管理" → "开发设置"
3. 找到"关联小程序"部分
4. 点击"关联小程序",填写腾讯元宝小程序的 AppID
### 4. 配置须知
⚠️ **重要提示**
1. **AppID 配置**
- 必须使用实际的元宝小程序 AppID
- 格式:`wx` 开头 + 18位字符
2. **路径配置**
- 根据元宝小程序实际页面路径填写
- 如果跳转到首页,通常为 `pages/index/index`
- 可通过元宝小程序的技术文档确认
3. **envVersion 参数**
- `release`:正式版
- `trial`:体验版
- `develop`:开发版
4. **测试验证**
- 配置完成后,在真机上测试跳转功能
- 确保能正常打开元宝小程序
### 5. 常见问题
#### Q1: 跳转失败,提示"不存在的小程序"
**原因**: AppID 配置错误或小程序未关联
**解决**:
- 检查 AppID 是否正确
- 确认已在微信小程序后台关联元宝小程序
#### Q2: 跳转成功但页面显示错误
**原因**: path 路径配置错误
**解决**:
- 联系元宝技术团队确认正确的页面路径
- 或跳转到首页: `pages/index/index`
#### Q3: 用户没有使用过元宝小程序,能否跳转?
**答**: 可以。微信会自动打开目标小程序。
#### Q4: 跳转后用户还能返回吗?
**答**: 可以。用户点击返回按钮会回到本小程序。
## 📝 配置模板
```javascript
// 在 TabBar.vue 中的配置示例
Taro.navigateToMiniProgram({
appId: 'wx1234567890abcdef', // 👈 替换为实际 AppID
path: 'pages/chat/index', // 👈 替换为实际路径
extraData: {
source: 'manulife-weapp', // 来源标识
userId: 'xxx', // 如果需要传递用户ID
},
envVersion: 'release',
success: (res) => {
// 跳转成功
console.log('跳转成功', res)
},
fail: (err) => {
// 跳转失败
console.error('跳转失败', err)
Taro.showToast({
title: '跳转失败',
icon: 'none'
})
}
})
```
## ✅ 配置检查清单
完成以下步骤后,AI答疑功能即可正常使用:
- [ ] 获取腾讯元宝小程序的实际 AppID
- [ ] 确认元宝小程序的页面路径
- [ ] 修改 `src/components/TabBar.vue` 中的配置
- [ ] 在微信小程序后台关联元宝小程序
- [ ] 真机测试跳转功能
## 📞 技术支持
如有问题,请联系:
- **公司技术团队**: [联系方式]
- **腾讯元宝AI客服**: [官方客服渠道]
---
**文档版本**: v1.0
**创建日期**: 2026-01-30
**最后更新**: 2026-01-30
......@@ -94,10 +94,26 @@ const handleTabClick = (item) => {
Taro.reLaunch({ url: item.path })
} else if (item.key === 'ai') {
// 跳转到腾讯元宝AI小程序
Taro.navigateToMiniProgram({
appId: 'wxXXXXXXXXXXXXXXXX', // TODO: 替换为实际的腾讯元宝小程序 AppID
path: 'pages/index/index', // TODO: 元宝小程序的路径(根据实际情况填写)
extraData: {
// TODO: 如果需要传递参数,在这里配置
// from: 'manulife-weapp'
},
envVersion: 'release', // 打开正式版
success: (res) => {
console.log('跳转元宝小程序成功', res)
},
fail: (err) => {
console.error('跳转元宝小程序失败', err)
Taro.showToast({
title: '功能开发中',
title: '跳转失败,请稍后重试',
icon: 'none'
})
}
})
}
}
</script>
......