如何用Worktrunk wt config state读取分支变量与切换历史新手完整指南【免费下载链接】worktrunkWorktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows项目地址: https://gitcode.com/GitHub_Trending/wo/worktrunkWorktrunk命令名wt是一个面向并行 AI Agent 工作流的 Git worktree 管理 CLI。它的wt config state子命令是查看和管理工作区内部状态的统一入口既能读取分支变量vars也能查看wt switch -依赖的切换历史previous branch。本文用一条主线带你从零掌握它。wt config state 到底存了什么Worktrunk 的所有运行时状态都存放在.git/目录内与你的配置文件分离git config 条目worktrunk.*前缀默认分支、分支标记、分支变量、切换历史、一次性提示.git/wt/目录树CI 状态缓存、LLM 摘要缓存、git 命令缓存、操作日志、待删除的 worktree 回收站理解这一点很关键状态不等于配置。配置文件如项目配置是你声明的规则而state记录的是工具运行过程中沉淀下来的数据。一键总览wt config state get最快的上手方式是直接运行聚合读取命令$ wt config state get它会按分区打印当前仓库的全部状态DEFAULT BRANCH— 默认分支如main缓存自远端探测结果PREVIOUS BRANCH— 上一次wt switch的分支即切换历史BRANCH MARKERS— 各分支的自定义标记如 WIPVARS— 各分支自定义变量分支、键、值三列表格CI STATUS CACHE / SUMMARY CACHE / GIT COMMANDS CACHE— 可再生的缓存COMMAND LOG / HOOK OUTPUT / TRASH— 日志与回收站例如输出中会出现这样的变量表VARS Branch Key Value ─────── ──── ─────── feature port 3000 main env staging需要程序化消费时加--formatjson即可获得结构化输出方便配合jq过滤。分支变量 vars按分支存储的自定义键值对分支变量是wt config state最实用的功能为每个分支存下任意键值对供钩子模板和脚本读取。设置、读取与列出变量$ wt config state vars set envstaging # 为当前分支设置 $ wt config state vars get env # 读取当前分支的值 $ wt config state vars list # 列出当前分支所有键 $ wt config state vars set envproduction --branchmain # 操作指定分支在钩子模板中引用变量变量可以在钩子/别名模板中通过{{ vars.key }}访问配合default过滤器处理未设置的情况[post-start] dev ENV{{ vars.env | default(development) }} npm start -- --port {{ vars.port | default(3000) }}支持 JSON 值与点路径访问——存储对象后可直接取字段$ wt config state vars set config{port: 3000, debug: true} # 模板中即可写 {{ vars.config.port }}命名规则与存储位置变量存储在 git config 中键路径为worktrunk.state.branch.vars.key键名只允许字母、数字和连字符圆点会与 git config 的分节符冲突下划线不符合变量名格式清理单个键用vars clear key清空当前分支全部键用vars clear --all切换历史wt switch - 与 previous branchWorktrunk 的wt switch -可以像cd -一样回到上次的 worktree详见 docs/public/switch.md。这个上一次在哪的记录就是切换历史每次wt switch都会自动更新存储在 git config 的worktrunk.history中。查看它有两种方式聚合读取wt config state get的 PREVIOUS BRANCH 分区直接显示值缓存视角切换历史属于可再生缓存wt config state cache会一并展示它——下次切换后该值会自然重新生成所以清除它毫无数据丢失风险$ wt config state cache # 查看所有可再生缓存含切换历史 早期的wt config state previous-branch子命令已并入cache旧命令仍可用但会提示已弃用推荐直接用cache。清理策略cache clear 与 state clear两个清理命令的边界要分清命令清理范围需要确认wt config state cache clear仅可再生缓存CI 状态、摘要、git 命令缓存、提示、切换历史否wt config state clear全部状态默认分支覆盖、标记、变量、缓存、日志、回收站是--yes跳过经验法则想让wt list的 CI 状态重新拉取、或让一次性提示重新出现用cache clear想彻底抹掉仓库内所有 Worktrunk 痕迹包括你手写的标记和变量才用state clear。常用命令速查场景命令总览全部状态wt config state get设置分支变量wt config state vars set envstaging读取分支变量wt config state vars get env列出分支变量wt config state vars list查看切换历史与缓存wt config state cache清空可再生缓存wt config state cache clear一键总览 JSON 输出wt config state get --formatjson延伸阅读源码与文档命令定义与帮助文本src/cli/config.rs状态读写核心实现src/commands/config/state.rs官方完整参考docs/public/config.mdworktree 切换用法docs/public/switch.md总结wt config state get一条命令总览默认分支、切换历史、分支变量与全部缓存分支变量按分支隔离、支持 JSON 与模板引用是配置钩子的利器切换历史随wt switch -自动维护属于可再生缓存随时可安全清除清理时区分cache clear安全无确认与state clear全量、有确认掌握这四条你就能把 Worktrunk 的状态管理用出八分火候。【免费下载链接】worktrunkWorktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows项目地址: https://gitcode.com/GitHub_Trending/wo/worktrunk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考