6 个版本

0.2.4 2022 年 12 月 26 日
0.2.3 2022 年 12 月 26 日
0.2.0 2022 年 8 月 14 日
0.1.3 2022 年 6 月 19 日

#2863命令行工具

MIT 许可证

32KB
795

木炭

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

安装

Arch (-ish)

yay -S charcoal

Brew

brew install lighghteeloo/charcoal/charcoal

从源码构建

cargo install char-coal

小贴士

建议将常用命令别名到 chrwd 或更短的名称(如果你不介意的话,可以使用 cc

alias chr="char-coal query -s"

不需要手动指定依赖项。如果你对 charcoal 使用的 crate 感兴趣,请参阅 Cargo.toml

用法

查询

char-coal query <QUERY>

查询可以缩写为 qsearchs

使用 -s--speak-as true

编辑

您可能希望以简单的方式编辑配置文件。Charcoal 可以帮您完成。

char-coal edit

使用 --reset 生成全新的配置文件,以防有任何问题。

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

清理

Charcoal 缓存您的查询,包括文本和音频。虽然这对于重复查询来说很方便,但它会占用一些空间。如果您愿意,可以使用以下方式清理它们:

char-coal clean

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

帮助

要查看更多选项,请运行

char-coal help

有关子命令的帮助,请运行

char-coal 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/char-coal query -s"

缓存策略

作为一个小的 CLI 工具,Charcoal 无法保证 100% 的缓存一致性;然而,其缓存策略设计得非常精细,不一致性很少发生,且影响很小。

只有不包含空格的 ASCII 文本将被保存为名称,保存在 cache 目录下,以提高兼容性;其余内容将被哈希后保存在 vault 目录下。

文本和音频都将被缓存。

许可证

此仓库使用 MIT 许可证。

免责声明和承诺

尽管可能性不大,但此软件可能会损坏数据。使用风险自担。

不会收集任何隐私信息。

致谢

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

@BinhaoQin 感谢您在 PKGBUILD 方面的建议(以及您的耐心!)

依赖项

~21–55MB
~1M SLoC