---
title: Voice 语音速记
description: 边录边转写、录完生成摘要与待办的语音速记
category: TemplateAi
status: beta
since: 0.9.1
tags: [template, ai, voice, transcription, summary, todo]
syncStatus: reviewed
verified: false
---

> **模板约束（文档站）**：下面的约定来自 Nexus 模板规范，改写或复刻本页时遵守。
>
> - 整页放进 `TemplateFrame`，由它负责展开、收起与尺寸。不要显式 import `Tx*` 组件，它们自动注册。
> - 演示从 `@enter` 开始播放，不要放在 `onMounted` 里。
> - 快捷键绑在模板根元素上，不绑 `window` 或 `document`。
> - 反馈放在舞台内的 `TxToastPanel` 里。禁止 `toast()`、`clearToasts()`、`TxToastHost`、`TxTouchTip`、`TxBottomDialog` 与 `TxBlowDialog`。
> - 完整规范见 `docs/engineering/specs/frontend/nexus-docs-templates.md`。

## 用法

### 会议速记
:::TuffDemoWrapper{demo="TemplateVoiceDemo" code-lang="vue" description="进入视口后自动录一段站会，约 15 秒后自动停止并写出摘要与待办；点录音键或选别的录音即交给你。"}
---
code: |
  <script setup lang="ts">
  import TemplateFrame from './TemplateFrame.vue'

  // 电平是一个 getter：TxVoiceBeam 在自己的循环里每帧取样，页面不会每帧重渲染
  function level() {
    return speaking ? syllableLoudness(now() - startedAt) : 0
  }

  // 识别结果几个词一批拼进 received；TxStreamText 负责在屏幕上匀速显影
  line.received = text.slice(0, end)

  // 停止：结束计时，没说完的一句只留在转写里，说完的句子交给摘要
  function stopRecording() {
    endRecording()
    live.phase = 'processing'
    streamSummary()
  }
  </script>

  <template>
    <TemplateFrame title="语音速记" @enter="start">
      <TxVoiceClip :src="row.src" :peaks="row.peaks" :duration-ms="row.durationMs" />
      <TxVoiceBeam :level="level" :active="busy" :processing="summarizing" :organic="1" :paused="!onScreen" :theme="theme">
        <button class="vnote-key" :aria-label="keyLabel" @click="onKey" />
      </TxVoiceBeam>
      <TxStreamText :content="line.received" :streaming="line.live" reveal="blur" />
      <TxBotAvatar :size="30" :state="botState" :paused="botPaused" :theme="theme" />
      <TxStreamText :content="point.received" :streaming="point.live" />
      <TxCheckbox v-model="checked[todo.key]" :label="todo.text" />
      <TxSuggestionChips :suggestions="suggestions" layout="list" @select="onSuggestion" />
      <TxToastPanel :open="toast.open" :tether="false" :stack="0">{{ toast.text }}</TxToastPanel>
    </TemplateFrame>
  </template>
---
:::

## 概述

边录边转写的语音速记：说话时转写按发言人逐段出现，停止后由 AI 写出摘要与待办。转写与摘要均为示例数据。

- 进入视口后自动按下录音键：四段发言说完、静音 2 秒后自动停止（约 15 秒），随后写出要点与 3 条待办，舞台内提示「已生成 3 条待办」。
- 录音中随时可点停止：只有说完的句子进入摘要，没说完的那句只留在转写里；录音键随后变成「重新录制」。
- 录音或总结途中选别的录音，当前这条立即收尾：已听到的内容就地生成摘要，不弹提示。
- 光晕跟随模拟电平，总结时转为处理态；舞台离开视口时光晕与助手头像都停住，头像只在总结、刚写完或指针悬停时活动。
- 每条录音都能播放：音频在页面里现场合成，不使用麦克风，也不请求网络；播放只由你的点击开始。
- 后续操作在舞台内给出结果：翻译切换示例译文；发到收件箱与设提醒只提示这是示例，不会真的发送或提醒。
- 转写与摘要跟随最新内容，向上翻看时停止跟随，整页不动。
- 列内（640–959px）转写与摘要上下排列，≥ 960px 摘要单独一栏、两边各自滚动；窄屏（< 640px）录音列表收进标题栏的切换；减少动态效果时直接呈现录完的结果，光晕不亮。

## 自定义

- 接真实麦克风时，用 `useMicrophone` 拿到的流传给 TxVoiceBeam 的 `stream`，它会自己分析电平与频段并忽略 `level`；没有流时像这里一样给 `level` 一个 getter。
- 把识别服务的增量结果拼进 TxStreamText 的 `content`，说话期间保持 `streaming` 为真，一句说完再置为假。
- 录音时按时间片记下电平的最大值，作为 TxVoiceClip 的 `peaks`，回放时就不必解码音频；音频还没生成时不要传 `durationMs`，不可用的片段会把按时长算出的宽度当作最小宽度，在窄栏里撑出横向溢出。
- 真实录音用 MediaRecorder 产出的 Blob 生成对象 URL 交给 `src`，换录音和卸载时用 `URL.revokeObjectURL` 释放。
- 待办的勾选状态按待办 id 保存，不随语言变化，切换译文时不会丢。

## 相关组件

| 区域 | 组件 | 作用 |
|---|---|---|
| 标题栏 | [TxTag](/docs/dev/components/tag)、[TxFlatRadio](/docs/dev/components/flat-radio) | 示例数据标记；窄屏切换列表与详情 |
| 录音列表 | [TxVoiceClip](/docs/dev/components/voice-clip) | 每条录音的波形、时长与播放 |
| 录音 | [TxVoiceBeam](/docs/dev/components/voice-beam) | 跟随电平的光晕与总结时的处理态 |
| 转写 | [TxStreamText](/docs/dev/components/stream-text) | 按发言人分段、边说边显影 |
| 摘要 | [TxBotAvatar](/docs/dev/components/bot-avatar)、[TxSkeleton](/docs/dev/components/skeleton) | 助手状态与写出要点前的骨架 |
| 待办与后续 | [TxCheckbox](/docs/dev/components/checkbox)、[TxSuggestionChips](/docs/dev/components/suggestion-chips) | 可勾选的待办与后续操作 |
| 提示 | [TxToastPanel](/docs/dev/components/toast-panel) | 舞台内的完成提示 |
