Charcoal

wudao-dict 的替代品。具有彩色输出和可选语音。

安装

Arch (-ish)

yay -S charcoal

Brew

brew install lighghteeloo/charcoal/charcoal

从源码构建

cargo install charcoal-dict

小贴士

建议将常用命令别名设置为 chr、wd 或任何更短的名称（如果您不介意的话，可以使用 cc）

alias chr="charcoal query -s"

不需要手动指定依赖项。如果您对 charcoal 使用的包库感兴趣，请查看 Cargo.toml。

使用

查询

charcoal query <QUERY>

查询可以是 q、search 或 s 的缩写。

使用 -s 或 --speak-as true 可以强制执行语音。

编辑

您可能希望以简单的方式编辑配置文件。使用 charcoal 即可完成此操作。

charcoal edit

使用 --reset 可以在出现问题时生成全新的配置。

有关配置文件的更多详细信息，请参阅 配置 部分。

清理

Charcoal 会缓存您的查询，包括文本和音频。虽然这对于重复查询很有用，但它会占用一些空间。如果您愿意，可以使用以下方法进行清理

charcoal clean

有关缓存的更多详细信息，请参阅 缓存策略 部分。

帮助

要查看更多选项，请运行

charcoal help

以获取子命令的帮助，或

charcoal query --help

要获取每个子命令的帮助，例如 query。

配置

配置很简单。只需更改布尔值即可。

开发

克隆并从源码构建

git clone [email protected]:LighghtEeloo/charcoal.git
cd charcoal
cargo build --all

别名

cd charcoal
cargo build --all
alias chr="RUST_LOG=info target/debug/charcoal query -s"

缓存策略

作为一个小巧的 CLI 工具，charcoal 不能保证 100% 的缓存一致性；然而，其缓存策略被精心设计，以确保不一致性很少发生，且损害很小。

只将无空格的 ascii 字符保存为名称，存储在 cache 目录下，以实现更好的兼容性；其余部分将被哈希并存储在 vault 目录下。

文本和音频都会被缓存。

许可证

此仓库使用 MIT 许可证。

免责声明和承诺

尽管可能性不大，但此软件可能会损害数据。请在自己的风险下使用。

不会收集任何隐私信息。

鸣谢

@TomCC7 感谢您对 charcoal 的支持、测试和提出建议。

@BinhaoQin 感谢您在 PKGBUILD 上的建议（以及您的耐心！）。

@Gorgeous-Patrick 感谢您更新过时的 README 文件。