# b3-dict 中文文档

规范地址：https://npmcn.com/package/b3-dict/

版本：0\.7\.3
npm 元数据更新时间：2026-11-03T03:47:22.149Z
中文译文更新时间：2026-11-03T04:47:16.803Z
软件包许可：ISC

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/b3-dict
原文对照：https://npmcn.com/package/b3-dict/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：234 kB，92 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：16 个
- 首次发布：2026-10-07T01:19:15.722Z
- 最新版本发布：2026-11-03T03:47:21.804Z
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

AI-first终端词典：自由格式的EN/VI单词问题，以越南语回答

## 安装

```sh
npm install b3-dict
```

也可以使用：`pnpm add b3-dict`、`yarn add b3-dict`、`bun add b3-dict`

## README

# B3 Dict类型

用于终端的ai优先字典。询问英语单词、习语或越南语/英语混合用法；答案来自越南语。自由形式的问题，而不是双语查找表：“可拖动的是一个真正的单词吗？”，“认为理所当然nghĩa lgì ？”，或者粘贴一个笑话并询问如何阅读它。

## 开始使用

需要Node 22或更新版本以及来自的API密钥 [OpenRouter](https://openrouter.ai/keys)， [OpenAI](https://platform.openai.com/api-keys) 或者 [烟花](https://app.fireworks.ai/settings/users/api-keys).

```bash
npm install
cp .env.example .env       # then paste your key into .env
npm run build
npm link                   # puts `b3dict` on your PATH

b3dict                     # interactive: type a question, press enter
b3dict "take for granted"  # one-shot: print the answer and exit
b3dict "Is draggable an English word?"
b3dict "they are your to decide if they are good to go"   # check a sentence you wrote
b3dict "Agreed or Agree? Approved or Approve?"            # which one to use
b3dict "take for granted" --fresh    # skip the stored answer, ask again
b3dict "draggable" --json            # raw answer envelope
```

答案存储在 `data/b3-dict.db`，所以同样的问题问两次，第二次不会有任何花费。 `.env` 和 `data/` 无论在哪里运行，都在此文件夹中 `b3dict` 从。 `settings.json` 坐在…旁边 `.env` 一旦你在TUI中选择了一个模型。从npm安装而不是签出，它们移动到 `~/.local/share/b3-dict` (或 `$XDG_DATA_HOME/b3-dict`）; 集 `B3_DICT_HOME` 把它们放在别的地方。

想知道每次通话的费用和时间吗？放你自己的 `LANGFUSE_PUBLIC_KEY`， `LANGFUSE_SECRET_KEY` 和 `LANGFUSE_BASE_URL` 在 `.env` 每个模特电话都会出现在你的 [Langfuse](https://langfuse.com/) 包括项目、问题和答案。B3dict没有自己的密钥，所以没有你的密钥，它什么也不会发送。

在交互式屏幕中，粘贴适用于多行问题。一旦答案出来了： `r` 又问, `s` 保存到单词本里， `esc` 返回, `q` 退却。新闻 `↓` 从问题框进入历史（你问过的所有问题）和词汇书（你用星号标出的内容）； `enter` 在不调用模型的情况下重新打开存储的答案， `s` 星号或非星号排列。同样的菜单有Model，当两个键都在时，您可以在其中选择对应的模型和提供程序 `.env` (记得下次，除非 `B3_DICT_PROVIDER` 或者 `B3_DICT_MODEL` 设置)，以及Help，它列出了键和文件的位置。从空的问题框中， `esc` 或者 `ctrl+c` 退却。

### 在Langfuse看到烟花的成本

跟踪到达令牌计数，但烟花模型的空成本列。Langfuse没有内置的价格，所以你可以在Langfuse项目的设置→模型下自己添加一个。有两件事容易出错：

-   **匹配完整的模型id。** b3dict发送 `accounts/fireworks/models/minimax-m3`,而不是 `minimax-m3`． 的模式 `(?i)^(minimax-m3)$` 不匹配任何值，并且cost为空。
-   **价格是按代币计算的，而不是按百万计算。** `0.3` 意味着每个代币0.30美元，这将十分之一美分的查找变成数百美元。

为 `minimax-m3` 每百万代币0.3美元进，1.2美元出：

| 场 | 价值 |
| --- | --- |
| 匹配模式 | `(?i)^(accounts/fireworks/models/minimax-m3)$` |
| `input` 价格 | `0.0000003` |
| `output` 价格 | `0.0000012` |

Fireworks还报告在usage键下缓存的提示令牌 `input_cached_tokens`． 没有这个键的价格行，这些令牌算免费的，所以添加一个烟花的缓存率为您的模型。其他的Fireworks模型也需要自己的定义；从 [烟花价格页面](https://fireworks.ai/pricing).

定义只对保存后到达的轨迹进行定价。老一些的保留空成本。

## 开发

```bash
npm run typecheck          # Typecheck
npm run lint               # Lint
npm test                   # Run tests
npm run dev -- "<query>"   # Run from source without building
npm run typecheck && npm run lint && npm test && npm run build   # Before creating a PR
```

## 体系结构

基于用户的模型→更新→视图。状态在单个reducer，组件调度动作，副作用在useEffect。在React习语中反映了Bubbletea的规则。

## 文档

-   [CLAUDE.md](https://npmcn.com/package/b3-dict/CLAUDE.md) -发展指引
-   [GLOSSARY.md](https://npmcn.com/package/b3-dict/GLOSSARY.md) -领域词汇表
-   [文档/ PRD.md](https://npmcn.com/package/b3-dict/docs/PRD.md) -产品要求
-   [文档/ USER-STORIES.md](https://npmcn.com/package/b3-dict/docs/USER-STORIES.md) -用户描述和验收标准
-   [文档/ INK-TUI-UI-UX-GUIDELINE.md](https://npmcn.com/package/b3-dict/docs/INK-TUI-UI-UX-GUIDELINE.md) -墨水TUI设计系统及组件规格
-   [文档/ INK-TUI-TECH-SPECS.md](https://npmcn.com/package/b3-dict/docs/INK-TUI-TECH-SPECS.md) —技术栈和配置

## 许可证

国际安全委员会

## 常见问题

### b3-dict 是什么？

AI-first终端词典：自由格式的EN/VI单词问题，以越南语回答

### 如何安装 b3-dict？

在项目目录运行 npm install b3-dict，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 b3dict，可以用 npx b3dict 直接运行。

### b3-dict 支持 TypeScript 吗？

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

### b3-dict 支持 ESM 还是 CommonJS？

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

### b3-dict 需要什么版本的 Node\.js？

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

### b3-dict 可以商用吗？

b3-dict 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### b3-dict 还在维护吗？

最新版本 0\.7\.3 发布于 2026/11/03（今天）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/10/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。