# 文档目录

本目录为智能体「生成 / 发布 / 灌数」相关说明（中文）。

| 文档 | 说明 |
|------|------|
| [智能体-生成发布-能力说明.md](./智能体-生成发布-能力说明.md) | **需求 / 能力边界**（做什么、不做什么、工作流、验收） |
| [智能体-生成发布-API.md](./智能体-生成发布-API.md) | **接口契约**（路径、请求/响应、宿主回执字段） |
| [数据同步-中间件.md](./数据同步-中间件.md) | 跨库同步能力与 API（LWW / agent push） |
| [数据同步-开通说明.md](./数据同步-开通说明.md) | 管理员开通：默认无感、opt-in |
| [数据同步-迁移手册.md](./数据同步-迁移手册.md) | O7：旧客从双写迁入（禁止静默） |
| [同步表约定.md](./同步表约定.md) | UUID 同步表模板与 agent 接口约定 |
| [发版说明-数据同步.md](./发版说明-数据同步.md) | 默认无感 / 增值开通发版摘录 |

> 业务用语称「**模块**」。HTTP 路径仍为 `/api/v1/apps/...`。智能体默认无需配置模块白名单即可自建发布。

## Linux 部署

本仓库根目录提供 `start.sh` / `restart.sh` / `stop.sh` / `pull-and-restart.sh`。  
与宇恒 Web 合并的交互菜单见同级目录 [`../ops/README.md`](../../ops/README.md)（`./deploy-menu.sh`）。

**配置热重载**（改域名/Nginx/yaml 不必整栈 rebuild）：[`../nginx/README.md`](../nginx/README.md)，执行 `./reload-config.sh`。

| 改什么 | 文件 | 命令 |
|--------|------|------|
| 容器反代 | `web/nginx.conf` | `./reload-config.sh web` |
| 公开 URL / 发布回执 | `.env` 的 `AIJZ_PUBLIC_BASE_URL` + `platform/etc/platform.docker.yaml` | `./reload-config.sh platform` |
| Gateway | `gateway/etc/gateway.docker.yaml` | `./reload-config.sh gateway` |
| LLM Key | `.env` | `./reload-config.sh ai` |
| 供应商 / 模型列表 | `ai-service/etc/llm.yaml` | `./reload-config.sh ai` |
| 域名 HTTPS | `nginx/aijz.host.conf` + 证书 | `./reload-config.sh host-nginx` |