# 概述

**Chiron 是一个多租户 SaaS 形态的 AI Agent 平台。** 它把「一个 agent 循环」做成可被多个租户共享、
且能被审计与配额约束的服务：Go 网关负责鉴权/路由/SSE/计费，Python 引擎负责 agent 循环、
工具执行、RAG 与工作流，Vue 3 前端负责会话界面。

## 架构一眼

```
浏览器 ─► 前端(Nginx/Vue 3, :3000) ─► Go 网关(cmd/chiron, :8080)
                                        │
                                        ▼
                          Python 引擎(python-engine, :8000)
                                        │
              PostgreSQL(pgvector) · Redis ◄──┴──► Milvus · MinIO/S3
```

- **网关薄、引擎厚**：`internal/` 里大量是路由与胶水；能力主要长在 `python-engine/`。
- **对外入口**：本地开发直连 `:5173`；容器形态走 frontend 容器的 nginx（`:3000`）。

> 权威来源：`README.md` §架构 / §目录结构 · [架构](Core-Architecture.md)

## 可比性口径（先说清"跟谁比、比哪一层"）

Chiron 与对标项目**只有「同一层」才可比** —— agent 循环 / 子 agent / 事件契约 / 执行隔离 / 可审计性。
**交付形态与 UI 不可比**，不列入差距。这是本仓库做对照分析时一直遵守的口径。

- 与 **DeepSeek Harness** 的对照：见 [DSH 差距分析（摘要）](https://github.com/Athenavi/chiron/blob/master/docs/dsh-gap-analysis.md) —— 六个「可超越」的切口。
- 与 **Reasonix 2.x** 的对照：见 [Reasonix 差距分析（摘要）](https://github.com/Athenavi/chiron/blob/master/docs/reasonix-gap-analysis.md) —— 能力面不落后，
  差距在「把纪律固定下来的形式」与**测试厚度**。
- 与 **Reasonix 2.x 的 UI/UX** 对照：见 [UI/UX 差距分析（摘要）](https://github.com/Athenavi/chiron/blob/master/docs/reasonix-ui-ux-gap-analysis.md)。

**平台面是 Chiron 独有的一段**：多租户、配额、计费、多副本协调、身份/会话隔离，在单机形态的对标项目里
**没有对应物**。

## 从哪里继续

| 我想…… | 去哪 |
|---|---|
| 把它跑起来 | [安装](Getting-Started-Install.md) → [快速入门](Getting-Started-Quickstart.md) |
| 看懂一条请求怎么走 | [架构](Core-Architecture.md) |
| 知道哪些事**明确不做** | [设计理念](Getting-Started-Philosophy.md) |
| 提交代码 | [贡献与验收](Contributing-Overview.md) |

---

_本页由仓库内 `docs/wiki/` 同步生成（`scripts/sync_github_wiki.py`）。**请不要直接编辑本 wiki** —— 改动会下次同步时被覆盖；请改仓库里的对应文件。_