用途:用一条命令在本地拉起 treg 开发栈,适合启动开发服务器、本地运行 treg、本地测试登录等场景。主要能力:scripts/dev-local.sh 在 tmux 会话中以开发安全配置运行 FastAPI 服务器(uv run python -m treg --reload,设 TREG_EMAIL_DEV_MODE=true,使用独立 sqlite treg-dev.db,端口 18790),同时运行前端 Vite 开发服务器(frontend/ 中 npm run dev,端口 5173),由 Python 入口加载热更新。无需基础设施依赖(sqlite)。前置条件:Node 22.12+、npm、tmux、uv(缺少 .venv 时脚本会运行 uv sync)。子命令:up(幂等启动,健康后打印 URL)、down(停止会话)、status(窗口与端口检查)、logs(服务器窗口最近 200 行)、restart(重启服务器窗口)、attach(接入 tmux)、cli <args>(使用工作区 treg CLI,沙箱 HOME,预指向 localhost)、reset(停止并清除 treg-dev.db 与 CLI 沙箱)。cli 是登录测试的关键:scripts/dev-local.sh cli login 以 HOME=scripts/.dev-home 对本地运行 CLI,不会覆盖真实的 ~/.treg/config.json。邮件 OTP 开发模式开启,验证码显示在登录页/API 响应中,无需发信服务。可用 TREG_DEV_DB=/absolute/path/to/dev.db 选择独立数据库而不重置默认库。局域网预览:用 bash scripts/build-dashboard.sh 构建,再执行 TREG_FRONTEND_DEV=false scripts/dev-local.sh restart(或 up),在 18790 端口提供编译资源;默认热更新模式要求浏览器在同一台机器。排错:18790 被占用且无会话时用 lsof -i :18790 排查;服务器窗口退出时用 scripts/dev-local.sh logs 查看回溯再 restart;需要全新数据库时先 reset 再 up。
dev-local
编程与开发
更新于 10-16 06:14