feat: 统一插槽命名并完善语音输入相关文档与属性

Author: zydemail

packages/pro-components/chat/chat-record/_example/base/index.wxml

@@ -15,7 +15,7 @@
         bind:send="onSend"
         bind:keyboardheightchange="onKeyboardHeightChange"
       >
-        <view slot="voice-input">
+        <view slot="speech-input">
           <t-chat-record useSpeechInputSlot useSpeechNoAuthSlot bind:recognize="onVoiceRecognize">
             <view slot="speechInput" style="padding: 10px; background: #f0f0f0; border-radius: 8px"> 按住说话 </view>
             <view slot="speechNoAuth" style="padding: 10px; background: #ffebee; border-radius: 8px; color: #d32f2f">

packages/pro-components/chat/chat-sender/chat-sender.wxml

@@ -56,7 +56,7 @@
       </block>
       <!-- 语音输入模式 -->
       <block wx:else>
-        <slot name="voice-input" />
+        <slot name="speech-input" />
       </block>
     </view>
 

packages/uniapp-pro-components/chat/chat-record/README.md

@@ -1,24 +1,93 @@
-## API
-### ChatRecord Props
+---
+title: ChatRecord 语音输入
+description: 用于聊天场景的语音输入组件，支持语音转文字、录音时长控制等功能。
+spline: base
+isComponent: true
+---
+## 引入
 
-名称 | 类型 | 默认值 | 说明 | 必传
--- | -- | -- | -- | --
-### 事件
+全局引入，在 miniprogram 根目录下的`app.json`中配置，局部引入，在需要引入的页面或组件的`index.json`中配置。
 
-事件名 | 说明 | 回调参数
--- | -- | --
-recognize | 发送消息 | msg:string
+```js
+import TChatRecord from '@tdesign/uniapp-chat/chat-record/chat-record.vue';
+```
 
+## 前置配置
+内置[微信同声传译插件](https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/extended/translator.html)，
+需要提前在微信小程序中开启同声传译插件，操作方法：登录微信公众平台后台，进入“设置”->“第三方设置”->“插件管理”，通过插件AppID搜索并添加，审核通过后即可在代码中配置使用
 
+### 1. 添加插件声明
 
-### 插槽
+在 `app.json` 中声明微信同声传译插件：
 
-插槽名 | 说明
--- | --
-speechInput | 自定义语音输入按钮内容
-speechNoAuth | 自定义未授权麦克风时的提示内容
+```json
+{
+  "plugins": {
+    "WechatSI": {
+      "version": "0.3.6",
+      "provider": "wx069ba97219f66d99"
+    }
+  }
+}
+```
+
+### 2. 麦克风权限
+
+使用语音输入需要用户授权麦克风权限。组件会自动处理授权流程，但开发者需要了解以下场景：
+
+#### 首次使用
+- 组件会自动调用 `wx.authorize` 申请麦克风权限
+- 用户同意后即可正常使用
+
+#### 用户拒绝授权
+- 如果用户点击拒绝，会显示"请授权麦克风权限"提示
+- 点击提示区域会引导用户前往设置页面开启权限
+
+#### 权限问题排查
+
+如果在小程序设置页面看不到麦克风权限选项：
+
+1. **检查微信 App 权限**
+   - 进入手机系统设置 > 应用管理 > 微信
+   - 确保微信有麦克风权限
+
+2. **检查小程序授权**
+   - 微信中下拉打开最近使用小程序列表
+   - 长按目标小程序 > 关于小程序 > 设置
+   - 查看是否有麦克风权限选项
+
+3. **重新授权**
+   - 删除小程序后重新搜索进入
+   - 首次点击语音输入时会重新触发授权弹窗
+
+4. **真机调试**
+   - 模拟器无法测试录音功能
+   - 必须使用真机预览或体验版测试
 
 ### 示例用法
 #### 基础类型
 
 {{ base }}
+
+## API
+
+### ChatRecord Props
+
+名称 | 类型 | 默认值 | 描述 | 必传
+-- | -- | -- | -- | --
+useSpeechNoAuthSlot | Boolean | false | 是否启用语音输入无权限时显示插槽 | N
+useSpeechInputSlot | Boolean | false | 是否启用语音输入时显示插槽 | N
+
+### ChatRecord Events
+
+名称 | 参数 | 描述
+-- | -- | --
+recognize | msg: string | 识别到的文本内容
+
+### ChatRecord Slots
+
+名称 | 描述
+-- | --
+speechInput | 语音输入按钮插槽
+speechNoAuth | 语音授权按钮插槽
+