新闻详情

新闻详情

首页 / 资讯中心 / 详情

如何用一条命令在本地跑treg?dev-local.sh开发环境全解析

发布时间:2026/9/29 2:03:58来源:尧图网络
如何用一条命令在本地跑treg?dev-local.sh开发环境全解析
如何用一条命令在本地跑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),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

小米格机后IMEI丢失?硬件级下拉电阻修复指南 2026/9/29 2:51:34

小米格机后IMEI丢失?硬件级下拉电阻修复指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
AD9833高频输出信号质量实测:劣化原因与改善方案 2026/9/29 2:51:33

AD9833高频输出信号质量实测:劣化原因与改善方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
LSTM股票预测实战:从门控原理到模型搭建与避坑 2026/9/29 2:51:27

LSTM股票预测实战:从门控原理到模型搭建与避坑

简介:基于LSTM神经网络的股票预测算法研究是一份面向金融数据建模与深度学习初学者的学术论文PDF。该文献围绕股票最高价预测问题,系统讲解了LSTM神经网络的细胞状态、隐藏状态与输出门机制,并给出了在PyTorch框架下的网络搭建与参数微调思路…

阅读更多 →
解锁VS Code新姿势:用TaoToken统一Key打通AI插件开发与Bug秒修 2026/9/29 2:51:27

解锁VS Code新姿势:用TaoToken统一Key打通AI插件开发与Bug秒修

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
ChatGPT虚拟角色对话工程化实践指南 2026/9/29 2:51:26

ChatGPT虚拟角色对话工程化实践指南

简介:本资源是一份聚焦AI内容创作前沿应用的学术研究文档,面向游戏开发、虚拟现实、影视编剧及NLP技术实践者,系统探讨ChatGPT在虚拟角色对话生成与情节开发两大核心场景中的落地路径、实证效果与优化挑战。文档涵盖技术原理剖析、多领域应用…

阅读更多 →
RT-Thread W60X 板级支持包实战指南:从固件编译下载到外设配置 2026/9/29 2:51:25

RT-Thread W60X 板级支持包实战指南:从固件编译下载到外设配置

操作系统嵌入式物联网嵌入式OSRTOS 【免费下载链接】rt-thread RT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/ 项目地址: https://gitcode.com/gh_mirrors/rt/rt-thread 点击查看 免费下载 W60X 是…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