PJS 字幕组语言资产检索平台。

sekai-platform 用于整理、检索和查看字幕组积累的语言资产。一期聚焦剧情原文、历史译文、翻译版本和行级搜索能力,让组员可以在同一平台中定位剧情、查看原文、检索既有译文,并按字幕组租户隔离管理译文资产。

平台当前以 Project SEKAI 剧情资产为主要对象。原文来自 Moe Sekai / Exmeaning 公共数据源,译文通过导入接口进入平台。原文作为全平台共享资产,译文和翻译版本按租户隔离。

一期后端核心能力和部署交付已完成,前端已进入应用骨架和登录闭环阶段。

gantt
 title 一期后端项目进度(已完成)
 dateFormat YYYY-MM-DD
 axisFormat %m/%d
 section 后端已完成
 Phase 0 仓库基础 :done, p0, 2026年05月03日, 1d
 Phase 1 共享约定 :done, p1, 2026年05月03日, 1d
 Phase 2 数据库 :done, p2, 2026年05月04日, 1d
 Phase 3 鉴权和租户 :done, p3, 2026年05月04日, 1d
 Phase 4 外部数据源同步 :done, p4, 2026年05月04日, 1d
 Phase 5 搜索索引 :done, p5, 2026年05月05日, 1d
 Phase 6 搜索 API :done, p6, 2026年05月05日, 1d
 Phase 7 历史译文批量导入 :done, p7, 2026年05月05日, 1d
 Phase 8 剧情详情 :done, p8, 2026年05月05日, 1d
 后端部署交付 :done, deploy, after p8, 1d

前端当前已完成项目初始化、应用骨架、登录与租户上下文,后续继续接入搜索、资产阅读、导入和管理能力。

gantt
 title 一期前端项目进度
 dateFormat YYYY-MM-DD
 axisFormat %m/%d
 section 前端
 项目初始化 :done, web0, 2026年05月07日, 1d
 应用骨架和登录闭环 :done, web1, 2026年05月07日, 1d
 搜索和资产只读主路径 :active, web2, after web1, 2d
 导入和租户管理 :web3, after web2, 1d
 同步运维和联调部署 :web4, after web3, 1d

• 原文同步:从 Moe Sekai / Exmeaning 同步活动剧情、主线剧情、卡面剧情、区域对话和特殊剧情原文。
• 历史译文导入:导入字幕组既有 JSON 译文资产,并保留翻译版本和署名信息。
• 统一搜索:检索全平台共享原文和译文,结果定位到剧情、章节和具体行。
• 剧情详情:查看剧情、原文行、翻译版本和译文行。
• 规划中的开放 API:通过独立 OpenApiService 提供开放 API 监听端口,当前暂不开放业务接口。
• 后端部署:提供 Docker Compose 本地环境、服务器 Compose 部署和 GitHub Actions 构建部署入口。

一期采用 ASP.NET Core 微服务架构,使用 Docker Compose 组织本地和服务器运行环境。

本地依赖:

• .NET SDK 10
• Docker Desktop 或兼容 Docker Compose v2 的运行环境
• 本地 .NET 工具通过 dotnet tool restore 安装

复制本地配置样例:

cp .env.example .env

生成本地内部服务 token 密钥:

scripts/generate-internal-auth-keys.sh >> .env

启动基础设施和服务容器:

docker compose up --build

API Service 健康检查:

curl http://localhost:8080/health

运行部署冒烟测试:

SMOKE_PASSWORD=your-local-login-password scripts/deployment-smoke.sh

运行抢活专项冒烟测试:

SMOKE_PASSWORD=your-local-login-password scripts/claiming-smoke.sh
CLAIM_SMOKE_RUN_CLAIMS=1 SMOKE_PASSWORD=your-local-login-password scripts/claiming-smoke.sh

常用工程命令:

dotnet build SekaiPlatform.sln
dotnet test tests/integration-tests/SekaiPlatform.IntegrationTests.csproj

• 平台业务 API 文档维护在 Apifox 项目 8210187,文档站:https://sekai-platform.apifox.cn/。
• 开放 API 文档维护在 Apifox 项目 8216122。
• 总体设计
• 接口草案
• 开放 API 草案
• 数据模型
• 外部数据源
• 安全模型
• 一期后端交付状态
• Docker Compose 与 GitHub Actions 部署说明

• 当前仓库不维护本地 OpenAPI 源文件,正式 API 文档以 Apifox 为准。
• 涉及架构、数据模型、接口或关键业务流程的改动,先查看 docs/design/ 下的相关设计文档。
• 涉及后端交付状态和剩余部署事项的改动,先查看 docs/plan/。