@dittowords/cli

中文文档
5.13.0发布于 2026/11/06MITTypeScriptCommonJS近 30 天下载 4万

Ditto(dittowords.com)的命令行界面.

中文使用文档
文档目录10 节
  1. 文档
  2. 支助
  3. 安装
  4. 认证
  5. 配置
  6. 使用量
  7. 拉开
  8. 扫描
  9. 遗产设置
  10. 反馈

Ditto CLI 数据

Ditto CLI使开发者能够直接从命令行访问Ditto API. 您可以使用 CLI 直接将 Ditto 数据导入到您的代码库 .

CLI 配置是为了默认获取 Ditto 最新版本的文本 。 然而,所有遗留的特征仍然得到充分支持,通过了 --legacy 旗与遗留的 CLI 命令。 见 遗产设置 关于使用带有更古老的Ditto项目和组件的CLI的细节.

NPM version

文档

支助

安装

npm install --save-dev @dittowords/cli

建议安装CLI作为开发依赖,以确保你整个团队在同一版本上.

认证

运行 ditto login 通过浏览器登录。 您的会话被保存到 ~/.config/ditto· ; ditto logout 忘记它.

在 CI 中, 或浏览器没有可用的任何地方, 设置 DITTO_TOKEN 环境变量改为 API 密钥. DITTO_TOKEN 优先于保存的会话。 您可以从您的 API 密钥生成 开发者集成设置。 。 。 .

如果您没有, CLI 会在您第一次运行时请求您提供 API 密钥 .

见 认证 关于 API 密钥的更多信息.

配置

默认情况下,CLI针对 ditto/ 文件夹相对于当前工作目录.

第一次你运行CLI,a ditto/ 如果文件夹不存在, 将会创建 。 文件夹也将包含默认内容 config.yml 文件,用于控制CLI的行为.

默认文件看起来像这样 :

projects: []
variants: []
statuses: []
components:
  folders: []
outputs:
    - format: json
        framework: i18next

关于CLI配置的更多信息,请参见: 文件部分。 。 。 .

使用量

拉开

npx @dittowords/cli pull

运行 CLI 从 Ditto 调取字符串数据并将其写入磁盘.

字符串文件以与您的配置相对应的格式写入指定的文件夹。 在将这些文件集成到开发中后,您可以随时执行 CLI 从 Ditto 中获取最新的字符串,并在您的应用程序中更新它们.

关于文件如何写入磁盘的更多信息,请参见 文件部分。 。 。 .

如何将 Ditto CLI 整合到不同环境中的演示项目 :

扫描

npx @dittowords/cli scan <path>

扫描您的密码库 <path> 以识别用户的文本,然后提示您导航到 Ditto 网络应用程序,您可以在其中创建识别文本的完整内容系统.

这个功能目前以β为单位,并且只能供选择的合伙人使用,所以在 支持@ dittowords.com 如果你愿意的话!

遗产设置

从开始 v5.0.0, Ditto CLI 默认指向新的 Ditto 体验。 要运行 CLI 和 遗留 Ditto 兼容, 请附加 --legacy 任何遗产命令的旗子, 和CLI 一样工作 4.x 版本。 所有现有的遗产命令目前仍然充分运作。 只有 pull 命令以 --legacy 旗帜.

反馈

有反馈吗? 我们很想听! 给我们留言 支持@ dittowords.com。 。 。 .

版本与发布记录

@dittowords/cli 共发布 102 个版本,首次发布于 2021/02/25;过去 12 个月发布了 21 个版本。

版本发布日期距今
5.13.0latest2026/11/066 天前
5.12.02026/10/1923 天前
5.11.02026/10/1330 天前
5.10.02026/09/171 个月前
5.9.12026/09/032 个月前
5.9.02026/09/022 个月前

其他发布通道:canary → 2.7.1,alpha → 4.1.0-alpha,beta → 5.0.0-beta.8。

关于 @dittowords/cli 的常见问题

@dittowords/cli 是什么?

Ditto(dittowords.com)的命令行界面.

如何安装 @dittowords/cli?

在项目目录运行 npm install @dittowords/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ditto-cli,可以用 npx ditto-cli 直接运行。

@dittowords/cli 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dittowords/cli 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@dittowords/cli 可以商用吗?

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

@dittowords/cli 的下载量有多少?

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

@dittowords/cli 还在维护吗?

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