Gas Town Mol Mall 设计为公式打造的可发现、可共享、可验证的注册中心【免费下载链接】gastownGas Town - multi-agent workspace manager项目地址: https://gitcode.com/GitHub_Trending/ga/gastown本文解读 Mol Mall 设计文档 及其配套的 Formula Resolution 架构阐述 Gas Town 如何将本地公式formula扩展为类 npm / Terraform Registry 的公式市场。文中将区分当前已实现Phase 1 本地公式与规划愿景Phase 2-5 注册表、发布、联邦两层内容并结合仓库源码如 internal/formula/embed.go、internal/cmd/formula.go说明现有实现与未来目标的对应关系。设计前提这是一份愿景文档不是已上线功能在深入技术细节之前必须先明确文档状态。docs/design/mol-mall-design.md开头明确标注Status: Vision document— Phase 1 (local formulas) exists. Phases 2-5 (registry, publishing, federation) are not implemented.这意味着Phase 1本地公式 三层解析已经在仓库中实现证据见 internal/formula/embed.go 中的ResolveFormulaContent与ProvisionFormulas以及gt formula list / show / run / create等命令internal/cmd/formula.goPhase 2-5导出/导入、公共注册表、企业私有注册表、HOP 联邦属于设计蓝图其中出现的gt formula install / publish / upgrade / login、hop://URI、锁文件.lock.json等均为目标形态仓库中尚无对应实现。阅读本文时请带着这层现状 vs 愿景的区分这既是理解该设计文档的正确姿势也是评估 Gas Town 公式体系演进路线图的起点。愿景把公式变成可流通的商品Mol Mall 的核心一句话是Gas Town 公式的市场marketplace for Gas Town formulas。设计文档用两个类比锚定定位Think npm for molecules—— 像 npm 分发 JavaScript 包一样分发 Gas Town 的分子molecule工作流Terraform Registry for workflows—— 像 Terraform Registry 沉淀基础设施模块一样沉淀工作流模板。文档中的一句话愿景颇具画面感Cook a formula, sling it to a polecat, the witness watches, refinery merges. What if you could browse a mall of formulas, install one, and immediately have your polecats executing world-class workflows?翻译成可操作的场景一个运维团队把code reviewsecurity auditdeploy to K8s这类工作流写成公式发布到 Mol Mall其他安装者一条命令装好本地的 polecat执行代理立刻开始按这套世界级工作流干活。网络效应Network Effect设计文档给出了公式分发背后的增长逻辑一个设计良好的公式每多一个采纳者就产生三重正向收益——更多代理在执行被验证过的工作流more agents executing proven workflows产生更多结构化、可追踪的工作产出more structured, trackable work output更好的能力路由better capability routing—— 在某个公式上有成功执行记录的代理会被优先分派同类工作。这正是后面能力标签 代理问责两节的设计动机没有能力标签就无法做语义化检索没有执行记录就无法做基于战绩的路由。架构三类注册表Mol Mall 的架构蓝图将注册表划分为三个层次PUBLIC REGISTRY (molmall.gastown.io) ├── Community formulas (MIT licensed) ├── Official Gas Town formulas (blessed) ├── Verified publisher formulas └── Open contribution model PRIVATE REGISTRY (self-hosted) ├── Organization-specific formulas ├── Proprietary workflows ├── Internal deployment patterns └── Enterprise compliance formulas FEDERATED REGISTRY (HOP future) ├── Cross-organization discovery ├── Skill-based search ├── Attribution chain tracking └── hop:// URI resolution公共注册表面向社区开放默认 MIT 许可官方公式blessed与其他发布者的验证公式共存私有注册表组织自托管承载专有工作流、内部部署模式与企业合规公式是 Phase 4 企业特性的落点联邦注册表基于 HOPHighway Operations Protocol实现跨组织发现是 Phase 5 的远期形态。值得注意的是这个公共/私有/联邦三层结构与仓库中已实现的三层本地解析结构rig town system形成了清晰的呼应本地解析解决公式从哪来注册表体系解决公式如何传播。二者通过 docs/design/formula-resolution.md 中Mol Mall ready的设计目标衔接起来。URI Scheme用 hop:// 标识一个公式为了让公式在任意注册表之间可引用Mol Mall 设计了基于 HOP 的 URI 方案hop://molmall.gastown.io/formulas/mol-polecat-work4.0.0 └──────────────────┘ └──────────────┘ └───┘ registry host formula name version # Short forms mol-polecat-work # Default registry, latest version mol-polecat-work4 # Major version mol-polecat-work4.0.0 # Exact version acme/mol-deploy # Scoped to publisher hop://acme.corp/formulas/mol-deploy # Full HOP URI设计要点形式语义场景mol-polecat-work默认注册表 最新版本日常快速安装mol-polecat-work4大版本锁定跟随次要/补丁更新mol-polecat-work4.0.0精确版本锁定可复现部署acme/mol-deploy发布者作用域企业/个人命名空间hop://host/formulas/...全量 HOP URI跨注册表显式引用版本粒度语义与 docs/design/formula-resolution.md 中规划的本地版本解析bd cook mol-polecat-work4、4.0.0、latest保持一致 —— 本地与远端共用同一套名称 版本心智模型这是设计上刻意为之的一致性。Registry APIOpenAPI 风格的端点规划设计文档为注册表服务器规划了完整的 HTTP API尚未实现核心端点如下GET /formulas # List all formulas Query: - q: string # Search query - capabilities: string[] # Filter by capability tags - author: string # Filter by author - limit: int - offset: int Response: formulas: - name: mol-polecat-work version: 4.0.0 description: Full polecat work lifecycle... author: stevegastown.io downloads: 12543 capabilities: [go, testing, code-review] GET /formulas/{name} # Get formula metadata Response: name: mol-polecat-work versions: [4.0.0, 3.2.1, 3.2.0, ...] latest: 4.0.0 author: stevegastown.io repository: https://github.com/steveyegge/gastown license: MIT capabilities: primary: [go, testing] secondary: [git, code-review] stats: downloads: 12543 stars: 234 used_by: 89 # towns using this formula GET /formulas/{name}/{version} # Get specific version Response: name: mol-polecat-work version: 4.0.0 checksum: sha256:abc123... signature: optional PGP signature content: base64 or URL to .formula.toml changelog: Added self-cleaning model... published_at: 2026-01-10T00:00:00Z POST /formulas # Publish formula (authenticated) Body: name: mol-my-workflow version: 1.0.0 content: formula TOML changelog: Initial release Auth: Bearer token (linked to HOP identity) GET /formulas/{name}/{version}/download # Download formula content Response: raw .formula.toml content接口设计透露出三个关键决策版本不可变GET /formulas/{name}/{version}返回checksumsha256与可选 PGPsignature与锁文件、安装流程中的校验和验证环节配套保证下载内容与发布内容一致能力标签进入查询面GET /formulas支持capabilities过滤说明能力标签不只是元数据装饰而是检索的一等公民为按能力找公式提供接口基础统计信息驱动排名downloads / stars / used_by三项指标构成排序依据对应信任等级中的更高搜索排名。Formula Package 格式从单文件到 BundleMol Mall 的公式包有两种形态与当前仓库中的公式文件格式天然衔接。简单形态单个 .formula.toml 文件大多数公式就是一个 TOML 文件。目标安装命令与落点gt formula install mol-polecat-code-review # Downloads mol-polecat-code-review.formula.toml to ~/gt/.beads/formulas/注意目标落点~/gt/.beads/formulas/—— 这正是 docs/design/formula-resolution.md 中定义的Tier 2town 级目录。设计意图非常明确从 Mol Mall 安装的公式落在 town 层从而在不改动项目仓库的前提下覆盖系统内置版本同时被同一用户的所有项目共享。复杂形态Formula Bundle需要附带脚本、模板、配置的公式打包为 bundle 目录mol-deploy-k8s.formula.bundle/ ├── formula.toml # Main formula ├── templates/ │ ├── deployment.yaml.tmpl │ └── service.yaml.tmpl ├── scripts/ │ └── healthcheck.sh └── README.mdBundle 以 tarball 分发# Bundles are tarballs mol-deploy-k8s-1.0.0.bundle.tar.gz安装后解压到独立目录gt formula install mol-deploy-k8s # Extracts to ~/gt/.beads/formulas/mol-deploy-k8s/ # formula.toml is at mol-deploy-k8s/formula.toml这一设计为仓库中internal/formula/formulas/下的现有公式如 mol-polecat-work.formula.toml、code-review.formula.toml预留了需要附带文件的升级路径 —— 当前这些公式都是单文件内联所有步骤说明而 bundle 形态允许公式携带渲染模板与辅助脚本。安装流程解析 → 下载 → 校验 → 落盘基础安装设计文档描绘的目标交互Phase 3 之后$ gt formula install mol-polecat-code-review Resolving mol-polecat-code-review... Registry: molmall.gastown.io Version: 1.2.0 (latest) Author: stevegastown.io Skills: code-review, security Downloading... ████████████████████ 100% Verifying checksum... ✓ Installed to: ~/gt/.beads/formulas/mol-polecat-code-review.formula.toml流程五步解析解析注册表与版本→ 展示元信息 → 下载 → 校验 checksum → 写入 town 层公式目录。版本固定Version Pinning$ gt formula install mol-polecat-work4.0.0 Installing mol-polecat-work4.0.0 (pinned)... ✓ Installed $ gt formula list --installed mol-polecat-work 4.0.0 [pinned] mol-polecat-code-review 1.2.0 [latest]--installed视角只展示 town 层已安装的公式并用[pinned]/[latest]标注固定策略。升级流程Upgrade Flow$ gt formula upgrade mol-polecat-code-review Checking for updates... Current: 1.2.0 Latest: 1.3.0 Changelog for 1.3.0: - Added security focus option - Improved test coverage step Upgrade? [y/N] y Downloading... ✓ Installed: mol-polecat-code-review1.3.0升级前先展示 changelog并要求显式确认默认[y/N]防止静默破坏性更新。锁文件Lock File与 npm 的package-lock.json类似Mol Mall 规划了~/gt/.beads/formulas/.lock.json{ version: 1, formulas: { mol-polecat-work: { version: 4.0.0, pinned: true, checksum: sha256:abc123..., installed_at: 2026-01-10T00:00:00Z, source: hop://molmall.gastown.io/formulas/mol-polecat-work4.0.0 }, mol-polecat-code-review: { version: 1.3.0, pinned: false, checksum: sha256:def456..., installed_at: 2026-01-10T12:00:00Z, source: hop://molmall.gastown.io/formulas/mol-polecat-code-review1.3.0 } } }源码对照锁文件的字段设计版本、checksum、安装时间、来源 URI与仓库中已实现的.installed.json高度同构。在 internal/formula/embed.go 中InstalledRecord记录了filename - sha256的映射并配套实现了ProvisionFormulas—— 安装时把内嵌公式部署到.beads/formulas/已存在的文件跳过不覆盖用户定制CheckFormulaHealth—— 依据内嵌哈希 vs 安装记录哈希 vs 磁盘当前哈希三者关系把公式状态归类为ok / outdated / modified / missing / new / untracked / errorUpdateFormulas—— 只更新outdated、missing、untracked状态的公式跳过用户修改过的modified。也就是说当前仓库已经用.installed.json实现了记录安装来源哈希、检测漂移、保护用户定制的本地等价物Mol Mall 的.lock.json是这一机制的远端注册表扩展版额外增加pinned标记与sourceURI。发布流程从登录到信任等级首次初始化$ gt formula publish --init Setting up Mol Mall publishing... 1. Create account at https://molmall.gastown.io/signup 2. Generate API token at https://molmall.gastown.io/settings/tokens 3. Run: gt formula login $ gt formula login Token: ******** Logged in as: stevegastown.io认证模型为Bearer token 绑定 HOP 身份与前面 Registry API 的Auth: Bearer token呼应token 与发布者身份绑定是后续信任等级的基础。发布前的 Pre-flight 检查$ gt formula publish mol-polecat-work Publishing mol-polecat-work... Pre-flight checks: ✓ formula.toml is valid ✓ Version 4.0.0 not yet published ✓ Required fields present (name, version, description) ✓ Skills declared Publish to molmall.gastown.io? [y/N] y Uploading... ✓ Published: hop://molmall.gastown.io/formulas/mol-polecat-work4.0.0 View at: https://molmall.gastown.io/formulas/mol-polecat-work四项 pre-flight 检查中formula.toml is valid在本地已有对应实现 —— 仓库的 internal/formula/parser.go 实现了完整的 TOML 解析与校验Parse会先inferType根据内容推断公式类型再调用Validate检查必填字段、类型合法性、步骤/腿 ID 唯一性、needs引用有效性以及循环依赖检测checkCycles/checkDependencyCycles。发布流程中✓ formula.toml is valid这步落地时可以直接复用这套校验器。信任等级Verification Levels设计文档为公式定义了四级信任体系UNVERIFIED (default) Anyone can publish Basic validation only Displayed with ⚠️ warning VERIFIED PUBLISHER Publisher identity confirmed Displayed with ✓ checkmark Higher search ranking OFFICIAL Maintained by Gas Town team Displayed with ️ badge Included in embedded defaults AUDITED Security review completed Displayed with badge Required for enterprise registries四个等级与安全设计的关键点等级门槛展示标记权益UNVERIFIED任何人可发布⚠️ 警告基础验证VERIFIED PUBLISHER身份已确认✓ 对勾更高搜索排名OFFICIALGas Town 官方维护️ 徽章进入内嵌默认集AUDITED完成安全审查 锁徽章企业注册表强制要求源码对照OFFICIAL 等级Included in embedded defaults与当前实现完全吻合 —— 仓库中internal/formula/formulas/下的 40 个公式正是通过//go:embed formulas/*.formula.toml见 internal/formula/embed.go编译进二进制作为官方内置默认且会在gt install时由ProvisionFormulas部署到.beads/formulas/。可以说OFFICIAL 内嵌默认这一信任等级在 Phase 1 就已经落地其余等级属于注册表上线后的扩展。Capability Tagging能力标签驱动的路由公式能力声明设计文档给出的能力声明 TOML 结构[formula.capabilities] # What capabilities does this formula exercise? Used for agent routing. primary [go, testing, code-review] secondary [git, ci-cd] # Capability weights (optional, for fine-grained routing) [formula.capabilities.weights] go 0.3 # 30% of formula work is Go testing 0.4 # 40% is testing code-review 0.3 # 30% is code reviewprimary/secondary主/次能力标签用于检索过滤weights可选能力权重声明公式工作在各能力上的分布为细粒度路由如这个公式的 Go 工作占比 30%提供依据。同一结构也出现在 docs/design/formula-resolution.md 的Extended Format (Mol Mall Ready)公式头部定义中说明能力标签是公式 schema 的正式组成部分而非临时字段。基于能力的搜索$ gt formula search --capabilitiessecurity,go Formulas matching capabilities: security, go mol-security-audit v2.1.0 ⭐ 4.8 8,234 Capabilities: security, go, code-review Comprehensive security audit workflow mol-dependency-scan v1.0.0 ⭐ 4.2 3,102 Capabilities: security, go, supply-chain Scan Go dependencies for vulnerabilities搜索同时展示星级评分⭐与下载量与 Registry API 中的stats字段对应。代理问责Agent Accountability当 polecat 完成一个公式时执行记录被追踪Polecat: beads/amber Formula: mol-polecat-code-review1.3.0 Completed: 2026-01-10T15:30:00Z Capabilities exercised: - code-review (primary) - security (secondary) - go (secondary)这份执行记录支撑三个能力Routing—— 有成功战绩的代理优先承接同类工作回扣愿景中的better capability routingDebugging—— 精确追溯哪个代理、何时、做了什么Quality metrics—— 按代理与公式统计成功率反哺公式迭代与代理评估。私有注册表企业落地形态客户端多注册表配置企业可以配置多个注册表并按优先级回退# ~/.gtconfig.yaml registries: - name: acme url: https://molmall.acme.corp auth: token priority: 1 # Check first - name: public url: https://molmall.gastown.io auth: none priority: 2 # Fallbackpriority语义明确企业内网注册表优先公共注册表兜底。这与本地三层解析最具体者优先rig town system的哲学一脉相承 ——先查最近的、最可信的来源再逐级回退。自托管注册表设计文档给出了 Docker 部署形态# Docker deployment docker run -d \ -p 8080:8080 \ -v /data/formulas:/formulas \ -e AUTH_PROVIDERoidc \ gastown/molmall-registry:latest # Configuration MOLMALL_STORAGEs3://bucket/formulas MOLMALL_AUTHoidc MOLMALL_OIDC_ISSUERhttps://auth.acme.corp关键环境变量变量用途AUTH_PROVIDERoidc/MOLMALL_AUTHoidc认证方式接入企业 OIDCMOLMALL_OIDC_ISSUEROIDC 签发者地址MOLMALL_STORAGEs3://bucket/formulas公式存储后端对象存储-v /data/formulas:/formulas本地卷挂载的备选存储企业合规公式 OIDC 认证 审计日志共同构成 Phase 4 Enterprise Features 的完整图景。联邦Federation通过 HOP 实现跨组织共享跨注册表发现$ gt formula search deploy kubernetes --federated Searching across federated registries... molmall.gastown.io: mol-deploy-k8s v3.0.0 ️ Official molmall.acme.corp: acme/mol-deploy-k8s v2.1.0 ✓ Verified molmall.bigco.io: bigco/k8s-workflow v1.0.0 ⚠️ Unverified联邦搜索把多个注册表的结果聚合展示每个结果都附带其信任等级标记️ Official / ✓ Verified / ⚠️ Unverified让使用者在更多选择与可信度甄别之间获得显式信息。HOP URI 解析流程# Full HOP URI gt formula install hop://molmall.acme.corp/formulas/acme/mol-deploy2.1.0 # Resolution via HOP (Highway Operations Protocol) 1. Parse hop:// URI 2. Resolve registry endpoint (DNS/HOP discovery) 3. Authenticate (if required) 4. Download formula 5. Verify checksum/signature 6. Install to town-level六步解析流程中Install to town-level再次确认无论公式来自哪个注册表最终落点都是 town 层~/gt/.beads/formulas/与 docs/design/formula-resolution.md 的 Tier 2 定义完全一致。实施阶段路线图Phase 1-5设计文档给出了清晰的五阶段演进路径结合源码可确认每阶段的现状Phase 1本地命令Now已实现详情见 Formula Resolution 架构文档。仓库证据三层解析ResolveFormulaContentinternal/formula/embed.go严格按rig town embedded顺序查找*.formula.toml内嵌系统层//go:embed formulas/*.formula.toml把 40 个公式编译进二进制internal/formula/embed.go安装时部署ProvisionFormulas在gt install时创建.beads/formulas/并写入内嵌公式同时生成.installed.json记录哈希internal/formula/embed.go健康管理CheckFormulaHealth/UpdateFormulas实现公式漂移检测与安全更新internal/formula/embed.go命令面gt formula list / show / run / create已落地internal/cmd/formula.go其中gt formula run支持--pr、--rig、--dry-run、--agent、--set等参数。Phase 2手动共享Formula export/importgt formula export mol-polecat-work mol-polecat-work.formula.tomlgt formula import mol-polecat-work.formula.tomlLock file 格式上文.lock.jsonPhase 3公共注册表molmall.gastown.io 上线gt formula install从注册表安装gt formula publish流程基础搜索与浏览。Phase 4企业特性私有注册表支持认证集成OIDC / Bearer token信任等级UNVERIFIED → AUDITED审计日志。Phase 5联邦HOP能力标签进入 schema联邦协议Highway Operations Protocol跨注册表搜索代理执行追踪问责。当前实现的公式本体为 Mol Mall 打下的地基要理解 Mol Mall 的落点需要先理解它分发的东西 —— 公式。仓库的 internal/formula/types.go 定义了四种公式类型类型常量用途convoyTypeConvoy并行腿legs执行 综合synthesisworkflowTypeWorkflow带依赖的顺序步骤expansionTypeExpansion模板化步骤生成供 compose 展开aspectTypeAspect多角度并行分析以 mol-polecat-work.formula.toml 为例它是标准的 workflow 公式定义issue / base_branch / setup_command / typecheck_command / test_command / lint_command / build_command七个变量编排load-context → branch-setup → implement → commit-changes → self-review → build-check → pre-verify → submit-and-exit八个步骤每个步骤带明确的 exit criteria。这种变量 步骤 验收标准的结构正是 Mol Mall 公式包content: formula TOML字段要承载的载荷—— 注册表本身不关心公式内部逻辑只负责把这份 TOML 可靠地分发、校验并记录出处。同时internal/formula/parser.go 的校验器必填字段、唯一 ID、needs引用、循环依赖检测、拓扑排序、ReadySteps就绪计算构成了pre-flight 检查中 formula.toml is valid的直接实现基础也为 Mol Mall 的POST /formulas服务端验证提供了可移植的校验逻辑。小结Mol Mall 是一份架构完整、落地分期的愿景文档它用三类注册表 HOP URI 五级 API 四级信任 能力标签 锁文件勾勒出一个类 npm 的 Gas Town 公式市场同时通过Install to town-level的设计把远端分发体系与仓库中已实现的三层本地解析docs/design/formula-resolution.md、internal/formula/embed.go无缝衔接。对读者最有价值的三点认识现状边界清晰Phase 1本地公式、三层解析、内嵌默认、健康检查已在仓库落地Phase 2-5导出导入、公共/私有注册表、HOP 联邦仍是设计蓝图文中的gt formula install/publish/upgrade与hop://为规划形态设计一致性无论是本地解析rig town system还是远端注册表private public federated贯穿始终的原则是就近、可信优先逐级回退升级路径平滑当前.installed.json与规划中的.lock.json同构现有解析器/校验器可直接服务注册表 API公式本体的 TOML 结构无需改变即可进入市场流通。相关文档Mol Mall Design —— 本文解读的设计文档本体Formula Resolution —— 已实现的三层本地解析架构rig town systemMolecules —— 公式Formula→ Proto → Mol 的完整生命周期cook, pour, squash公式解析器与校验器 —— TOML 解析、类型推断、依赖校验与拓扑排序公式类型定义 —— convoy / workflow / expansion / aspect 四种公式结构公式内嵌与部署实现 —— 三层解析、安装时部署、健康检查与更新内置公式集 —— 40 个官方内嵌公式OFFICIAL 等级的现实形态gt formula 命令实现 —— 当前已实现的 list / show / run / create【免费下载链接】gastownGas Town - multi-agent workspace manager项目地址: https://gitcode.com/GitHub_Trending/ga/gastown创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Gas Town Mol Mall 设计：为公式打造的可发现、可共享、可验证的注册中心
Gas Town Mol Mall 设计为公式打造的可发现、可共享、可验证的注册中心【免费下载链接】gastownGas Town - multi-agent workspace manager项目地址: https://gitcode.com/GitHub_Trending/ga/gastown本文解读 Mol Mall 设计文档 及其配套的 Formula Resolution 架构阐述 Gas Town 如何将本地公式formula扩展为类 npm / Terraform Registry 的公式市场。文中将区分当前已实现Phase 1 本地公式与规划愿景Phase 2-5 注册表、发布、联邦两层内容并结合仓库源码如 internal/formula/embed.go、internal/cmd/formula.go说明现有实现与未来目标的对应关系。设计前提这是一份愿景文档不是已上线功能在深入技术细节之前必须先明确文档状态。docs/design/mol-mall-design.md开头明确标注Status: Vision document— Phase 1 (local formulas) exists. Phases 2-5 (registry, publishing, federation) are not implemented.这意味着Phase 1本地公式 三层解析已经在仓库中实现证据见 internal/formula/embed.go 中的ResolveFormulaContent与ProvisionFormulas以及gt formula list / show / run / create等命令internal/cmd/formula.goPhase 2-5导出/导入、公共注册表、企业私有注册表、HOP 联邦属于设计蓝图其中出现的gt formula install / publish / upgrade / login、hop://URI、锁文件.lock.json等均为目标形态仓库中尚无对应实现。阅读本文时请带着这层现状 vs 愿景的区分这既是理解该设计文档的正确姿势也是评估 Gas Town 公式体系演进路线图的起点。愿景把公式变成可流通的商品Mol Mall 的核心一句话是Gas Town 公式的市场marketplace for Gas Town formulas。设计文档用两个类比锚定定位Think npm for molecules—— 像 npm 分发 JavaScript 包一样分发 Gas Town 的分子molecule工作流Terraform Registry for workflows—— 像 Terraform Registry 沉淀基础设施模块一样沉淀工作流模板。文档中的一句话愿景颇具画面感Cook a formula, sling it to a polecat, the witness watches, refinery merges. What if you could browse a mall of formulas, install one, and immediately have your polecats executing world-class workflows?翻译成可操作的场景一个运维团队把code reviewsecurity auditdeploy to K8s这类工作流写成公式发布到 Mol Mall其他安装者一条命令装好本地的 polecat执行代理立刻开始按这套世界级工作流干活。网络效应Network Effect设计文档给出了公式分发背后的增长逻辑一个设计良好的公式每多一个采纳者就产生三重正向收益——更多代理在执行被验证过的工作流more agents executing proven workflows产生更多结构化、可追踪的工作产出more structured, trackable work output更好的能力路由better capability routing—— 在某个公式上有成功执行记录的代理会被优先分派同类工作。这正是后面能力标签 代理问责两节的设计动机没有能力标签就无法做语义化检索没有执行记录就无法做基于战绩的路由。架构三类注册表Mol Mall 的架构蓝图将注册表划分为三个层次PUBLIC REGISTRY (molmall.gastown.io) ├── Community formulas (MIT licensed) ├── Official Gas Town formulas (blessed) ├── Verified publisher formulas └── Open contribution model PRIVATE REGISTRY (self-hosted) ├── Organization-specific formulas ├── Proprietary workflows ├── Internal deployment patterns └── Enterprise compliance formulas FEDERATED REGISTRY (HOP future) ├── Cross-organization discovery ├── Skill-based search ├── Attribution chain tracking └── hop:// URI resolution公共注册表面向社区开放默认 MIT 许可官方公式blessed与其他发布者的验证公式共存私有注册表组织自托管承载专有工作流、内部部署模式与企业合规公式是 Phase 4 企业特性的落点联邦注册表基于 HOPHighway Operations Protocol实现跨组织发现是 Phase 5 的远期形态。值得注意的是这个公共/私有/联邦三层结构与仓库中已实现的三层本地解析结构rig town system形成了清晰的呼应本地解析解决公式从哪来注册表体系解决公式如何传播。二者通过 docs/design/formula-resolution.md 中Mol Mall ready的设计目标衔接起来。URI Scheme用 hop:// 标识一个公式为了让公式在任意注册表之间可引用Mol Mall 设计了基于 HOP 的 URI 方案hop://molmall.gastown.io/formulas/mol-polecat-work4.0.0 └──────────────────┘ └──────────────┘ └───┘ registry host formula name version # Short forms mol-polecat-work # Default registry, latest version mol-polecat-work4 # Major version mol-polecat-work4.0.0 # Exact version acme/mol-deploy # Scoped to publisher hop://acme.corp/formulas/mol-deploy # Full HOP URI设计要点形式语义场景mol-polecat-work默认注册表 最新版本日常快速安装mol-polecat-work4大版本锁定跟随次要/补丁更新mol-polecat-work4.0.0精确版本锁定可复现部署acme/mol-deploy发布者作用域企业/个人命名空间hop://host/formulas/...全量 HOP URI跨注册表显式引用版本粒度语义与 docs/design/formula-resolution.md 中规划的本地版本解析bd cook mol-polecat-work4、4.0.0、latest保持一致 —— 本地与远端共用同一套名称 版本心智模型这是设计上刻意为之的一致性。Registry APIOpenAPI 风格的端点规划设计文档为注册表服务器规划了完整的 HTTP API尚未实现核心端点如下GET /formulas # List all formulas Query: - q: string # Search query - capabilities: string[] # Filter by capability tags - author: string # Filter by author - limit: int - offset: int Response: formulas: - name: mol-polecat-work version: 4.0.0 description: Full polecat work lifecycle... author: stevegastown.io downloads: 12543 capabilities: [go, testing, code-review] GET /formulas/{name} # Get formula metadata Response: name: mol-polecat-work versions: [4.0.0, 3.2.1, 3.2.0, ...] latest: 4.0.0 author: stevegastown.io repository: https://github.com/steveyegge/gastown license: MIT capabilities: primary: [go, testing] secondary: [git, code-review] stats: downloads: 12543 stars: 234 used_by: 89 # towns using this formula GET /formulas/{name}/{version} # Get specific version Response: name: mol-polecat-work version: 4.0.0 checksum: sha256:abc123... signature: optional PGP signature content: base64 or URL to .formula.toml changelog: Added self-cleaning model... published_at: 2026-01-10T00:00:00Z POST /formulas # Publish formula (authenticated) Body: name: mol-my-workflow version: 1.0.0 content: formula TOML changelog: Initial release Auth: Bearer token (linked to HOP identity) GET /formulas/{name}/{version}/download # Download formula content Response: raw .formula.toml content接口设计透露出三个关键决策版本不可变GET /formulas/{name}/{version}返回checksumsha256与可选 PGPsignature与锁文件、安装流程中的校验和验证环节配套保证下载内容与发布内容一致能力标签进入查询面GET /formulas支持capabilities过滤说明能力标签不只是元数据装饰而是检索的一等公民为按能力找公式提供接口基础统计信息驱动排名downloads / stars / used_by三项指标构成排序依据对应信任等级中的更高搜索排名。Formula Package 格式从单文件到 BundleMol Mall 的公式包有两种形态与当前仓库中的公式文件格式天然衔接。简单形态单个 .formula.toml 文件大多数公式就是一个 TOML 文件。目标安装命令与落点gt formula install mol-polecat-code-review # Downloads mol-polecat-code-review.formula.toml to ~/gt/.beads/formulas/注意目标落点~/gt/.beads/formulas/—— 这正是 docs/design/formula-resolution.md 中定义的Tier 2town 级目录。设计意图非常明确从 Mol Mall 安装的公式落在 town 层从而在不改动项目仓库的前提下覆盖系统内置版本同时被同一用户的所有项目共享。复杂形态Formula Bundle需要附带脚本、模板、配置的公式打包为 bundle 目录mol-deploy-k8s.formula.bundle/ ├── formula.toml # Main formula ├── templates/ │ ├── deployment.yaml.tmpl │ └── service.yaml.tmpl ├── scripts/ │ └── healthcheck.sh └── README.mdBundle 以 tarball 分发# Bundles are tarballs mol-deploy-k8s-1.0.0.bundle.tar.gz安装后解压到独立目录gt formula install mol-deploy-k8s # Extracts to ~/gt/.beads/formulas/mol-deploy-k8s/ # formula.toml is at mol-deploy-k8s/formula.toml这一设计为仓库中internal/formula/formulas/下的现有公式如 mol-polecat-work.formula.toml、code-review.formula.toml预留了需要附带文件的升级路径 —— 当前这些公式都是单文件内联所有步骤说明而 bundle 形态允许公式携带渲染模板与辅助脚本。安装流程解析 → 下载 → 校验 → 落盘基础安装设计文档描绘的目标交互Phase 3 之后$ gt formula install mol-polecat-code-review Resolving mol-polecat-code-review... Registry: molmall.gastown.io Version: 1.2.0 (latest) Author: stevegastown.io Skills: code-review, security Downloading... ████████████████████ 100% Verifying checksum... ✓ Installed to: ~/gt/.beads/formulas/mol-polecat-code-review.formula.toml流程五步解析解析注册表与版本→ 展示元信息 → 下载 → 校验 checksum → 写入 town 层公式目录。版本固定Version Pinning$ gt formula install mol-polecat-work4.0.0 Installing mol-polecat-work4.0.0 (pinned)... ✓ Installed $ gt formula list --installed mol-polecat-work 4.0.0 [pinned] mol-polecat-code-review 1.2.0 [latest]--installed视角只展示 town 层已安装的公式并用[pinned]/[latest]标注固定策略。升级流程Upgrade Flow$ gt formula upgrade mol-polecat-code-review Checking for updates... Current: 1.2.0 Latest: 1.3.0 Changelog for 1.3.0: - Added security focus option - Improved test coverage step Upgrade? [y/N] y Downloading... ✓ Installed: mol-polecat-code-review1.3.0升级前先展示 changelog并要求显式确认默认[y/N]防止静默破坏性更新。锁文件Lock File与 npm 的package-lock.json类似Mol Mall 规划了~/gt/.beads/formulas/.lock.json{ version: 1, formulas: { mol-polecat-work: { version: 4.0.0, pinned: true, checksum: sha256:abc123..., installed_at: 2026-01-10T00:00:00Z, source: hop://molmall.gastown.io/formulas/mol-polecat-work4.0.0 }, mol-polecat-code-review: { version: 1.3.0, pinned: false, checksum: sha256:def456..., installed_at: 2026-01-10T12:00:00Z, source: hop://molmall.gastown.io/formulas/mol-polecat-code-review1.3.0 } } }源码对照锁文件的字段设计版本、checksum、安装时间、来源 URI与仓库中已实现的.installed.json高度同构。在 internal/formula/embed.go 中InstalledRecord记录了filename - sha256的映射并配套实现了ProvisionFormulas—— 安装时把内嵌公式部署到.beads/formulas/已存在的文件跳过不覆盖用户定制CheckFormulaHealth—— 依据内嵌哈希 vs 安装记录哈希 vs 磁盘当前哈希三者关系把公式状态归类为ok / outdated / modified / missing / new / untracked / errorUpdateFormulas—— 只更新outdated、missing、untracked状态的公式跳过用户修改过的modified。也就是说当前仓库已经用.installed.json实现了记录安装来源哈希、检测漂移、保护用户定制的本地等价物Mol Mall 的.lock.json是这一机制的远端注册表扩展版额外增加pinned标记与sourceURI。发布流程从登录到信任等级首次初始化$ gt formula publish --init Setting up Mol Mall publishing... 1. Create account at https://molmall.gastown.io/signup 2. Generate API token at https://molmall.gastown.io/settings/tokens 3. Run: gt formula login $ gt formula login Token: ******** Logged in as: stevegastown.io认证模型为Bearer token 绑定 HOP 身份与前面 Registry API 的Auth: Bearer token呼应token 与发布者身份绑定是后续信任等级的基础。发布前的 Pre-flight 检查$ gt formula publish mol-polecat-work Publishing mol-polecat-work... Pre-flight checks: ✓ formula.toml is valid ✓ Version 4.0.0 not yet published ✓ Required fields present (name, version, description) ✓ Skills declared Publish to molmall.gastown.io? [y/N] y Uploading... ✓ Published: hop://molmall.gastown.io/formulas/mol-polecat-work4.0.0 View at: https://molmall.gastown.io/formulas/mol-polecat-work四项 pre-flight 检查中formula.toml is valid在本地已有对应实现 —— 仓库的 internal/formula/parser.go 实现了完整的 TOML 解析与校验Parse会先inferType根据内容推断公式类型再调用Validate检查必填字段、类型合法性、步骤/腿 ID 唯一性、needs引用有效性以及循环依赖检测checkCycles/checkDependencyCycles。发布流程中✓ formula.toml is valid这步落地时可以直接复用这套校验器。信任等级Verification Levels设计文档为公式定义了四级信任体系UNVERIFIED (default) Anyone can publish Basic validation only Displayed with ⚠️ warning VERIFIED PUBLISHER Publisher identity confirmed Displayed with ✓ checkmark Higher search ranking OFFICIAL Maintained by Gas Town team Displayed with ️ badge Included in embedded defaults AUDITED Security review completed Displayed with badge Required for enterprise registries四个等级与安全设计的关键点等级门槛展示标记权益UNVERIFIED任何人可发布⚠️ 警告基础验证VERIFIED PUBLISHER身份已确认✓ 对勾更高搜索排名OFFICIALGas Town 官方维护️ 徽章进入内嵌默认集AUDITED完成安全审查 锁徽章企业注册表强制要求源码对照OFFICIAL 等级Included in embedded defaults与当前实现完全吻合 —— 仓库中internal/formula/formulas/下的 40 个公式正是通过//go:embed formulas/*.formula.toml见 internal/formula/embed.go编译进二进制作为官方内置默认且会在gt install时由ProvisionFormulas部署到.beads/formulas/。可以说OFFICIAL 内嵌默认这一信任等级在 Phase 1 就已经落地其余等级属于注册表上线后的扩展。Capability Tagging能力标签驱动的路由公式能力声明设计文档给出的能力声明 TOML 结构[formula.capabilities] # What capabilities does this formula exercise? Used for agent routing. primary [go, testing, code-review] secondary [git, ci-cd] # Capability weights (optional, for fine-grained routing) [formula.capabilities.weights] go 0.3 # 30% of formula work is Go testing 0.4 # 40% is testing code-review 0.3 # 30% is code reviewprimary/secondary主/次能力标签用于检索过滤weights可选能力权重声明公式工作在各能力上的分布为细粒度路由如这个公式的 Go 工作占比 30%提供依据。同一结构也出现在 docs/design/formula-resolution.md 的Extended Format (Mol Mall Ready)公式头部定义中说明能力标签是公式 schema 的正式组成部分而非临时字段。基于能力的搜索$ gt formula search --capabilitiessecurity,go Formulas matching capabilities: security, go mol-security-audit v2.1.0 ⭐ 4.8 8,234 Capabilities: security, go, code-review Comprehensive security audit workflow mol-dependency-scan v1.0.0 ⭐ 4.2 3,102 Capabilities: security, go, supply-chain Scan Go dependencies for vulnerabilities搜索同时展示星级评分⭐与下载量与 Registry API 中的stats字段对应。代理问责Agent Accountability当 polecat 完成一个公式时执行记录被追踪Polecat: beads/amber Formula: mol-polecat-code-review1.3.0 Completed: 2026-01-10T15:30:00Z Capabilities exercised: - code-review (primary) - security (secondary) - go (secondary)这份执行记录支撑三个能力Routing—— 有成功战绩的代理优先承接同类工作回扣愿景中的better capability routingDebugging—— 精确追溯哪个代理、何时、做了什么Quality metrics—— 按代理与公式统计成功率反哺公式迭代与代理评估。私有注册表企业落地形态客户端多注册表配置企业可以配置多个注册表并按优先级回退# ~/.gtconfig.yaml registries: - name: acme url: https://molmall.acme.corp auth: token priority: 1 # Check first - name: public url: https://molmall.gastown.io auth: none priority: 2 # Fallbackpriority语义明确企业内网注册表优先公共注册表兜底。这与本地三层解析最具体者优先rig town system的哲学一脉相承 ——先查最近的、最可信的来源再逐级回退。自托管注册表设计文档给出了 Docker 部署形态# Docker deployment docker run -d \ -p 8080:8080 \ -v /data/formulas:/formulas \ -e AUTH_PROVIDERoidc \ gastown/molmall-registry:latest # Configuration MOLMALL_STORAGEs3://bucket/formulas MOLMALL_AUTHoidc MOLMALL_OIDC_ISSUERhttps://auth.acme.corp关键环境变量变量用途AUTH_PROVIDERoidc/MOLMALL_AUTHoidc认证方式接入企业 OIDCMOLMALL_OIDC_ISSUEROIDC 签发者地址MOLMALL_STORAGEs3://bucket/formulas公式存储后端对象存储-v /data/formulas:/formulas本地卷挂载的备选存储企业合规公式 OIDC 认证 审计日志共同构成 Phase 4 Enterprise Features 的完整图景。联邦Federation通过 HOP 实现跨组织共享跨注册表发现$ gt formula search deploy kubernetes --federated Searching across federated registries... molmall.gastown.io: mol-deploy-k8s v3.0.0 ️ Official molmall.acme.corp: acme/mol-deploy-k8s v2.1.0 ✓ Verified molmall.bigco.io: bigco/k8s-workflow v1.0.0 ⚠️ Unverified联邦搜索把多个注册表的结果聚合展示每个结果都附带其信任等级标记️ Official / ✓ Verified / ⚠️ Unverified让使用者在更多选择与可信度甄别之间获得显式信息。HOP URI 解析流程# Full HOP URI gt formula install hop://molmall.acme.corp/formulas/acme/mol-deploy2.1.0 # Resolution via HOP (Highway Operations Protocol) 1. Parse hop:// URI 2. Resolve registry endpoint (DNS/HOP discovery) 3. Authenticate (if required) 4. Download formula 5. Verify checksum/signature 6. Install to town-level六步解析流程中Install to town-level再次确认无论公式来自哪个注册表最终落点都是 town 层~/gt/.beads/formulas/与 docs/design/formula-resolution.md 的 Tier 2 定义完全一致。实施阶段路线图Phase 1-5设计文档给出了清晰的五阶段演进路径结合源码可确认每阶段的现状Phase 1本地命令Now已实现详情见 Formula Resolution 架构文档。仓库证据三层解析ResolveFormulaContentinternal/formula/embed.go严格按rig town embedded顺序查找*.formula.toml内嵌系统层//go:embed formulas/*.formula.toml把 40 个公式编译进二进制internal/formula/embed.go安装时部署ProvisionFormulas在gt install时创建.beads/formulas/并写入内嵌公式同时生成.installed.json记录哈希internal/formula/embed.go健康管理CheckFormulaHealth/UpdateFormulas实现公式漂移检测与安全更新internal/formula/embed.go命令面gt formula list / show / run / create已落地internal/cmd/formula.go其中gt formula run支持--pr、--rig、--dry-run、--agent、--set等参数。Phase 2手动共享Formula export/importgt formula export mol-polecat-work mol-polecat-work.formula.tomlgt formula import mol-polecat-work.formula.tomlLock file 格式上文.lock.jsonPhase 3公共注册表molmall.gastown.io 上线gt formula install从注册表安装gt formula publish流程基础搜索与浏览。Phase 4企业特性私有注册表支持认证集成OIDC / Bearer token信任等级UNVERIFIED → AUDITED审计日志。Phase 5联邦HOP能力标签进入 schema联邦协议Highway Operations Protocol跨注册表搜索代理执行追踪问责。当前实现的公式本体为 Mol Mall 打下的地基要理解 Mol Mall 的落点需要先理解它分发的东西 —— 公式。仓库的 internal/formula/types.go 定义了四种公式类型类型常量用途convoyTypeConvoy并行腿legs执行 综合synthesisworkflowTypeWorkflow带依赖的顺序步骤expansionTypeExpansion模板化步骤生成供 compose 展开aspectTypeAspect多角度并行分析以 mol-polecat-work.formula.toml 为例它是标准的 workflow 公式定义issue / base_branch / setup_command / typecheck_command / test_command / lint_command / build_command七个变量编排load-context → branch-setup → implement → commit-changes → self-review → build-check → pre-verify → submit-and-exit八个步骤每个步骤带明确的 exit criteria。这种变量 步骤 验收标准的结构正是 Mol Mall 公式包content: formula TOML字段要承载的载荷—— 注册表本身不关心公式内部逻辑只负责把这份 TOML 可靠地分发、校验并记录出处。同时internal/formula/parser.go 的校验器必填字段、唯一 ID、needs引用、循环依赖检测、拓扑排序、ReadySteps就绪计算构成了pre-flight 检查中 formula.toml is valid的直接实现基础也为 Mol Mall 的POST /formulas服务端验证提供了可移植的校验逻辑。小结Mol Mall 是一份架构完整、落地分期的愿景文档它用三类注册表 HOP URI 五级 API 四级信任 能力标签 锁文件勾勒出一个类 npm 的 Gas Town 公式市场同时通过Install to town-level的设计把远端分发体系与仓库中已实现的三层本地解析docs/design/formula-resolution.md、internal/formula/embed.go无缝衔接。对读者最有价值的三点认识现状边界清晰Phase 1本地公式、三层解析、内嵌默认、健康检查已在仓库落地Phase 2-5导出导入、公共/私有注册表、HOP 联邦仍是设计蓝图文中的gt formula install/publish/upgrade与hop://为规划形态设计一致性无论是本地解析rig town system还是远端注册表private public federated贯穿始终的原则是就近、可信优先逐级回退升级路径平滑当前.installed.json与规划中的.lock.json同构现有解析器/校验器可直接服务注册表 API公式本体的 TOML 结构无需改变即可进入市场流通。相关文档Mol Mall Design —— 本文解读的设计文档本体Formula Resolution —— 已实现的三层本地解析架构rig town systemMolecules —— 公式Formula→ Proto → Mol 的完整生命周期cook, pour, squash公式解析器与校验器 —— TOML 解析、类型推断、依赖校验与拓扑排序公式类型定义 —— convoy / workflow / expansion / aspect 四种公式结构公式内嵌与部署实现 —— 三层解析、安装时部署、健康检查与更新内置公式集 —— 40 个官方内嵌公式OFFICIAL 等级的现实形态gt formula 命令实现 —— 当前已实现的 list / show / run / create【免费下载链接】gastownGas Town - multi-agent workspace manager项目地址: https://gitcode.com/GitHub_Trending/ga/gastown创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考