byk
byk 是一个别名执行器:把常用命令写进 *.byk.json,用短名字调用它们。
它只做两件事——找到别名,执行命令。
安装
安装脚本会顺带把 byk 加入 PATH,并写入一行 shell 补全。
快速开始
写一个别名文件:
hello.byk.json
项目里这份手写最直接。想放进全局目录 ~/.byk/alias/ 时不必开编辑器:byk @@hello..init 建文件,byk @@hello..set hello --cmd "echo hello world" 加条目。详见文件命令。
执行:
当前目录里的 *.byk.json 默认参与合并,而且优先级高于全局目录——cd 进项目就能直接调用,不用写任何声明。
需要精确指定「哪个文件里的哪个别名」时,用 @文件.key(本地)或 @@文件.key(全局):
如果某段别名只想被精确调用、不要出现在 byk <key> 里,在对应位置写 "$private": true。详见 别名配置 - 可见性。
一个命令是怎么执行的
byk解析参数,识别选项与隐藏接口__api__- 剩下第一个词作为别名名,其余作为参数
- 命中
@文件.key精确语法 → 直接读该文件 - 否则在合并后的别名空间里查找(全局
~/.byk/alias/+ 当前目录) - 替换变量(
${byk_dir}/${file_dir}/${deps_dir}与$var),解析参数占位符 - 在
$cwd下执行命令;未命中则列出候选并退出 1