[Brave]

Brave

你是否想拥有一套私人的内容创作系统，既能通过强大的语音转文字工具快速记录灵感，又能通过专业的发布平台管理你的内容？本文专为 Mac 用户（尤其是技术小白）打造，介绍如何利用 Orbstack 搭建一套包含 本地语音识别 和 专业内容管理 的全能创作中心，并利用 BraveDAO 的前端插件 实现二者的无缝整合。

这套系统能为你做什么

这套系统由三个核心部分组成，精简而高效：

1. WordPress：🌐 世界上最流行的内容管理系统。用于发布、整理和归档你的图文内容。
2. WhisperLiveKit：🎙️ 基于 OpenAI Whisper 模型的高性能实时语音转文字服务。运行在本地，保护隐私，提供后端 API 支持。
3. Whisper Live Transcriber （WordPress插件）：🔌 由 BraveDAO 开发的前端适配器，它像一座桥梁，让你直接在 WordPress 文章编辑器中通过语音输入文字，无需在不同软件间切换。

安装方法一：简单直接版（推荐小白用户）

第一步：安装 Orbstack

你可以直接访问 orbstack.dev 下载 Orbstack 的安装包。如果你使用的是 M1/M2/M3 等苹果芯片，请选择 Apple Silicon 版本。安装完成后，双击运行并启动。

第二步：创建服务配置文件

这一步我们创建一个文本文件，告诉系统如何启动 WordPress 和 Whisper 服务。

1. 打开 Mac 的终端（Terminal），创建一个新文件夹：

mkdir -p ~/我的创作系统 cd ~/我的创作系统

1. 创建配置文件：

nano docker-compose.yml

1. 复制并粘贴以下内容：

name: my-content-stack

services:
  # WhisperLiveKit: 语音转文字后端服务
  whisperlivekit:
    build:
      context: .
      dockerfile_inline: |
        FROM python:3.11-slim
        RUN apt-get update && apt-get install -y --no-install-recommends \
            ffmpeg \
            git \
            build-essential \
            && rm -rf /var/lib/apt/lists/*
        RUN pip install --no-cache-dir torch --index-url https://download.pytorch.org/whl/cpu
        RUN pip install --no-cache-dir whisperlivekit
        WORKDIR /app
        EXPOSE 8000
        ENTRYPOINT ["wlk"]
        CMD ["--host", "0.0.0.0", "--port", "8000", "--model", "small", "--language", "auto"]
    container_name: whisperlivekit
    ports:
      - "8000:8000"
    volumes:
      - whisper-cache:/root/.cache
    environment:
      - HF_HOME=/root/.cache/huggingface
    restart: unless-stopped
    networks:
      - app_network

  # MariaDB 数据库
  db:
    image: mariadb:10.6.4-focal
    container_name: wordpress-db
    command: --default-authentication-plugin=mysql_native_password
    volumes:
      - db_data:/var/lib/mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: somewordpress
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p$MYSQL_ROOT_PASSWORD"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 60s
    networks:
      - app_network

  # WordPress 网站
  wordpress:
    image: wordpress:latest
    container_name: wordpress
    depends_on:
      db:
        condition: service_healthy
    volumes:
      - wp_data:/var/www/html
    ports:
      - "80:80"
    restart: always
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
      WORDPRESS_DB_NAME: wordpress
    networks:
      - app_network

# 卷定义
volumes:
  whisper-cache:
  db_data:
  wp_data:

# 网络定义
networks:
  app_network:
    name: app_network
    driver: bridge

1. 保存并退出：按 Ctrl+X，然后按 Y 确认，最后按 Enter。

第三步：一键启动所有服务

在终端中执行：

docker compose up -d

> 注意：首次运行需要下载和构建镜像，可能需要几分钟。待 Orbstack 面板中所有服务变绿（Running）即表示成功。

安装方法二：进阶版（使用 Ubuntu 虚拟机 + Dockge）

此部分适合喜欢使用 Dockge 面板管理的高级用户，配置代码与上方 YAML 相同，只需将代码粘贴至 Dockge 的编辑窗口即可。

可参考基地文章：《最佳macOS版Docker方案：Orbstack+Linux+Docker》

安装后的关键步骤：配置前端适配插件 (BraveDAO Edition)

服务启动后，我们虽然有了 WordPress (前端) 和 Whisper (后端)，但它们还没连通。现在我们需要使用 BraveDAO 开发的专用插件来实现“无缝整合”。

准备工作：确保你拥有 whisper-live-transcriber.zip 插件包。

1. 安装插件

1. 浏览器访问 http://localhost 进入你的 WordPress 站点。
2. 完成 WordPress 初始化设置（设置语言、账号密码等）。
3. 进入后台仪表盘，点击左侧菜单 插件 (Plugins) -> 安装插件 (Add New)。
4. 点击顶部的 上传插件 (Upload Plugin)，选择 whisper-live-transcriber.zip 文件并安装。
5. 点击 启用 (Activate)。

2. 配置 WebSocket 连接

1. 在 WordPress 后台左侧菜单找到 Whisper Live 或 设置 -> Whisper Live Transcriber。
2. 在设置页面中找到 WebSocket URL 字段。
3. 保存设置。

3. 在文章中调用

该插件通过短代码（Shortcode）工作。你可以在任何页面或文章中插入录音按钮。

1. 新建一篇文章。
2. 在编辑器中输入短代码：[whisper_live]
3. 或者将其添加到侧边栏的小工具中，方便随时调用。

终极工作流：如何使用你的新系统

配置完成后，你的“语音写作”流程将变得行云流水：

1. 开启灵感：打开 WordPress 的“新建文章”页面。
2. 点击录音：在页面中看到 [whisper_live] 生成的录音/连接按钮，点击开始。
3. 口述内容：对着麦克风直接把你的想法、草稿说出来。得益于 Whisper 模型，无需刻意放慢语速，系统会自动识别并添加标点。
4. 实时上屏：你会看到文字实时出现在屏幕上，你可以编辑这些文字，并通过Vibe Coding修改插件，获得更多进阶的拓展功能。

常见问题 (FAQ)

• Q: 插件显示连接失败？
  • A: 请检查 Orbstack 中 whisperlivekit 容器是否正在运行（绿色状态）。同时确认你在浏览器中访问 http://localhost:8000 是否有响应（通常显示 404 或 API 文档即代表连通）。
• Q: 识别速度慢？
  • A: 在 docker-compose.yml 中，我们将模型设置为了 --model small。如果你觉得慢，可以改为 --model tiny（速度快但精度略低）。如果你是 M1/M2 Max/Ultra 芯片，可以尝试改为 --model medium 获得更高的识别精度。
• Q: 只能在本地用吗？
  • A: 默认配置下是的。如果你需要在公网访问（例如用手机对着电脑说话），你需要配置内网穿透（如 Cloudflare Tunnel）并将 WebSocket URL 改为你的公网地址。

🎉 恭喜！ 你现在拥有了一套完全私有、数据自控且支持高效语音输入的现代化内容创作系统！