Resolve merge conflicts with upstream

Author: avianion

.codex/config.toml

@@ -0,0 +1,3 @@
+[features]
+goals = true
+collaboration_modes = true

.env.example

@@ -6,6 +6,7 @@ ANTHROPIC_API_KEY=dummy_anthropic_key
 FIREWORKS_API_KEY=dummy_fireworks_key
 CANOPYWAVE_API_KEY=dummy_canopywave_key
 SILICONFLOW_API_KEY=dummy_siliconflow_key
+OPENCODE_API_KEY=dummy_opencode_key
 
 # Database & Server
 DATABASE_URL=postgresql://manicode_user_local:secretpassword_local@localhost:5432/manicode_db_local
@@ -29,6 +30,7 @@ STRIPE_SUBSCRIPTION_500_PRICE_ID=price_dummy_subscription_500_id
 # External Services
 LINKUP_API_KEY=dummy_linkup_key
 LOOPS_API_KEY=dummy_loops_key
+ZEROCLICK_API_KEY=dummy_zeroclick_key
 
 # Discord Integration
 DISCORD_PUBLIC_KEY=dummy_discord_public_key
@@ -43,4 +45,4 @@ NEXT_PUBLIC_POSTHOG_API_KEY=phc_dummy_posthog_key
 NEXT_PUBLIC_POSTHOG_HOST_URL=https://us.i.posthog.com
 NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_dummy_publishable
 NEXT_PUBLIC_STRIPE_CUSTOMER_PORTAL=https://billing.stripe.com/p/login/test_dummy
-NEXT_PUBLIC_WEB_PORT=3000
+NEXT_PUBLIC_WEB_PORT=3000

.github/actions/setup-bun-compile-runtime/action.yml

@@ -0,0 +1,51 @@
+name: 'Setup Bun Compile Runtime'
+description: 'Download and cache a Bun runtime used by bun build --compile-executable-path'
+
+inputs:
+  target:
+    description: 'Bun compile target, for example bun-windows-x64'
+    required: true
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Get Bun version
+      id: bun-version
+      shell: bash
+      run: echo "version=$(bun --version)" >> "$GITHUB_OUTPUT"
+
+    - name: Cache Bun compile runtime
+      uses: actions/cache@v5
+      with:
+        path: ${{ runner.temp }}/bun-compile-runtimes/${{ inputs.target }}-v${{ steps.bun-version.outputs.version }}
+        key: ${{ runner.os }}-bun-compile-runtime-${{ inputs.target }}-v${{ steps.bun-version.outputs.version }}
+
+    - name: Prepare Bun compile runtime
+      shell: pwsh
+      env:
+        BUN_COMPILE_TARGET: ${{ inputs.target }}
+        BUN_VERSION: ${{ steps.bun-version.outputs.version }}
+        RUNTIME_DIR: ${{ runner.temp }}/bun-compile-runtimes/${{ inputs.target }}-v${{ steps.bun-version.outputs.version }}
+      run: |
+        $ErrorActionPreference = 'Stop'
+
+        $runtimePath = Join-Path $env:RUNTIME_DIR 'bun.exe'
+        if (!(Test-Path -LiteralPath $runtimePath)) {
+          New-Item -ItemType Directory -Force -Path $env:RUNTIME_DIR | Out-Null
+
+          $zipPath = Join-Path $env:RUNTIME_DIR "$($env:BUN_COMPILE_TARGET).zip"
+          $downloadUrl = "https://github.com/oven-sh/bun/releases/download/bun-v$($env:BUN_VERSION)/$($env:BUN_COMPILE_TARGET).zip"
+
+          Write-Host "Downloading $($env:BUN_COMPILE_TARGET): $downloadUrl"
+          Invoke-WebRequest -Uri $downloadUrl -OutFile $zipPath
+          Expand-Archive -LiteralPath $zipPath -DestinationPath $env:RUNTIME_DIR -Force
+
+          $extractedRuntimePath = Join-Path $env:RUNTIME_DIR "$($env:BUN_COMPILE_TARGET)/bun.exe"
+          if (!(Test-Path -LiteralPath $extractedRuntimePath)) {
+            throw "Downloaded $($env:BUN_COMPILE_TARGET), but bun.exe was not found at $extractedRuntimePath"
+          }
+
+          Copy-Item -LiteralPath $extractedRuntimePath -Destination $runtimePath -Force
+        }
+
+        "BUN_COMPILE_EXECUTABLE_PATH=$runtimePath" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8

