@bunli/plugin-completions

中文文档
0.3.5发布于 2026/03/28MITTypeScriptES Module近 30 天下载 3220

Bunli CLI 框架的 Shell 补全插件

中文使用文档
文档目录13 节
  1. 安装
  2. 设置
  3. 图标
  4. 生成一个补全脚本
  5. 动态补全协议召回( 被 shell 脚本使用)
  6. Shell 设置示例
  7. 巴许
  8. 日语
  9. 鱼
  10. 动力壳
  11. 页:1
  12. 运行时间包装
  13. @bomb.sh/tab 类型注释

@bunli/ plugin- 完成

Bunli CLIs 的 Tab- 动力外壳完成 .

此插件代表脚本生成和动态补全协议( E)complete -- <args>改为: @bomb.sh/tab从 Bunli 生成的元数据中创建 Tab 命令树(.bunli/commands.gen.ts) (中文(简体) ).

安装

bun add @bunli/plugin-completions

设置

import { defineConfig } from '@bunli/core'
import { completionsPlugin } from '@bunli/plugin-completions'

export default defineConfig({
  name: 'my-cli',
  plugins: [
    completionsPlugin({
      // generatedPath: '.bunli/commands.gen.ts',
      // commandName: 'my-cli',
      // executable: 'my-cli',
      // includeAliases: true,
      // includeGlobalFlags: true
    })
  ]
})

你一定有过 .bunli/commands.gen.ts 可用(运行) bunli generate,或启用您的建筑中的代码.

图标

生成一个补全脚本

my-cli completions zsh
my-cli completions bash
my-cli completions fish
my-cli completions powershell

动态补全协议召回( 被 shell 脚本使用)

my-cli complete -- <args...>

不要在 Bunli 的解析中构建自己的整合 positional 此路径的参数 : Tab 依赖于后端的空字符串 sentinel(''Bunli 解析器会空出字符串 。 实施用途 runtime.args 直接说.

Shell 设置示例

巴许

source <(my-cli completions bash)

日语

source <(my-cli completions zsh)

鱼

my-cli completions fish > ~/.config/fish/completions/my-cli.fish

动力壳

my-cli completions powershell | Out-String | Invoke-Expression

页:1

运行时间包装

@bunli/plugin-completions 发布捆绑的运行时间( i)dist/index.js)已经包括 Tab 。 下游消费者只安装 @bunli/plugin-completions 并且不需要单独的运行时间依赖 @bomb.sh/tab。 。 。 .

@bomb.sh/tab 类型注释

截止 @bomb.sh/[email protected],已发布的软件包参考文献 dist/t.d.ts 但只有舰只 dist/t-<hash>.d.ts. Bunli的单雷波用途 bun patch 在开发/CI期间保持TypeScript所构建的屏蔽,直到上游修复包装.

版本与发布记录

@bunli/plugin-completions 共发布 12 个版本,首次发布于 2026/01/30;过去 12 个月发布了 12 个版本。

版本发布日期距今
0.3.5latest2026/03/287 个月前
0.3.42026/03/048 个月前
0.3.32026/03/018 个月前
0.3.22026/03/018 个月前
0.3.12026/02/278 个月前
0.3.02026/02/278 个月前

关于 @bunli/plugin-completions 的常见问题

@bunli/plugin-completions 是什么?

Bunli CLI 框架的 Shell 补全插件

如何安装 @bunli/plugin-completions?

在项目目录运行 npm install @bunli/plugin-completions,或使用 pnpm add / yarn add / bun add。

@bunli/plugin-completions 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bunli/plugin-completions 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bunli/plugin-completions 可以商用吗?

@bunli/plugin-completions 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@bunli/plugin-completions 的下载量有多少?

根据 npm 官方下载统计,@bunli/plugin-completions 在 2026/10/09 – 2026/11/07 这 30 天内被下载 3,220 次,日均约 107 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bunli/plugin-completions 还在维护吗?

最新版本 0.3.5 发布于 2026/03/28(7 个月前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/01/30。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。