Oh My Zsh arcanist 插件：为 Arcanist 工作流定制快捷别名与 URL 友好的命令函数

arcanist 插件是 Oh My Zsh 插件体系中面向 Facebook/Phacility 开发的 Arcanist（arc 命令行工具）的一组 shell 快捷层：它为 arc 的常用子命令提供语义化别名，并额外提供 ardu、arpa 两个可直接粘贴浏览器地址栏 URL 的命令函数。读完本篇，你将掌握该插件的启用方式、全部 20 个别名与 2 个函数的含义，以及其底层依赖的 zsh 参数修饰符原理和 Oh My Zsh 插件加载机制。

插件定位与启用方式

arcanist 插件的全部功能定义在单一文件 plugins/arcanist/arcanist.plugin.zsh 中，官方说明位于 plugins/arcanist/README.md。它本身不替代 arc，也不安装任何依赖，前提是你已在系统中安装了 Arcanist 并将其加入 PATH。启用方式与其他 Oh My Zsh 插件一致：在 ~/.zshrc 的 plugins 数组中加入 arcanist：

plugins=(... arcanist)

从源码结构看，Oh My Zsh 主入口 oh-my-zsh.sh 的插件加载流程保证了这一配置的生效方式：

1. is_plugin 函数会检查 plugins/<name>/<name>.plugin.zsh 或 plugins/<name>/_<name> 是否存在，据此决定是否把插件目录加入 fpath（oh-my-zsh.sh 第 84–98 行）。arcanist 插件目录只有 arcanist.plugin.zsh，因此它只贡献别名与函数，不提供补全定义文件；
2. 启动时按 plugins 数组顺序逐个 source 对应文件：for plugin ($plugins); do _omz_source "plugins/$plugin/$plugin.plugin.zsh"; done（oh-my-zsh.sh 第 204–207 行）。加载时若 ZSH_CUSTOM 下存在同名插件则优先使用自定义版本，这是 Oh My Zsh 允许用户覆写官方插件的机制（oh-my-zsh.sh 第 176–180 行）；
3. _omz_source 还支持通过 zstyle :omz:plugins:arcanist aliases false 一类配置在加载前备份、加载后回滚该插件引入的别名，便于精细控制（oh-my-zsh.sh 第 156–195 行）。

完整别名清单

插件为 arc 的子命令定义了 20 个别名，按命令分组整理如下（与源码 plugins/arcanist/arcanist.plugin.zsh 第 6–24 行一致）：

分支与提交类

别名	等价命令	说明
ara	arc amend	用新内容修改已有 diff（amend）
arb	arc branch	在分支上创建 diff
arbl	arc bland	在 HEAD 上创建空 diff，用于讨论或计划
arci	arc commit	用 Arcanist 执行 git commit

diff（差异）类

arc diff 是日常使用频率最高的一组，插件为其常用参数组合单独准备了别名：

别名	等价命令	说明
ard	arc diff	常规创建/查看 diff
ardc	arc diff --create	创建 diff（无新改动时提示创建）
ardp	arc diff --preview	在 Phabricator 界面中预览新 diff
ardnu	arc diff --nounit	不附带工作单元信息
ardnupc	arc diff --nounit --plan-changes	同时携带计划变更元数据
ardpc	arc diff --plan-changes	携带计划变更元数据

审查、导出与查询类

别名	等价命令	说明
arco	arc cover	查看代码覆盖率报告
are	arc export	导出 diff 为 patch 文件
arh	arc help	查看 arc 帮助
arho	arc hotfix	创建 hotfix 分支并提交 diff
arl	arc land	合并已通过的 diff 回主干
arli	arc lint	运行代码规范检查
arls	arc list	列出本地/远程 diff 列表

别名设计遵循“短前缀 + 动作语义”的约定：几乎都以 ar 开头对应 arc，后续字符提示子命令动作（如 li 对应 lint、ls 对应 list），便于肌肉记忆。

函数 ardu 与 arpa：支持直接粘贴 URL

README 强调的另一个亮点是：ardu 和 arpa 让“从浏览器地址栏复制 revision 链接再执行命令”的体验变得自然——既接受完整 URL，也接受裸的 revision 编号，例如：

# 两种方式等价：
ardu https://arcanist-url.com/D1234
ardu D1234

源码实现（plugins/arcanist/arcanist.plugin.zsh）只有各一行核心逻辑：

ardu() {
  # Both `ardu https://arcanist-url.com/<REVISION>`, and `ardu <REVISION>` work.
  arc diff --update "${1:t}"
}

arpa() {
  # Both `arpa https://arcanist-url.com/<REVISION>`, and `arpa <REVISION>` work.
  arc patch "${1:t}"
}

两个函数分别等价于 arc diff --update <revision_id>（更新一个已存在的 diff，将本地提交重新关联到该 diff 上）和 arc patch <revision_id>（把某个 diff 对应的补丁应用到当前工作区）。

关键机制：zsh 修饰符 ${1:t}

这里的 ${1:t} 是 zsh 的路径修饰符（parameter modifier）：:t 表示取路径的“tail”，即最后一个 / 之后的部分。因此：

• 传入 https://arcanist-url.com/D1234 时，${1:t} 展开为 D1234，URL 的域名部分被自动剥离；
• 传入裸 ID D1234（不含 /）时，修饰符原样返回 D1234。

同一套逻辑在 bash 中需要用 ${1##*/} 实现，而 zsh 的 :t 语义更贴近“文件名的最后一段”，这也解释了为何 Oh My Zsh 这类面向 zsh 的框架可以写出如此简洁的函数。从源码注释看，作者显式保留了两种用法的说明，README 的 Functions 小节也对应列出：

函数	实际执行
ardu [URL or revision_id]	arc diff --update [revision_id]
arpa [URL or revision_id]	arc patch [revision_id]

一个使用边界值得注意：:t 只截取最后一个路径组件，因此 revision ID 必须是 URL 的末段（Phabricator 默认的 …/D1234 形式天然满足）。

典型工作流示例

结合别名与函数，一次典型的 Arcanist 提交审查流程可以是：

arls                 # 列出 diff，了解当前有哪些 revision
ardi  # 无此别名，直接用 arc；此处示例按实际别名：
arci                 # 提交改动（arc commit）
ardc                 # 创建/更新 diff（arc diff --create）
ardu D1234           # 或粘贴 URL：https://arcanist-url.com/D1234，将新提交更新进该 diff
arli                 # 提交前自查代码规范
arl                  # diff 通过后合并回主干（arc land）

小结

arcanist 插件用不到 40 行代码解决了两个具体问题：一是把 arc 高频子命令收敛为统一的短别名，减少敲错长参数的概率；二是用 zsh 原生的 ${1:t} 修饰符消除“从 URL 手动提取 revision ID”的摩擦。它没有引入外部依赖、不提供补全文件、不修改 fpath 以外的任何环境，属于典型的轻量级 Oh My Zsh 插件；若你的团队使用 Phabricator/Arcanist 工作流，把它加入 plugins 数组即可获得完整体验。