# LQAgentWritePlatform

施工方案编写独立服务。

## 启动 API

```bash
pip install -r requirements.txt
cp config/config.ini.template config/config.ini
python server/app.py
```

默认端口：`8003`。
默认会随 API 自动启动 `construction_write` Celery Worker；如需手动管理 Worker，将
`config/config.ini` 中的 `AUTO_START_CELERY_WORKER` 改为 `False`。

## 手动启动 Worker

```bash
celery -A foundation.infrastructure.messaging.celery_app.app worker -Q construction_write --loglevel=info
```

## Docker 部署

`docker/docker-compose.yml` 中 API 和 Celery Worker 已拆成独立服务：

- `LQAgentWriteServer`：FastAPI 服务
- `LQAgentWriteWorker`：`construction_write` 队列消费者
- `lqRedis`：Redis

Docker 部署时 API 容器通过 `AUTO_START_CELERY_WORKER=False` 关闭自动拉起 Worker，避免和独立 Worker 服务重复消费。

## 已注册接口

- `/sgbx/generating_outline`
- `/sgbx/regenerate_outline`
- `/sgbx/content_completion`
- `/sgbx/context_generate`
- `/sgbx/similar_fragment_search`
- `/sgbx/task_cancel`
- `/sgbx/task_status`
- `/health`
- `/celery/status`

## 配置

敏感配置不要写入代码：

- `DASHSCOPE_API_KEY`
- Redis 密码
- 模型服务 API Key
- Milvus 连接信息

运行前按实际环境更新 `config/config.ini`。
大纲生成默认使用 `outline_chapter_revise -> shutian_qwen3_5_122b`，需要配置
`SHUTIAN_122B_API_KEY`（可写入 `config/config.ini` 或使用同名环境变量）。