# vkit
秒级唤起的 CLI 伴生工具：在当前工作上下文里完成选择与操作后退出。
## Language
### Worktree 管理
**Worktree**:
当前仓库登记的一个附加工作目录，检出在某一分支上，与主工作树共享同一 git 对象库。
_Avoid_: workspace, clone, 副本
**Main Worktree**:
仓库的主工作目录（通常 `.git` 为目录的那一份）；出现在列表中且可进入，但不是 Remove / Purge 的目标。
_Avoid_: root, 主仓, 主目录
**Placement**:
Worktree 目录的落盘位置类别：仅 In-repo 与 Global 两种；不在这两类路径下的 git worktree 不在本功能的管理范围内（列表不展示）。
_Avoid_: location, storage, path type, 其它
**In-repo Placement**:
落在当前仓库 `.worktrees/<name>` 下的 Placement；新建时的默认选择。
_Avoid_: local, nested
**Global Placement**:
落在全局根（默认 `~/worktrees/<repo-name>/<worktree-name>`，根路径可经配置覆盖）下、且属于本仓库的 Placement。
_Avoid_: shared, home worktree
**Remove**:
去掉该 Worktree 的工作目录与登记，保留对应分支。
_Avoid_: delete, clean, prune（易与「连分支删」混淆）
**Purge**:
Remove 之后再删除对应分支（未合并或脏时需额外确认）。
_Avoid_: force delete, 彻底删除（口语过宽）
**Worktree Name**:
Worktree 目录名；由分支名转成 kebab-case（`/` 等分隔符变为 `-`），例如 `feat/auth/oauth` → `feat-auth-oauth`。
_Avoid_: slug, folder name, 短名