# bbboyCli

**Repository Path**: wangshh_123/bbboy-cli

## Basic Information

- **Project Name**: bbboyCli
- **Description**: 智能体项目全仓
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-18
- **Last Updated**: 2026-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# bbBoyCli

本地 AI 智能体（**bbboy**）与支付渠道聚合 API 服务（**echo_gf / channel_app**）的组合工作区。智能体通过 HTTP 调用服务端 OpenAPI，也可选配数据库、文件与浏览器插件能力。

## 项目结构

| 目录 | 说明 | 技术栈 |
|------|------|--------|
| [`bbboy/`](bbboy/) | 智能体 CLI：终端 TUI + LLM 编排 + 工具执行 | Go、Eino、DeepSeek、Bubble Tea |
| [`echo_gf/app/channel_app/`](echo_gf/app/channel_app/) | 支付渠道聚合 API（Photon / PingPong / Interlace） | Go、GoFrame v2、MySQL、Redis、JWT |

两个子目录各自为**独立 Git 仓库**，可单独克隆与发布；本目录便于联调与文档统一维护。

## 架构概览

```
┌─────────────────────────────────────────────────────────────┐
│  bbboy（智能体端）                                            │
│  TUI → Agent(ReAct/顺序/并行/循环) → 工具                     │
│         ├─ api_*     ──────────► channel_app :8080          │
│         ├─ db_*      ──(可选)──► 分析库                       │
│         ├─ file_*    ──────────► 本地工作目录                  │
│         └─ browser_* ◄─WS:9899── 浏览器插件                   │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  channel_app（服务端）                                        │
│  JWT 分级 API → Facade → 各渠道 SDK → 第三方支付平台            │
│  MySQL（渠道配置）  Redis（Token 等）  OpenAPI /api.json       │
└─────────────────────────────────────────────────────────────┘
```

详细说明见 [docs/architecture.md](docs/architecture.md)。

## 快速开始（联调）

### 1. 启动服务端

```bash
cd echo_gf/app/channel_app
# 编辑 manifest/config/config.yaml：database、redis、jwt
go run main.go
```

- HTTP：<http://127.0.0.1:8080>
- OpenAPI：<http://127.0.0.1:8080/api.json>
- Swagger：<http://127.0.0.1:8080/swagger>

### 2. 创建 API Token（可选，访问受保护接口时需要）

使用配置中的 `jwt.admin_key` 请求 Token 管理接口，例如：

```bash
curl -X POST http://127.0.0.1:8080/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -H "X-Admin-Key: <your-admin-key>" \
  -d '{"app_name":"bbboy","levels":[4]}'
```

将返回的 `token` 配置到 bbboy（见下）。

### 3. 启动智能体

```bash
cd bbboy
cp configs/config.example.yaml configs/config.yaml
# 设置 DEEPSEEK_API_KEY；若调用 channel_app 则开启 auth 并填入 token
go run ./cmd/agent
```

在 TUI 中用自然语言提问；Agent 会优先通过 `api_discover` 读取 `/api.json` 再调用业务接口。

## 文档索引

| 文档 | 内容 |
|------|------|
| [docs/README.md](docs/README.md) | 全仓库文档导航 |
| [docs/06-platform-solution.md](docs/06-platform-solution.md) | **平台总纲**：微服务、管理端、网关、Schema、沙盒、插件、路线图 |
| [docs/architecture.md](docs/architecture.md) | 架构、权限、协作方式 |
| [docs/05-echo-gf-linapro-admin.md](docs/05-echo-gf-linapro-admin.md) | echo_gf 管理微服务（LinaPro 模板，保留 channel_app） |
| [docs/getting-started.md](docs/getting-started.md) | 分步安装与配置 |
| [bbboy/README.md](bbboy/README.md) | 智能体：功能、配置、工具、Agent 模式 |
| [bbboy/docs/](bbboy/docs/) | 防幻觉、数据分析、多用户安全、阶段 2 网关 |
| [echo_gf/app/channel_app/README.MD](echo_gf/app/channel_app/README.MD) | 服务端：API 分级、鉴权、渠道、目录结构 |

## 环境要求

- Go 1.23+（channel_app）、Go 1.24+（bbboy）
- MySQL、Redis（channel_app 运行依赖）
- DeepSeek API Key（bbboy 运行依赖）

## 安全提示

- 勿将 `config.yaml`、生产 DSN、API Key 提交到版本库
- 多用户场景请参考 [bbboy/docs/03-multi-user-security-and-privacy.md](bbboy/docs/03-multi-user-security-and-privacy.md)，规划由服务端承担鉴权与数据隔离，Agent 仅作带 Token 的客户端