“始终在线”的 Deepseek AI 助手

一种由 Deepseek-V3、RealtimeSTT 和 Typer 提供支持的始终在线 AI 助手模式，专为工程师设计。

请查看演示，我们将带您逐步体验这款始终在线的 AI 助手。

设置

• cp .env.sample .env
  • 使用您的密钥更新 .env 文件：DEEPSEEK_API_KEY 和 ELEVEN_API_KEY
• uv sync
• （可选）安装 Python 3.11（uv python install 3.11）

命令

基础助手聊天界面

更多详情请参阅 main_base_assistant.py。 启动与基础助手的对话式聊天会话：

uv run python main_base_assistant.py chat

Typer 助手对话命令

更多详情请参阅 main_typer_assistant.py、modules/typer_agent.py 和 commands/template.py。

• --typer-file: 包含 Typer 命令的文件
• --scratchpad: 您和助手之间的活动记忆
• --mode: 决定助手如何处理命令：('default', 'execute', 'execute-no-scratch')。

1. 唤醒助手

uv run python main_typer_assistant.py awaken --typer-file commands/template.py --scratchpad scratchpad.md --mode execute

2. 与助手交谈 试试这个：“你好！Ada，ping 一下服务器，等待响应”（请确保清晰地发音“Ada”）

3. 查看草稿板中的命令 打开 scratchpad.md，即可看到生成的命令。

助手架构

更多详情请参阅 assistant_config.yml。

Typer 助手

更多详情请参阅 assistant_config.yml。

• 🧠 大脑：Deepseek V3
• 📝 工作（提示）：prompts/typer-commands.xml
• 💻 活动记忆（动态变量）：scratchpad.txt
• 👂 耳朵（语音识别）：RealtimeSTT
• 🎤 口舌（文本转语音）：ElevenLabs

基础助手

更多详情请参阅 assistant_config.yml。

• 🧠 大脑：ollama:phi4
• 📝 工作（提示）：无
• 💻 活动记忆（动态变量）：无
• 👂 耳朵（语音识别）：RealtimeSTT
• 🎤 口舌（文本转语音）：本地

资源

• 本地语音转文本：https://github.com/KoljaB/RealtimeSTT
• faster whisper（支持 RealtimeSTT）：https://github.com/SYSTRAN/faster-whisper
• whisper：https://github.com/openai/whisper
• 示例：https://github.com/KoljaB/RealtimeSTT/blob/master/tests/realtimestt_speechendpoint_binary_classified.py
• elevenlabs 语音模型：https://elevenlabs.io/docs/developer-guides/models#older-models

Always-On AI Assistant 快速上手指南

本指南帮助开发者快速部署基于 Deepseek-V3 的“始终在线”AI 助手，支持语音交互与工程命令执行。

环境准备

• 操作系统：Linux / macOS / Windows (WSL 推荐)
• Python 版本：推荐 Python 3.11
• 前置依赖：
  • uv 包管理工具（用于快速同步环境和运行）
  • API Keys：
    • DeepSeek API Key (DEEPSEEK_API_KEY)
    • ElevenLabs API Key (ELEVEN_API_KEY)，用于语音合成
• 网络提示：由于涉及海外 API 调用，建议确保网络通畅或配置代理。国内用户可关注是否有社区提供的镜像加速方案。

安装步骤

1. 克隆项目并配置环境变量 复制示例配置文件并填入你的 API 密钥：

   cp .env.sample .env
   

   编辑 .env 文件，填入以下关键信息：

   DEEPSEEK_API_KEY=你的_deepseek_key
   ELEVEN_API_KEY=你的_elevenlabs_key
   

2. 安装 Python 环境（可选） 如果尚未安装 Python 3.11，可使用 uv 一键安装：

   uv python install 3.11
   

3. 同步依赖 使用 uv 安装项目所需的所有依赖包：

   uv sync
   

基本使用

本项目提供两种主要模式：基础聊天模式和工程命令执行模式（Typer）。

1. 启动基础聊天助手

进入纯对话模式，适合日常问答测试：

uv run python main_base_assistant.py chat

2. 启动工程命令助手（推荐）

此模式允许你通过语音指令让 AI 生成并执行工程命令。

启动助手：

uv run python main_typer_assistant.py awaken --typer-file commands/template.py --scratchpad scratchpad.md --mode execute

参数说明：

• --typer-file: 定义可用命令模板的文件。
• --scratchpad: 用于存储 AI 生成的命令和上下文的临时记忆文件。
• --mode: 设置为 execute 表示生成命令后尝试执行。

进行语音交互： 启动后，对着麦克风清晰地说出唤醒词和指令，例如：

"Hello! Ada, ping the server wait for a response" (注意：请清晰发音 "Ada" 以触发唤醒)

查看结果： 打开 scratchpad.md 文件，你可以看到 AI 根据语音指令生成的具体命令内容。