如何用一条命令在本地跑tregdev-local.sh开发环境全解析【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg 是agent 工具界的 OpenRouter一个统一的工具注册中心让 AI agent 用一个令牌调用 3000 个目录化 API 端点SEO、富化、广告、抓取等。如果你想在本地把 treg 跑起来做开发或自托管官方脚本scripts/dev-local.sh一条命令up就能拉起整个开发栈——本教程带你完整看懂它做了什么。为什么需要 dev-local.sh手动跑一个 FastAPI 服务要配数据库、密钥、环境变量还要小心别污染自己的生产配置。dev-local.sh 把这一切封装成一条命令并且天然与生产数据隔离服务跑在独立的 tmux 会话treg-dev里带热重载用独立的 SQLite 库treg-dev.db已被 gitignore不碰你的.env邮件 OTP 走开发模式验证码直接显示在页面上无需邮件服务一键启动前的三项前置条件脚本的preflight()会自动检查以下依赖缺一会明确报错dev-local.sh依赖用途安装方式tmux后台托管服务窗口brew install tmux或包管理器uvPython 包管理自动uv sync建虚拟环境官方安装脚本npm(Node 22.12)构建与运行 Vue 仪表盘前端安装 Node 22.12 或更高版本 如果仓库里还没有.venv脚本会自动执行uv sync如果frontend/node_modules不存在会自动npm ci。所以你只需要装好三样工具。一键启动dev-local.sh up 到底做了什么在仓库根目录执行scripts/dev-local.sh up脚本会按顺序完成这些事dev-local.sh预检确认 tmux / uv / npm 可用缺依赖自动补齐虚拟环境铸造开发密钥首次运行时生成一次性 Fernet 密钥与 session 密钥写入 scripts/.dev-home/dev-keys.env。这样--reload热重启后已登录会话和加密的密钥不会全部失效启动后端在 tmux 窗口里运行uv run python -m treg --reload监听18790端口并轮询最多 15 秒等待端口就绪失败则打印最近日志帮助排查启动前端另开一个 tmux 窗口跑 Vite 开发服务器5173 端口实现前端热更新输出结果成功时提示server up → http://localhost:18790并提醒 OTP 开发模式已开启启动后打开浏览器你会看到这个登录页本地开发模式下无需 GitHub 等 OAuth 配置直接用邮箱验证码即可与生产隔离的五个精妙设计读懂这几点才算真正理解脚本源码均在 dev-local.sh1️⃣ 独立的开发数据库环境变量TREG_DATABASE_URL被强制指向sqliteaiosqlite:///root/treg-dev.db注释里特意说明这三项最后设置所以永远生效——无论你的 shell 里写了什么开发栈都会保持自己的数据库和 OTP 模式。2️⃣ 邮件 OTP 开发模式TREG_EMAIL_DEV_MODEtrue让/auth/email/start直接把验证码返回在响应里。登录页面上会直接显示 dev code无需任何邮件发送器3️⃣ 沙箱化 CLIscripts/dev-local.sh cli args子命令会用沙箱 HOMEscripts/.dev-home替换你的真实 HOME 运行工作树里的tregCLI并预配置指向localhost:18790dev-local.sh。这意味着你测的是当前代码而不是已安装的生产版 CLI永远不会碰你真实的~/.treg/config.json4️⃣ 特性开关透传tmux 会话继承的是 tmux 服务端的旧环境TREG_HUB_ENABLED1 dev-local.sh up这种写法通常看似生效实则 404。脚本会在自身进程内展开白名单变量并烘焙进启动命令所以特性开关能可靠地到达服务器。5️⃣ 幂等与端口保护重复up会提示session already running而不是崩溃如果 18790 或 5173 端口被脚本之外的程序占用脚本会直接报错拒绝启动避免端口冲突引发的诡异问题。七个子命令日常速查表命令作用scripts/dev-local.sh up启动服务栈幂等scripts/dev-local.sh down停止 tmux 会话scripts/dev-local.sh status查看窗口列表 端口状态scripts/dev-local.sh logs查看服务窗口最近 200 行输出scripts/dev-local.sh restart重启服务窗口scripts/dev-local.sh attach进入 tmux 会话交互操作scripts/dev-local.sh cli login沙箱 CLI 登录本地服务scripts/dev-local.sh reset停止并清空开发数据库与 CLI 沙箱登录进入仪表盘后就是你团队的工具注册面板——可以添加密钥、注册工具、管理成员启动成功后先做这三件事第一步验证服务。浏览器打开http://localhost:18790交互版 OpenAPI 文档在/docs登录页在/login。第二步用沙箱 CLI 走通登录。scripts/dev-local.sh cli login # 邮箱验证码登录本地服务第三步注册一个密钥试试加密链路。在仪表盘的 Secrets 面板或treg secret add添加一个密钥——所有密钥都会用脚本铸造的 Fernet 密钥在服务端加密存储页面上永远只显示掩码⚠️ 注意reset会删除treg-dev.db和scripts/.dev-home开发密钥也会被重新铸造——重置后需要重新登录并重新添加密钥。想进一步探索scripts/dev-local.sh — 本文主角139 行的完整源码值得逐行读README.md — Self-hosting development 章节含不依赖 tmux 的手动运行方式USAGE.md — 完整的tregCLI 命令参考docs/context/architecture/local-run.md —treg run本地执行的安全隔离机制docs/context/architecture/local-proxy.md — 本地代理拦截任意程序的出站请求注入凭据frontend/README.md — 仪表盘前端的开发与构建说明src/treg/main.py — 服务入口python -m treg的启动逻辑一句话总结scripts/dev-local.sh up就是 treg 开发者的一键开机键——它替你管好数据库隔离、密钥铸造、前端热更新和沙箱 CLI让你把精力留给代码本身。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考