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 在 命令行工具
32KB
795 行
木炭
wudao-dict 的替代品。带有彩色输出和可选语音。
安装
Arch (-ish)
yay -S charcoal
Brew
brew install lighghteeloo/charcoal/charcoal
从源码构建
cargo install char-coal
小贴士
建议将常用命令别名到 chr
、wd
或更短的名称(如果你不介意的话,可以使用 cc
)
alias chr="char-coal query -s"
不需要手动指定依赖项。如果你对 charcoal 使用的 crate 感兴趣,请参阅 Cargo.toml
。
用法
查询
char-coal query <QUERY>
查询可以缩写为 q
、search
或 s
。
使用 -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