@earendil-works/pi-voice

中文文档
0.2.0发布于 2026/10/16MITES Module构建来源已验证近 30 天下载 2112

Pi 的本地语音对文本

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 从 pi- transis 升级
  4. 文件复制和FFmpeg
  5. 开发并建设皮声

皮声

本地语为皮.

按下键盘快捷键,交谈,产生的记录稿将直接放入您的聊天中.

安装

安装 npm 包 :

pi install npm:@earendil-works/pi-voice

如果您更喜欢在开发端,可以从 GitHub 安装:

pi install ssh://[email protected]/earendil-works/pi-voice

使用量

扩展登记册:

  • 可配置的终端快捷方式(Ctrl+Alt+Z 默认情况下)开始并停止录音;
  • /voice,与快捷键相同。 在录音时, Space 并停止和翻译 Escape 弃物;
  • (单位:千美元) transcribe_file a. 代理可以用来转录本地音频或视频文件的工具;
  • /voice-settings 用于首选语言、模型、抄写语言、麦克风和快捷键设置.

/transcribe 仍可作为兼容性别名用于: /voice-settings。 。 。 .

从 pi- transis 升级

建议通过国家防范机制安装Pi Voice. 如果你有更古老的 Pi-trancis 安装 解开它:

pi remove git:github.com/earendil-works/pi-transcribe

如果你把它安装在一个项目中 -l运行 pi remove -l git:github.com/earendil-works/pi-transcribe 而不是那个项目。 然后安装 Pi 语音 :

pi install npm:@earendil-works/pi-voice

文件复制和FFmpeg

探员可以打电话 transcribe_file 用于本地音频或视频文件。 解码音频限为512 MiB(约2.3小时). 文件解码需要 ffmpeg 可执行文件 。 如果您尚未安装系统软件包, 请用系统软件包管理器安装 FFmpeg

# macOS with Homebrew
brew install ffmpeg

# Debian or Ubuntu
sudo apt install ffmpeg

# Windows with winget
winget install Gyan.FFmpeg

如果 FFmpeg 在外部安装 PATH在皮伊开始前

export PI_VOICE_FFMPEG_PATH=/path/to/ffmpeg

遗产 PI_TRANSCRIBE_FFMPEG_PATH 当 PI_VOICE_FFMPEG_PATH 未设置.

当FFmpeg不可用时, transcribe_file 向代理人提供针对平台的指导意见。 代理在运行包管理命令前应当询问. 模式设置仍然明确:运行 /voice-settings 一次在交互式 TUI 中选择并在确认后下载本地模式.

开发并建设皮声

要开发或运行它从检查:

git clone [email protected]:earendil-works/pi-voice.git
cd pi-voice
npm install --ignore-scripts
pi -e .

如果您想要重新登入, 您可以在启动 Pi 时启用调试env var 。 这样可以使 /voice-onboarding 命令.

PI_VOICE_DEBUG=1 pi -e /absolute/path/to/pi-voice

版本与发布记录

@earendil-works/pi-voice 共发布 2 个版本,首次发布于 2026/09/23;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.0latest2026/10/1629 天前
0.1.02026/09/231 个月前

关于 @earendil-works/pi-voice 的常见问题

@earendil-works/pi-voice 是什么?

Pi 的本地语音对文本

如何安装 @earendil-works/pi-voice?

在项目目录运行 npm install @earendil-works/pi-voice,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:typebox(*)、@earendil-works/pi-tui(*)、@earendil-works/pi-coding-agent(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@earendil-works/pi-voice 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/earendil-works__pi-voice 是否存在。

@earendil-works/pi-voice 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@earendil-works/pi-voice 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@earendil-works/pi-voice 可以商用吗?

@earendil-works/pi-voice 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@earendil-works/pi-voice 的下载量有多少?

根据 npm 官方下载统计,@earendil-works/pi-voice 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,112 次,日均约 70 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@earendil-works/pi-voice 还在维护吗?

最新版本 0.2.0 发布于 2026/10/16(29 天前);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/09/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。