.github/workflows/cli-release-build.yml

@@ -315,6 +315,11 @@ jobs:
             echo "$ENV_OVERRIDES" | jq -r 'to_entries | .[] | .key + "=" + .value' >> $GITHUB_ENV
           fi
 
+      - name: Prepare Windows Bun compile runtime
+        uses: ./.github/actions/setup-bun-compile-runtime
+        with:
+          target: bun-windows-x64
+
       - name: Build binary
         run: bun run scripts/build-binary.ts ${{ inputs.binary-name }} ${{ inputs.new-version }}
         working-directory: cli

.github/workflows/freebuff-e2e.yml

@@ -162,6 +162,11 @@ jobs:
           echo "NEXT_PUBLIC_CB_ENVIRONMENT=prod" >> $GITHUB_ENV
           echo "CODEBUFF_GITHUB_ACTIONS=true" >> $GITHUB_ENV
 
+      - name: Prepare Windows Bun compile runtime
+        uses: ./.github/actions/setup-bun-compile-runtime
+        with:
+          target: bun-windows-x64
+
       - name: Build Freebuff binary
         run: bun freebuff/cli/build.ts 0.0.0-e2e
         shell: bash

README.md

@@ -1,5 +1,7 @@
 # Codebuff & Freebuff
 
+English | [简体中文](./README.zh-CN.md)
+
 **[Codebuff](https://codebuff.com)** is an open-source AI coding assistant that edits your codebase through natural language instructions. **[Freebuff](https://www.npmjs.com/package/freebuff)** is the free, ad-supported version — no subscription, no credits, no configuration.
 
 Instead of using one model for everything, Codebuff coordinates specialized agents that work together to understand your project and make precise changes.

README.zh-CN.md

@@ -0,0 +1,251 @@
+# Codebuff & Freebuff
+
+[English](./README.md) | 简体中文
+
+**[Codebuff](https://codebuff.com)** 是一款开源的 AI 编程助手，能根据自然语言指令直接修改你的代码库。**[Freebuff](https://www.npmjs.com/package/freebuff)** 是它的免费、广告支持版本——无需订阅、无需积分、零配置。
+
+与那种"一个模型干所有事"的工具不同，Codebuff 会协调多个专业化的智能体（agent）协同工作，理解你的项目并做出精准的改动。
+
+<div align="center">
+  <img src="./assets/codebuff-vs-claude-code.png" alt="Codebuff vs Claude Code" width="400">
+</div>
+
+在我们的[评测](evals/README.md)中，Codebuff 在 175+ 个真实开源仓库的编码任务上以 61% 对 53% 的成绩领先 Claude Code。
+
+
+## 工作原理
+
+当你让 Codebuff "给我的 API 加上身份验证"时，它可能会调用：
+
+1. **File Picker Agent** —— 扫描代码库、理解架构、找出相关文件
+2. **Planner Agent** —— 规划哪些文件需要改、按什么顺序改
+3. **Editor Agent** —— 执行精确的修改
+4. **Reviewer Agent** —— 校验改动是否正确
+
+<div align="center">
+  <img src="./assets/multi-agents.png" alt="Codebuff Multi-Agents" width="250">
+</div>
+
+相比单模型工具，这种多智能体方案能带来更准的上下文理解、更精确的修改，以及更少的错误。
+
+## CLI：装好就能写代码
+
+安装：
+
+```bash
+npm install -g codebuff
+```
+
+运行：
+
+```bash
+cd your-project
+codebuff
+```
+
+然后直接告诉 Codebuff 你想做什么，剩下的它自己搞定：
+
+- "修掉用户注册里的 SQL 注入漏洞"
+- "给所有 API 端点加上限流"
+- "重构数据库连接代码，提升性能"
+
+Codebuff 会找到对应的文件，跨多个文件做改动，并跑测试确认没有破坏现有功能。
+
+## 创建自定义智能体
+
+要开始构建自己的智能体，先启动 Codebuff 然后执行 `/init`：
+
+```bash
+codebuff
+```
+
+进入 CLI 后：
+
+```
+/init
+```
+
+这会生成：
+```
+knowledge.md               # Codebuff 用的项目上下文
+.agents/
+└── types/                 # TypeScript 类型定义
+    ├── agent-definition.ts
+    ├── tools.ts
+    └── util-types.ts
+```
+
+通过编写智能体定义文件，你可以最大程度地控制智能体的行为。
+
+通过指定工具、可派生的子智能体和提示词来实现自己的工作流。我们还提供了 TypeScript 生成器，方便你以更程序化的方式控制流程。
+
+下面是一个 `git-committer` 智能体的例子，它会基于当前的 git 状态生成提交。注意它先跑 `git diff` 和 `git log` 分析改动，然后再把决策权交给 LLM，让它撰写有意义的 commit message 并完成实际提交。
+
+```typescript
+export default {
+  id: 'git-committer',
+  displayName: 'Git Committer',
+  model: 'openai/gpt-5-nano',
+  toolNames: ['read_files', 'run_terminal_command', 'end_turn'],
+
+  instructionsPrompt:
+    'You create meaningful git commits by analyzing changes, reading relevant files for context, and crafting clear commit messages that explain the "why" behind changes.',
+
+  async *handleSteps() {
+    // 分析改动
+    yield { tool: 'run_terminal_command', command: 'git diff' }
+    yield { tool: 'run_terminal_command', command: 'git log --oneline -5' }
+
+    // 暂存文件，并用合适的 message 生成提交
+    yield 'STEP_ALL'
+  },
+}
+```
+
+## SDK：在生产环境里跑智能体
+
+安装 [SDK 包](https://www.npmjs.com/package/@codebuff/sdk)——注意这跟 CLI 用的 codebuff 包是两个不同的包。
+
+```bash
+npm install @codebuff/sdk
+```
+
+引入 client，开始跑智能体：
+
+```typescript
+import { CodebuffClient } from '@codebuff/sdk'
+
+// 1. 初始化 client
+const client = new CodebuffClient({
+  apiKey: 'your-api-key',
+  cwd: '/path/to/your/project',
+  onError: (error) => console.error('Codebuff error:', error.message),
+})
+
+// 2. 跑一个编码任务……
+const result = await client.run({
+  agent: 'base', // Codebuff 默认的基础编码智能体
+  prompt: 'Add error handling to all API endpoints',
+  handleEvent: (event) => {
+    console.log('Progress', event)
+  },
+})
+
+// 3. 也可以跑自定义智能体！
+const myCustomAgent: AgentDefinition = {
+  id: 'greeter',
+  displayName: 'Greeter',
+  model: 'openai/gpt-5.1',
+  instructionsPrompt: 'Say hello!',
+}
+await client.run({
+  agent: 'greeter',
+  agentDefinitions: [myCustomAgent],
+  prompt: 'My name is Bob.',
+  customToolDefinitions: [], // 也可以加自定义工具！
+  handleEvent: (event) => {
+    console.log('Progress', event)
+  },
+})
+```
+
+更多 SDK 用法请看[这里](https://www.npmjs.com/package/@codebuff/sdk)。
+
+## Freebuff：免费的编程智能体
+
+不想订阅？**[Freebuff](https://www.npmjs.com/package/freebuff)** 是 Codebuff 的免费版本——无需订阅、无需积分、零配置，装上就能用。
+
+```bash
+npm install -g freebuff
+cd your-project
+freebuff
+```
+
+Freebuff 由广告支持，使用经过优化、兼顾速度与质量的模型。内置网页检索、浏览器使用等能力。详情见 [Freebuff README](./freebuff/README.md)。
+
+## 为什么选 Codebuff
+
+**自定义工作流**：用 TypeScript 生成器把 AI 生成和程序化控制混着用。智能体可以派生子智能体、按条件分支、跑多步流程。
+
+**OpenRouter 上的任何模型**：Claude Code 把你锁死在 Anthropic 的模型上，Codebuff 不一样——它支持 [OpenRouter](https://openrouter.ai/models) 上的所有模型，从 Claude、GPT 到 Qwen、DeepSeek 这类专用模型都行。可以按任务切换模型，也能随时用上最新发布的模型，不必等平台跟进。
+
+**复用已发布的智能体**：把社区[已发布的智能体](https://www.codebuff.com/store)拼起来用，少走弯路。Codebuff 智能体就是新一代的 MCP！
+
+**SDK**：把 Codebuff 嵌进你自己的应用里。可以创建自定义工具、对接 CI/CD，或把编码能力内嵌进你的产品。
+
+## 进阶用法
+
+### 自定义智能体工作流
+
+用 `/init` 命令创建带专门工作流的智能体：
+
+```bash
+codebuff
+/init
+```
+
+这会在 `.agents/` 下生成一套可自定义的智能体结构。
+
+## 参与贡献
+
+我们 ❤️ 来自社区的贡献——无论是修 bug、调整智能体、还是改进文档。
+
+**想参与？** 看一眼[贡献指南](./CONTRIBUTING.md) 就能上手。
+
+### 运行测试
+
+跑测试套件：
+
+```bash
+cd cli
+bun test
+```
+
+**交互式端到端测试**需要 tmux：
+
+```bash
+# macOS
+brew install tmux
+
+# Ubuntu/Debian
+sudo apt-get install tmux
+
+# Windows（通过 WSL）
+wsl --install
+sudo apt-get install tmux
+```
+
+更完整的测试文档见 [cli/src/__tests__/README.md](cli/src/__tests__/README.md)。
+
+可以帮忙的方向：
+
+- 🐛 **修 bug** 或新增功能
+- 🤖 **打造专用智能体**并发布到 Agent Store
+- 📚 **完善文档**或撰写教程
+- 💡 **分享想法**：在 [GitHub Issues](https://github.com/CodebuffAI/codebuff/issues) 留言
+
+## 开始使用
+
+### 安装
+
+**CLI**：`npm install -g codebuff`
+
+**SDK**：`npm install @codebuff/sdk`
+
+**Freebuff（免费版）**：`npm install -g freebuff`
+
+### 资源
+
+**文档**：[codebuff.com/docs](https://codebuff.com/docs)
+
+**社区**：[Discord](https://codebuff.com/discord)
+
+**Issue 与想法**：[GitHub Issues](https://github.com/CodebuffAI/codebuff/issues)
+
+**贡献指南**：[CONTRIBUTING.md](./CONTRIBUTING.md) ——想贡献从这里开始！
+
+**支持**：[support@codebuff.com](mailto:support@codebuff.com)
+
+## Star 历史
+
+[![Star History Chart](https://api.star-history.com/svg?repos=CodebuffAI/codebuff&type=Date)](https://www.star-history.com/#CodebuffAI/codebuff&Date)

agents/__tests__/base2.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, test } from 'bun:test'
+
+import {
+  FREEBUFF_DEEPSEEK_V4_FLASH_MODEL_ID,
+  FREEBUFF_DEEPSEEK_V4_PRO_MODEL_ID,
+  FREEBUFF_KIMI_MODEL_ID,
+  FREEBUFF_MINIMAX_MODEL_ID,
+} from '@codebuff/common/constants/freebuff-models'
+
+import { createBase2 } from '../base2/base2'
+
+describe('base2 reviewer selection', () => {
+  test.each([
+    [FREEBUFF_MINIMAX_MODEL_ID, 'code-reviewer-minimax'],
+    [FREEBUFF_KIMI_MODEL_ID, 'code-reviewer-kimi'],
+    [FREEBUFF_DEEPSEEK_V4_PRO_MODEL_ID, 'code-reviewer-deepseek'],
+    [FREEBUFF_DEEPSEEK_V4_FLASH_MODEL_ID, 'code-reviewer-deepseek-flash'],
+  ])('uses matching reviewer for model %p', (model, expectedReviewer) => {
+    const base2 = createBase2('free', { model })
+
+    expect(base2.spawnableAgents).toContain(expectedReviewer)
+    expect(base2.instructionsPrompt).toContain(`Spawn a ${expectedReviewer}`)
+    expect(base2.stepPrompt).toContain(`spawn a ${expectedReviewer}`)
+  })
+})