# 后宫台本 API (Shiquan Script API) v1.1

Base URL: http://shiquan.sysmeng.com

## 这是什么
三部 Galgame 精简台本 API。
格式只有两种行：
1. 角色「台词」
2. 旁白（无前缀的叙述）

已删除：引擎指令 / 语音编号 / 跳转旗标 / raw 脚本 / 菜单选项。
男主角统一「祖宋」。昵称：宋君 / 宋さん / 宋くん / 宋先生 / 宋様。

## AI 使用流程
1. GET /llms.txt 或 GET /
2. GET /v1/games
3. GET /v1/games/{id}/acts
4. GET /v1/games/{id}/dialogue?act=ACT_A&format=text
5. GET /v1/search?q=关键词

## 作品 ID
- hgc    = 后宫村     女主: 亜麻音/綾乃/舞奈/アイリ
- hgame  = 后宫游戏   女主: 美菜子/エリカ/いずみ/彩佳/香奈
- harem2 = 后宫游戏2  女主: 明日香/綾奈/爱丽丝/理沙/真由

## 端点
| Method | Path | 说明 |
|--------|------|------|
| GET | / | 使用说明 HTML |
| GET | /llms.txt | 纯文本说明（给 Agent） |
| GET | /openapi.json | OpenAPI |
| GET | /docs | Swagger |
| GET | /health | 健康检查 |
| GET | /v1/games | 作品列表 |
| GET | /v1/games/{id} | 作品详情 |
| GET | /v1/games/{id}/acts | 章节列表 |
| GET | /v1/games/{id}/dialogue?act=ACT_A | 读一章（推荐 format=text） |
| GET | /v1/games/{id}/full | 全台本拼接 |
| GET | /v1/games/{id}/file?path=clean/ACT_A.txt | 按路径读 |
| GET | /v1/games/{id}/speakers | 说话人统计 |
| GET | /v1/search?q=&game=&limit= | 搜索 |
| GET | /v1/male-lead | 男主命名约定 |

## 示例
http://shiquan.sysmeng.com/v1/games/hgc/dialogue?act=ACT_A&format=text
http://shiquan.sysmeng.com/v1/search?q=宋君&game=hgame&limit=20
http://shiquan.sysmeng.com/v1/games/harem2/full?format=text

## 约定
- UTF-8，无鉴权，CORS *
- 写新台本时说话人用「祖宋」，昵称用「宋君」
- 不要用旧名：竜児、鈴屋祖宋、高槻祖宋、高槻公平