API 参考

1// 创建客户端（推荐使用 tokenProvider 动态获取临时Token）
2const client = new ChatClient({
3  appId: 'your-project-id',
4  tokenProvider: async () => {
5    // ⭐ 每次请求前自动调用，安全且支持 Token 自动刷新
6    const res = await fetch('/api/auth/temp-token', { method: 'POST' });
7    return (await res.json()).tempToken;
8  },
9});
10
11// === 消息 ===
12await client.send('你好');                                     // 纯文本，非流式
13await client.sendMessage({ content: '你好', stream: true });   // 流式响应
14await client.sendImage(fileInput.files[0], '请描述这张图');   // 图片 + 文字
15
16// === 会话 ===
17await client.getConversations();          // 获取会话列表
18await client.switchConversation('conv_xxx'); // 切换会话
19client.newConversation();                 // 新会话
20
21// === TTS ===
22client.setTtsMuted(false);              // 开启流式播报
23await client.playTts(msg.id, msg.content); // 播放单条消息
24await client.generateTts('你好', { voice: 'longxiaochun_v3' }); // 仅合成
25
26// === 控制 ===
27client.abortAll();                      // 中止所有请求
28client.destroy();                        // 销毁实例

1// 全局：注册跨页面通用动作
2const offGlobal = client.registerAgentAction({
3  name: 'openProjectsPage',
4  description: '打开项目列表页',
5  parameters: [],
6  handler: async () => ({ success: true, message: '已打开项目列表页' }),
7});
8
9// 页面：注册当前页面专属动作（组件卸载时注销）
10const offPage = client.registerAgentAction({
11  name: 'submitOrderForm',
12  description: '提交当前订单表单',
13  parameters: [],
14  needsConfirmation: true,
15  confirmMessage: '确认提交订单？',
16  handler: async () => ({ success: true, message: '订单已提交' }),
17});
18
19// cleanup
20offPage();
21offGlobal();

1import { useChat } from '@lingshuai/chat-uniapp';
2
3const chat = useChat({
4  apiKey: 'tmp_live_xxx',
5  appId: 'your-app-id',
6});
7
8const off = chat.registerAgentAction({
9  name: 'deleteProjectsBatch',
10  description: '批量删除项目',
11  parameters: [{ name: 'projectIds', type: 'array', required: true, description: '项目ID数组' }],
12  needsConfirmation: true,
13  confirmMessage: '确认批量删除这些项目？',
14  handler: async (params) => ({ success: true, message: '已执行删除', data: params }),
15});
16
17chat.on('agent:action_execute', (e) => console.log('action_execute', e));
18chat.on('agent:action_confirm', (e) => console.log('action_confirm', e));
19
20const pending = chat.getPendingConfirms();
21if (pending.length > 0) {
22  await chat.approveAction(pending[0].confirmId);
23}
24
25off();