开发工具CLI配置管理【免费下载链接】chezmoiManage your dotfiles across multiple diverse machines, securely.项目地址https://gitcode.com/gh_mirrors/ch/chezmoi点击查看免费下载rbw是 chezmoi 提供的 Bitwarden 密码管理器集成模板函数之一它通过第三方 Rust 实现的 Bitwarden CLI 客户端rbw为骨架结合仓库源码internal/cmd/rbwtemplatefuncs.go、internal/cmd/testdata/scripts/rbw.txtar与配置实现完整讲解rbw的签名、返回值结构、缓存机制、前置条件与配置方式帮助读者在 dotfiles 模板中安全、高效地注入用户名、密码等敏感数据。函数签名与基本用法rbw模板函数的完整签名如下rbw *name* [*arg*...]nameBitwarden 密码库中条目的名称会作为rbw get --raw的第一个参数传入arg...额外的参数会原样追加到rbw get之后例如--folder my-folder用于限定条目所在的文件夹。函数的执行流程为把name与所有额外arg拼接到rbw get --raw命令之后执行该命令并把命令输出解析为 JSON 后返回。文档给出的典型示例如下username {{ (rbw test-entry).data.username }} password {{ (rbw test-entry --folder my-folder).data.password }}第一行从名为test-entry的条目中取出data.username作为配置模板中的username第二行通过--folder参数限定文件夹取出该条目的data.password。由于返回值是结构化 JSON模板中可以继续使用点号.逐级访问嵌套字段。从源码看rbw函数的实现位于 internal/cmd/rbwtemplatefuncs.gofunc (c *Config) rbwTemplateFunc(name string, extraArgs ...string) map[string]any { chezmoi.SkipTemplateIf(c.skipSecrets) args : append([]string{get, --raw, name}, extraArgs...) output : mustValue(c.rbwOutput(args)) var data map[string]any must(json.Unmarshal(output, data)) return data }关键点有三参数构造args固定以get --raw开头随后追加name和extraArgs最终执行的完整命令等价于rbw get --raw name [arg...]--raw模式rbw get --raw直接输出未经格式化处理的 JSON供函数做结构化解析跳过机制SkipTemplateIf(c.skipSecrets)表示当配置中启用了跳过密钥类数据的开关如--skip-secrets时该函数会被跳过执行避免在不需要密钥的场景下触发外部命令调用。返回值结构rbw get的 JSON 字段rbw函数返回的是rbw get --raw输出的完整 JSON 对象map[string]any因此所有顶层字段都可直接访问。测试用例 internal/cmd/testdata/scripts/rbw.txtar 中 mock 的返回体给出了真实字段形状{ id: adf723e1-ab03-4ff3-81aa-f5f3c2b68a5f, folder: null, name: test-entry, data: { username: foo, password: hunter2, totp: null, uris: [ { uri: example.com, match_type: null } ] }, fields: [ { name: something, value: secret } ], notes: blah, history: [ { last_used_date: 2022-08-18T23:24:47.994Z, password: hunter2 } ] }据此可归纳常用取值方式目标数据模板表达式说明登录用户名{{ (rbw item).data.username }}嵌套在data对象下登录密码{{ (rbw item).data.password }}同上TOTP 令牌{{ (rbw item).data.totp }}可能为null需自行判空条目 ID{{ (rbw item).id }}顶层字段条目备注{{ (rbw item).notes }}顶层字段附加 URI{{ (rbw item).data.uris }}数组可在模板中遍历自定义字段{{ (rbw item).fields }}数组元素含name/value自定义字段的便捷访问rbwFields由于fields是数组逐项按name查找比较繁琐chezmoi 额外提供了姊妹函数rbwFields。其定义见 assets/chezmoi.io/docs/reference/templates/bitwarden-functions/rbwFields.md签名与rbw完全相同但会把 JSON 中fields数组的元素转换为以每个字段的name为键的字典{{ (rbwFields item).name.value }} {{ (rbwFields item --folder my-folder).name.value }}对应源码实现在 internal/cmd/rbwtemplatefuncs.go函数解析fields数组后逐个把field[name]作为键、整个字段对象作为值构建结果 map。也就是说上面例子中自定义字段名为something时可用{{ (rbwFields item).something.value }}直接取到secret。缓存机制同名参数只调用一次rbwrbw函数带有一个重要优化以参数为键的进程内结果缓存。文档明确说明The output fromrbw get --rawis cached so callingrbwmultiple times with the same arguments will only invokerbwonce.即在同一模板渲染过程中使用完全相同参数多次调用rbw只会真正执行一次rbw命令其余调用直接命中缓存。源码中的rbwOutput方法实现了这一点internal/cmd/rbwtemplatefuncs.gofunc (c *Config) rbwOutput(args []string) ([]byte, error) { key : strings.Join(args, \x00) if data, ok : c.RBW.outputCache[key]; ok { return data, nil } cmd : exec.Command(c.RBW.Command, args...) cmd.Stdin os.Stdin cmd.Stderr os.Stderr output, err : chezmoilog.LogCmdOutput(c.logger, cmd) if err ! nil { return nil, newCmdOutputError(cmd, output, err) } if c.RBW.outputCache nil { c.RBW.outputCache make(map[string][]byte) } c.RBW.outputCache[key] output return output, nil }值得注意的实现细节缓存键strings.Join(args, \x00)把所有参数含get、--raw、name与额外参数用\x00连接成字符串作为缓存键因此参数组合完全一致才可复用缓存缓存生命周期缓存存放在rbwConfig.outputCache见 internal/cmd/rbwtemplatefuncs.go属于本次 chezmoi 进程/配置实例内部状态进程结束即失效不存在跨进程的陈旧数据问题IO 透传命令的Stdin与Stderr分别透传给进程自身os.Stdin、os.Stderr便于交互式解锁与错误信息展示错误处理命令执行失败时newCmdOutputError会把命令、输出与错误一并封装便于模板渲染报错时定位问题。对使用者而言这意味着在同一个模板文件中多处引用同一条目时不必担心反复启动外部进程拖慢渲染速度但若需要读取多个不同条目或同一条目配合不同参数则各参数组合会分别执行一次。前置条件与安全说明安装并登录rbwrbw是独立的 Bitwarden 命令行客户端Rust 实现需要先在本机安装并完成解锁。官方集成指南见 assets/chezmoi.io/docs/user-guide/password-managers/bitwarden.md其中同时覆盖了官方bwCLI、Secrets CLIbws与rbw三种接入方式。使用rbw前请确保已通过rbw自身的登录/解锁流程完成认证如rbw login、rbw unlockrbw get --raw可以独立在终端中正常返回对应条目的 JSON模板中所引用的条目名与文件夹参数如--folder真实存在否则命令执行失败会导致模板渲染报错。版本要求chezmoi 通过doctor子命令对rbw做环境体检检查项定义于 internal/cmd/doctorcmd.gobinaryCheck{ name: rbw-command, binaryName: c.RBW.Command, ifNotSet: checkResultWarning, ifNotExist: checkResultInfo, versionArgs: []string{--version}, versionRx: regexp.MustCompile(^rbw\s(\d\.\d\.\d)), minVersion: rbwMinVersion, },而最小版本在 internal/cmd/rbwtemplatefuncs.go 中定义为1.7.0var rbwMinVersion semver.Version{Major: 1, Minor: 7, Patch: 0}也就是说chezmoi 要求rbw版本不低于 1.7.0doctor会执行rbw --version用正则^rbw\s(\d\.\d\.\d)解析版本号并与该最小值比较低于此版本会给出检查警告。日常排查可运行chezmoi doctor并在输出中关注rbw-command一项的状态。配置rbw.command自定义命令路径默认情况下chezmoi 调用名为rbw的命令。若你的rbw二进制不在PATH中或使用了别名/自定义包装脚本可通过配置项rbw.command覆盖。该配置在 internal/cmd/config.go 中注册为rbwConfig结构体RBW rbwConfig json:rbw mapstructure:rbw yaml:rbw结构体定义internal/cmd/rbwtemplatefuncs.go只有一个可配置字段type rbwConfig struct { Command string json:command mapstructure:command yaml:command outputCache map[string][]byte }默认值为rbw见 internal/cmd/config.go。outputCache为内部缓存不参与配置读取。在~/.config/chezmoi/chezmoi.toml中配置自定义命令的写法如下[rbw] command /usr/local/bin/rbwrbw.command的值会被exec.Command(c.RBW.Command, args...)用作实际执行的可执行文件路径因此可以是绝对路径、相对路径或仅在 PATH 中可解析的命令名。测试验证txtar 端到端用例仓库在 internal/cmd/testdata/scripts/rbw.txtar 中提供了完整的端到端测试脚本mock 了一个bin/rbw命令并用chezmoi execute-template直接验证模板求值结果mockcommand bin/rbw # test rbw template function exec chezmoi execute-template {{ (rbw test-entry).data.password }} stdout ^hunter2$ # test rbw template function with extra args exec chezmoi execute-template {{ (rbw test-entry --folder my-folder).data.password }} stdout ^correcthorsebatterystaple$ # test rbwFields template function exec chezmoi execute-template {{ (rbwFields test-entry).something.value }} stdout ^secret$不带额外参数时{{ (rbw test-entry).data.password }}求值为hunter2带--folder my-folder时由于 mock 返回不同的 JSON求值为correcthorsebatterystaple证明额外参数确实被透传给了rbw getrbwFields则验证了自定义字段something的value取值为secret。这套测试同时验证了函数签名name 可变arg...、额外参数透传、JSON 解析与字段访问、以及rbwFields的按名索引行为。若读者希望在本地快速体验可先手动执行rbw get --raw 条目名查看输出再通过chezmoi execute-template {{ (rbw 条目名) }}验证函数返回的完整结构。与官方 Bitwarden CLI 集成的取舍chezmoi 的 Bitwarden 相关模板函数共分三组见 assets/chezmoi.io/docs/reference/templates/bitwarden-functions/index.md函数前缀后端命令说明bitwarden*bw官方 Bitwarden CLI需设置BW_SESSION或配置bitwarden.unlock自动解锁bitwardenSecretsbwsBitwarden Secrets Manager CLI面向服务账号令牌rbw*rbw第三方 Rust 实现的轻量客户端无需维护BW_SESSION会话变量相对bw需要先bw unlock --raw并维护BW_SESSION环境变量assets/chezmoi.io/docs/reference/templates/bitwarden-functions/index.md 中介绍了bitwarden.unlock自动解锁配置仅作用于bwrbw的会话管理由rbw自身负责chezmoi 侧只需直接调用rbw get --raw即可。选择哪种后端取决于个人工作流若已习惯rbw的轻量与原生密码库缓存rbw/rbwFields是开箱即用的选择若团队统一使用官方bwCLI则应选用bitwarden*系列函数。小结rbw模板函数是 chezmoi 与 Bitwarden 生态对接的低摩擦方案以rbw get --raw为数据源通过一次调用返回完整 JSON 结构配合参数级缓存避免重复进程开销并以rbw.command支持自定义二进制路径。使用时只需保证本机rbw版本 ≥ 1.7.0、已解锁且条目名准确即可在任意模板中通过{{ (rbw name).data.password }}这类表达式安全地引用密码库数据让 dotfiles 中的密钥既不出现在仓库明文里又能随模板自动渲染。赞分享开发工具CLI配置管理【免费下载链接】chezmoiManage your dotfiles across multiple diverse machines, securely.项目地址https://gitcode.com/gh_mirrors/ch/chezmoi点击查看免费下载相关推荐chezmoi Bitwarden 模板函数完全指南用 bitwarden* 与 rbw* 安全注入密码、附件与自定义字段chezmoi Bitwarden 模板函数完全指南用 bitwarden 与 rbw 安全注入密码、附件与自定义字段 本篇指南围绕 chezmoi 的 Bi开发工具CLI配置管理Impeccable Optimize 实战指南用“先测量、后修复、再复测”的方法论提升 UI 性能Impeccable Optimize 实战指南用“先测量、后修复、再复测”的方法论提升 UI 性能 性能本身就是一种特性Performance is a开发工具CLI配置管理5 分钟看懂 awesome-design-md用 DESIGN.md 让 AI 复刻 Stripe 风格界面5 分钟看懂 awesome design md用 DESIGN.md 让 AI 复刻 Stripe 风格界面 想让 AI 画一个 Stripe 风格的落地页开发工具CLI配置管理上一篇超详细AWS CLI创建S3 Express One Zone目录桶避坑指南下一篇SiYuan v2.9.2 版本深度解析数据同步多内核在线感知、冲突文件治理与启动体验重塑创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考