PROMPT
仓库全名：Probably Rendering One More Pixel Tonight。日常名称、包名和服务名统一使用 PROMPT / prompt。
个人图文、动效与视频实验项目。当前仅搭建开发环境及 CI/CD，没有业务页面；访问 / 返回 404 是预期行为。
技术栈
Next.js Pages Router、React、TypeScript（strict）、Tailwind CSS、Node.js 24。依赖版本由 package-lock.json 固定。
nvm use
npm ci
npm run dev
健康检查：GET /api/health。支持 HEAD，拒绝写入请求，并返回当前部署 commit。
验证
npm run typecheck
npm test
npm run build
npm run test:smoke
Smoke test 会启动 standalone 生产服务，验证 HTTP 健康检查、release 标识及不支持的方法，随后停止测试进程。默认自动选择可用测试端口，可设置 SMOKE_PORT 覆盖。
Gitea Actions 与持久部署
工作流为 .gitea/workflows/ci.yml，使用 runs-on: ces-control。PR 运行验证；main 分支 push 或在 main 上手动执行会在全部检查通过后部署。
Runner 前提：Linux 宿主机可访问 systemd，提供 Bash、Git、flock、基础文件工具及 root 或免密 sudo。Runner 的 label 必须让 Job 在该宿主机环境执行；容器里的 host 模式不一定就是物理宿主机。如果这些条件不满足，部署会明确失败，不能将 CI 中临时启动的进程当成持久服务。
仓库需要开启 Actions，且 ces-control runner 对仓库可用。Checkout 使用 Gitea Actions 提供的临时凭据，不在仓库保存密码或长期 token。
部署约定：
| 项目 | 值 |
|---|---|
| 服务 | prompt.service |
| 系统用户 | prompt |
| HTTP 端口 | 18131 |
| 发布目录 | /opt/prompt/releases/<commit> |
| 当前发布 | /opt/prompt/current |
| 持久数据目录 | /var/lib/prompt |
| 健康检查 | http://127.0.0.1:18131/api/health |
发布包含独立 Node 运行时。systemd 负责开机启动和故障重启；部署使用宿主机文件锁串行执行，跳过落后的 commit，通过原子软链接切换版本。新版本健康检查失败时恢复旧版本；首次发布失败则停止服务。数据目录不随 checkout 清理或版本切换而删除，当前尚未引入数据库或用户素材。
端口对外可达性取决于目标机器网络和防火墙；工作流不会修改防火墙。CI 日志会输出部署主机名及地址。当前没有业务接口或 UI，后续再确定图文、视频模块的包和设计系统。
维护命令（在目标宿主机执行）：
sudo systemctl status prompt.service
sudo journalctl -u prompt.service -n 100 --no-pager
curl -fsS http://127.0.0.1:18131/api/health