hookehuyr

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

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

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

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
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>
......