feat(tabbar): AI答疑按钮改为跳转到腾讯元宝小程序
功能变更: - 移除本地开发的AI页面 - 点击AI答疑按钮跳转到腾讯元宝AI小程序 - 使用 Taro.navigateToMiniProgram API 需要配置: - 腾讯元宝小程序 AppID - 小程序页面路径 - 在微信后台关联元宝小程序 相关文档:docs/腾讯元宝AI接入说明.md Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Showing
2 changed files
with
161 additions
and
1 deletions
docs/腾讯元宝AI接入说明.md
0 → 100644
| 1 | +# 腾讯元宝AI小程序接入说明 | ||
| 2 | + | ||
| 3 | +## 📌 功能说明 | ||
| 4 | + | ||
| 5 | +点击底部导航栏的"AI答疑"按钮,将跳转到腾讯元宝AI的小程序进行智能问答。 | ||
| 6 | + | ||
| 7 | +## 🔧 配置步骤 | ||
| 8 | + | ||
| 9 | +### 1. 获取腾讯元宝小程序 AppID | ||
| 10 | + | ||
| 11 | +联系公司技术团队或腾讯元宝AI客服,获取: | ||
| 12 | +- **小程序 AppID**:格式如 `wxXXXXXXXXXXXXXXXX` | ||
| 13 | + | ||
| 14 | +### 2. 配置跳转参数 | ||
| 15 | + | ||
| 16 | +在 `src/components/TabBar.vue` 文件中,找到 AI 答疑按钮的点击处理函数: | ||
| 17 | + | ||
| 18 | +```javascript | ||
| 19 | +// 文件位置: src/components/TabBar.vue | ||
| 20 | +// 行数: 约第 96 行 | ||
| 21 | + | ||
| 22 | +} else if (item.key === 'ai') { | ||
| 23 | + Taro.navigateToMiniProgram({ | ||
| 24 | + appId: 'wxXXXXXXXXXXXXXXXX', // 👈 替换这里为实际的元宝小程序 AppID | ||
| 25 | + path: 'pages/index/index', // 👈 根据元宝小程序实际路径填写 | ||
| 26 | + extraData: { | ||
| 27 | + // 如果需要传递参数,在这里配置 | ||
| 28 | + // from: 'manulife-weapp' | ||
| 29 | + }, | ||
| 30 | + envVersion: 'release', // 打开正式版 | ||
| 31 | + success: (res) => { | ||
| 32 | + console.log('跳转元宝小程序成功', res) | ||
| 33 | + }, | ||
| 34 | + fail: (err) => { | ||
| 35 | + console.error('跳转元宝小程序失败', err) | ||
| 36 | + Taro.showToast({ | ||
| 37 | + title: '跳转失败,请稍后重试', | ||
| 38 | + icon: 'none' | ||
| 39 | + }) | ||
| 40 | + } | ||
| 41 | + }) | ||
| 42 | +} | ||
| 43 | +``` | ||
| 44 | + | ||
| 45 | +### 3. 微信小程序后台配置 | ||
| 46 | + | ||
| 47 | +在微信小程序后台添加关联: | ||
| 48 | + | ||
| 49 | +1. 登录 [微信小程序后台](https://mp.weixin.qq.com/) | ||
| 50 | +2. 进入"开发" → "开发管理" → "开发设置" | ||
| 51 | +3. 找到"关联小程序"部分 | ||
| 52 | +4. 点击"关联小程序",填写腾讯元宝小程序的 AppID | ||
| 53 | + | ||
| 54 | +### 4. 配置须知 | ||
| 55 | + | ||
| 56 | +⚠️ **重要提示**: | ||
| 57 | + | ||
| 58 | +1. **AppID 配置** | ||
| 59 | + - 必须使用实际的元宝小程序 AppID | ||
| 60 | + - 格式:`wx` 开头 + 18位字符 | ||
| 61 | + | ||
| 62 | +2. **路径配置** | ||
| 63 | + - 根据元宝小程序实际页面路径填写 | ||
| 64 | + - 如果跳转到首页,通常为 `pages/index/index` | ||
| 65 | + - 可通过元宝小程序的技术文档确认 | ||
| 66 | + | ||
| 67 | +3. **envVersion 参数** | ||
| 68 | + - `release`:正式版 | ||
| 69 | + - `trial`:体验版 | ||
| 70 | + - `develop`:开发版 | ||
| 71 | + | ||
| 72 | +4. **测试验证** | ||
| 73 | + - 配置完成后,在真机上测试跳转功能 | ||
| 74 | + - 确保能正常打开元宝小程序 | ||
| 75 | + | ||
| 76 | +### 5. 常见问题 | ||
| 77 | + | ||
| 78 | +#### Q1: 跳转失败,提示"不存在的小程序" | ||
| 79 | +**原因**: AppID 配置错误或小程序未关联 | ||
| 80 | +**解决**: | ||
| 81 | +- 检查 AppID 是否正确 | ||
| 82 | +- 确认已在微信小程序后台关联元宝小程序 | ||
| 83 | + | ||
| 84 | +#### Q2: 跳转成功但页面显示错误 | ||
| 85 | +**原因**: path 路径配置错误 | ||
| 86 | +**解决**: | ||
| 87 | +- 联系元宝技术团队确认正确的页面路径 | ||
| 88 | +- 或跳转到首页: `pages/index/index` | ||
| 89 | + | ||
| 90 | +#### Q3: 用户没有使用过元宝小程序,能否跳转? | ||
| 91 | +**答**: 可以。微信会自动打开目标小程序。 | ||
| 92 | + | ||
| 93 | +#### Q4: 跳转后用户还能返回吗? | ||
| 94 | +**答**: 可以。用户点击返回按钮会回到本小程序。 | ||
| 95 | + | ||
| 96 | +## 📝 配置模板 | ||
| 97 | + | ||
| 98 | +```javascript | ||
| 99 | +// 在 TabBar.vue 中的配置示例 | ||
| 100 | + | ||
| 101 | +Taro.navigateToMiniProgram({ | ||
| 102 | + appId: 'wx1234567890abcdef', // 👈 替换为实际 AppID | ||
| 103 | + path: 'pages/chat/index', // 👈 替换为实际路径 | ||
| 104 | + extraData: { | ||
| 105 | + source: 'manulife-weapp', // 来源标识 | ||
| 106 | + userId: 'xxx', // 如果需要传递用户ID | ||
| 107 | + }, | ||
| 108 | + envVersion: 'release', | ||
| 109 | + success: (res) => { | ||
| 110 | + // 跳转成功 | ||
| 111 | + console.log('跳转成功', res) | ||
| 112 | + }, | ||
| 113 | + fail: (err) => { | ||
| 114 | + // 跳转失败 | ||
| 115 | + console.error('跳转失败', err) | ||
| 116 | + Taro.showToast({ | ||
| 117 | + title: '跳转失败', | ||
| 118 | + icon: 'none' | ||
| 119 | + }) | ||
| 120 | + } | ||
| 121 | +}) | ||
| 122 | +``` | ||
| 123 | + | ||
| 124 | +## ✅ 配置检查清单 | ||
| 125 | + | ||
| 126 | +完成以下步骤后,AI答疑功能即可正常使用: | ||
| 127 | + | ||
| 128 | +- [ ] 获取腾讯元宝小程序的实际 AppID | ||
| 129 | +- [ ] 确认元宝小程序的页面路径 | ||
| 130 | +- [ ] 修改 `src/components/TabBar.vue` 中的配置 | ||
| 131 | +- [ ] 在微信小程序后台关联元宝小程序 | ||
| 132 | +- [ ] 真机测试跳转功能 | ||
| 133 | + | ||
| 134 | +## 📞 技术支持 | ||
| 135 | + | ||
| 136 | +如有问题,请联系: | ||
| 137 | +- **公司技术团队**: [联系方式] | ||
| 138 | +- **腾讯元宝AI客服**: [官方客服渠道] | ||
| 139 | + | ||
| 140 | +--- | ||
| 141 | + | ||
| 142 | +**文档版本**: v1.0 | ||
| 143 | +**创建日期**: 2026-01-30 | ||
| 144 | +**最后更新**: 2026-01-30 |
| ... | @@ -94,10 +94,26 @@ const handleTabClick = (item) => { | ... | @@ -94,10 +94,26 @@ const handleTabClick = (item) => { |
| 94 | 94 | ||
| 95 | Taro.reLaunch({ url: item.path }) | 95 | Taro.reLaunch({ url: item.path }) |
| 96 | } else if (item.key === 'ai') { | 96 | } else if (item.key === 'ai') { |
| 97 | + // 跳转到腾讯元宝AI小程序 | ||
| 98 | + Taro.navigateToMiniProgram({ | ||
| 99 | + appId: 'wxXXXXXXXXXXXXXXXX', // TODO: 替换为实际的腾讯元宝小程序 AppID | ||
| 100 | + path: 'pages/index/index', // TODO: 元宝小程序的路径(根据实际情况填写) | ||
| 101 | + extraData: { | ||
| 102 | + // TODO: 如果需要传递参数,在这里配置 | ||
| 103 | + // from: 'manulife-weapp' | ||
| 104 | + }, | ||
| 105 | + envVersion: 'release', // 打开正式版 | ||
| 106 | + success: (res) => { | ||
| 107 | + console.log('跳转元宝小程序成功', res) | ||
| 108 | + }, | ||
| 109 | + fail: (err) => { | ||
| 110 | + console.error('跳转元宝小程序失败', err) | ||
| 97 | Taro.showToast({ | 111 | Taro.showToast({ |
| 98 | - title: '功能开发中', | 112 | + title: '跳转失败,请稍后重试', |
| 99 | icon: 'none' | 113 | icon: 'none' |
| 100 | }) | 114 | }) |
| 101 | } | 115 | } |
| 116 | + }) | ||
| 117 | + } | ||
| 102 | } | 118 | } |
| 103 | </script> | 119 | </script> | ... | ... |
-
Please register or login to post a comment