精读 Gas Town CHANGELOG多智能体工作区管理器从 SQLite 到 Dolt-Native 的 26 个版本演进【免费下载链接】gastownGas Town - multi-agent workspace manager项目地址: https://gitcode.com/GitHub_Trending/ga/gastownGas Town 是一个多智能体multi-agent工作区管理器其 CHANGELOG.md 以 Keep a Changelog 格式和语义化版本Semantic Versioning规范记录了从 0.1.02026-01-02到 1.2.12026-06-06共 26 个正式版本的全部关键变更。阅读本文可以按时间线掌握该项目从「Town/Rig/Polecat」基础架构、两层 Beads 模型到 Dolt-Native 存储迁移、合并队列、OpenTelemetry 遥测、Windows 平台支持的完整演进脉络并能理解 Gas Town 的版本发布工具链bump-version.sh、gt info --whats-new、make check-version-tag如何保证 CHANGELOG、Go 版本常量、npm 包与 Nix flake 之间的一致性。变更日志的格式约定CHANGELOG.md 开头声明了两个基础约定格式基于 Keep a Changelog 1.0.0 规范即每个版本条目使用## [版本号] - 日期标题内部按### Added/### Changed/### Fixed/### Removed/### Documentation/### Tests/### Deprecated/### Contributors等小节分类版本遵循语义化版本规范SemVer 2.0.0。除此之外该文件还有几个 Gas Town 特有的惯例读版本历史之前值得先了解[Unreleased]工作缓冲区文件顶部常驻一个## [Unreleased]节开发期间的变更先写入此处发布时由版本脚本统一改写为正式版本条目机制见后文「发布工具链」一节。条目自带问题追踪引用每条变更普遍标注来源格式有三类——GitHub issue 编号如gh#4180、GH#2624、bead ID如gt-zzob、hq-j6hur.4.1、aa-4yf2。其中hq-前缀是镇级town-levelbeads其余前缀gt-、ma-、aa-等对应各 rig 自己的 beads 前缀这与 0.2.0 版本引入的「两层 Beads 架构」一脉相承。重大版本附带分组小标题如 0.8.0 使用#### Work Queue Dispatch Engine、#### Telemetry Observability (OTEL)等四级标题对 Added 小节再做主题分组便于快速定位子系统演进。极少数版本注明「发布时未记录」0.3.1 和 0.4.0 两个条目仅有一行说明「Changelog not documented at release time. See git log ... for changes」指读者去 git log 查证这是该文件坦诚度较高的做法。版本总览时间线版本日期主题定位0.1.0 / 0.1.12026-01-02首次公开发布Town 结构、代理角色、Convoy/Sling/Hook/Mail0.2.02026-01-04Convoy DashboardWeb UI、两层 Beads 架构、成本追踪0.2.1–0.2.62026-01-05 ~ 01-12gt config、rig 运行态park/dock、Deacon 安全化、升级系统0.3.0 / 0.3.1 / 0.4.02026-01-17 ~ 01-19发布自动化 molecule、beads 原生的消息队列/频道、插件系统0.5.02026-01-22Mail 交互改进、命令别名、OpenCode 预置0.6.02026-02-15Dolt-Native 架构移除全部 SQLite 代码0.7.02026-02-15Convoy 所有权模型、合并策略选择、gt done检查点韧性0.8.02026-02-23队列与调度引擎、OpenTelemetry 全量埋点、Dog 子系统0.9.02026-03-01批量二分合并队列、持久化 Polecat、六阶段数据生命周期0.10.0 / 0.11.02026-03-03 / 03-05增量修复Docker 支持、Cursor hooks、级联关闭0.12.0 / 0.12.12026-03-11 / 03-15事件驱动 Polecat 生命周期ACP 协议、gt mountain、类型化记忆0.13.02026-03-29指令与覆盖层directives/overlays、巡逻成本调优~66% 降本1.0.02026-04-02Windows 平台支持、workflow 公式、merge_strategypr1.0.12026-04-25gt dog done清理插件邮件积累1.1.02026-05-06Convoy 完成通知、调度器守卫、Dolt 内存压力韧性1.2.02026-05-27守护进程崩溃循环治理、rig 初始化重复 Dolt 库修复1.2.12026-06-06Shell 集成静默化opt-in、bd create别名路由下面按阶段展开各版本的关键内容。0.x 早期多智能体工作区地基0.1.0–0.5.00.1.0首次公开——角色体系与核心工作流0.1.0 条目定义了整个 Gas Town 的概念骨架后续所有版本都建立在这些构件之上Town 结构分层工作区由 rigs项目容器、crews持久开发者工作区、polecats临时代理 worker组成代理角色Mayor全局协调者、Deacon镇级生命周期巡逻与心跳、Witness每 rig 的 polecat 生命周期管理器、Refinery带代码评审的合并队列处理器、Crew、Polecat工作管理gt convoy create/list/status追踪关联工作批次、gt sling bead rig派工、Hook 机制把任务挂到代理身上、Molecule 公式执行多步任务通信gt mail inbox/send/read邮件系统、gt escalate带严重级别的升级协议、gt handoff保上下文的会话轮换集成Beadsbd命令issue 追踪、tmux 会话、GitHub CLI 建 PR基础设施daemon 后台生命周期管理、npm 包分发、GitHub Actions CI/CD、GoReleaser 多平台构建。0.1.1 同日发布修复了 tmux 键位C-b n/p泄漏到非 Gas Town 会话的问题并补齐了 OSS 工程文件CHANGELOG.md 本身、.golangci.yml、RELEASING.md、版本提升脚本 scripts/bump-version.sh。0.2.0Convoy Dashboard 与两层 Beads 架构0.2.0 是该系列中增量最大的版本之一核心是gt dashboardWeb 监控界面Polecat Workers 实时活动面板、Refinery 合并队列展示、10 秒 HTMX 自动刷新两层 Beads 架构镇级 beads 位于~/gt/.beads/使用hq-*前缀承载 Mayor 邮件与跨 rig 协调rig 级 beads 用 rig 前缀如gt-*命令通过routes.jsonl按前缀自动路由到正确 rig提供gt migrate-agents迁移工具多代理支持可插拔代理注册表、gt rig start/stop/restart/status批量操作、gt sling支持一条命令派多个 beads成本追踪gt costs命令成本改存 beads取代 JSONLStop hook 在会话结束时自动记账tmux 会话自动探测瞬态 Polecat 模型每个工作单元后回收 polecatWitness 巡逻公式同步适配防御性修复文件锁防止重复 daemon孤儿守护进程防护、HasSession精确匹配防前缀碰撞、SendKeys去抖到 500ms 保证 Enter 键可靠送达。0.2.1–0.2.6安全加固、运行态管理与 Deacon 安全化这六个月版本密度极高主线有三条安全加固0.2.1gt config命令管理每 rig 或全局的 agent 设置model、provider修复命令注入校验 beads 前缀、路径穿越校验 crew 名、ReDoS邮件搜索转义用户输入三类安全问题。Rig 运行态两级控制0.2.2gt rig park/unparkLevel 1暂停 daemon 自动启动但保留会话与gt rig dock/undockLevel 2停止全部会话并阻止自动启动统一代理启动的 Manager 模式gt status --watch监听模式最小 beads 版本兼容性校验。Deacon 安全化0.2.3标注为 Worker safety release这是早期一个值得注意的架构决策——移除 Deacon 的 kill 权限Deacon 巡逻只做--dry-run检测僵尸绝不直接杀进程「死亡令」death warrant提交给 Boot 处理审讯/执行。变更条目说明这防止了「destroyed worker context, mid-task progress, and unsaved state」多层暂停机制基于文件的状态、gt deacon pause/resume命令、gt prime与 heartbeat 中的守卫gt doctor从「杀掉会话」降级为「发出警告」。该版本还新增了gt account switch切换 Claude Code 账号管理~/.claude符号链接、Cursor/Auggie/Sourcegraph AMP 代理预置。值得注意的是条目原文附了一段保守声明Deacon 安全改进「believed to be correct but have not yet been extensively tested in production」建议先gt deacon pause观察——这种在 changelog 中保留不确定性声明的写法本身也是工程坦诚的体现。0.2.4 的 ZFCZero Framework Cognition改造移除 PID 探测与 pending.json 追踪代理存活状态直接从 tmux 查询状态从文件系统派生而非内存缓存gt prime增加--dry-run/--state/--explain三个调试旗标。0.2.5 则确立了「self-cleaning polecat model」polecat 完成即自毁Witness 只跟踪租约。0.2.6 引入统一升级系统severity 级别、路由、追踪并将 1560 行的sling.go拆分为 7 个聚焦模块。0.3.0–0.5.0消息基础设施与发布自动化0.3.0gastown-releasemolecule 公式预检、CHANGELOG 更新、本地安装、daemon 重启的发布工作流beads 原生的消息基础设施——queue beads消息队列、channel beads带保留策略的发布/订阅、group beads、地址解析、gt mail claim插件发现与管理gt plugin run、gt plugin historygt show/gt cat/gt orphans list/kill/gt convoy close/gt commit/gt trail等命令。同时移除 mrqueue 包MR 改为以 beads 存储。0.3.1 / 0.4.0未随发布记录仅留 git log 指引。0.5.0以交互打磨为主——gt mail read支持数字序号按收件箱位置读取、gt mail delete支持多 ID、收件箱并行查询带来约 6 倍加速命令别名体系gt bdgt bead、gt workgt hook、gt close的--comment别名OpenCode 成为内置代理预置gt config set agent opencodegt orphans kill清理孤儿 Claude 进程squash merge 让 git 历史更干净。0.6.0Dolt-Native 架构分水岭0.6.02026-02-15是整个演进史中最大的架构断点条目第一行即宣告「Complete SQLite-to-Dolt migration - Gas Town is now Dolt-native; all SQLite code removed」。核心内容gt dolt命令族服务器管理start、stop、status、migrate、rollback、sync、init-riggt install整合了 Dolt 身份、HQ 数据库与服务器启动branch-per-polecat 写隔离每个 polecat 获得自己的 Dolt 分支防止写冲突该基础设施在 0.8.0 的 server mode 成熟后被移除主动式 Dolt 健康告警daemon 用 30 秒 ticker 监控服务器健康gt dolt sync自动创建 DoltHub 仓库并推远端连接风暴防护max-connections 与准入控制Dashboard UX 大改版13 个交互数据面板、SSE 实时推送取代 10 秒轮询、命令面板自动补全、convoy 与 hook 的交互管理launchd/systemd 监管支持OS 原生的 daemon 管理agent 重启指数退避Hook 集中管理gt hooks sync/diff/list、per-matcher 合并逻辑可靠性工程flock 跨分子 attach、事件/喂料写入、crew 文件的锁catalog、routes、settings 的原子写进程组终止改为「验证成员枚举」而非盲目 PGID kill安全加固Web dashboard 处理器输入校验、dog/rig/bead 操作的路径穿越防护、会话名校验与分支名清洗的 shell 注入防护、拒绝 flag 样式的标题防止畸形命令创建垃圾 bead。0.6.0 条目结尾还列出「200 bug fixes」并指引git log v0.5.0..v0.6.0查完整细节——CHANGELOG 在此明确自我定位为「显著变更」而非逐 commit 记录。0.7.0–0.9.0所有权模型、遥测与数据生命周期0.7.0Convoy 所有权与合并策略所有权模型gt convoy create与gt sling增加--owned旗标--merge旗标支持direct、mr、local三种合并策略owneddirect 的 convoy 跳过 Witness/Refinery 注册以换取更快派发新增gt convoy land处理 owned convoy 的收尾gt done基于检查点的韧性会话在收尾中途死亡时可恢复代理工厂数据驱动的预置注册表取代 provider switch 语句Gemini CLI 与 GitHub Copilot CLI 作为一等运行时适配器接入基础设施git 子模块支持worktree 与合并队列、合并队列--verify旗标、 Mayor 的 Task 工具守卫GT_ROLE检查、gt rig add期间服务端建库。0.8.0队列调度引擎与 OpenTelemetry0.7.0 与 0.8.0 同日2026-02-23 前后连续发布条目采用四级标题分组是理解子系统布局的最好样本Work Queue Dispatchgt queueCLI 与守护进程驱动的派发引擎、gt queue epic批量入队 epic 子项、gt sling --queue异步派发路径、入队时校验、配置驱动的容量调度器OTEL横跨 gt、bd、Claude Code 的 OpenTelemetry 全量埋点、VictoriaMetrics/VictoriaLogs 集成、生命周期事件与时长直方图、gt.* OTEL资源属性、命令用量遥测与gt metrics读取器Dog 子系统handler 巡逻、session-hygiene Dog 插件僵尸 tmux 清理、空闲 dog 收割、shutdown dance moleculeDogs 的死亡令执行状态机Wisps 与瞬态存储agent beads 迁移到 wisp 表瞬态 SQLite 存储、巡逻周期中的 closed wisp GC代理提供商与运行时Pi agent provider、基于 promptfoo 的巡逻代理模型对比框架、成本层级预置清理移除 Dolt branch-per-polecat 遗留代码、BD_BRANCH、JSONL 回退代码——Dolt 成为唯一后端。当前 go.mod 中go.opentelemetry.io/otel v1.43.0及 OTLP 日志/指标导出器otlploghttp、otlpmetrichttp依赖与 0.8.0 引入的埋点体系相互印证。0.9.0合并队列二分、持久化 Polecat 与六阶段生命周期Bors 式合并队列批量 MR、在 tip 上跑测试、失败时二分定位GatesParallel 让测试与 lint 按 MR 并发持久化 Polecat身份与沙箱跨任务存活会话是瞬态的而身份永久累积gt done转入 idle 而非直接销毁。这与 0.2.5 的「self-cleaning polecat」模型是明显的路线修正值得对照阅读四个新增 DogCompactor Dog每日DOLT_RESET --soft扁平化提交历史可配置阈值、Doctor DogDolt 服务器健康巡逻僵尸、孤儿库、陈旧锁、JSONL DogJSONL 备份导出的尖刺检测与污染防火墙、Wisp Reaper Dog7d 关闭 wisp 的 DELETE、30d 陈旧 issue 自动关闭六阶段数据生命周期CREATE、LIVE、CLOSE、DECAY、COMPACT、FLATTEN 全部由 Dogs 自动化EnsureLifecycleDefaults()启动时自动填充 daemon.json配套gt maintain一键 flattengc、gt vitals统一健康面板、gt upgrade二进制后置迁移成本与性能调参Changed 小节硬编码阈值hung session、stale claims、最大重试、崩溃循环退避迁入operational.jsonGo 代码只读配置、由 agent 改值ZFC 合规协议消息从永久邮件改为瞬态 wisp 或 nudge巡逻流量的 Dolt 提交量减少约 80%Dolt 默认连接数上限从 200 提到 1,000测试基础设施迁移到 testcontainers每套测试用临时 Dolt 服务器BEADS_TEST_MODE1强制隔离清掉 45 个僵尸测试服务器7GB 内存。当前 go.mod 中的testcontainers-go v0.42.0与modules/dolt依赖正是这一体系的延续。0.10.0–0.13.0事件驱动生命周期与成本治理0.11.0容器化与清理Docker 支持docker-compose 与 Dockerfile当前仓库根目录的 docker-compose.yml 与 Dockerfile 即产物、Cursor IDE hooks、上下文预算守卫、bd close --cascade级联关闭带环保护与深度限制、gt wl sync的 Wasteland 模式演化。Changed 小节记录了 beads 依赖从 v0.57.0 升到 v0.59.0、hook 安装器合并为通用声明式系统、Reaper TTL 缩短auto-close 7 天、purge 3 天Removed 小节则删除了gt swarm命令与internal/swarm包、Beads Classic 的 SQLite/JSONL/sync 遗留路径。0.12.0事件驱动的 Polecat 生命周期FIX_NEEDED 反馈环Polecat 生命周期从轮询改为事件驱动引入awaiting_verdict状态gt-k0h跨库 convoy 解析多 rig 镇中 bd SQL JOIN 跨库失败时的 CLI 侧依赖解析GH#2624、GH#2625gt plugin sync构建后自动部署插件升级通道Email、Slack、SMS、log 四种通知通道CPU/内存压力门控opt-inspawn 前检查、gt rig add --reference部分克隆、公式extends组合、/review命令A-F 评分并接入 refinery、MVGT 联邦集成指南。0.12.1ACP 协议与 epic 级工作流Agent Client Protocol (ACP)结构化代理通信协议含推进触发检测与输出抑制——对应仓库中的 internal/acp/ 包propulsion、keepalive、代理转发gt mountain一条命令完成 epic 工作的 stage、label、launchgt assign一次性建 bead 并 hook 派发gt convoy create --from-epic把 epic 子项装入 convoy 波次并自动生成验证 bead类型化记忆gt remember --type feedback/project/user/reference仓库源 rig 设置repo 内.gastown/settings.json自动配置 rig 行为测试门、合并策略修复条目同样信息密度高空闲巡逻 CPU 空转、compactor-dog 对 Dolt base32 格式的误报、tmux 套接字脑裂GH#2442、polecat 生成风暴的两级熔断等。0.13.0指令覆盖层与巡逻降本0.13.0 的 Added 小节超过 20 条主线是「让 agent 发现与配置更便宜」directives 与 overlays新的gt prime指令加载器与覆盖层系统配套gt directive、gt overlayCLI 和 doctor 的 overlay 完整性检查——对应仓库中的 docs/design/directives-and-overlays.mdgt changelog命令从 CLI 生成 changelog见后文源码一节注意它与本文件的区别Wasteland 体系gt wl stamp/gt wl stamps/gt wl show work-id、scorekeeper 与 stamp loop 集成测试、pilot_cohort列巡逻降本空闲巡逻周期降推理 efforteffort_idle/effort_active按公式配置最大退避从 5 分钟提到 15 分钟条目给出的量化结论是「dormant rigs 成本降低约 66%」compactor 阈值从 500 提到 2000 减少无谓压实Dolt 运维failover/failback 多主机支持、.no-sync标记文件排除同步、启动超时按库数量动态伸缩每库 5 秒、SIGTERM→SIGKILL 宽限从 5 秒提到 30 秒安全加固bead ID 后缀校验、公式变量改用 bead ID 而非用户提供的标题、--subject/--args在 tmux pane 注入前清洗。1.x 系列跨平台、稳定性与守护进程韧性1.0.0Windows 支持与合并队列 PR 策略1.0 是第一个功能里程碑版本Windows 平台支持平台相关信号处理、进程管理、tmux 后裔进程追踪estop 拆分为 OS 专属文件——仓库中成对的*_unix.go/*_windows.go如 internal/cmd/process_unix.go 与 internal/cmd/process_windows.go即此拆分产物workflow 公式类型gt formula run支持type workflow的交互式步骤执行Refinerymerge_strategypr用gh pr merge取代直接 push启用 GitHub 原生合并队列require_reviewtrue现在会阻止 PR 在获得批准前合并其他新增/crew-commit技能、429 限流自动 estop 的 watchdog 插件、gt mail send --from中继转发、gt mail mark-read --all、gt rig add/adopt的前缀碰撞检测、PR 正文携带 bead 描述与 diff stat、CLAUDE_CODE_EFFORT_LEVEL默认 effort 配置、gt dolt pull安全修复dolt_remotes远程名查询的 SQL 注入转义 SQL 字符串被明确标注为 security fix。1.0.1–1.1.0从邮件积压到调度守卫1.0.1 修复了一个典型的 agent 系统雪崩daemon 发给 dog 的「Plugin: X」派发邮件在执行后从不关闭每次 UserPromptSubmit hook 的gt mail check --inject都会重注入全部未读邮件agent 上下文膨胀到 60–70% 引发压缩/hook 冲突并冻结 deacon修复方式是gt dog done在清工作前归档 dog 收件箱中所有 Plugin: 邮件1.1.0Convoy 完成与跨 rig 依赖解析触发通知免轮询scheduleBead跳过 closed/tombstone beads 防止「no such bead」空派发Dolt 内存压力下gt status靠子进程超时 并行 rig 扫描优雅降级而非挂死bd init --prefix兼容 bd 1.0此前依赖已移除的bd config set issue_prefix调用daemon 加固与 legacy flat polecat 布局回归覆盖。1.2.0守护进程崩溃循环治理1.2.0 的条目是理解 Gas Town 故障预算fault budget设计哲学的关键样本Stuck-agent-dog 与 Claude 用量限制的交互daemon 曾把「agent 因 API 限流暂停」误判为崩溃反复 kill/restart 消耗崩溃循环故障预算。修复后 stuck-agent-dog 先检查 agent tmux pane 中的 Claude 用量/限流特征签名识别出的暂停施加固定重试延迟PauseBackoff默认 60 秒且不计入崩溃循环故障预算让quota_dog有机会轮换账号而非烧预算gh#3398rig 初始化重复 Dolt 库gt rig add曾留下与 beads 前缀同名的孤儿库如前缀ma产生ma库与规范 rig 库如mobile_apps并存因为清理代码只认识 bd 0.62 的beads_prefix旧命名——beads 可能写进孤儿库而 mayor 从规范库读造成静默数据分裂。修复后两种命名都清理AddRig遇到残留孤儿会大声失败gh#3562陈旧 hooked 邮件 beadssendHandoffMail()在创建新 handoff bead 前关闭上一会话遗留的statushookedgt:messagebeads#3859。1.2.1Shell 集成的静默化源码级解读1.2.1 是最新正式版核心修复是 shell 集成 hook 不再在任意 shell 中打扰用户。变更条目描述了三个症状与对应解法症状gt install --shell安装的 hook 会在任何非已知 rig 的 git 仓库里弹出Add repo to Gas Town? [y/N/never]bash 下甚至在每条命令前都重新询问而不止cd时Ctrl-C 中断的提示从不记录答案跨恢复的终端会话可无限循环。解法add-offer 改为 opt-in设置GASTOWN_OFFER_ADD1才开启默认 hook 保持静默只在已知 rig 内导出GT_TOWN_ROOT/GT_RIGbash 只在真实目录变更时才提议repo 在提示前就记录中断读取不会再循环。这一修复的完整逻辑可以在 internal/shell/integration.go 的_gastown_offer_add函数中逐行对应# Offer-to-add is OPT-IN. By default Gas Town stays silent in your shells # and only sets GT_TOWN_ROOT/GT_RIG when you are inside a known rig. [[ ${GASTOWN_OFFER_ADD:-} 1 ]] || return 0 [[ ${GASTOWN_DISABLE_OFFER_ADD:-} 1 ]] return 0 _gastown_already_asked $repo_root return 0 [[ -t 0 ]] || return 0 # Record that we asked BEFORE reading the answer. If the prompt is # interrupted (Ctrl-C) we must not re-offer on the next prompt -- otherwise # an interrupted read loops forever. _gastown_mark_asked $repo_root源码还展示了条目未细说的两个设计点never回答会在仓库根创建.gastown-ignore文件_gastown_ignored沿目录树向上查找它y回答则调用gt rig quick-add $repo_root --yes并切到 crew 工作区后重跑 hook 以设置环境变量。其余三条 1.2.1 修复bd create仓库别名按规范路由 gh#4180、邮件 reply-to 从收件箱推断、gt doctor rig-config-sync接受前缀命名的 Dolt 库属于小的路由/诊断修正。源码佐证CHANGELOG 背后的版本工具链CHANGELOG.md 不是孤立文档它与仓库中多处代码和脚本构成一套版本一致性体系。版本常量的唯一事实源internal/cmd/version.go 中Version 1.2.1是 CLI 报告的版本常量。RELEASING.md 解释了为什么发布流程要校验 tag 与常量一致release.yml工作流在 tag push 时先跑make check-version-tag若 tagvX.Y.Z与Version常量不匹配直接中止发布——这是为了阻止 #3459 事故复发当时 v0.13.0 发布后gt version仍报告 0.12.1。bump-version.sh四个文件的联动更新scripts/bump-version.sh 是发布准备的中心脚本用法为./scripts/bump-version.sh X.Y.Z --commit --tag --push --install。它做四件事更新 internal/cmd/version.go 的Version常量更新 npm-package/package.json 的版本字段若系统有 nix更新 flake.nix 的版本与 vendorHash经 scripts/update-nix-flake.sh更新 CHANGELOG.md把## [Unreleased]原地改写为## [Unreleased] 新增## [X.Y.Z] - 当日日期两节sed 替换即「[Unreleased] 工作缓冲区」机制的实现。脚本还内置三重防御语义化版本正则校验、--tag依赖--commit且--push依赖--tag的旗标依赖校验、更新后重新 grep 三个文件验证版本一致不一致即退出。--install走make install重建并校验安装后的gt version输出。RELEASING.md 还记录了 tag push 后的自动动作GoReleaser 构建全平台二进制、Homebrew tapgastownhall/gastownformula 覆写、npmgastown/gtOIDC 可信发布。gt info --whats-newCHANGELOG 的 agent 可用投影CHANGELOG 面向人类读者而 agent 需要的是「与本版本操作相关」的子集。internal/cmd/info.go 中硬编码了一个versionChanges切片为每个近期版本存放NEW:/CHANGED:/FIX:前缀的 agent-actionable 摘要如 1.2.1 条目前 81 行的GASTOWN_OFFER_ADD1说明gt info --whats-new展示它。这解释了为什么 1.2.0 的info.go摘要scheduler 容量分桶、Dolt 最低版本 2.0.7 校验等与 CHANGELOG.md 中 1.2.0 条目不完全重合前者是面向 agent 行为的策展子集后者是完整变更清单。发布文档 RELEASING.md 的手动流程Option C也明确要求同步更新internal/cmd/info.go的versionChanges切片即这份投影是发布检查单的一部分。gt changelog不要与 CHANGELOG.md 混淆internal/cmd/changelog.go 实现的gt changelog命令与本文档文件是两回事它展示的是当前 Town 中各 rig 已关闭 beads 的工作日志过滤掉 wisp/patrol 等瞬态 bead旗标包括--today当日、--week默认本周一零点起、--since YYYY-MM-DD、--rig name、--json。其帮助文本自述为「Show a changelog of closed beads across all rigs in Gas Town」。0.13.0 条目称其为「Generate changelogs from the CLI with tests」。简言之CHANGELOG.md 记录产品版本演进gt changelog记录 agent 团队完成的实际工作——两者在 Gas Town 的术语体系里恰好同名。实践指引如何使用这份 CHANGELOG结合仓库现状当前Version 1.2.1go.mod 声明 Go 1.26.2、beads v1.0.5 依赖1.2.0 起要求 Dolt 最低 2.0.7给出几条使用建议定位行为变更升级前重点读目标版本的 Changed 小节尤其是影响会话行为与默认值的条目例如 1.2.1 的 shell hook 静默化默认不再询问添加 repo需要询问时显式export GASTOWN_OFFER_ADD1、0.9.0 的协议消息从邮件改为 wisp/nudge、0.2.3 起 Deacon 不再直接杀进程。用 bead 前缀反查来源条目中的hq-*是镇级 beadrig 前缀gt-*等是各 rig 的 bead在对应 rig 的 beads 数据库中bd show id可查看完整上下文这是 changelog 条目与原始工作项之间的桥接。发布前自检按 RELEASING.md 执行./scripts/bump-version.sh X.Y.Z后运行make check-version-tag未打 tag 的 HEAD 上是 no-op可安全运行确认 tag、Version常量、npm 包、flake 四处一致后再推 tag 触发自动发布。agent 视角的变更速览在已安装环境中运行gt info --whats-new获取针对 agent 行为策展的版本摘要避免解析整份 changelog。注意记录缺口的版本0.3.1、0.4.0、0.10.0 三个条目未随发布记录细节仅给出 git log 区间提示涉及这些版本的回归排查需要直接查 git 历史。这套「CHANGELOG 版本常量 校验工作流 agent 摘要投影」的组合在多智能体工具的长生命周期维护中提供了可追溯的升级依据每条显著变更要么可追溯到 issue/bead要么可在源码中逐行对应如 1.2.1 的 shell hook要么有量化说明如 0.9.0 巡逻流量 Dolt 提交量减少约 80%、0.13.0 空闲巡逻降本约 66%这正是 Keep a Changelog 格式在高变更频率项目中的价值所在。【免费下载链接】gastownGas Town - multi-agent workspace manager项目地址: https://gitcode.com/GitHub_Trending/ga/gastown创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考