# 剧本平台

**Repository Path**: tangxiaozun/script-platform

## Basic Information

- **Project Name**: 剧本平台
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-27
- **Last Updated**: 2026-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Narrative Planner

本地私有的 AI 剧情游戏策划平台，面向 VN/AVG 项目。平台负责从项目基础、故事方案、世界人物、剧情玩法、路线结局、章节节点、叙事演出和资产需求，一直推进到一致性审校与完整策划包导出。

不负责正式图片/音频生产、完整台词写作、Godot 开发、构建或发布。

## 工作流

1. 第一阶段确定完整项目基础与基调。可手选、连贯随机、引用参考项目/方法模板，或让 AI 从零补全。
2. 每个后续策划产物都可以生成 3-5 份 AI 候选，比较、筛选、混合后采用到工作稿。
3. AI 采用不会自动变成正式内容；仍需人工保存不可变版本并接受阶段。
4. 项目规则和已接受上游是后续任务的冻结上下文。规则变化会精确标记受影响内容。
5. 完整导出要求全部阶段有效、审校无错误，且所有风险已有人工处置记录。

## 环境

- Windows 10/11
- Go（版本以 `go.mod` 为准）
- Node.js 与 npm
- 已登录并可运行的本地 Codex CLI

平台不会修改 `~/.codex/config.toml`。模型设置留空时使用 Codex CLI 当前默认模型，并保留自定义 `codex_remote_pool`；设置页保存的 Codex 配置对新任务立即生效。

## 开发运行

```powershell
npm install
pwsh -File scripts/dev.ps1
```

Web 开发端口为 `http://127.0.0.1:5174`，API 默认代理到 `http://127.0.0.1:8093`。

## 生产运行

```powershell
pwsh -File scripts/build.ps1
pwsh -File scripts/run.ps1 -Addr 127.0.0.1:8093 -DataDir data
```

`run.ps1` 在当前窗口前台运行 `bin/narrative-planner.exe`，不会重新构建；二进制不存在时会提示先运行 `scripts/build.ps1`。`-DataDir` 默认是项目根目录下的 `data`，使用自定义目录后，每次重启都必须传入相同值。按 `Ctrl+C` 可让服务优雅退出。

局域网使用时把监听地址改为局域网接口，例如 `0.0.0.0:8093`。非回环监听会启用共享令牌会话；令牌文件路径会写入启动日志。公网访问必须放在 VPN、Tailscale 或带 TLS 的反向代理之后。

在设置页排队恢复后，返回运行平台的前台 PowerShell 窗口并按 `Ctrl+C`，再使用完全相同的 `run.ps1` 命令重启，保留原来的 `-Addr` 和 `-DataDir`。看到启动日志中的监听地址后，可等待以下健康检查返回 `status: ok`，此时恢复已经应用：

```powershell
Invoke-RestMethod http://127.0.0.1:8093/api/v1/health
```

运行数据默认保存在 `data/`：

- `planner.db`：SQLite 权威数据
- `jobs/`：冻结的 AI 任务上下文和诊断
- `exports/`：策划导出包
- `backups/`：校验备份

## 验证

快速受影响测试：

```powershell
pwsh -File scripts/test-fast.ps1
```

发布前集中验证：

```powershell
go test -tags=integration ./apps/server/...
npm --prefix apps/web run test -- --passWithNoTests
npm --prefix apps/web run typecheck
npm --prefix apps/web run build
go build ./apps/server/cmd/planner
```

当前工程为新建平台，没有旧平台数据迁移。`../script-studio/` 仅作只读历史参考，不属于本平台运行或构建链路。