# 圣鸡教廷·AI辩经馆

这是一个“纯 HTML 前端 + 零依赖 Node AI 适配层”的上线版项目。

它现在具备三件核心能力：

- 可直接打开的 3D 主站 [index.html](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/index.html)
- 可直接 `node` 启动的 AI 接口适配层 [server/server.js](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/server/server.js)
- 可直接照着执行的生产部署文档 [DEPLOYMENT.md](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/DEPLOYMENT.md)

## 文件结构

- [index.html](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/index.html)
  - 正式主站
  - 3D 场景、神谕对话、音频、飞升与圣怒特效
- [runtime-config.js](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/runtime-config.js)
  - 运行时接口配置
  - 本地 `file://` 打开时默认连 `http://127.0.0.1:8788/v1/responses`
  - 正式 HTTPS 站点默认连同域 `/v1/responses`
- [offline-preview.html](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/offline-preview.html)
  - 纯离线预览
- [The_Clockmaker_s_Prayer.mp3](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/The_Clockmaker_s_Prayer.mp3)
  - 网站背景音乐
- [server/server.js](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/server/server.js)
  - AI 适配层
  - 支持 `POST /v1/responses`、`POST /api/debate`、`GET /health`
- [server/example.env.sh](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/server/example.env.sh)
  - 本地 shell 环境变量示例
- [deploy/nginx.holy-chicken.conf](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/deploy/nginx.holy-chicken.conf)
  - Nginx 站点模板
- [deploy/holy-chicken-ai.service](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/deploy/holy-chicken-ai.service)
  - `systemd` 服务模板
- [deploy/holy-chicken-ai.env.example](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/deploy/holy-chicken-ai.env.example)
  - 生产环境变量模板
- [CHICKEN_DOCTRINE_REFERENCE.md](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/CHICKEN_DOCTRINE_REFERENCE.md)
  - 教义与人格约束

## 本地运行

### 1. 启动后端

```bash
cd "/Users/adonisdc/Documents/New project/holy-chicken-ai-debate-hall/server"
node server.js
```

或开发模式：

```bash
cd "/Users/adonisdc/Documents/New project/holy-chicken-ai-debate-hall/server"
npm run dev
```

如果你有自己的本地密钥文件：

```bash
cd "/Users/adonisdc/Documents/New project/holy-chicken-ai-debate-hall/server"
npm run start:local
```

### 2. 打开前端

直接双击：

- [index.html](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/index.html)

本地文件模式下会自动请求：

- `http://127.0.0.1:8788/v1/responses`

### 3. 健康检查

```bash
curl http://127.0.0.1:8788/health
```

## 上游模型配置

后端支持 OpenAI-compatible 上游：

- `responses`
- `chat`
- `auto`

最常用变量：

```bash
export UPSTREAM_BASE_URL="https://your-provider.example/v1"
export UPSTREAM_API_KEY="your-api-key"
export UPSTREAM_MODEL="your-model-name"
export UPSTREAM_API_STYLE="responses"
```

也支持备用上游：

```bash
export FALLBACK_UPSTREAM_BASE_URL=""
export FALLBACK_UPSTREAM_API_KEY=""
export FALLBACK_UPSTREAM_MODEL=""
export FALLBACK_UPSTREAM_API_STYLE="responses"
```

## 正式上线

完整生产部署方案见：

- [DEPLOYMENT.md](/Users/adonisdc/Documents/New%20project/holy-chicken-ai-debate-hall/DEPLOYMENT.md)

推荐正式架构：

- 单域名 `Nginx`
- 同域静态主站
- 同域反代 `/v1/responses`
- `systemd` 常驻 Node 后端
- 上游模型密钥只放服务端

## 当前实现范围

- 纯 HTML 主站
- 3D 粒子教皇鸡、地球、经文环、飞升与圣怒特效
- 自动移动端降档
- 神谕人格、反应系统、飞升逻辑、圣怒关页逻辑
- OpenAI-compatible `Responses` 适配
- SSE 流式输出
- 离线预览

## 后续可继续升级

- 正式 NestJS + Redis + JWT 架构
- 管理后台与日志面板
- 上游模型健康切换与熔断
- 更复杂的 3D 后处理与模型资源管线
