README.zh-CN.md

<p align="center">
  <a href="./README.md">English</a> · <strong>简体中文</strong>
</p>

# Brancha

[![CI](https://github.com/Sider-ai/brancha/actions/workflows/ci.yml/badge.svg)](https://github.com/Sider-ai/brancha/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

![Brancha 手绘植物图鉴：小红花、多肉、向日葵、孤松与竹](media/brancha-flora.png)

Brancha 是一个由你自己的 Agent 驱动的创意发散画布。能够让 Agent 生成多个不同方向的方案，在实时画布中一目了然地查看、比较，再选中其中一版继续迭代打磨，直至心中所想。

## 🚀 安装

公开发布后，在 ChatGPT Work 模式或 Codex 的 **Plugins** 目录中搜索 **Brancha** 并安装。

**Claude Code** 中安装：

```
/plugin marketplace add Sider-ai/brancha
/plugin install brancha@brancha
```

本地开发时，将仓库根目录作为插件根目录安装。Skill 入口位于
[`skills/brancha/SKILL.md`](skills/brancha/SKILL.md)。安装后，Agent 会自行完成设置与启动。

## 🌿 开始创作

安装后，告诉你的 Agent：

> 使用 brancha skill 创建新的设计项目，需求为：xxx。

Agent会启动画布并开始创作，你可以在浏览器打开画布实时查看agent的工作情况： [http://127.0.0.1:9519](http://127.0.0.1:9519)

需要切换显示主题时，直接告诉 Agent 使用浅色、深色或跟随系统即可；已打开的画布会立即更新。

界面支持简体中文、English、日本語、Español 和 Deutsch。直接告诉 Agent 切换语言即可；设置会保留，已打开的页面会立即更新。

## 🌳 它能够做什么

凡是需要**先看几个方向、比较之后再决定**的任务，都适合放进 Brancha：

- **落地页与产品官网**——先生成不同的首屏、叙事结构和视觉风格，选中方向后继续打磨，再交给 Agent 正式开发。
- **交互 Demo 与产品原型**——把想法直接做成可以点击的 HTML Demo，比较信息架构、操作流程和界面方案，而不只是阅读文字描述。
- **文案与内容传播**——同时发散产品介绍、README、发布文章、推文、小红书笔记、广告语和活动文案，保留不同语气与传播角度。
- **品牌与视觉探索**——比较 Logo、海报、插画、配色、版式和整套视觉方向，让相近方案沿原分支继续演变。
- **文档与知识创作**——制作简历、教案、课程大纲、产品方案、研究报告和结构化文档，在树上同时查看框架、章节与多个成稿版本。
- **图片、视频与音频**——让 Agent 调用你选择的模型或服务生成媒体内容，并将不同方向挂回创作树中统一比较；所需 Key 或订阅凭据始终留在你自己的 Agent 环境中。

典型工作流：让 Agent 先生成三个明显不同的方向 → 在画布上查看真实结果 → 选中最接近的一版 → 让 Agent 从该节点继续分叉或修改。

## 🍃 本地数据

Brancha 将用户数据保存在仓库之外：

- macOS：`~/Library/Application Support/Brancha/`
- Windows：`%APPDATA%\Brancha\`
- Linux：`${XDG_DATA_HOME:-~/.local/share}/brancha/`

备份时请复制完整数据目录，以同时保留创作树和作品文件。


## 许可证

[MIT](LICENSE) © 2026 Sider AI。随发布 bundle 分发的依赖许可见 [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md)。