# 开发与目录结构

> 本文档由 README 拆分而来：目录职责、开发协作、测试。
> 返回 [README](../README.md)。

## 目录

```
cmd/modelrouter            # 入口（纯 Go 服务端）
cmd/gui                  # Electron 桌面 GUI（内嵌核心 + 托盘 + 打包）
internal/config          # YAML 配置加载/校验
internal/lua             # LuaJIT VM + worker 池 + AdapterCache + 内置适配器 (embed)
internal/provider        # Provider(HTTP) + Registry(路由)
internal/gateway         # OpenAI 兼容 HTTP 服务 + 鉴权 + SDK/流式 + WebUI
internal/types           # 统一格式 & OpenAI wire 类型
```

## 开发协作

- **Git 分支工作流**：主分支 / 特性分支 / 发布分支的规范见
  **[docs/git-workflow.md](docs/git-workflow.md)**（[English](docs/git-workflow-en.md)）。
  主线：`main` 永可部署 → 特性合入 `main` → 切 `release/vX.Y.Z` 打 tag 发布 →
  hotfix 提交发布分支并 cherry-pick 回 `main`。
- **Lua 适配器协议**：见 **[docs/lua-adapters.md](docs/lua-adapters.md)**
  （[English](docs/lua-adapters-en.md)）。

## 测试

```bash
go test -tags luajit ./...
```

覆盖：配置校验、适配器加载/变换、签名钩子、Gateway 鉴权、SDK 结算、SSE 流式、
模型路由、多模态透传与 thinking 预算。