【免费下载链接】claude-sneakpeekGet a parallel build of Claude code that unlocks feature-flagged capabilities like swarm mode.项目地址https://gitcode.com/gh_mirrors/cl/claude-sneakpeek点击查看免费下载claude-sneakpeek是一款帮你构建Claude Code 隔离变体variant的开源工具它会安装一份与现有安装完全独立的 Claude Code独立配置、会话、MCP 服务器和凭证并通过补丁解锁 swarm mode蜂群模式等未公开的特性。本文带你深入它的源码看看核心的Step-based VariantBuilder是如何把「构建一个变体」这件复杂的事拆成一条优雅、可组合的流水线。先搞清楚claude-sneakpeek 构建了什么运行一条命令npx realmikekelly/claude-sneakpeek quick --name claudesp工具就会在你的机器上「长出」一个完整的隔离实例~/.claude-sneakpeek/claudesp/ ├── npm/ # 独立安装的 Claude Code ├── config/ # 独立配置、会话、MCP 服务器 └── variant.json # 变体元数据 ~/.local/bin/claudesp # 包装脚本直接当命令用构建过程涉及目录创建、npm 安装、源码补丁开启 swarm mode、主题定制、包装脚本生成等一系列操作。步骤一多代码就容易变成「意大利面」。claude-sneakpeek 的答案就是把每个动作抽象成一个 Step步骤由 Builder 统一编排。整体设计一个 Context 一群 Step核心实现位于 src/core/variant-builder/ 目录。整个模式只有两个关键角色BuildContext构建上下文在 types.ts 中定义是贯穿所有步骤的「共享背包」包含四个部分paths所有预计算的路径变体目录、config 目录、npm 目录、包装脚本路径等prefs解析好的偏好设置npm 包名、是否启用 prompt pack、技能安装等state构建过程中累积的可变状态二进制路径、警告备注、最终元数据report进度上报函数CLI/TUI 界面靠它显示「Installing...」「Writing configuration...」BuildStep构建步骤每个步骤是一个实现execute(ctx)/executeAsync(ctx)接口的小类只依赖上下文、彼此不感知可以任意增删排序。VariantBuilder的构造函数就是一张「工序表」见 VariantBuilder.ts#步骤做什么1PrepareDirectoriesStep创建变体目录骨架2InstallNpmStep在隔离目录安装 Claude Code npm 包3SwarmModeStep补丁 cli.js开启原生多智能体特性默认开启4WriteConfigStep写入 settings.jsonAPI 地址、Key、模型映射5BrandThemeStep按 provider 应用品牌主题6TweakccStep运行 tweakcc 补丁 prompt pack7WrapperStep生成~/.local/bin/name包装脚本8ShellEnvStep集成 shell 环境变量按需9SkillInstallStep安装技能如 dev-browser10FinalizeStep汇总写入 variant.json 元数据注意第 3 步和第 6 步的注册方式——它们由特性开关条件注册如...(NATIVE_MULTIAGENT_SUPPORTED ? [new SwarmModeStep()] : [])开关定义在 constants.ts。这让「某版本不支持某特性」变成一行声明而不是散落各处的 if 判断。亮点步骤SwarmModeStep 如何「解锁」蜂群模式swarm mode 是 claude-sneakpeek 最核心的卖点。它的原理非常克制Claude Code 2.1.16 内部已经写好了多智能体代码TeammateTool、任务委托、成员消息邮箱等只是被一个 feature flag 门控函数挡着。swarm-mode-patch.ts 用正则定位这个门控函数把它替换为「永远返回 true」的版本。补丁流程在 SwarmModeStep.ts 中每一步都很「防御式」先备份cli.js→cli.js.backup随时可还原补丁失败不崩溃找不到门控函数时只往state.notes里追加一条警告构建继续进行写回后验证重新读取文件并检测状态确认补丁真正生效才标记swarmModeEnabled true关于门控函数细节可参考项目内的调研文档 docs/research/native-multiagent-gates.md。最后一步 FinalizeStep.ts 会把整个构建过程沉淀为variant.jsonprovider、npm 版本、swarmModeEnabled等后续的 update / doctor / remove 都依赖这份元数据。同步 异步双模消灭重复代码的动机源码文件头注释直接点明了设计动机「This builder eliminates duplication between sync and async createVariant functions」。为什么需要两种模式同步版给 CLI 快速路径用异步版给 TUI 界面用——长耗时操作比如 npm 安装期间report函数里会yieldToEventLoop()通过setImmediate让出事件循环让 Ink/React 界面有机会刷新进度条。于是每个 Step 只需实现两个方法Builder 按构造时传入的isAsync决定走哪条路见 index.ts 中极简的公开 APIexport const createVariant (params) new VariantBuilder(false).build(params); export const createVariantAsync async (params) new VariantBuilder(true).buildAsync(params);新增一个功能步骤写一个小类、往工序表里插一行同步异步两条路自动都生效——这正是 Step-based 设计最优雅的地方变化的部分被封装在 Step 内部不变的编排逻辑永远不动。更新流程同样优雅VariantUpdater变体更新没有另起炉灶而是复用同一套模式VariantUpdater.ts 维护一条update-steps工序表重构建 → 重装 npm → swarm 补丁 → 模型映射 → 主题 → 包装脚本 → 配置 → 元数据上下文类型是UpdateContext同样支持同步/异步双模。创建和更新两条流水线对称心智负担减半。总结三个可以抄走的工程实践Builder Step 编排把多阶段流程拆成语义清晰的原子步骤Builder 只负责顺序Step 只负责自己的事新增功能零侵入单一 Context 贯穿路径、偏好、状态、上报函数集中在一个对象里传递避免参数爆炸双模执行execute/executeAsync成对实现 事件循环让位同一套步骤同时服务 CLI 和 TUI 进度显示。想动手研究的话可以从以下入口读起编排核心VariantBuilder.ts 与 types.ts全部步骤src/core/variant-builder/steps/更新流水线src/core/variant-builder/update-steps/架构总览docs/architecture/overview.md特性文档swarm mode 相关特性、Mirror Claude 变体支持仓库克隆后运行npx realmikekelly/claude-sneakpeek quick --name claudesp快速体验完整构建流程 赞分享【免费下载链接】claude-sneakpeekGet a parallel build of Claude code that unlocks feature-flagged capabilities like swarm mode.项目地址https://gitcode.com/gh_mirrors/cl/claude-sneakpeek点击查看免费下载相关推荐把 10 美元的鼠标变成触控板Mac Mouse Fix 从安装、配置到事件拦截机制的实操手册把 10 美元的鼠标变成触控板Mac Mouse Fix 从安装、配置到事件拦截机制的实操手册 如果你受够了滚轮一跳一跳的粗糙手感、闲置的侧键Mac Mou桌面应用系统编程claude-howto 实战如何为 Claude Code 构建 incident-commander 事件响应子代理claude howto 实战如何为 Claude Code 构建 incident commander 事件响应子代理 本指南以 claude howto教程文档learn-claude-code s01 深入解析一个 while 循环 Bash如何构建最简 Agent Looplearn claude code s01 深入解析一个 while 循环 Bash如何构建最简 Agent Loop 在 Claude Code 式的示例工程AI Agent人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
