Project Rules

服务与代码

每次修改项目内任何代码、配置、脚本后，必须执行 ./restart.sh 以使服务生效。
默认通过 ./start.sh 启动，保持 RELOAD=0（后台运行更稳定）。
若需开发期热重载，可显式使用 RELOAD=1 ./start.sh。
每次完成修改后，必须执行 git add/commit 并推送到 origin/main（https://github.com/Shadowell/Alpha）。
当系统架构、页面功能、API 接口、项目结构或技术栈发生变化时，必须同步更新 README.md（包括但不限于：核心功能表、界面预览、技术栈、项目结构树、API 接口列表等对应章节）。

每次生成的"实施计划 / 任务方案 / plan" 都必须保存到 .cursor/plans/ 目录下的 Markdown 文件。
文件名格式固定为：YYYYMMDD-HH_<简短主题>.plan.md
- YYYYMMDD 为当天日期，HH 为 00–23 的 24 小时制小时（本地时区，亚洲/上海）。
- 示例：20260418-17_修复缩量启动点击bug.plan.md、20260418-22_接入本地Ollama-LLM.plan.md
文件内容要求：
- 必须包含 "背景 / 目标"、"任务分解（checklist）"、"验收标准" 三个章节。
- 建议再加 "风险与回滚" 与 "关键决策记录"。
计划文件只增不删；同一主题后续有更新，另起新文件并引用旧文件链接，而不是覆盖原文件。
生成计划后，先保存到 .cursor/plans/，再开始执行具体任务。